Installing ARIS Connect/ARIS Design Server using an Oracle database

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 start the remote installation from a Windows system.

In RedHat and SUSE systems *.rpm files will perform these actions automatically:

Prerequisites

Procedure

  1. Copy the file aris10-cloud-agent-<number>-1.x86_64.rpm or aris10-cloud-agent-SLES-<number>-1.x86_64.rpm from the installation media to the hard drive of your Linux system.

    This file provides ARIS Agent. ARIS Agent is needed to perform a remote server installation.

  2. Optionally copy the file aris10-acc_<number>-1.x86_64.rpm from the installation media (Linux) to the hard drive of your Linux system.

    This file provides ARIS Cloud Controller (ACC).

  3. Optionally copy the files for installing ARIS Server Administrator and ARIS Scriptrunner. These files are not mandatory for ARIS Server to be installed.
  4. 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 ARIS 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.

    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.

  5. Adjust the settings used by all configuration scripts.

    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.

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

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

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

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

  10. Save the envset.bat file. So you can use it for future update setups again.
  11. 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.

  12. Create an empty schema for each tenant. Two schemes are mandatory. One for the master tenant and one for the default tenant. The names, for example, aris_master and aris_default can be modified. 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)

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

  13. Perform the ARIS Server installation from a machine running a Microsoft Windows operating system (DVD 1, folder Setups\Windows\ARIS_Server).
  14. Start the setup.exe file as an administrator.
  15. Select the Perform installation on a remote server option and enter the name of your Linux system.
  16. Select the installation directory.
  17. Only if you need to specify an external IP address for incoming requests please enter the server name or server IP.
  18. Change the ARIS agent user's 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.

  19. 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).
  20. 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.

  21. To import the ARIS license file, click Change to navigate to the license zip file. Otherwise licenses must be imported after the installation.

    Make sure this file contains the required ARIS Server license. If you have purchased an ARIS Design Server license (YDS), ARIS Connect components are not available and ARIS document storage provides only basic functionality. ARIS Connect and the full range of ARIS document storage are only available if you are using an ARIS Connect Server License (YCS).

  22. Select Oracle.
  23. Select the required JDBC driver for the Oracle database management system.
  24. 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.

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

  26. Activate Use TLS/SSL encryption to prevent password sniffing.
  27. Only if your mail server requires SMTP authentication, select the option SMTP authentication and enter the user's credentials.

    Warning

    If you enter these parameters but your mail server does not require SMTP authentication, the connection will be rejected.

  28. If you are about to use a proxy server, please 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.

  29. Configure 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.

  30. 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. Alternatively, you might want to modify the shortcut (Start > All Programs > ARIS > Administration >...). However, that bears the risk of a stolen password.

This process takes some time. Settings entered during the setup process can be adjusted. Use the reconfigure ACC command (see ARIS Cloud Controller (ACC) Command-Line Tool.pdf document) to change settings. 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.