Create a backup directory

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

For example, if you plan to back up two docbases (docbaseA and docbaseB), your directory structure would be as follows:
/docbase_backups/[version]/docbaseA
/docbase_backups/[version]/docbaseB
Very important notes
  • The user used to run TEXTML Server daemon *must* have write privileges to the top-level docbase_backups directory. This is described in the procedure below.
    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:

  1. On the machine where TEXTML Server is installed, create a directory for your docbase backups. (For example, /docbase_backups/4.5/.)
  2. Give the permissions for the folder to the UID of the user running the TEXTML server (by default, the UID is textml):
    1. Right-click the docbase directory and select Properties.
    2. Select the Permissions tab.
    3. Set up full permissions for UID (by default, this is textml):

      Figure: Giving folder permissions to TEXTML Server



    4. Click OK.
    Note:
    The example above was made using a remote Unix desktop application. However, you can also set up permissions through a command-line interface using the chmod command. For example:
    chown -R textml:textml  /docbase_backups
    chmod -R o+rw,g+rw,o+r-w /docbase_backups/