Sun Java System Web Server 6.1 SP12 Administrator's Guide

Editing Using the Virtual Server Manager

The Virtual Server Manager contains four tabs: Preferences, Logs, Web Applications, and WebDAV.

The Preferences tab contains pages for:

The Status page lists some settings and provides links to the virtual server’s access and error logs.

The Settings page contains the following settings for a virtual server:

If you are editing a single virtual server, it is convenient to use the Virtual Server Manager and change all these settings on one page.

The Logs tab contains a single page allowing you to generate reports for the selected virtual server.

For more information about deploying and editing web application files, see Chapter 16, Extending Your Server With Programs.

The WebDAV Tab allows you to create and edit WebDAV collections on a virtual server. A WebDAV collection is a resource or a set of resources that are enabled for WebDAV operations. Using WebDAV, you can collaboratively author documents in-place on the Web. WebDAV allows you to place locks of different levels of granularity on WebDAV-enabled resources thus effectively preventing overwrite conflicts during collaborative content authoring on the Web.

The WebDAV tab contains the following pages:

The Add Collection page allows you to create a WebDAV collection.

The Edit DAV Collection page allows you to configure WebDAV-enabled collections.

The Lock Management page allows you to view outstanding locks and other lock-related information pertaining to the WebDAV-enabled resources on your server.

For more information, see Chapter 20, Web Publishing with WebDAV.

Generating Reports for a Virtual Server

You can now generate a report for a single virtual server using the Virtual Server Manager. Create a new access log to be used by the virtual server, and add the new access log to the virtual server settings, as described below.

To generate a report for a virtual server, perform the following steps.

ProcedureTo generate a report for a virtual server

  1. Go to the Logs tab in the Server Manager for the server instance and select Log Preferences.

  2. Create a new access log by entering the path and file name in the Log File field.

    You can also manually create a new access log in magnus.conf by changing

    Init fn=init access="$accesslog" to Init fn=init access="newaccesslog"

  3. Select Only Log under Format and check Virtual Server Id.

    For a custom format, select Custom Format and add %vsid% to the end of the line.

    %vsid% is useful when using multiple virtual servers. This entry records vsid in the access log.

    You can also manually add %vsid% to the end of Init fn in the magnus.conf file.

  4. Click OK.

  5. Click Apply.

  6. Click Apply Changes for your changes to take effect.

  7. Select the virtual server you wish to generate a report for and go to the Virtual Server Manager > Manage Classes > select the Virtual server from the tree view.

  8. Go to the Preferences tab and select Settings.

    In the Access Log field, change the access log to the newly created one.

  9. Click OK.

  10. Click Apply.

  11. Click Apply Changes for your changes to take effect.

  12. Select the Logs tab.

    The Generate Reports page appears.

    This page will not appear unless a virtual server has been created and LogVSid is On. For more information about enabling the Virtual Server Id, see Enabling Logging for a Virtual Server.

  13. (Optional) change the settings, if desired.

  14. Click OK to generate the report.

Choosing a Directory Service for a Virtual Server

You can assign a particular directory service for a particular virtual server. When you do so, the directory service you choose is logged under the USERDB element of the corresponding VS (virtual server) element in the server.xml file. The rights and permissions associated with this directory service is later used by the server to evaluate and enforce access control rules.

To assign a directory service to a virtual server, perform the following steps

ProcedureTo assign a directory service to a virtual server

  1. From the Virtual Server Manager choose the Settings tab.

    A listing of the virtual server settings is displayed.

  2. Click the Edit link next to Directory Services.

    The Pick Directory Services for Virtual Server page is launched in a new window.

  3. Choose a directory service and click OK.

  4. Save and apply changes.

    Note –

    The directory service you choose for a particular virtual server is not shared across other virtual servers. Access control files, on the other hand, are shared across virtual servers.