Migrate data from ARIS document storage (version 9.x or older)

Migrate the data from ARIS document storage in order to use it in a newer ARIS Risk & Compliance Manager version. If you are using ARIS document storage for the first time or are updating it based on a 9.x version, you do not need to perform the migration. If you are switching from version 4.x to the latest version, you must migrate the data from ARIS document storage. In the 4.x versions, there were separate installations of ARIS document storage for ARIS Server with a connection to Process Governance and ARIS Risk & Compliance Manager. As of version 9, there is only one common ARIS document storage.

The next section describes the steps for merging and migrating the two document repositories.

Procedure

  1. Stop the ARIS Risk & Compliance Manager ACC runnable: stop <arcm-runnable>. All other runnables must be running.
  2. Check the CouchDB content (http://<your host>:19975/_utils/ - basic authentication, login data of a user who has the Document administrator function privilege).
  3. The CouchDB content now appears as follows:

    CouchDB ARIS document storage 1

  4. Start the Windows prompt (CMD) and switch to the directory <ARCM installation directory>\server\bin\work\work_adsadmin_m\tools\bin.
    1. Start the ARIS Risk & Compliance Manager CouchDB migration:
    1. Start the Process Governance CouchDB migration:

      CMD: y-admintool.bat migrate -s "<backup directory Governance CouchDB>" -t "<ARCM installation directory>\server\bin\work\work_couchdb_m\data"

      In the CouchDB overview, new databases should now be displayed with documents:

      CouchDB ARIS document storage 2

  5. Start the reindex process for the CouchDB:

    CMD: y-admintool.bat -t default reindex -u <USER> -p <PASSWORD>

    Replace <USER> and <PASSWORD> with the login data of a user who has the Document administrator function privilege.

  6. After reindexing, the number of documents has increased:

    CouchDB ARIS document storage 3

The migration of data from ARIS document storage is complete.