Sun Java Communications Suite 5 Installation Guide

Creating a State File

To create a state file, you must run an interactive session of the installer. A state file generated by the installer takes advantage of the installer’s real-time dependency checking and error reporting.

Caution –

Do not create a state file manually. This method can cause problems at installation time, configuration time, or server startup time.

Generating the Initial State File

You create the initial state file by running the installer interactively using the parameters of the installer command that tell the installer to capture your answers. As you proceed through the pages of the installer, your answers are captured and a state file is generated. The installer determines the order of the product components to be installed, so you can specify the components in any order. When you complete the installation, the state file is available in the location that you specified.

You can use the -no option if you do not want software to be installed during this session.

Syntax examples:

To create a state file using the graphical interface:

./installer -saveState statefile_path
To create a state file using the text-based interface:

./installer -nodisplay -saveState statefile_path
To create a state file using the graphical interface without installing software in this session:

./installer -no -saveState statefile_path

Full syntax for the installer command can be found in Appendix F, Installation Commands.

Refer to Appendix G, Example State File to see an example of a generated state file.

Editing the State File

After you have generated a state file, you must edit the state file to ensure that the local parameters are set correctly for the destination host. These parameters include host name, domain name, IP address, and other such settings.

You might also need to change the state file ID, if you plan to do an installation on a platform that is different from the one on which you generated the initial state file.

This section addresses the following:

State File Editing Guidelines

When editing the state file, follow these guidelines:

Do not modify parameters, except to edit their values.
- Do not remove a parameter, even if it does not have a value.
- Do not add a parameter.
- Do not change the order in which parameters appear.
Notice original types and formats and maintain them as you type new values. For example:
- If the old value is a host name, type a host name and not a fully qualified domain name.
- If the old value starts with a leading slash, make sure that the new value starts with a leading slash.
Replace any value that you delete. For a required parameter, installation or configuration could fail if the parameter has been deleted.
Retain the case of the original value.

Editing Local Parameters

The following table lists parameters that you might need to edit, depending on the product components you want to install or on your host setup. For example, the host on which you generated the state file might be in the same domain as the host on which you are installing.

For a description of each parameter, refer to the tables in Chapter 3, Configuration Information, in Sun Java Enterprise System 5 Installation Reference for UNIX.

Table 5–2 State File Parameters Often Edited for Silent Installation


Component	Parameter Name
Common Server Settings	`CMN_HOST_NAME` `CMN_DOMAIN_NAME` `CMN_IPADDRESS` `CMN_ADMIN_USER` `CMN_ADMIN_PASSWORD` `CMN_SYSTEM_USER` `CMN_SYSTEM_GROUP`
Access Manager	`IS_WS_HOST_NAME` `IS_WS_INSTANCE_DIR` (if Web Server is the web container) `CONSOLE_HOST` `IS_SERVER_HOST` `IS_DS_HOST` `IS_DS_HOSTNAME` `COOKIE_DOMAIN_LIST`
Application Server	`ASNA_ADMIN_HOST_NAME` `AS_WEB_SERVER_LOCATION` `AS_WEB_SERVER_PLUGIN_TYPE`
Directory Server	`CREATE_INSTANCE` `DSEE_INSTANCE_DIR` `DSEE_INSTANCE_PORT` `DSEEE_INSTANCE_SSL_PORT` `DSEE_DN_MANAGER` `DSEE_INSTANCE_USER` `DSEE_INSTANCE_GROUP` `DSEE_INSTANCE_PASSWORD` `DSEE_SUFFIX`
Web Server	`WS_ADMIN_HOST`
Web Proxy Server	`CMN_WPS_INSTALLDIR` `WPS_ADMIN_USER` `WPS_ADMIN_PASSWORD` `WPS_ADMIN_PORT` `WPS_ADMIN_RUNTIME_USER` `WPS_INSTANCE_RUNTIME_USER` `WPS_ISNTANCE_PORT` `WPS_INSTANCE_AUTO_START` `WPS_PROXY_DOMAIN`