Installing ARIS Publisher 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:

This setup will install ARIS Agent and ARIS Publisher Server. The standard setup installs ARIS Publisher Server including Apache TomcatTM 7.x Web Application Server. As the used Web Application Server version cannot be the most recent version a denial of service (DoS) vulnerability can occur. This vulnerability is not critical for intranet use. For Internet use please make sure to use the most recent web application server version that matches your security requirements.

For a productive ARIS Publisher system, you must select the small or large installation option. For these installation options an external database system is required. The external database system is not included in the package. 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.

Depending on the ARIS Publisher Server license purchased, the system enables all users to simultaneously work on exports.

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. Start the ARIS Publisher Server installation from a machine running a Microsoft Windows operating system (DVD folder Setups\Windows\ARIS_Publisher_Server).
  6. Start the setup.exe file as an administrator.
  7. Select the Perform installation on a remote server option and enter the name of your Linux system.
  8. To import the ARIS license file right now, click Select file... and navigate to the license archive file. Otherwise licenses must be imported after the installation.
  9. Select the ARIS Publisher Server to be installed. A Report Server can only be installed on another machine. This is to optimize system performance when running reports.
  10. If you retain the settings of the installation program, the context path and the default port 14500 to the web server are entered automatically. Either make sure that the default port is not used by other programs, or enter another free port number.
  11. If you use Process Governance please specify the IP address or fully-qualified ARIS Server name. Enter the port number only if it is another than the standard port.

    The Process Governance module and the Start governance process pop-up menu are only available in the Publisher exports if a Process Governance license is available for the connected ARIS Server and all Process Governance integration parameters have been entered during the ARIS Publisher Server setup process.

  12. To use the user and license management of another ARIS Server, select Use the ARIS Administration of an existing ARIS Server.

    Enter the URL to that ARIS Server ARIS Administration:

    http://<IP address or fully-qualified host name>:<load balancer port>/umc

    You must enter the port number only if you have changed or redirected the standard port.

    Enter the ARIS Administration user name superuser and the corresponding password. You can also enter encrypted passwords.

  13. If you are about to manage documents using ARIS document storage of another ARIS Server, enter the required parameters. Only in this case ARIS document storage will be available if customized.
  14. Select the Medium or Large installation option. You need to take the memory requirement into account to ensure optimum load distribution and better protection against failure.
  15. Select Oracle as database system.
  16. Select the required JDBC driver for the Oracle database management system.
  17. Enter the connection parameters you have defined while creating the Oracle database.
  18. Start the installation process.

This process takes some time. Settings entered during the setup process can be adjusted, such as standard database connection parameters. Use the reconfigure ACC command (see ARIS Cloud Controller (ACC) Command-Line Tool.pdf) to change settings. After the ARIS Server installation has completed, you must check the installation and configure the system.

After the installation, reports are run by ARIS Publisher Server. You can additionally install a Report Server to optimize system performance when running reports. To install ARIS Publisher Report Server, start this setup again and select the ARIS Publisher Report Server to be installed. After you have installed ARIS Publisher Report Server, exports are managed by ARIS Publisher Server and reports are run by ARIS Publisher Report Server.

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.