Create a backup directory in Linux

In the Linux environment, MadCap Software recommends that you store all the docbase backups in a top-level folder, called docbase_backups. You can then create a sub-folder for IXIA TEXTML Server version and then a sub-folder for each docbase backup.

If you plan to back up more than one docbase , such as "docbaseA" and "docbaseB", your directory structure would look like this:
/docbase_backups/[version]/docbaseA
/docbase_backups/[version]/docbaseB
Very important notes
  • The user that runs the TEXTML Server daemon must have write privileges to the top-level docbase_backups directory.
    Note: To determine the name of the user that is running the TEXTML Server, see the username field in the /opt/ixiasoft/textmlserver/<instancename>/textmlserver4.conf file. By default, this is textml.
  • The backup directory must not be within the directory structure of your live docbase .
  • Never use one of the following directories by itself to store the backups:
    • /, /tmp, /usr, /lib, /var, /etc, ...
    Otherwise, this directory will be erased if the TEXTML Server process runs as root and you select the option to overwrite existing backups.

To create a backup directory in Linux:

  1. On the machine where TEXTML Server is installed, create a directory for your docbase backups, such as /docbase_backups/4.4/.
  2. Give the permissions for the folder to the UID of the user running the TEXTML Server. The default UID is textml.
    1. Right-click the docbase directory and select Properties.
    2. Select the Permissions tab.
    3. Set up full access permissions for UID. The default ownership is textml.
      Figure: Folder access permissions for TEXTML Server


    4. Click OK.
      The docbase backup directory is created.
    Note: The example used a remote Unix desktop application. However, you can also set up permissions through a command-line interface using the chmod command, such as:
    chown -R textml:textml  /docbase_backups
    chmod -R o+rw,g+rw,o+r-w /docbase_backups/