Install a new docbase on Windows

This procedure describes how to install a new, unpopulated docbase into IXIA TEXTML Server.

c:\docbases\TEXTML4.4\Prod_v50
c:\docbases\TEXTML4.4\Test_v50

1. Create a directory for your docbase on a local drive or a storage area network (SAN) on the machine where you installed IXIA TEXTML Server.
   For example: C:\docbases\TEXTML<serverversion>\Prod_v<cmsversion>; where <serverversion> is the TEXTML Server version and <cmsversion> is the IXIA CCMS Desktop version.

   It should look like the following: c:\docbases\TEXTML4.4\Prod_v50

2. Give TEXTML Server permissions for the high-level directory (for example, the docbases directory) and its subdirectories:
   1. (Windows) Right-click the high-level directory and select Properties.
   2. Select the Security tab.
   3. Select the user under which TEXTML Server is running.

      If the identity given to TEXTML Server does not appear, you must add it.

      Important: By default, LOCAL SERVICE is the identity for TEXTML Server and Metaservices components during TEXTML Server installation. However, if your deployment TEXTML Server is running in a cluster or forest, you must run TEXTML Server as another user that is listed in the Group or user names box. If it is not in that list, you must add it.
   4. Click Edit and set up full permissions for the username:

      
      

      

      
      

   5. Click OK.
3. Open the TEXTML Server Administration Console.
4. In the TEXTML Administration view, double-click the server.
5. If your server is not displayed in the view, add it by doing the following:
   1. To find the server name, click Window > Preferences and select IXIA CCMS.
      In the TEXTML Server Connection section, the server name is the Hostname.
   2. Copy the Hostname and close the Preferences window.
   3. In the TEXTML Administration view, right-click and select Add Server.
   4. In the Server field, enter the server name.
      The Port field should fill automatically. If you need the port number, you can find it in the same place as the server name in the Preferences window.
   5. Click OK.
6. When the Connect as dialog opens, type your username and password and click OK.
7. In the TEXTML Administration view, right-click the server and click Install Document Base.
   The Install Document Base dialog opens.

   
   

   

   
   

8. In the Name box, type the name of the docbase.
   Note: While the name of the docbase can be different from the name of the docbase folder, MadCap Software highly recommends that you use the same name.
9. In the Data box, type the path to the docbase folder.
   Important: If you opened the TextmlServer Console Java or IXIA TEXTML Server perspective from a different machine than where TEXTML Server and the docbase are installed, you must enter the full path to the docbase on the machine where it is installed (and the Browse button is disabled).
10. Optional: Do one of the following:
    • To have logger records saved in the docbase directory, select Use same directory for logs.
    • To have logger records written to a different directory, specify a folder in the Logs box.

    Note: Logger records (not to be confused with transaction logs) are duplicates of the master record for docbase transactions. TEXTML Server creates logger records when performing write operations on the docbase. Users who expect frequent intense write activity on a docbase may choose to locate the logger records in a separate directory residing on a different physical disk to improve performance.
11. Under Installation Type, click New document base to install a new and empty docbase entity.
12. Click OK.
    The new docbase and its associated subfolders appear as child nodes of the server.