16.3.1. Restoring Procedure

Engineering Knowledge Manager

Administration Guide | Chapter 16: Backing Up and Restoring EKM | 16.3. Restoring EKM |

16.3. Restoring EKM |  | Appendix A. Java Security Manager and EKM Scripting
Prev |  | Next

### 16.3.1. Restoring Procedure

A full restore involves restoring all components where EKM data is stored. This would be used for example, if the server where EKM was installed suffered a catastrophic disk failure, and needed to be reinstalled from scratch.

A partial restore, say of just the EKM version root directory, might be necessary if the files in this directory were corrupted or accidentally deleted.

A restore of the EKM program/user data would be necessary if data within the EKM application got corrupted. In this case, the EKM database and the EKM data directory would need to be restored.

In all cases, the EKM database and EKM data directory must be restored together because they are very closely linked.

- Restoring the EKM Database

- Restoring the EKM Data, Version Root, Job Data, and Repository Directories

- Clearing the Search Indices

#### 16.3.1.1. Restoring the EKM Database

The procedure for restoring the EKM database varies by database server type. Follow the directions provided with your database server to restore the EKM database from the backups you created.

For the MySQL database server, use the `mysql` command to restore the EKM database from the dump created by the `mysqldump` command, as described in Backing up the EKM Database. Here is the suggested command-line for restoring the `ekm` database:

    MYSQL_HOME/bin/mysql < ekm.sql

where ``MYSQL_HOME`` is the directory where the MySQL database server is installed.

After restoring the EKM database and EKM data directory, it is also necessary to clear the search indices as instructed in Clearing the Search Indices.

Important: When restoring the EKM database, it is also necessary to restore the EKM data directory from the same backup set.

#### 16.3.1.2. Restoring the EKM Data, Version Root, Job Data, and Repository Directories

You can restore these directories from your EKM data directory backup. This is a simple filesystem restore, with no special commands to run.

After restoring anything from the EKM data or repository directory, clear the search indices as instructed in Clearing the Search Indices.

Important: When restoring the EKM data directory, it is also necessary to restore the EKM database from the same backup set.

#### 16.3.1.3. Clearing the Search Indices

After any restore, it is necessary to clear the search indices for all domains present on the EKM server. The search indices will automatically get recreated the next time EKM is started. This will ensure that the search indices are consistent with the data in the EKM repository after the restore operation.

To clear the search indices:

1. Go to the `repository` directory and open the `workspaces` sub-directory.

2. For each subdirectory in the `workspaces` directory (such as `Default`, `root` and so on), delete the `index` subdirectory and all of its contents.

Contains proprietary and confidential information of ANSYS, Inc. and its subsidiaries and affiliates.

Prev | Up / Contents | Next

Release 18.2 - © ANSYS, Inc. All rights reserved.