Perform an on-demand backup of the docbase

If you need to manually trigger a backup of the docbase, you can launch the backup from the TEXTML Server interface.

Note: Content Store data is stored in a TEXTML Server docbase. To back up a Content Store, you back up the TEXTML Server docbase that stores the Content Store data.

To trigger a backup:

On the computer where the TEXTML Server is installed, create a directory for the backups.
Open the TEXTML Administration perspective by clicking the TEXTML Administration shortcut on the tool bar. If the shortcut is not displayed, follow these steps:
1. Select Window > Open Perspective > Other
2. Click TEXTML Administration.
3. Click OK.
In the TEXTML Administration view, double-click the server. If your server is not displayed in the view, you must add it to the view.
When the Connect as dialog opens, type your username and password and click OK.
Double-click the name of your docbase to open a connection to the Content Store.
Right-click the docbase and select Backup.
The Start backup window opens:
Figure: Backing up a docbase

Important note:
BEWARE: If the destination folder is not empty, TEXTML Server deletes the contents of the folder before starting the backup.
In the Directory Path box, type the full path to the folder you created for the docbase backups.
For example (replace [version] by the release version) :
```
C:\docbase_backups\[version]\docbaseA
```
```
/docbase_backups/[version]/docbaseA
```
Note: The TEXTML Server service or daemon *must* have write privileges to the top-level folder storing the backups; for example, the docbase_backups directory.
Click OK.
The backup is initiated. To verify, look in the Properties view under General > Status. When the backup is initiated, the value for Status changes from Ready to Ready Backing-up.
Figure: Example of Properties view:
Wait while the backup occurs. Depending on the size of the docbase and your server activity, this could take considerable time.

Note: While the backup is occurring, a temporary file is created (backuperror.tmp) under the backup folder. If no errors occur during backup, this file is deleted and a new file called backup.info is created when the backup is complete.
To confirm that the backup was successful, look in your target directory:
- If the backup.info file is present, then the backup was successful.
- It the backup is completed but the backuperror.tmp is present, then an error occurred and the backup is corrupted.
If an error occurs, or to get more information about the backup operation, look at the logs. They are available in the log directory.
On Windows:
```
%program_data%\IxiaSoft\TextmlServer[version]\Log
```
For example:
```
C:\ProgramData\IxiaSoft\TextmlServer[version]\Log
```
On Linux:
```
<textml_install_dir>/<instance_name>/log/
```
For example:
```
/opt/ixiasoft/textmlserver/ts01/log/
```