Installing MIDP

This chapter describes how to install the MIDP Reference Implementation, Version 2.0 FCS, onto your desktop system. It assumes that your system meets the hardware and software requirements detailed in the Release Notes.

Note – Only one person can use the MIDP Reference Implementation’s midp executable at a time. If others try to use the executable at the same time, they will get file sharing violations.

If multiple people will be using midp executable concurrently, they should each install the MIDP Reference Implementation.

Decide where you will install the MIDP Reference Implementation on your system.

For example, you might decide that you will install it into a subdirectory of C:\.

If multiple people are installing the MIDP Reference Implementation, each person must choose a different directory.

If you have not installed CLDC, Version 1.0.4, install it into the directory that you chose in Step 1.

See the instructions that came with CLDC, Version 1.0.4.

If it is already installed, go to the next step.

Unzip the MIDP Reference Implementation distribution into the directory that you chose in Step 1.

Unzipping the distribution will create a subdirectory, midp2.0fcs, that contains the subdirectories listed in the Release Notes.

The MIDP Reference Implementation documentation refers to the full path name of the directory that holds your MIDP Reference Implementation installation (such as c:\midp2.0fcs) as midpInstallDir.

Set your environment variables to support building and using the MIDP Reference Implementation.

See the section that corresponds to your system type:

Setting Environment Variables for Microsoft Windows 2000

Setting Environment Variables for the Solaris™ Operating Environment and the Linux Operating System

Setting Environment Variables for Microsoft Windows 2000

In the Environment Variables pane (under the Advanced tab) of the System Properties dialog box, edit the PATH system variable, if necessary. Ensure that it includes the directories of:

The tools you will use to build the MIDP Reference Implementation. These tools will probably include the JDK™ release and Cygwin, as well as your other programming tools.

Note – The directory of the Cygwin executables must be before the directory of the Windows executables.

Any libraries (DLLs) of native methods for your device, if you are porting the MIDP Reference Implementation.

If necessary, also in the Environment Variables pane, the following environment variables:

ALT_BOOTDIR – Have it point to the directory that contains your JDK release, if it is not in the C:\jdk1.3.1 directory.

KVM_DIR – Have it point to the directory that contains your CLDC, Version 1.0.4 installation if the release is not in the midpInstallDir\..\kvm directory.

Setting Environment Variables for the Solaris™ Operating Environment and the Linux Operating System

To set the environment variables for the Solaris™ Operating Environment or Linux operating system:

If necessary, edit the PATH environment variable to include the directories of the tools you will use to build the MIDP Reference Implementation. They will probably include the JDK release, ZIP tools, and GCC, as well as your other programming tools.

Note – On the Solaris OE, the directory /usr/bin must appear before /usr/ucb.

If necessary, also edit the following environment variables:

ALT_BOOTDIR – Have it point to the directory that contains your JDK release if it is not in either /usr/local/java/jdk1.3/x86 or
/usr/local/java/jdk1.3/solaris (depending on your system architecture).

KVM_DIR – Have it point to the directory that contains your CLDC, Version 1.0.4 installation if the release is not in the midpInstallDir/../kvm directory.

Chapter 1

Installing MIDP

Setting Environment Variables for Microsoft Windows 2000

Setting Environment Variables for the Solaris™ Operating Environment and the Linux Operating System