Sun Java System Web Server 7.0 Update 1 Administrator's Guide

Managing Virtual Servers

Adding a Virtual Server

ProcedureTo Add a Virtual Server

Before You Begin
  1. Select the configuration from which you will need to add a virtual server. You can select the configuration from the list of configuration shown in the Configurations tab.

  2. Click on the Virtual Servers tab > New button.

  3. You will get a popup wizard page, which will guide you through the Virtual Server configuration process. From the wizard page, perform the following tasks:

    • Enter the new virtual server information:

      1. Enter a name to identify the new virtual server. The name can be alphanumeric and can also include period (.), dash (-) and underscore (_) characters.

      2. (Optional) Enter a list of hosts to be added to the new virtual server.

      3. (Optional) Enter the document root for the virtual server.

    • Select an HTTP listener for the newly configured virtual server. You can either choose an existing HTTP listener or create a new HTTP listener.

  4. You will now see the wizard summary page. To change the configuration, go back to the previous pages by clicking Previous. Click Finish to complete the new virtual server configuration process.

  5. You will now see the Results page. If you see any error, Configure the virtual server again by going back to the previous pages in the wizard.


    Note –

    Using CLI

    For adding a virtual server through CLI, execute the following command:


    wadm> create-virtual-server --user=admin --password-file=admin.pwd 
    --host=serverhost --port=8989 --config=config1 --document-root=../docs config1_vs_1

    See CLI Reference, create-virtual-server(1).


Configuring a Virtual Server

For configuring virtual server's general settings, perform the following task:

ProcedureTo Configure a Virtual Server

  1. Select the Configuration.

    Select the configuration from the configuration list. Click Configurations tab to get the list of available configurations.

  2. Select the Virtual Server.

    Select the virtual server from the virtual server list. Click Virtual Servers tab to get the available virtual servers for the selected configuration.

  3. Click General tab. Configure the following settings.

    • Enabled — Whether the virtual server is enabled at runtime.

    • Document Root — The document root path for the virtual server, where the virtual server's data will be stored. This includes exploded web application directories and log files.

    • Hosts — You can enter more than one URL host, separated by commas.

Duplicating a Virtual Server

For duplicating a virtual server, perform the following task:

ProcedureTo Duplicate a Virtual Server

  1. Select the Configuration.

    Select the configuration from the configuration list. Click Configurations tab to get the list of available configurations.

  2. Select the Virtual Server.

    Select the virtual server from the virtual server list. Click Virtual Servers tab to get the available virtual servers for the selected configuration.

  3. Click Copy button.

    Provide a name for the new virtual server.


    Note –

    Using CLI

    For duplicating a virtual server through CLI, execute the following command:


    wadm> copy-virtual-server --user=admin --password-file=admin.pwd --host=serverhost 
    --port=8989 --config=config1 --vs=config1_vs_1 copiedVs

    copiedVS is the name of the new virtual server.

    See CLI Reference, copy-virtual-server(1).