Before updating an ARIS installation, you must assure that the following prerequisites are met.
You know all required user credentials.
The ARIS agent user name and password (default credentials: Clous/g3h31m) for each node that is part of the installation to be updated.
The password of the superuser user (default credentials: superuser/superuser) or the password of a user who has all function privileges for each tenant.
You have enough free disk space available.
For a successful update, sufficient free disk space must be available on each node that is part of the update installation.
Warning
Do not try an update if free disk space is limited. The update might fail, and the installation cannot be repaired. Try to clean up your current installation to delete content that is not needed any longer.
The following is a rough guideline on how to determine the disk space required:
Determine the currently available free disk space f on the machine where the ARIS agent runs.
Determine the current size w of all runnables working directories located in:
Windows: <installation directory>\server\bin\work
Linux: /home/ARIS/cloudagent/work).
Make sure that the condition f > w + 100 GB is met.
All runnables are activated (affecting source versions from 9.8.4 and later)
Starting with ARIS 9.8 SR4, individual runnables can be deactivated. A deactivated runnable is ignored by the startup process of the runnables. This can be useful in cases where the full product is installed, but where only a subset of the functionality is initially used. For example, you might start out only with ARIS Design Server, but for an easier upgrade to ARIS Connect, ARIS Connect Server was installed. In this case, the unneeded runnables can be deactivated, such as ECP and PostgresECP.
To keep an installation consistent, however, deactivated runnables must also be updated. Hence, a deactivated runnable is not ignored by the update process. Some of the steps described in this guide might require the entire installation or at least one instance of a specific application to be started for the step to be successful. So, unless you fully understand the dependencies of the different runnables and which runnables are involved in which step, it is therefore highly recommended to activate all runnables before proceeding and deactivate them again later.
Sufficient amount of virtual memory is available (affecting ARIS server installations on Linux machines)
From ARIS 10 SR4, the elastic runnable (elastic search) requires more virtual memory on your Linux operating system to prevent indices from causing out-of-memory exceptions. On the machine where the elastic runnable is installed, check which value the vm.max_map_count system parameter is currently set to.
For this, use the sysctl vm.max_map_count command. If the value is lower than 262144, change it to 262144.
To change the value for this session only, use the following command (root access permissions required):
sudo sysctl -w vm.max_map_count=262144
This command changes the value for the current session only. After a reboot, this change is undone.
To change the value permanently, add this line to the sysctl.conf configuration file that is available in the ARIS installation directory on your machine:
vm.max_map_count=262144
Files are writable.
Make sure that no file in the installation directory is opened or in use by another process. Locked files will cause issues while the patch setup is running. Use the task manager or the process explorer to identify processes that may access related files, such as notepad or notepad++.
Close all ARIS command-line tools, such as ARIS Cloud Controller, ARIS server Administrator, ARIS document storage Command-Line Tool, or Process Governance Command-Line Tool.
Close all command prompt boxes that you use to start command-line tools, such as y-datadump.bat, y-elasticsearch.bat, y-ldapsync.bat, y-password.bat, or y-tenantmgmt.bat.
Sign off all other users to release all possible file locks.
The user account running the ARIS agent 10.0 Windows service must have the permission to delete and write files. This is the system user on Windows operating systems and the ARIS10 user on Linux operating systems.