A P P E N D I X B

Command-Line Options for Installing the IDE

This appendix describes the command-line options for installing the IDE. There are four main reasons for using command-line options.

To specify a non-standard location for the J2SE platform, see Specifying the Location of the J2SE Platform

To specify a non-standard location for the temporary space directory, see Specifying the Location of the Temporary Space Directory

To specify a log file for error messages to aid in debugging, see Specifying a Log File for Error Messages.

To install in silent mode, see Installing the IDE in Silent Mode.

Command-Line Options Used With the GUI Installer

Three command-line options can be used with the GUI installer files. TABLE B-1 summarizes these option.

TABLE B-1 Command-line Options Used with GUI Installers
Option	Description
`-is:tempdir` pathname	Specifies the directory to use for temporary space. Used when the default on your system has insufficient space for the installer to run successfully.
`-is:javahome` pathname	Specifies the locations of your J2SE platform. Useful when the J2SE platform is installed in a non-standard location.
-`is:log log.txt`	Directs the installer to put error messages into the log file, `log.txt`.

Specifying the Location of the J2SE Platform

If the installer does not detect your J2SE platform (this can happen if your J2SE platform is installed in a non-standard location), you can invoke the installer from the command line using the option -is:javahome to specify the path to your J2SE platform.

For example, on a Microsoft Windows system, type this command:

 C:\> \jstudio-download-directory\jstudio_M04q3-win-en.exe -is:javahome C:\j2se-directory

Replace the variable j2se-directory with the location of your J2SE installation.

Specifying the Location of the Temporary Space Directory

If the default temporary space directory does not have enough space to run the installer, you can invoke the installer from the command line using the option -is:tempdir to specify another directory that has sufficient space.

C:\> \jstudio-download-directory\jstudio_M04q3-win-en.exe -is:tempdir C:\temporary-directory

Specifying a Log File for Error Messages

If you need to do additional troubleshooting during a problem installation, you can run the installer with the -is:log log.txt option. This directs the installer to put error messages in the file log.txt.

C:\> \jstudio-download-directory\jstudio_M04q3-win-en.exe -is:log log.txt

Note - This option is highly recommended, as you will not be able to track installation errors without it.

Installing the IDE in Silent Mode

You can run the installer in a non-interactive mode, called silent mode, by specifying the -silent option on the command line. This option suppresses GUI displays to the terminal window.

If you downloaded the installer files from the web site, you create a file containing the command-line install options and use the installer launchers. The installer launcher and the options file must reside in the same directory. See Installing Silently Using Web Download.

Installing Silently Using Web Download

Create a file containing the command-line options you want to use and place the file in the jstudio-download-directory. Then invoke the installer from the command line using the -silent option.

To Install Silently From Web Download (Solaris OS)

1. In a text editor, create the jstudio_M04q3-sol-sparc-en.sp file in the jstudio-download-directory where you saved the downloaded jstudio_M04q3-sol-sparc-en.bin installer launcher.

Include at least the three mandatory options and remember to put them in quotes. For example, your .sp file might look like this:

installDir="/opt/jstudio_m04q3"

jdkHome="/usr/j2se"

serialNumber="trial"

See TABLE B-2 for other install options.

TABLE B-2 Command-Line Options for Silent Installation
Option - Short Name	Option - Long Name	Description
`id`	`installDir`	Specifies the directory where you want the IDE installed. Mandatory for `-silent` mode.
`jh`	`jdkHome`	Sets the location of the valid J2SE version to use with the IDE. Mandatory for `-silent` mode.
`sn`	`serialNumber`	Sets the license serial number for the IDE. Mandatory for `-silent` mode.
`ps`	`proxyServer`	Specifies with the -DportNumber option, the registry setting for the proxy server name and port number.
`pn`	`portNumber`	Specifies with -DproxyServer option, the registry setting for the proxy server name and the port number. These options can be set at any time using the IDE. Specifying these two options on the command line is optional. However, if specified, they are both required. These options can also be set at any time using the Setup wizard in the IDE . See Chapter 10.
wcw=no	installConnWizard	Prevents the J2ME Wireless Connection Wizard Module from being installed. The default is `wcw=yes`.

2. Start the installer launcher from the command line.

# cd jstudio-download-directory

# jstudio_M04q3-sol-sparc-en.bin -is:log log.txt -silent

Note - The -is.log option is not required, but is recommended for capturing error messages during installation.

The installer uses the options specified in the s1s5me-sol-sparc-en.sp file to install the IDE and displays the following in the command prompt window:

InstallShield Wizard

Initializing InstallShield Wizard...

Searching for Java(tm) Virtual Machine...

.........

Running InstallShield Wizard...

3. When the installation completes, review the log file install.log found in the jstudio-install-directory. (This file is only created if the install is not successful and the debug option is not turned on.)

4. If you installed as a superuser, exit from superuser privileges.

# exit

To Install Silently From Web Download (Microsoft Windows)

The following example shows the steps for installing the IDE silently from the command line on a Microsoft Windows system.

1. In a text editor, create the jstudio_M04q3-win-en.sp file in the jstudio-download-directory where you saved the downloaded jstudio_M04q3-win-en.exe installer launcher.

Include these mandatory options and remember to put them in quotes. For example, your .sp file might look like this:

installDir="C:\Sun\jstudio_m04q3"

jdkHome="C:\j2sdk1.4.1_02"

serialNumber="trial"

2. Start the installer launcher from the command line.

C:\> cd jstudio-download-directory

C:\> jstudio_M04q3-win-en.exe -is:log log.txt -silent

Note - The -is.log option is not required, but is recommended for capturing error messages during installation.

The installer uses the options specified in the s1s5me-win-en.sp file to install the IDE and displays the following in the command prompt window:

InstallShield Wizard

Initializing InstallShield Wizard...

Searching for Java(tm) Virtual Machine...

.........

Running InstallShield Wizard...