Update ARIS Connect/ARIS Design Server

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

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

  1. Back up all tenants data.
  2. Make sure to have all runnables activated.
  3. Exit ACC.
  4. Start the update setup as the same administrator that has installed ARIS.
  5. Enter the ARIS agent user's credentials. The update process starts. The default tenant's system database is updated automatically.
  6. When the setup is completed update the system databases for all additional tenants.
  7. For the use of Tenant Management user interface all operational tenants must be configured. Make sure to enter superuser in the Impersonation target users field again.
  8. 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.
  9. 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.

  10. 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.