15.1 Manually Setting Up More Than Three Mirrored Folder Resource Drivers

15.1.1 Editing the installer.xml File

The Novell Vibe Installation program enables you to set up three mirrored folder resource drivers. However, there is no limit to the total number of mirrored folder resource drivers that you can set up after installation. A useful strategy is to set up resource drivers for root directories, then set up Mirrored File folders for root directories and subdirectories as needed, as described in Section 15.2, Creating a Mirrored Files Folder for a Mirrored Folder Resource Driver.

When you run the Vibe Installation program, it creates the installer.xml file in the directory where you run it. The installer.xml file stores the information you provided during installation. You can also edit it manually, then update your Vibe installation.

  1. Make a backup copy of your existing installer.xml file.

  2. Open the installer.xml file in a text editor.

  3. Search for mirrored.

  4. Scroll down until you reach the three existing mirrored folder resource drivers.

  5. Copy the mirrored folder resource driver that is most like the one you want to create, then paste it between the <MirroredFolder> and </MirroredFolder> tags.

    The Vibe Installation program displays only the first three mirrored folder resource drivers, so you might want to place new resource drivers at the top of the list in order to double-check the information when you run the Vibe Installation program to implement your changes.

  6. Set the parameters as needed for the file system location that you want to mirror in your Vibe site:

    Tag

    Setting

    enabled=

    true

    type=

    file or webdav

    id=

    The unique internal name for the mirrored folder resource driver. Use only alphanumeric characters. Do not include spaces, extended characters, or double-byte characters.

    title=

    The name of the mirrored folder resource driver that displays on the Vibe site. The title can include any characters.

    rootPath=

    For the file mirrored folder type, the absolute path to the directory from the point of view of the Vibe server.

    For the webdav mirrored folder type, the path to the directory after the WebDAV server hostname, and optionally, the port number, as specified by the hostUrl= parameter. The path should start with a slash (/), because it is appended to the setting of the hostUrl= parameter. For example, if the full WebDAV server location is:

    http://webdavserver/archive/docs

    the rootPath= setting would be:

    /archive/docs

    readonly=

    true or false

    zoneId=

    For a multi-zone Vibe site, this is the ID of the zone where you want the mirrored folder resource driver to be available. For information about Vibe zones, see Section 16.0, Setting Up Zones (Virtual Vibe Sites). For a single-zone Vibe site, leave this parameter empty.--

    AllowedUsers idList=

    A list of Vibe user IDs that can access the mirrored folder resource driver and create mirrored folders. Use a semicolon (;) between user IDs.

    AllowedGroups idList=

    A list of Vibe groups that can access the mirrored folder resource driver and create mirrored folders. Use a semicolon (;) between group IDs.

  7. (Conditional) If you are setting up a webdav mirrored folder, set the following additional parameters:

    Tag

    Setting

    hostUrl=

    The hostname, and optionally, the port number for the WebDAV server. For example:

    http://webdav_hostname[:port]
    https://webdav_hostname[:port]
    

    Do not include the directory path to the data. Use the rootPath= parameter to specify the path to the directory on the WebDAV server. For example, if the full WebDAV server location is:

    http://webdav_hostname/archive/docs

    the hostUrl= setting would be:

    http://webdav_hostname

    user=

    The username that Vibe can use to connect to the WebDAV server. The WebDAV server must support HTTP Basic authentication.

    password=

    The password for the username specified by the user= parameter.

  8. Repeat Step 5 and Step 6 for each mirrored folder resource driver that you want to create.

  9. Save the installer.xml file, then exit the text editor.

15.1.2 Updating Your Vibe Site Configuration

After you edit the installer.xml file, you must run the Novell Vibe Installation program to update the configuration of your Vibe site. If you need assistance with any of the following steps, refer to the appropriate platform-specific instructions in Installing and Setting Up a Basic Vibe Site in Basic Installation in the Novell Vibe OnPrem 3.1 Installation Guide.

  1. Stop Vibe.

  2. Start the Vibe Installation program.

    The Vibe Installation program reads the updated installer.xml file. If your edits inadvertently changed the syntax of the file, the Installation program cannot start. If this happens, correct the problem in the installer.xml file, or return to your backup copy and try your edits again.

  3. Accept the License Agreement, then click Next.

  4. Select Reconfigure Settings, then click Next.

  5. Select Advanced, then click Next.

  6. Click Next until you reach the Mirrored Folder Resource Driver Configuration page.

    The Vibe Installation program displays the first three mirrored folder resource drivers listed in the installer.xml file.

  7. (Conditional) If you placed the new resource drivers at the top of the list, review the information that you added, and make corrections if necessary.

  8. Click Next.

  9. Click Install to implement the new mirrored folder resources.

  10. Start Vibe.