test

N1 Grid Service Provisioning System User's Guide and Release Notes for the Sun Java System Web Server Plug-In 1.0

Creating and Deleting Web Server Instances

ProcedureHow to Create Additional Web Server Instances

The Sun Java System Web Server Plug-In cannot create a new Web Server instance on a server. However, the plug-in enables you to control Web Server instances that you create manually. Consequently, whenever you manually create a Web Server instance, use the following procedure to update the N1 Grid Service Provisioning System 5.0 database to include the new Web Server instance.

Steps

  1. Access the Administration Server and create a new Web Server instance.

    For more information, see Sun Java Enterprise System 2005Q1 Installation Guide.

  2. In the browser interface of the provisioning system, click the Sun Java System WS 6 icon under the Common Tasks section of the left control panel.

  3. Click the Create Web Server instance: create link.

  4. Click the Run button.

  5. In the Plan Parameters table, in the Variable Settings column for the WebServerInstance component, click Select From List.

    The Select a Variable Setting window opens.

  6. From the list of Variable Settings, change the following variables as described below.

    1. Set the hostName variable to the value you provided in the Server Identifier field on the Web Server Administration Server page when you created the Web Server instance.

    2. Set the domainName variable to the value you provided as the domain name in the Server Identifier field on the Web Server Administration Server page. If you did not specify a domain name in the Server Identifier field, set the domainName value to null.

    3. Set the webInstancePort variable to the port number you want to use to access the Web Server instance.

    4. Click the Select button.

    For information about other Variable Settings, see WebServerInstance Component.

  7. Select the target hosts.

  8. Click the Run Plan (includes preflight) button.

    The CreateWebServerInstance plan creates a virtual host for the Web Server instance of the com.sun.jes6_WS#WebServerInstanceHT host type.

ProcedureHow to Delete a Web Server Instance

The Sun Java System Web Server Plug-In cannot delete a Web Server instance from a server. Consequently, you must manually delete a Web Server instance using the Administration Server. Then, use the following procedure to remove the Web Server instance from the N1 Grid Service Provisioning System 5.0 database.

Steps

  1. Access the Administration Server and delete the Web Server instance.

  2. In the browser interface of the provisioning system, click the Sun Java System WS 6 icon under the Common Tasks section of the left control panel.

  3. Click the Delete Web Server instance: delete link.

  4. Click the Run button.

  5. In the Plan Variables section, in the installPath field, type the value for the installPath variable for this Web Server instance.

    The default value for the installPath is /tmp/hostName. hostName is the value that you entered for the hostName variable when you created this Web Server instance. To find the value of the installPath, complete the following steps:

    1. In the left control panel, under the Hosts Setup section, click Hosts.

    2. In the list of hosts, click the virtual host on which you installed the Administration Server that controls the Web Server instance that you want to uninstall.

      The host type for an Administration Server virtual host is com.sun.jes6_WS#WebAdminServerHT.

    3. Click the Components Installed button.

    4. In the Components Installed on Host table, identify the /com/sun/jes6_WS/WebServerInstance component that you want to uninstall.

      To help you identify the Web Server instances, you can review the variable settings that you selected when you installed the Web Server instance. In the Installed column, click on the date and time.

    5. Find the value in the Install Path column for the /com/sun/jes6_WS/WebServerInstance component that you want to uninstall.

    Caution – Caution –

    If you do not set the installPath variable, the provisioning system deletes the most recent Web Server instance that you created for the Administration Server that you selected.

  6. Click the Run Plan (includes preflight) button.

    The provisioning system removes the virtual host for the Web Server instance.