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. 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
An operating Microsoft SQL Server database. If you have not yet installed the Microsoft SQL Server, please follow the instructions in the Microsoft 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 Latin1_General_CI_AI sorting is selected for the COLLATE statement.
The SQL Server and Windows authentication mode (mixed mode) option is selected (Microsoft SQL Console > Security tab).
You must know the port number, the database name of the new database instance if it was not configured as a default instance, and also the user name and the password of the application user.
You have downloaded the latest supported version (see ARIS System Requirements) of the Microsoft SQL Server JDBC driver from the Microsoft Download Center 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\mssql) 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 envset.bat file to specify the connection data of the Microsoft SQL server instance. It's a good idea to write down the credentials. They must be entered later during the ARIS setup process.
To specify the connection data of the Microsoft SQL instance, modify the highlighted parameters and refer to the comments:
REM
REM You may edit this section for customizing purposes.
REM
REM This script is intended to be executed on the Microsoft SQL server machine, therefore the default value is 'localhost'
REM If the MSSQL_SAG_FILEGROUP_FILE_DIR directory exists on the Microsoft SQL server machine, you can run the script remotely. When executed locally, the script creates this mandatory directory.
REM If you use a default instance, an instance name is not required.
REM If you use named instances, enter a backslash ‘\’ followed by the instance name.
SET MSSQL_SAG_MSSQL_SERVER_NAME=localhost
REM This script is configured for the use of Windows authentication by default.
REM Windows authentication uses the user account running this script and does not require user credentials to be specified in this script.
REM If you want to use user/password authentication instead, uncomment the following lines and modify the settings for use by the SQL Server command line tool (sqlcmd).
REM SET SQLCMDUSER=sa
REM SET SQLCMDPASSWORD=manager
REM name of database that will be created by the script.
SET MSSQL_SAG_DATABASE_NAME=ARIS10DB
REM folder in which the database files should be stored.
SET MSSQL_SAG_FILEGROUP_FILE_DIR=F:\msqldata\ARIS10DB
REM credentials of the login that is used by the application.
SET MSSQL_SAG_APP_USER=ARIS10
REM If using % character in your password: Write %% to yield a single % character.
SET MSSQL_SAG_APP_PWD=*ARIS!1dm9n#
REM schema names for the default and master tenants
SET MSSQL_SAG_TENANT_DEFAULT=ARIS_DEFAULT
SET MSSQL_SAG_TENANT_MASTER=ARIS_MASTER
REM
REM The rest of the script must not be modified.
....
Execute the inst.bat file. This will create the database including the two mandatory tenants and the application user. The application user (APP_USER) is the Microsoft SQL user connecting ARIS and the Microsoft SQL database. The default user name is ARIS10. But you may have changed that name in the envset.bat earlier. Two schemes are mandatory. One for the master tenant and one for the default tenant. 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 for each new tenant. If you are going to create additional tenants for ARIS10.0 to migrate data from ARIS 9.8.7 or later, make sure to use identical names in both ARIS versions.
Run the script create_schema_for_tenant.bat and pass the schema name as parameter, for example:
create_schema_for_tenant.bat <schema name for additional tenant>
If the schema already exists it will be dropped and recreated automatically. If you do not use the scripts you can also setup the database and create an empty schema for each tenant manually.
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. You can open or download documents from the Documentation Web site. Documents are also contained in the ARIS installation package (see Documents > English folder structure) 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 ARIS Functional Product Matrix. You can open or download documents from the Documentation Web site. Documents are also contained in the ARIS installation package (see Documents > English folder structure) that is available in the ARIS Download Center.
Select MSSQL.
Select the required JDBC driver for the Microsoft SQL database management system.
Enter the connection parameters used in the envset.bat file and exactly the values used by the Microsoft SQL server.
The values shown are the default values used in the envset.bat file and the default parameters used when setting up the Microsoft SQL server.
Server: Fully qualified name or IP address of the Microsoft SQL server. The default parameter used in the envset.bat file is localhost. The default name works only if you run that script from the machine were the Microsoft SQL server is installed.
Port: Port addressing the SQL server instance running over TCP. The default port number used in the envset.bat file is 1433.
Instance name: When setting up a Microsoft SQL server, the default instance name is MSSQLSERVER. If you use named instances, enter the used named instance name instead.
Database name: Name of the database that was created by the envset.bat script. The default value is ARIS10DB.
Application user: Login user name that is used by the application. The default value used in the from envset.bat file is ARIS10.
Password: The application user's password. The default value used in the from envset.bat file is *ARIS!1dm9n#.
Default schema: Schema name for the default tenant and user name for that schema's owner. The default value used in the from envset.bat file is ARIS_DEFAULT.
Master scheme: Schema name for the master tenant and user name for that schema's owner. The default value used in the from envset.bat file is ARIS_MASTER.
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, such as ports. After the ARIS Server installation has completed, you must check the installation and configure the system.
To uninstall ARIS from a Red Hat or a SUSE system enter, for example, rpm –e aris10-cloud-agent and rpm –e aris10-acc.