Chapter 4 Using the Sun Java System Web Server Plug-In

The Sun Java System Web Server Plug-In provides a number of specific components, plans, and host types that enable you to install and control Sun Java System Web Server 6.1 2005Q1 SP4 Administration Servers and Sun Java System Web Server 6.1 2005Q1 SP4 Web Server Instances. This chapter describes the following information:

• Introduction to the Sun Java System Web Server 6.1 2005Q1 SP4

• Installing the Sun Java System Web Server 6.1 2005Q1 SP4

• Creating and Deleting Web Server Instances

• Controlling the Sun Java System Web Server 6.1 2005Q1 SP4

Introduction to the Sun Java System Web Server 6.1 2005Q1 SP4

The Sun Java System Web Server 6.1 2005Q1 SP4 is a secure and highly available server that you can use to host web sites. When you install the Sun Java System Web Server 6.1 2005Q1 SP4 product, the following two server instances are installed:

• Administration Server

• Web Server instance

The Administration Server is a web-based server that contains the Java forms that you use to configure all of your Web Server instances. After you install the initial Web Server instance, you can use the Administration Server to install additional instances.

The Sun Java System Web Server Plug-In enables you to use the N1 Grid Service Provisioning System to install and control Sun Java System Web Server 6.1 2005Q1 SP4 Administration Servers and Web Server instances. Using the provisioning system, you install an Administration Server and the first Web Server instance together. The provisioning system cannot install additional instances of the Web Server. You must use the Administration Server to manually install additional instances. However, you can use the provisioning system to control all of your Web Server instances if you use the CreateWebServer plan to add those instances to the provisioning system database.

Installing the Sun Java System Web Server 6.1 2005Q1 SP4

When you use the provisioning system to install the Sun Java System Web Server 6.1 2005Q1 SP4, the provisioning system installs an Administration Server and the first Web Server instance. To install the Sun Java System Web Server 6.1 2005Q1 SP4 using the provisioning system, use the following steps:

1. Create the JES_ADMIN_PASSWORD and WEB_ADMIN_PASSWORD session variables.

   See Creating Session Variables.

2. Define the host as a Sun Java System Web Server 6.1 2005Q1 SP4 host.

   See How to Define a Host as a Sun Java System Web Server 6.1 2005Q1 SP4 Host.

3. Install the Administration Server and the first Web Server instance.

   See How to Install an Administration Server and the First Web Server Instance.

Creating Session Variables

The installation of the Sun Java System Web Server 6.1 2005Q1 SP4 requires that you create passwords to use to install the Sun Java System Web Server and to access the Administration Server. The provisioning system stores secure data, such as passwords, as session variables. When you save a password as a session variable, the password is stored in a way that prevents other users from accessing the password information. However, the password information is available for use by the provisioning system when you are logged in to that session.

You must create a Common Server Settings password for the Sun Java Enterprise System installation program. Create a session variable called JES_ADMIN_PASSWORD. The Sun Java Enterprise System installation program uses the password to install the Sun Java System Web Server components. For more information about this password, see CMN_ADMIN_PASSWORD in Common Server Settings.

You must create a password that you want to use to access the Administration Server. Create a session variable called WEB_ADMIN_PASSWORD. The value that you give this session variable is the password that you want to use to access the Administration Server. When the provisioning system is installing the Administration Server, the provisioning system sets the access password for the Administration Server to the value of this variable.

How to Create Session Variables

Steps

1. From any page in the N1 Grid Service Provisioning System, click Session Variables.

   You will find the Session Variables link in the top right corner of the page.

2. In the Session Variable column, in the blank field, type JES_ADMIN_PASSWORD.

3. In the Password column, click the checkbox.

4. In the Value column, in the blank field, type the password you want to use to install the Sun Java System Web Server components.

5. Click the Create link.

6. In the N1 Grid SPS password field, type the password you use to access the N1 Grid Service Provisioning System.

7. Click the Save button.

   The provisioning system creates the session variable and returns you to the session variable list.

8. In the Session Variable column, in the blank field, type WEB_ADMIN_PASSWORD.

9. In the Password column, click the checkbox.

10. In the Value column, in the blank field, type the password you want to use to access the Administration Server.

11. Click the Create link.

12. In the N1 Grid SPS password field, type the password you use to access the N1 Grid Service Provisioning System.

13. Click the Save button.

How to Define a Host as a Sun Java System Web Server 6.1 2005Q1 SP4 Host

Before you can deploy the Administration Server and a Web Server instance, you must define the target host to be of a com.sun.jes6_WS#opsystem-JESWebHost host type.

Steps

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

2. Select the target host.

3. On the Host Details page, click the Edit button.

4. Choose the appropriate com.sun.jes6_WS#opsystem-JESWebHost host type from the host type menu.

   opsystem is one of the following values:

   • Sol8 – Select if the target host is running the Solaris 8 OS on a SPARC based system.

   • Sol9– Select if the target host is running the Solaris 9 OS on a SPARC based system.

   • Sol9x86– Select if the target host is running the Solaris 9 OS on an x86 based system.

   • Sol10– Select if the target host is running the Solaris 10 OS on a SPARC based system.

   • Sol10x86– Select if the target host is running the Solaris 10 OS on an x86 based system.

   • RedHat-AS21– Select if the target host is running the Red Hat Linux Advanced Server 2.1.

   For example, if the target host is a SPARC based system running the Solaris 8 OS, select com.sun.jes6_WS#Sol8-JESWebHost as the host type.

5. Click the Save button.

How to Install an Administration Server and the First Web Server Instance

Before You Begin

Before you can deploy the Administration Server and a Web Server instance, you must have the Sun Java System Web Server 6.1 2005Q1 SP4 installation files saved on the target server. For more information, see Sun Java Enterprise System 2005Q1 Installation Guide.

Be sure to create the JES_ADMIN_PASSWORD and WEB_ADMIN_PASSWORD session variables. For more information, see How to Create Session Variables.

Be sure to change the host type of any target host to the appropriate host type. For more information, see How to Define a Host as a Sun Java System Web Server 6.1 2005Q1 SP4 Host.

Steps

1. Click the Sun Java System WS 6 icon under the Common Tasks section of the left control panel.

2. Click the Install Web Admin Server: install link.

3. Click the Run button.

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

   The Select a Variable Setting window opens.

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

   1. Set the installPath variable to the path on the target server where you want to install the state file that contains the name/value pairs needed to install the Administration Server.

   2. Set the JES_Media_Directory variable to the path to the Sun Java System Web Server 6.1 2005Q1 SP4 installation binary on the target server.

   3. (Optional) Set the hostDomain variable to the actual domain name of the target server.

   4. If you are installing the Administration Server on a Linux server, change the following variables:

      • Set the jesSystemGroup variable to root.

      • Set the webInstanceUser variable to nobody.

      • Set the webInstanceGroup variable to nobody.

   5. Click the Select button.

   For information about other Variable Settings, see WebAdminServer Component.

6. Select the target hosts.

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

   The InstallWebAdminServer plan completes the following tasks:

   • Installs the Administration Server and one Web Server instance.

   • If you set the webAutoStart variable to yes, starts the Administration Server and the Web Server instance.

   • If you set the webAutoStart variable to yes, verifies that the Administration Server and the Web Server instance are running.

   • Creates a virtual host for the Administration Server of the com.sun.jes6_WS#WebAdminServerHT host type.

   • Creates a virtual host for the Web Server instance of the com.sun.jes6_WS#WebServerInstanceHT host type.

Creating and Deleting Web Server Instances

How 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.

How 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 –

   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.

Controlling the Sun Java System Web Server 6.1 2005Q1 SP4

The Sun Java System Web Server Plug-In enables you to start, stop, and restart Administration Servers and Web Server instances.

How to Control Administration Servers and Web Server Instances

Steps

1. In the left control panel, under the Application deployment section, click Components.

2. In the list of Components click the component for the server type you want to control.

   • To control an Administration Server, click the WebAdminServer component.

   • To control a Web Server instance, click the WebServerInstance component.

3. Choose the Component Procedure you want to run and click the Run link.

   For details about the component procedures, see Components.

4. On the Run details page, select the hosts for which you want to run this procedure.

5. Click the Run Selected Installations button.