Changing the State File (Sun Java System Web Server 7.0 Update 6 Installation and Migration Guide)

Sun Java System Web Server 7.0 Update 6 Installation and Migration Guide

Changing the State File

You can change the state file after it has been generated by editing its values and variables. The following table lists the variables in the state file, in alphabetical order.

Note –

Ensure you only edit the values and variables. The structure of the state file should not be modified.

In Web Server 7.0, the values supported for the selected components property were admincli_l10 and svrcore_l10n.

Table 2–3 Variables in the State File


Variable Name	Valid Values (If Applicable)	Description
`ADMIN_PORT`	0-65535	Valid port to run the Administration Server.
`ADMIN_SSL_PORT`	0–65535	Valid port for secure connections.
`ADMIN_UID`	Valid UNIX user ID	Valid UNIX user ID to run the Administration Server.
`CREATE_SERVICE`	True or false	Creates a SMF instance for the server instance. This flag is valid only for Solaris 10.
`NODE_HOST`		Fully qualified domain name of the computer on which you are installing the Administration Node.
`NODE_SSL_PORT`	0–65535	Valid port for secure connections.
`CONFIG_NAME`		Default configuration name used by the Web Server to create a configuration, associate it with a node, and create an instance. The default for the Administration Server is `https-config1`.
`IS_ADMIN_NODE`	True or false	Valid only for Administration Server and Administration Node installations; null for Administration Command Line installations.
`currentInstallDirectory`		Specified installation directory path.
`defaultInstallDirectory`	`/sun/webserver7` on UNIX; `C:\Program Files\Sun\WebServer7` on Windows	Default installation directory path.
`JDK_LOCATION`		Selected Java Platform, Standard Edition (Java SE^TM) installation directory path.
`REGISTER_NODE`	True or false	Specifies whether the Administration Node instance should be registered with the Administration Server instance at the time of installation or later.
`SELECTED_COMPONENTS`	`svrcore, svrcore64, admincli, devsupport`	Comma-separated list of product components selected for installation. Installs the following: Server Core: Installs the core binaries needed to set up the Web Server environment. In silent mode, it corresponds to `svrcore`. Server Core 64–bit Binaries: (Solaris SPARC,AMD64 and Linux only) The 64–bit binaries required for setting up the 64–bit runtime for Web Server instances. This option is available only if the system on which you are installing has 64-bit support. Both the 64- and 32-bit binaries are installed. In silent mode, it corresponds to `svrcore64`. Administration Command Line Interface: The command-line administration client used to manage and configure the Web Server and its hosted applications from the command line. In silent mode, it corresponds to `admincli`. Sample Applications: Sample applications that demonstrate Web Server features and functionality. In silent mode, it corresponds to `devsupport`.
`SIXTYFOURBIT_INSTALL`	True or false	Identifies a 64-bit installation.
`SKIP_INSTANCE_CREATION`	True or false	True will not create default instances.
`STARTUP_ONBOOT`	True or false	Start on system boot option.
`UPGRADE`	True or false	Identifies the existing installation.
`USE_BUNDLED_JDK`	True or false	Install the JDK bundled with the installer; if `false`, `JDK_LOCATION` cannot be empty.
`WEB_DOCROOT`		The primary document directory for the Web Server instance; if this is empty, a default document directory is created.
`WEB_PORT`	0–65535	Valid default port to run the Web Server instance server under HTTP mode.
`WEB_SERVERNAME`		Fully qualified domain name of the computer on which the default Web Server instance is installed.
`WEB_UID`	Valid UNIX user ID	Valid UNIX user ID to use when running the default Web Server instance.

Variables such as ADMIN_HOST ADMIN_PORT ADMIN_NAME and ADMIN_PASSWD act differently based on the configuration. The table below has more information that you have installed.

Table 2–4 Configuration for Administration Server Instance


Variable name	Valid values (if applicable)	Description
`ADMIN_HOST`		Fully qualified domain name of the computer on which the Administration Server is installed
`ADMIN_PORT`	0-65535	Non-SSL port for the Administration Server
`ADMIN_NAME`		Administrator user name for the initial server instance
`ADMIN_PASSWD`		Administrator user password for the initial server instance, stored as plain text

The following fields are displayed when you configure Administration Node to an Administration Server.

Table 2–5 Configuration for Administration Node Instance


Variable name	Valid values (if applicable)	Description
`ADMIN_HOST`		Fully qualified domain name of the computer on which the Administration instance is installed
`ADMIN_SSL_PORT`	0-65535	SSL port for the Administration Server
`ADMIN_NAME`		Administrator user name to log in to remote admin server
`ADMIN_PASSWD`		Administrator user password to log into remote admin server