Components

The Sun Java System Web Server Plug-In provides two components that allow you to control Administration Servers and Web Server instances.

WebAdminServer Component

The WebAdminServer component provides controls that enable you to stop, start, and restart Administration Servers. The component variables and component procedures available for use with the WebAdminServer component are described below. For instructions to control an Administration Server, see Controlling the Sun Java System Web Server 6.1 2005Q1 SP4.

Component Variables

installPath

Path on the target host to install the state file that contains the name/value pairs for the installation of the Administration Server.

exitOnDependency

The value of this variable determines whether the installation will exit if a dependency fails. The default value is no.

logCurrentlyInstalled

The value of this variable determines whether the provisioning system creates a log of Sun Java System Web Server 6.1 2005Q1 SP4 items that are already installed on the target host. Valid values are yes and no.

removeBundledProducts

The value of this variable populates the REMOVE_BUNDLED_PRODUCTS variable in the state file that the provisioning system uses to install the Administration Server. The default value for this variable is blank.

upgradeincompatibleJDK

The value of this variable determines whether the provisioning system will upgrade the JDK^TM software if the version installed on the target host is incompatible with the Sun Java System Web Server 6.1 2005Q1 SP4. Valid values are yes and no.

jesInstallPath

The path in which to install the Administration Server on the target host.

hostName

Host name of the target system.

hostDomain

Domain name of the target system.

ipAddress

IP address of the target system.

jesAdminUser

User ID for all components of the Sun Java Enterprise System. For more information, see CMN_ADMIN_USER in Chapter 4: Configuration Information.

jesSystemUser

User ID under which component processes run.

jesSystemGroup

Group of the jesSystemUser.

If you are installing the Administration Server on a Linux server, set the jesSystemGroup variable to root.

webAdminUser

User ID to use to log into the Adminstration Server.

adminPort

Port to use to access the Administration Server.

webAdminSystemUser

User ID under which the Administration Server processes run.

webInstanceUser

User ID that the default instance of Web Server uses to run on the system.

If you are installing the Administration Server on a Linux server, set the webInstanceUser variable to nobody.

webInstanceGroup

Group ID in which the default instance of Web Server runs.

If you are installing the Administration Server on a Linux server, set the webInstanceGroup variable to nobody.

webInstancePort

Port to use to access the Web Server instance.

docRoot

Path for the Web Server to store content documents.

webAutoStart

The value of this variable determines whether the provisioning server will create a boot script that will start the Administration Server and the Web Server instance upon system boot. Valid values are y and n.

startOnInstall

The value of this variable determines whether the provisioning server will start the Administration Server and the Web Server instance when installation is complete. Valid values are y and n.

JES_Media_Directory

Path to the Sun Java System Web Server 6.1 2005Q1 SP4 installation binary on the target server.

Component Procedures

markOnly:install

Use this procedure to update the N1 Grid Service Provisioning System 5.0 database to include any Administration Servers that you installed manually.

markOnly:uninstall

Use this procedure to update the N1 Grid Service Provisioning System 5.0 database to remove any Administration Servers that you uninstalled manually.

StartWebAdminServer

Use this procedure to start an Administration Server.

RestartWebAdminServer

Use this procedure to stop and then restart an Administration Server.

StopWebAdminServer

Use this procedure to stop an Administration Server.

WebServerInstance Component

The WebServerInstance component provides controls that enable you to stop, start, and restart Web Server instances. The component variables and component procedures available for use with the WebServerInstance component are described below. For instructions explaining how to control a Web Server instance, see Controlling the Sun Java System Web Server 6.1 2005Q1 SP4.

Component Variables

jesInstallPath

Path where the Web Server instance is installed on the target host.

hostName

The value you provided in the Server Identifier field on the Web Server Administration Server page when you created the Web Server instance.

hostDomain

Domain name of the system on which the Web Server instance is installed. If you did not specify a domain name in the Server Identifier field when you created the Web Server instance on the Administration Server, set the hostDomain value to null.

webInstancePort

Port to use to access the Web Server instance.

docRoot

Path for the Web Server to store content documents.

webAutoStart

The value of this variable determines whether the provisioning server will create a boot script that will start the Web Server instance upon system boot. Valid values are y and n.

startOnInstall

The value of this variable determines whether the provisioning server will start the Web Server instance when installation is complete. Valid values are y and n.

installPath

The provisioning system uses the installPath variable to identify the various Web Server instances. The default value of this variable is /tmp/hostName. hostName is the value that you entered for the hostName variable.

When you want to delete a Web Server instance, you must input the value of the installPath variable on the Plan run page in the installPath field.

Component Procedures

StartWebServer

Use this procedure to start a Web Server instance.

RestartWebServer

Use this procedure to stop and then restart a Web Server instance.

StopWebServer

Use this procedure to stop a Web Server instance.