Copy a tenant to a different server

You can copy the content of a backed up tenant to a different ARIS Server. This procedure can also be used to migrate data in case of an upgrade installation. You need to have access to the relevant back-up archive file containing the data of a tenant:

Extensions, for example, SSL certificates, SAP® Java Connector, and JDBC drivers, added using the enhance ACC command are not backed up.

Prerequisites

Procedure

  1. Create a tenant on the ARIS Server where the tenant will be copied to and import the licenses.
  2. Start ARIS Cloud Controller (ACC).
  3. To restore Process Governance data, stop the Process Governance runnable first. To do so enter, for example: stop apg_m
  4. Enter: restore tenant <Tenant name> from <pathToBackUpFile> encryption.key <encryption password or encryption key> username=<user name of a user holding the required privileges> password=<this user's password>

    or as an example for the us of an unencrypted acb file: restore tenant default from "f:\\backupDefault.acb" username=y1234 password=managery1234

    Notice the double backslashes. Alternatively, use a single forward slash. You must enter the user credentials of the server's ARIS Administration you have created the new tenant. If you are about to migrate data, you might use the standard name and password system/manager.

  5. In case you restored Process Governance data, restart the Process Governance runnable. To do so enter, for example: start apg_m

All data of the backup file will be copied to the new tenant. Current data will be deleted except the name of the new tenant, as well as user credentials. The current user data will be untouched. If users were deleted after the tenant has been backed up, these users will be available again. Please make sure to delete those users.

In case of a migration process the default credentials will automatically be in use. To prevent unauthorized access to the ARIS system, after installation or data migration, always change the default passwords of the arisservice user, the guest user, the system user and the superuser user on all operational tenants, as well as on the infrastructure tenant (master).

You can also create tenants using the ARIS Administration's command line tools or Tenant Management.