Before installing an ARIS Server on a Linux operating system, you must provide 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. Therefore, refer to the ARIS Distributed Installation Cookbook.pdf document. Le savoir-faire nécessaire peut être acquis uniquement en suivant la formation ARIS Server Installation, disponible 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
An operating Oracle database management system. If you have not yet installed the Oracle database management system, please follow the instructions in the Oracle installation program, as well as the documentation provided by the manufacturer. The external database management system is not included in this package. If you need help in setting up ARIS using your external database system, please contact Software AG. Please note that this service is not subject to the standard Software AG software maintenance agreement and that these changes can only be performed if you requested and agreed on them.
Ensure that SQL*PLUS is available. Therefore an ORACLE client or an ORACL server must be installed on the machine where the scripts are run.
Use of the database character set AL32UTF8 is mandatory.
You must know the port number, the database/service name of the new database instance and also the credentials, for example, the user name and the password of the application user.
You have downloaded the latest version of the Oracle JDBC driver, for example, ojdbc7-12.1.0.1.jar from the Oracle Web Site to a directory of your choice.
SQL scripts and all additional files. All scripts and files are located on the installation medium (Add-ons\DatabaseScripts\Design&ConnectServer\oracle) or they can be downloaded from the ARIS Download Center.
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 ARIS Agent. 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 ARIS Agent to your Red Hat system.
rpm –i aris10-cloud-agent-SLES-<number>-1.x86_64.rpm
This command installs 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.
Your database administrator must adjust the settings that are used by all database scripts. These scripts must be executed by the database administrator to setup the database as required.
Edit the file envset.bat to specify the connection data of the Oracle instance. It's a good idea to write down values and credentials. They must be entered later during the ARIS Server setup process.
Edit the envset.bat file and adjust the following lines replacing the highlighted parameters with the settings appropriate for your environment:
REM The path to where sqlplus.exe can be found.
SET CIP_ORA_BIN_PATH=<enter the path>
REM hostname, port and service name
SET TARGET_HOST=localhost
SET TARGET_PORT=1521
SET TARGET_SERVICE_NAME=ARIS
Edit the following lines to change the highlighted credentials of the application user:
REM credentials of the user that is used by the application.
SET CIP_APP_USER=ARIS10
SET CIP_APP_PWD=*ARIS!1dm9n#
REM password of the tenant schemas.
SET CIP_TENANT_SCHEMA_PWD=*ARIS!1dm9n#yy
With the next two lines you specify the DBA user you intend to use to create the application user and this DBA user’s password:
REM credentials of the Oracle user that will be used to create the application schema.
REM Note that this user must be endowed with DBA privileges such as user SYSTEM.
SET CIP_INSTALL_USER=system
SET CIP_INSTALL_PWD=manager
If your data tablespace name is different from ARISDATA respectively TEMP for temp tablespace, you will also need to modify these highlighted parameters accordingly:
REM tablespace name of the tablespace in which the data of the application schema should be stored.
SET CIP_TS_DATA=ARISDATA
REM name of the temporary tablespace.
SET CIP_TS_TEMP=TEMP
Save the envset.bat file. So you can use it for future update setups again.
Run the script cip_create_app_user.bat.
This will create the application user. The application user (CIP_APP_USER) is the Oracle user connecting ARIS and the Oracle database. The default user name is ARIS10. But you may have changed that name in the envset.bat earlier.
Create an empty schema for each tenant. Two schemes are mandatory. One for the master tenant and one for the default tenantdefault tenant. The names, for example, aris_master and aris_default can be modified. Write down the tenant names. These names must be entered later during the ARIS Server setup process. If you need additional tenants, you must create additional schemes.
To create the schema objects, run these commands for each schema name aris_master, aris_default and additional tenants.
Run the script cip_create_schema_for_tenant.bat and pass the schema name as parameter, for example:
cip_create_schema_for_tenant.bat aris_master (mandatory)
cip_create_schema_for_tenant.bat aris_default (mandatory)
cip_create_schema_for_tenant.bat <oracle schema name for additional tenant> (optional)
Si vous allez créer des locataires supplémentaires pour ARIS 10.0 pour migrer des données d'ARIS 9.8.7 ou d'une version ultérieure, assurez-vous d'utiliser des noms identiques dans les deux versions d'ARIS. If the schema already exists it will be dropped and recreated.
If you use an external database management system and you have created empty schemes for additional tenants, you must assign additional tenants to these schemes after the ARIS Server setup is completed. The default tenant and the master tenant were assigned automatically.
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 and can be downloaded from Empower or from 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 ARIS Functional Product Matrix contained in the downloaded ARIS installation package, ARIS Download Center, or Empower).
Select Oracle.
Select the required JDBC driver for the Oracle database management system.
Enter the connection parameters used in the envset.bat file and exactly the values used by the Oracle server.
The values shown are the default values used in the envset.bat file and the default parameters used when setting up the Oracle server.
Enter exactly the values used by the Oracle server, for example, database name. Use the default schema's name and the master schema's name that have been created earlier.
Server: Fully qualified name or IP address of the Oracle server.
Port: Specify the port number addressing the Oracle server instance running over TCP. The corresponding line in the envset.bat file is SET TARGET_PORT=1521.
Database/Service name: Specify the Oracle SID or Oracle service name. The corresponding line in the envset.bat file is SET TARGET_SERVICE_NAME=ARIS.
Application user: Login user name that is used by the application. The corresponding line in the envset.bat file is SET CIP_APP_USER=ARIS10.
Password: The application user's password. The corresponding line in the envset.bat file is SET CIP_APP_PWD=*ARIS!1dm9n#. Enter the schema names exactly in the way as they have been created earlier.
Master schema: Schema name for the master tenant and user name for that schema's owner. Enter exactly the name used when you have created the schema, for example, aris_master (see step Create an empty schema for each tenant).
Default schema: Schema name for the default tenant and user name for that schema's owner. Enter exactly the name used when you have created the schema, for example, aris_default (see step Create an empty schema for each tenant).
If you want to use an Oracle cluster you must change the connection URL as required: syntax: jdbc:oracle:thin:@<ORACLE_SERVER>:<ORACLE_PORT>:<ORACLE_SID>. After the setup process is completed you need to update the external service.
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 Administration ARIS of this server. Please refer to the online help of Administration ARIS.
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 Administration ARIS of this server. Please refer to the online help of Administration ARIS.
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. Vous pouvez modifier les paramètres saisis lors du processus d'installation. Utilisez la commande ACC reconfigure pour changer les paramètres tels que les ports, 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 an Oracle database, we recommend that you recalculate the database statistics regularly.
To uninstall ARIS from a Red Hat or a SUSE system enter, for example, rpm –e aris10-cloud-agent and rpm –e aris10-acc.
Update installations are available. Components will be stopped. After the system has been updated all components will be started automatically.