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

Configuring Document Directories

The primary document directory,also called the document root is the central directory where you store all the files you want to make available to remote clients.

You can create a document directory which is in addition to the primary document directory. By doing this, you can let someone manage a group of documents without giving them access to your primary document root.

ProcedureTo Create a Document Directory

  1. Click the Configuration tab and select the configuration needed.

  2. Click the Virtual Servers tab to get the list of configured virtual servers for the selected configuration and select the virtual server for which you need to add a new document directory.

  3. Click Content Handling > Document Directories tab.

  4. Click New and configure the following parameters:

    • URL Prefix — URI prefix that has to be mapped to a directory.

    • Directory Path — Absolute server path and a valid directory for storing documents.

    Note –

    When deploying a configuration across instances in a cluster, the document directories and documents are not deployed across the nodes in a cluster. The document directories are either NFS mounted onto the nodes or are available on the nodes. Only config, deployed webapps, using add-webapp, and generated directories containing user initiated pre-compiled JSP files created during add-webapp, are propagated.

    Note –

    Using CLI

    To create a document directory through CLI, execute the following command.

    wadm> create-document-dir --user=admin --password-file=admin.pwd 
    --host=serverhost --port=8989 --config=config1 --vs=config1_vs_1 
    --uri-prefix=/config1_uri --directory=../docs1

    See CLI Reference, create-document-dir(1).