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, TLS/SSL certificates, SAPĀ® Java Connector, and JDBC drivers, added using the enhance ACC command are not backed up.

Prerequisites

  • Analysis administrator

  • License administrator

  • ARCM administrator

  • Portal administrator

  • Collaboration administrator

  • Process Governance administrator

  • Database administrator

  • Server administrator

  • Dashboard administrator

  • Technical configuration administrator

  • Document administrator

  • User administrator

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 use 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. If values contain special characters, you must quote the strings and special characters. If a password for example is User&12345, you must enter password=\"User\&12345\". 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 all users that are automatically created (arisservice user, guest user, system user, superuser user) on all operational tenants, as well as on the infrastructure tenant (master).

Warning

To prevent unauthorized access to the ARIS system, after installation or data migration, always change the default passwords of all users that are automatically created (arisservice user, guest user, system user, superuser user) on all operational tenants, as well as on the infrastructure tenant (master).

'system' user

The system user is created automatically. By default, the system user has all function privileges. This user can log in to Process administration Process administration, ARIS Administration, User Management, and ARIS Process Board. In ARIS Architect and ARIS Designer, this user has all access privileges for all database groups of all databases. This user only uses up a license if a license privilege is activated for this user. The default password is manager. You should change the default password to prevent unauthorized access. You can change all user data except for the user name.

Having more than one system user can avoid problems, if, for example, your single system user has forgotten his password. You can create additional system users or copy the existing system user. If your only system user was deleted accidentally, create a new one by using the superuser. The user can only be deleted individually. Enable the Generate, if not available option (Application launcher Application launcher > Administration Administration > Configuration > User management > Users >) so that the user is automatically generated again at startup with the last saved password.

'superuser'

The user superuser is created automatically. By default, this user is assigned the User management, License management, and Configuration administrator function privileges. This user can also enable this function privilege for other users. Users of the superuser type do not use up a license. They manage the system administration, but cannot use ARIS products due to license restrictions. The default password is superuser. You should change the default password to prevent unauthorized access. The password of the superuser is very important, as it is the only user who cannot be deleted. You can change all user data except for the user name. The superuser can recreate the other default users (system, arisservice, guest) if they were deleted.

'arisservice' user

The user arisservice is created automatically. By default, this user is assigned the Database administrator and Process Governance administrator function privileges. This user only uses up a license if a license privilege is activated for this user. The default password is arisservice. You should change the default password to prevent unauthorized access. You can change all user data except for the user name. The user can only be deleted individually. Enable the Generate, if not available option (Application launcher Application launcher > Administration Administration > Configuration > User management > Users >) so that the user is automatically generated again at startup with the last saved password.

'guest' user

The user guest is created automatically. By default, no function or license privileges are assigned to this user. This user serves technical purposes only. It is not for use by end users. Logging in to ARIS or other Software AG products with this user is not allowed. Further information is available in the Software AG license terms (http://softwareag.com/licenses). The user can only be deleted individually. Enable the Generate, if not available option (Application launcher Application launcher > Administration Administration > Configuration > User management > Users >) so that the user is automatically generated again at startup with the last saved password.

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