To update the installed version run the most recent ARIS Server installation program.
When you update or uninstall ARIS by an ARIS setup, the current installation will automatically be backed up. This process takes additional time and requires additional disk space while the setup is running. Make sure that the size of the free disk space is at least 15 GB larger than the folder size of the working directories <ARIS installation path>\server\bin\work (Windows®) or /home/ARIS10/cloudagent/work (Linux). The update will fail if there is insufficient free disk space. If the update process fails, all ARIS components will be rolled back automatically.
Restrictions
If you use an external database management system backup these systems before running an update setup. In case of a failed update you will be able to restore the external database systems, too.
If you update ARIS make sure to exit ARIS Cloud Controller before running the update setup.
During the update, you will in general need the following credentials:
Usern ame/password of the ARIS Agent (default values are Clous/g3h31m)
The password of the superuser user (default: superuser), or alternatively, the password of a user with all functional privileges for each tenant.
Warning
Process Governance backup archives greater than 2 GB might lead to insufficient TEMP space issue when restoring them into ARIS with Oracle back end. For such large backups, extend the temp tablespace size before restoring operation executed.
To avoid data inconsistencies and possible data loss, you must not perform any of the following activities in parallel, neither manually nor scheduled:
- Deleting any Process Governance process instance, process version, or process
- Archiving Process Governance process instances
- Backup/restore tenant (containing Process Governance or ARIS document storage data)
Procedure
Exit ARIS Cloud Controller.
Start the update setup as the same administrator that has installed ARIS.
Enter the ARIS agent user's credentials. The update process starts. The default tenant's system database is updated automatically.
When the setup is completed
If you previously had added certificates to your current system in order to allow SSL connections between ARIS Server and external systems, you must make these certificates available again after each update of ARIS Agent. Certificates stored in the JRE of ARIS Agent are used, for example, if you use SSL access and ARIS Aware Dashboards or LDAP. These certificates are overwritten by an update. If you update ARIS Server, the latest JRE will be installed with its own cacert keystore.
If you use ARIS document storage, adjust timestamps manually.
In previous ARIS versions, ARIS document storage stored timestamps, for example Creation time and Update time, referred to documents and folders in local server time and without any time zone information. If data was moved between ARIS Servers or if a tenant was restored from a backup file, timestamps were likely adjusted using a wrong time offset.
Since ARIS 10 SR6, Coordinated Universal Time (UTC) is mandatory for timestamps stored by ARIS document storage. Because time zone information in existing data is not available, the timestamps of existing documents and folders cannot be adjusted automatically. After the update to ARIS 10 SR6, you must manually adjust timestamps. In a Windows-based installation with local time UTC-2, for example, use the y-admintool.bat command-line tool and, considering UTC offset of your ARIS Servers>, enter the following:
y-admintool.bat -s https://localhost -t default adjustTimestamps -offset "-120" -u system -p manager
If you have restored a tenant from backup file created with ARIS 10 SR5 or earlier, you must adjust the timestamps as well.
Make sure that all fonts are available.
ARIS is up to date.
Make sure that you also update locally installed clients.
If the update process has failed all ARIS runnables will be restored automatically. Please restore your external database system using the backup.