Replace an installed Content Store without shutdown

When you have more than one docbase installed on IXIA TEXTML Server, you can restore one without impacting usage of another docbase.

When more than one Content Store is installed in IXIA TEXTML Server, you may not want to perform a system shutdown to replace a single Content Store, since a shutdown would unnecessarily impact a large number of users.

Remember: TEXTML Server must be granted permissions to the high-level directory (for example, the docbases directory) and its subdirectories.

To replace a Content Store without a system shutdown:

  1. Click the TEXTML Administration shortcut on the toolbar to open the TEXTML Administration perspective or take the following actions:
    1. Select Window > Perspective > Open Perspective > Other
    2. Click TEXTML Administration.
    3. Click Open.
  2. In the TEXTML Administration view, double-click the server.
  3. If your server is not in the view, add it by taking the following actions:
    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 fills automatically. If it does not and you need the port number, you can find it in the same place as the server name in the Preferences window.
    5. Click OK.
  4. When the Connect as dialog opens, type your username and password and click OK.
  5. Double-click the name of your Content Store to open a connection to it.
  6. Right-click the Content Store and click Uninstall.
  7. Delete all the files related to the Content Store being replaced.
    For example, if the existing Content Store was in C:\docbases\TEXTML4.4\Prod (Windows) or /docbases/TEXTML4.4/Prod (Linux), then you would delete all the files in the Prod folder.
  8. Copy all the Content Store files (data files and log facility) from the backup and paste them into the Content Store folder.
    Note: Use copy and paste instead of drag and drop to move the files to ensure data integrity.
    Important: If the backup was generated as a snapshot, ensure the files are writable.
  9. In the TEXTML Administration view, right-click the server and click Install Document Base.
    The Install Document Base dialog opens.
    Figure: Installing a docbase


  10. 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.
  11. 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).
  12. 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.
  13. Under Installation Type, click Existing document base to install a populated docbase (for example, a docbase that you previously migrated or are restoring from a backup).
  14. Click OK.
  15. Right-click the Content Store.
  16. Click Unlock all documents.