Create a backup directory in Windows

For a Windows environment, MadCap Software recommends that you build a hierarchical structure for your backups. For example, you could store all Content Store docbase backups in a top-level folder named docbase_backups, then create a sub-folder for IXIA TEXTML Server version, and then create a sub-folder for each docbase backup.

Suppose you have a Content Store "docbaseA" and "docbaseB" that require backup, so you structure your directory as follows:

C:\docbase_backups\[version]\docbaseA
C:\docbase_backups\[version]\docbaseB
Very important notes
  • The "logon as" user for the TEXTML Server service must have write privileges to the top-level docbase_backups directory.
  • The backup directory must not be within the directory structure of your live docbase.
  • Never use directories by themselves such as c:\, c:\Windows, c:\Program Files, or d:\ to store the backups. The backup erases the directory if you select the option to overwrite the existing files. Such an action can corrupt your operating system, or may render a program or application unusable.

To create a backup directory in Windows:

  1. On the machine where TEXTML Server is installed, create a directory for your docbase backups.

    For example, C:\docbase_backups\4.4\.

  2. Give the TEXTML Server permissions for the high-level folder (i.e., C:\docbase_backups) and its sub-directories. For example:
    1. Right-click the C:\docbase_backups directory and select Properties.
    2. Select the Security tab.
    3. Select the user under which the TEXTML Server is running.
      Important: By default, LOCAL SERVICE is the identity given to the TEXTML Server and Metaservices components when TEXTML Server is installed. Several conditions would indicate the TEXTML Server may have an alternate identity:
      • If the TEXTML Server is running in a cluster
      • If Kerberos is enabled in a network with multiple Active Directory Forests or if an Active Directory Forest includes many domains
      If the TEXTML Server identity is not listed in the Group or user names box:
      1. Click Add.
      2. In the Enter the object names to select box, type the username and click Check Names.
        Note: The username is underlined. For example, if the TEXTML Server is running with the LOCAL SERVICE identity, the LOCAL SERVICE username is underlined.
        Add Local Service user
      3. Click OK.
      4. Select the username.
    4. Click Edit and set up full permissions for the username you selected.
      Figure: Permissions for the TEXTML Server


    5. Click OK.
      The docbase backup directory is created.