test

Sun Java Communications Suite 5 Installation Guide

Appendix F Installation Commands

This appendix describes the command syntax and options for running the installer and uninstaller.

installer Command

After expanding the distribution, the installer is located in the top-level directory under the operating system directory.

The installer command has the following format:

installer [option]...

The following table describes the options for the installer command.

Table F–1 Communications Suite Installer Command-line Options

Option 

Description 

-help

Defines command-line options for the installer. 

-id

Prints a state file ID to the screen. 

-no

Runs the installer without installing software. 

-noconsole

Starts the installer in silent mode, suppressing the graphical interface. Use this option with the -state option to run the installer in silent mode.

-nodisplay

Starts the installer in text-based mode (does not launch the graphical interface). 

-saveState [statefile ]

Instructs the installer to generate a state file at the location specified by statefile. State files are used when performing a silent installation.

If the specified file does not exist, the command creates it. 

If you omit the statefile value, the installer writes to the default file, statefile.out.

You can specify the same state file in subsequent installation sessions. After the first session, n is appended to the file name, where n is an integer that is incremented for each session, beginning with zero (0).

-state statefile

Uses the specified state file to provide input for silent installation. Use this option with the -noconsole option for starting silent installation.

-version

Prints the build information, including Product, Date, Build, Patch Level. Primarily an internal tool, but can be helpful in filing bugs. 

Examples

To run the installer in graphical mode from the installation directory:


./installer

To run the installer in text-based mode:


./installer -nodisplay

To run the graphical installer without installing software:


./installer -no

To create a state file without installing software:

To create a state file while installing software in text-based mode:


./installer -nodisplay -saveState myInstallStatefile

To run the installer in silent mode:


./installer -noconsole -state myInstallStatefile

viewlog Command

After installation, the installer places the viewlog command here:

The viewlog command has the following format:


viewlog [option]...

The following table describes the options for the viewlog command.

Table F–2 Communications Suite Log Viewer Command-line Options

Option 

Description 

-help

Defines command line options for the Log Viewer 

Examples

To run the graphical Log Viewer:


./viewlog

uninstall Command

After installation, the installer places the uninstall utility here:

The uninstall command has the following format:


uninstall [option]...

The following table describes the options for the uninstall command.

Table F–3 Communications Suite Uninstall Command-line Options

Option 

Description 

-help

Defines command line options for the uninstaller. 

-id

Prints a state file ID to the screen. 

-no

Runs the uninstaller without removing software. 

-noconsole

Starts the uninstaller in silent mode, suppressing the graphical interface. Use this option with the -state option to run the uninstaller in silent mode.

-nodisplay

Starts the uninstaller in text-based mode (does not launch the graphical interface). 

-saveState [statefile ]

Instructs the uninstaller to generate a state file at the location specified by statefile. State files are used when performing a silent uninstallation.

If the specified file does not exist, the command creates it. 

If you omit the statefile value, the uninstaller writes to the default file, statefile.out.

You can specify the same state file in subsequent uninstallation sessions. After the first session, n is appended to the file name, where n is an integer that is incremented for each session, beginning with zero (0).

-state statefile

Uses the specified state file to provide input for silent uninstallation. Use this option with the -noconsole option for starting silent uninstallation.

-version

Prints the build information, including Product, Date, Build, Patch Level. Primarily an internal tool, but can be helpful in filing bugs. 

Examples

To run the uninstaller in graphical mode from within the uninstaller directory:


./uninstall

To run the uninstaller in text-based mode:


./uninstall -nodisplay

To run the graphical uninstaller without removing software:


./uninstall -no

To create a state file without removing software:

To create an uninstaller state file while uninstalling software in text-based mode:


./uninstall -nodisplay -saveState myUninstallStatefile

To run the uninstaller in silent mode:


./uninstall  -noconsole -state myUninstallStatefile