Sun Java Enterprise System 2005Q4 Installation Guide for UNIX

Creating a State File

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


Caution – Caution –

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


Generating a State File

A state file is created by running the installer without installing the software. As you proceed through the pages of the installer, your answers are captured and a state file is generated. When you complete the installation, the state file is available in the location that you specified. You can generate the state file by running either the graphical interface installer or the text-based interface installer. The -no option is used so no software is installed.

To create a state file using the graphical interface:

./installer -no -saveState statefile_path

To create a state file using the text-based interface:

./installer -no -nodisplay -saveState statefile_path

Full syntax for the installer command can be found in Appendix B, Installation Commands. Refer to Appendix B, Installation Commands to see an example of a generated state file.

Editing the State File

After you have generated a state file, you must edit it to ensure that the local parameters are set correctly for the various destinations hosts. These parameters include host name, domain name, IP address, and other such settings. You might also need to change the state file key, if you plan to do an installation on a platform that is different from the one on which you created the state file.

This section addresses the following:

State File Editing Guidelines

When editing the state file, follow the guidelines in this section.

Editing Local Parameters

The following table lists parameters that you might need to edit, depending on the components you wish to install. The parameters you must edit also depend 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.

Table 5–1 State File Parameters to Edit

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

Administration Server 

ADMINSERV_DOMAIN

ADMINSERV_CONFIG_DIR_HOST

Application Server 

ASNA_ADMIN_HOST_NAME

ASNA_ADMIN_HOST_NAME

AS_WEB_SERVER_LOCATION

Directory Server 

DS_SERVER_IDENTIFIER

DS_ADM_DOMAIN

CONFIG_DIR_HOST (if USE_EXISTING_CONFIG_DIR is set to 1)

USER_DIR_HOST (if USE_EXISTING_USER_DIR is set to 1)

Portal Server 

PS_LOAD_BALANCER_URL (format //hostname.domainname:port+deploy_uri)

PS_DEPLOY_INSTANCE

Portal Server Secure Remote Access 

SRA_SERVER_DOMAIN

SRA_SERVER_HOST

SRA_GW_HOSTNAME

SRA_GW_DOMAIN

SRA_GW_IPADDRESS

SRA_NLP_HOSTNAME

SRA_NLP_DOMAIN

SRA_NLP_IPADDRESS

SRA_RWP_HOSTNAME

SRA_RWP_DOMAIN

SRA_RWP_IPADDRESS

Web Server 

WS_ADMIN_HOST

Web Proxy Server 

WPS_PROXY_DOMAIN

For a description of each parameter, refer to the tables in Chapter 1, Configuration Information, in Sun Java Enterprise System 2005Q4 Installation Reference.