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

The Sun Java System Web Server 7.0 Plug-In 1.0 provides a number of specific components and plans that enable you to install and control Web Server 7.0 Administration Servers and Web Server 7.0 Web Server Instances. This chapter describes the following information:

• Introduction to the Web Server 7.0

• Installing the Web Server 7.0

• Creating and Deleting Web Server Instances

• Controlling the Web Server 7.0

Introduction to the Web Server 7.0

The Web Server 7.0 is a secure and highly available server that you can use to host web sites. When you install the Web Server 7.0 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 7.0 Plug-In 1.0 enables you to use the N1 Service Provisioning System to install and control Web Server 7.0 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.

Installing the Web Server 7.0

When you use the provisioning system to install the Web Server 7.0, the provisioning system installs an Administration Server and the first Web Server instance. To install the Web Server 7.0 using the provisioning system, use the following steps:

1. Create the WEB_ADMIN_PASSWORD session variables.

   See Creating Session Variables.

2. 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 Web Server 7.0 requires that you create passwords to use to install the Sun Java System Web Server 7.0 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 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, it sets the access password for the server to the value of this variable.

How to Create Session Variables

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

   The Session Variables link can be found in the top right corner of the page.

2. Type the WEB_ADMIN_PASSWORD in the blank field of the Session Variable column.

3. Click the checkbox in the Password column.

4. Type the password to access the Administration Server in the blank field of the Value column. The password must be a minimum of eight characters.

5. Click Create link.

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

7. 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 Web Server 7.0 installation files saved on the target server. For more information, see Sun Java Enterprise System 5 Installation Guide for UNIX.

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

1. Click the Sun Java System Web Server 7.0 icon under the Common Tasks section of the left control panel.

2. Click the Standalone Web Server 7.0 Admin Server Management: 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 Variable Setting screen displays.

5. Click Create Set link.

   The Select Variable Setting screen displays.

6. Enter a name in the Set Name field.

   The Select check boxes to assign value to the respective variables.

7. Click the Save button.

   The Select Variable Setting screen displays.

8. Click the Select button.

9. From the list of Variable Settings, change the following variables as described in the following steps.

   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. Set install variable to unique value which differentiates the webAdminServers.

      ---

      Note –

      The value for the installPath variable is treated as a relative path to the default Remote Agent directory, unless you specify an absolute path, such as /opt or c:\mydir. For example, for a Windows Remote Agent, if you set the installPath variable to c:\mydir and deploy the file to an Agent with a default home directory of c:\Program Files\N1 Service Provisioning System\agent, the file is deployed to c:\Program Files\N1 Service Provisioning System\agent\c\mydir.

      ---

   2. Set the JES_Media_Directory variable to the path to the Web Server 7.0 installation binary on the target server. Ensure that port numbers are not in use.

   3. Click the Select button.

   For information about other Variable Settings, see WebAdminServer Component.

10. Select the target hosts.

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

Creating and Deleting Web Server Instances

How to Create Additional Web Server Instances

The Sun Java System Web Server 7.0 Plug-In 1.0 can create a new Web Server instance on a server. The plug-in enables you to control the default as well as additional Web Server instances that you create using N1 Service Provisioning System .

1. In the browser interface of the provisioning system, click the Sun Java System Web Server 7 icon under the Common Tasks section of the left control panel.

2. Click the Standalone Web Server 7.0 Instance Management: create link.

3. Click the Run button.

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

   The Select Variable Setting window opens.

5. Click the Create Set link

   The Select Variable Setting screen displays.

6. Enter a name in the Set Name field.

   Select check boxes to assign value to the respective variables.

7. Click the Save button.

   The Select Variable Setting screen displays.

8. Click the Select button.

9. From the list of Variable Settings, change the following variables as described in the following steps:

   1. Set the installIdentifier variable to installId the you provided while installing Web Server Administration Server.

   2. If you want to create aWeb Server instance with an existing configuration, set the configName variable to an existing configName. To create a Web Server instance with a new configuration, set the configName variable to a new value.

   3. (Optional) Set the server name variable to server name for the new configuration.

   4. Click the Select button.

   For information about other Variable Settings, see WebServerInstance Component.

10. Select the target hosts.

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

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

How to Delete a Web Server Instance

The Sun Java System Web Server 7.0 Plug-In 1.0 can delete a Web Server instance from a server except the default Web Server instance. The default Web Server instance will be deleted from N1 Service Provisioning System database when you run delete default Web Server instance, you should manually delete this instance from the disk.

1. In the browser interface of the provisioning system, click the Sun Java System Web Server 7.0 icon under the Common Tasks section of the left control panel.

2. Click the Standalone Web Server 7.0 Instance Management: delete link.

3. Select the Web Server instance(s) that you want to delete and click the Run button.

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

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

Controlling the Web Server 7.0

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

How to Control Administration Servers and Web Server Instances

1. In the browser interface of the provisioning system, click the Sun Java System Web Server 7.0 icon under the Common Tasks section of the left control panel.

2. To control an Administration Server, click Standalone Web Server 7.0 Admin Server Management: Start, Stop and Restart link.

3. To control a Web Server instance, click Standalone Web Server 7.0 Instance Management: Start, Stop and Restart link.

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

   For details about the component procedures, see Components.

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

6. Click the Run Selected Installations button.