Before installing an ARIS server on a Linux operating system, you must provide the ARIS agent to your Linux Red Hat or SUSE system. To allow customizing activities additionally provide the command-line tools ARIS Server Administrator, ARIS Cloud Controller (ACC), and ARIS Scriptrunner. Use the *.rpm files for Red Hat or SUSE systems.
After you have copied and installed the files, you must start the remote installation from a Windows system. If you do not want to run the setup remotely from a Windows machine, you must execute all required steps manually using ARIS Cloud Controller. For more information on manual setup, refer to the ARIS Distributed Installation Cookbook.pdf document. The required know-how can be acquired only by attending the training course ARIS Server Installation, available via Global Education Services.
In RedHat and SUSE systems *.rpm files will perform these actions automatically:
/etc/sysctl.conf
kernel.shmmax:
if "kernel.shmmax < 629145600" then "kernel.shmmax = 629145600"
max_file_max:
if "max_file_max < 200000” then "fs.file-max = 200000"
/etc/security/limits.d/40-aris.conf
$max_file_max = "ulimit –n"
If "$max_file_max > 2^20" then max_file_max = 2^20
aris10 soft nofile $max_file_max
aris10 hard nofile $max_file_max
aris10 soft nproc 12204
aris10 hard nproc 12204
/etc/pam.d/su
session required pam_limits.so
Prerequisites
Make sure that the general prerequisites are met.
Procedure
Copy the file aris10-cloud-agent-<number>-1.x86_64.rpm or aris10-cloud-agent-SLES-<number>-1.x86_64.rpm from the ARIS installation package to the hard drive of your Linux system.
This file provides the ARIS agent. The ARIS agent is needed to perform a remote server installation.
Optionally copy the file aris10-acc_<number>-1.x86_64.rpm from the contained in the ARIS installation package (..\Linux setups) to the hard drive of your Linux system.
This file provides ARIS Cloud Controller (ACC).
Optionally copy the files for installing ARIS Server Administrator and ARIS Scriptrunner. These files are not mandatory for ARIS server to be installed.
Depending on the files you have copied and the type of the Linux system enter the relevant command to install the files. By default, these installations will create an unprivileged and locked user aris10 which uses /home/ARIS10 to install ARIS itself. If you want to use different settings, make sure to .
By default, the executed rpm files will create an unprivileged and locked user aris10 which uses /home/ARIS10 to install ARIS itself. If you want to use different settings, make sure to change them before installing the first rpm file.
To change the directory, you must set the environment variable TARGETDIR to the desired directory, for example:
export TARGETDIR=/mnt/largedisk
To change the user under which ARIS will run, you must set the environment variable user (lower case is mandatory), for example:
export user=TheOtherUser
Ensure to set the environment variables in the same user context as the package manager call that uses the environment variables.
Code Example
sudo -s
export TARGETDIR=/mnt/largedisk
export user=TheOtherUser
rpm install aris10-cloud-agent-<number>-1.x86_64.rpm
rpm –i aris10-acc-<number>-1.x86_64.rpm
This command installs ARIS Cloud Controller (ACC) (/bin/acc10.sh) to your Red Hat and SUSE system.
rpm –i aris10-cloud-agent-<number>-1.x86_64.rpm
This command installs the ARIS agent to your Red Hat system.
rpm –i aris10-cloud-agent-SLES-<number>-1.x86_64.rpm
This command installs the ARIS agent to your SUSE system.
rpm –i aris10adm-<number>-1.x86_64 and rpm –i aris10-scriptrunner-<number>-1.x86_64
These commands optionally install the administrator tools ARIS Server Administrator and ARIS Scriptrunner.
Perform the ARIS server installation from a machine running a Microsoft Windows operating system (see ARIS installation package\Windows setups\ARIS_Server).
Start the setup.exe file as an administrator.
Select the Perform installation on a remote server option and enter the name of your Linux system.
Select ARIS server to be installed.
Select ARIS Aware. This will activate the dashboarding runnable and provide dashboards. If you do not select this option, the runnable will be installed but not activated.
Select ARIS Risk and Compliance if you want to install this program as well. The ARIS Risk and Compliance installation procedure is described in the ARIS Risk and Compliance Installation Guide. Documents are available in the Documents folder. You can open or download documents and the Technical Help from the Documentation Web site. Documentation is also contained in the ARIS installation package that is available in the ARIS Download Center.
Select the installation directory if required.
Only if you need to specify an external proxy server IP address for incoming requests enter the proxy server computer name or IP.
Change the ARIS agent user credentials to prevent unauthorized access to your ARIS system. Make sure to store the credentials on a save place. If you forget the credentials, you can no longer update the system or modify the configuration.
If you change the credentials, you will be further on prompted to enter that password you've chosen whenever you start/stop the ARIS server or access your ARIS installation using ARIS Cloud Controller.
If the ports 1080 or 1443 are already in use, specify the port numbers to be used. If you change the default port numbers users must ad :<this port number> to the URL (see below).
To force secure connections (HTTPS), uncheck HTTP port. If you do so, make sure to make a valid TLS server certificate available.
Select the suitable system settings option. You need to take the RAM required and the number of users who will be accessing the ARIS server into account. For a productive system it is recommended to select the Medium or Large option.
The Demo scenario option is recommended for demonstration purposes (laptop) only.
Warning
If the hardware does not fit the system requirements, a warning is prompted. In this case do not proceed the setup. Otherwise, ARIS might not work reliably.
To import the ARIS license file, enable Import now, click Select file..., and navigate to the license archive file. Otherwise, licenses must be imported after the installation.
Make sure this file contains the required ARIS server license. The functional range depends on the server license that you have purchased (see Functional Product Matrix. You can open or download documents and the Technical Help from the Documentation Web site. Documentation is also contained in the ARIS installation package that is available in the ARIS Download Center.
Select the Standard database system.
Enter the SMTP mail processing parameters of an existing account.
Warning
If you don't, ARIS will not send any notifications, due to the missing mailing functionality.
But you can configure SMTP mail processing at any later point of time. Some parameters can also be managed using the ARIS Administration of this server. Please refer to the online help of ARIS Administration.
Activate Use TLS/SSL encryption to prevent password sniffing.
Only if your mail server requires SMTP authentication, select the option SMTP authentication and enter the user credentials.
Warning
If you enter these parameters but your mail server does not require SMTP authentication, the connection will be rejected.
If you are about to use a proxy server, enter all proxy processing parameters. You can also enter them later, using the ARIS Administration of this server. Please refer to the online help of ARIS Administration.
You can specify a URL to be used for validating the proxy server settings.
Select the start option:
Select Start automatically if you want to have the server started up with every restart of your operating system.
Select Start manually if you want to start/stop the server on the active computer manually.
Start the installation process. If you have changed the ARIS agent's default user credentials during this procedure, you will be prompted for that password you have chosen.
The installation process takes some time. You can change settings entered during the setup process. Use the reconfigure ACC command to change settings, such as ports. After the ARIS server installation has completed, you must check the installation and configure the system.
To ensure optimum performance when you are using ARIS with the standard database system, we recommend that you regularly shrink the database. This prevents the used disk space constantly increases. To do so, execute the vacuumdb.exe file (<ARIS installation directory>\server\bin\agentLocalRepo\.unpacked\<build number>_PostgreSQL-run-prod-<ARIS version>-windows64-runnable.zip\postgresql\bin). For detailed information, read the instructions provided by the manufacturer.
To uninstall ARIS from a Red Hat or a SUSE system enter, for example, rpm –e aris10-cloud-agent and rpm –e aris10-acc.