ARIS Server Installation and Administration Guide - 0 PDF

Server Installation and Administration
Guide
ARIS
Version 9.6
April 2014
This document applies to ARIS Version 9.6 and to all subsequent releases. Specifications
contained herein are subject to change and these changes will be reported in subsequent release
notes or new editions.
Copyright © 2010 - 2014 Software AG, Darmstadt, Germany and/or Software AG USA Inc.,
Reston, VA, USA, and/or its subsidiaries and/or its affiliates and/or their licensors.
The name Software AG and all Software AG product names are either trademarks or registered
trademarks of Software AG and/or Software AG USA Inc. and/or its subsidiaries and/or its
affiliates and/or their licensors. Other company and product names mentioned herein may be
trademarks of their respective owners. Detailed information on trademarks and patents owned by
Software AG and/or its subsidiaries is located at http://documentation.softwareag.com/legal/.
Use of this software is subject to adherence to Software AG's licensing conditions and terms.
These terms are part of the product documentation, located at
http://documentation.softwareag.com/legal/ and/or in the root installation directory of the
licensed product(s).
This software may include portions of third-party products. For third-party copyright notices and
license terms, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party
Products". This document is part of the product documentation, located at
http://documentation.softwareag.com/legal/ and/or in the root installation directory of the
licensed product(s).
Server Installation and Administration Guide
Contents
1 General Notices .................................................................................................... 1
2 Installation ........................................................................................................... 2
2.1 Available Setups .......................................................................................... 3
2.1.1 ARIS Connect Server Installation (Windows Operating System)............. 5
2.1.2 ARIS Design Server Standalone Installation (Windows Operating
System) ........................................................................................... 9
2.1.3 ARIS Risk & Compliance Manager Server Installation (Windows
Operating System) .......................................................................... 12
2.1.4 ARIS Publisher Server Installation (Windows Operating System) ......... 14
2.1.5 ARIS Remote Installations (Windows Operating System) ...................... 16
2.1.6 Installing ARIS on a Linux Operating System ...................................... 17
2.2 Using Oracle or Microsoft SQL Server instead of the Standard Database
System .................................................................................................... 19
2.2.1 Customize the Oracle Database ........................................................ 19
2.2.2 Customize the Microsoft SQL Server System ....................................... 21
2.3 Using Oracle or Microsoft SQL Server for ARIS Publisher Server ...................... 26
2.3.1 Use Oracle Database (Tomcat).......................................................... 26
2.3.2 Use Microsoft SQL Database ............................................................. 29
2.3.3 Change Database Connection Parameters .......................................... 31
2.4 Update Installation .................................................................................... 32
2.5 Back up and Restore Data .......................................................................... 35
3 Tenant Management ............................................................................................ 37
4 User and License Management .............................................................................. 38

4.1 Log into the Administration as superuser ...................................................... 39
4.2 Change Passwords ..................................................................................... 40
4.3 Import License .......................................................................................... 40
4.4 Create Users ............................................................................................. 41
4.5 Create Users Groups .................................................................................. 42
4.6 Import Users and User Groups from LDAP .................................................... 42
4.7 Assign Users to User Groups ....................................................................... 43
4.8 Assign Privileges ........................................................................................ 43
4.9 Start ARIS ................................................................................................ 44
4.10 Create Databases ...................................................................................... 44
4.11 Assign Database specific Privileges and Pilters ............................................... 44
4.12 What License and Function Privileges can be Assigned? .................................. 46
4.12.1 License Privileges ............................................................................ 46
4.12.2 Function Privileges within the Administration ...................................... 48
4.12.3 Function Privileges within ARIS ......................................................... 49
5 Customizing ....................................................................................................... 51
5.1 Administration Tools .................................................................................. 51
5.1.1 Administration ................................................................................ 51
5.1.2 Command Line Tools for the Administration ........................................ 52
5.1.3 ARIS Cloud Controller (ACC) ............................................................. 61
5.1.4 ARIS Server Administrator .............................................................. 101
I
5.2 Logging ................................................................................................... 102

5.3 Configure Single Sign-On........................................................................... 103
5.4 ARIS Connect ........................................................................................... 109
5.5 ARIS Publisher/ARIS IT Inventory ............................................................... 109
5.5.1 IT Inventory - User Management, License and Permissions.................. 109
5.5.2 Modify Configuration....................................................................... 110
5.5.3 Logging ........................................................................................ 119
5.6 Process Governance .................................................................................. 120
5.6.1 Provide Executable Governance Process ............................................ 120
5.6.2 ARIS Process Board ........................................................................ 120
5.7 Process-driven Management for SAP® Solutions........................................... 124
5.7.1 Required Software/SAP® systems .................................................... 124
5.7.2 Requirements and privileges in the SAP® system ............................. 125
5.7.3 Provide SAP® JCo for Process-driven Management for SAP® Solutions
................................................................................................... 128
5.7.4 Provide SAP® JCo for Download Clients ............................................ 129
5.7.5 Provide SAP® JCo for Locally Installed Clients ................................... 130
5.7.6 Provide SAP® JCo for server LOCAL ................................................. 131
5.7.7 Customizing Features ..................................................................... 131
6 Data migration from ARIS version 9.x to ARIS version 9.6 ...................................... 147
7 Data Migration from ARIS version 7.2 to ARIS version 9.x ....................................... 148
7.1 Migration of ARIS with a Local User Administration ....................................... 148
7.2 Migration of ARIS with LDAP Integration ...................................................... 149
7.3 Migration of ARIS with Process Governance without Central User
Management ............................................................................................ 149
7.4 Migration of ARIS with Process Governance with Central User Management ... 150
7.5 Migration of ARIS document storage Data .................................................... 150
7.6 Migration of Databases, Configuration Elements and Scripts........................... 151
8 Notes on Data Security Observance ...................................................................... 152

8.1 Server Administrator ................................................................................. 152
8.2 ARIS Administrator ................................................................................... 155
9 Basic Troubleshooting ......................................................................................... 156

9.1 No Access to ARIS .................................................................................... 156
9.2 ARIS clients Cannot Perform Connections to Servers Using SSL ...................... 156
9.3 Server Started but No Access to ARIS ......................................................... 157
9.4 Components do Not Start .......................................................................... 157
9.5 Resolving Port Conflicts ............................................................................. 157
10 Known Restrictions ............................................................................................. 159

10.1 Update Setup ........................................................................................... 159
10.2 Process Governance .................................................................................. 159
10.3 Right-to-left (RTL) .................................................................................... 160
10.4 Tenant Names .......................................................................................... 160
11 Support ............................................................................................................ 161
12 Glossary ........................................................................................................... 162
II
1 General Notices
This manual describes the settings and features as they were at the time of print.
In this document, file names and user-defined content are formatted and identified as follows:
 File names, keyboard entries etc. are shown in bold.
 Entries with user-defined content are highlighted in <bold and enclosed in angle
brackets>.
 Optional ACC command parameters are highlighted in (round brackets followed by)?
Warnings are highlighted.

Since manual and software are subject to different production cycles, the description of settings
and features may differ from actual settings and features. Information about discrepancies is
provided in the Readme file that accompanies the product. Please read this file and take the
information into account when installing, setting up, and using the product.
In general, it is advisable to use up-to-date hardware taking into account the number of users
who will be accessing the ARIS. For information about hardware and software requirements,
please refer to the ARIS Platform Matrix document (see installation media or download it
http://aris.softwareag.com/ARISDownloadCenter/ADCDocumentationServer).
Please consider the legal notices http://documentation.softwareag.com/legal/.
If you are about to install all technical and/or business system functions without the services of
Software AG, you require extensive knowledge of the system to be installed, its intended
purpose, the target systems, and their various dependencies. Due to the number of platforms and
interdependent hardware and software configurations, we can only describe specific installations.
It is not possible to document all settings and dependencies.
When you combine various technologies, please observe the manufacturers' instructions,
particularly announcements concerning releases on their Internet pages. We cannot guarantee
proper functioning and installation of approved third-party systems and do not support them.
Always follow the instructions provided in the installation manuals of the relevant manufacturers.
If you experience difficulties, please contact the relevant manufacturer.
If you need help installing third-party systems, please contact your local Software AG sales
organization (https://empower.softwareag.com). Please note that this type of
manufacturer-specific or customer-specific change 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.
1
2 Installation
This chapter describes all one-node server installation procedures using the setup programs.
For all other installation scenarios e.g. multi-node systems for a larger distributed scenario and
higher availability please contact your local Software AG sales organization (page 161).
To avoid redundancies this document does not re-iterate information available in other
documents. For more details please review the following documents (see installation media or
download them http://aris.softwareag.com/ARISDownloadCenter/ADCDocumentationServer):
 For information about hardware and software requirements, please refer to the ARIS
Platform Matrix document
 The client installation is described in the ARIS Client Installation Guide.
 For an overview on features and functionalities, please refer to the Product Functionality
Matrix document
 For an overview on supported interfaces, methods, languages, and compatibilities, please
refer to the Technical Product Matrix document

Depending on the desired installation scenario, you first need to customize your database
management system. If you use the standard database system just run the setup programs to
install the servers you require. It is assumed that you perform the installation using the start.exe
startup file as an administrator. You can also start individual installation programs via the
corresponding Setup.exe.
If you are about to use all ARIS server types in your system, ARIS Connect Server, ARIS Design
Server, ARIS Publisher Server and ARIS Risk & Compliance Manager Server must be installed on
different machines. You can only install one server on one machine.
ARIS Agent must be provided for Linux systems (page 17). For local installations under Windows
ARIS Agent will be installed automatically. To perform remote installations (page 16) please first
run the ARIS Agent setup on the remote servers.
Please refer to the chapter Administration (page 51) to obtain information on additional settings
required for using ARIS.
2
2.1 Available Setups

ARIS Connect Server Setup (page 5)
This setup will install ARIS Agent, ARIS Connect Server containing ARIS Design Server,
standard database system, ARIS Connect Viewer, ARIS Connect Designer and ARIS
download clients and provide the default tenant. The functionalities ARIS Connect
workflows‚ Share model, Change request and Approve model are available using an ARIS
Connect Server license. For full ARIS Process Governance functionality you need to purchase and
import an ARIS Process Governance Server license.
The installation procedures are available for a Windows operating system (page 5) or a Linux
operating system (page 17). If you use your Oracle database system or your Microsoft SQL
database system please make sure to customize your operating database system (page 19)
before starting the ARIS setup.
Please install an ARIS Client if you would like to manage server data using ARIS Server
Administrator (page 101).
ARIS Design Server Setup (standalone) (page 9)
This setup will install ARIS Agent, ARIS Design Server, standard database system and
ARIS download clients and provide the default tenant.
The installation procedure is available for a Windows operating system (page 9) or a Linux
operating system (page 17). If you would like to use your Oracle database system or your
Microsoft SQL database system you need to configure your operating database system (page 19)
ARIS Risk & Compliance Manager Server Setup (page 12)
This setup will install ARIS Agent, ARIS Risk & Compliance Manager Server and ARIS
document storage.
The installation procedure is available for a Windows operating system (page 14). If you would
like to use your Oracle database system or your Microsoft SQL database system you need to
configure your operating database system (page 19) before starting the ARIS setup.
If you are using ARIS Risk & Compliance Manager already you can connect the existing ARIS
document storage and the ARIS Risk & Compliance Manager User Management to the active ARIS
Connect Server or ARIS Design Server.
ARIS Publisher Server Setup (page 14)
This setup will install ARIS Agent and ARIS Publisher Server.
operating system (page 17).
3
The standard installation uses a Derby database system and Apache Tomcat Web Application
Server. With this test system, only one user can access a Publisher export. Swim lane models
cannot be exported using a Derby database. If you are installing ARIS Publisher Server on a Linux
operating system you cannot use a Derby database.
For a productive system, a larger number of users and on a Linux system, you need an Oracle
database system or a Microsoft SQL database system that must be configured for ARIS
Publisher Server (page 26) before starting the ARIS setup. These systems are not included in the
package. Depending on the ARIS Publisher Server license purchased (page 116), these systems
enable all users to simultaneously work on exports.
For demonstration reasons (laptop) we also recommend the ARIS client installation including the
server LOCAL (see Client Installation Guide).
Installing ARIS on a Linux Operating System (page 17)
Before installing ARIS Connect Server, ARIS Design Server or ARIS Publisher Server on a Linux
operating system you must provide ARIS Agent to your Linux Debian or Red Hat system. To allow
customizing activities additionally provide ARIS Cloud Controller (ACC). Use the *.deb files for
Debian systems and *.rpm files for Red Hat systems. After you have copied and installed the files
start the remote installation from a Windows system.
4
2.1.1 ARIS Connect Server Installation

(Windows Operating System)
This procedure describes the installation that can be performed under a Windows operating
system. To perform remote installations (page 16) please first run the ARIS Agent setup on the
remote servers.
This setup will install ARIS Agent, ARIS Connect Server containing ARIS Design Server,
standard database system, ARIS Connect Viewer, ARIS Connect Designer and ARIS
download clients and provide the default tenant. The functionalities ARIS Connect
workflows‚ Share model, Change request and Approve model are available using an ARIS
Connect Server license. For full ARIS Process Governance functionality you need to purchase and
import an ARIS Process Governance Server license.
The installation procedures are available for a Windows operating system (page 5) or a Linux
operating system (page 17). If you use your Oracle database system or your Microsoft SQL
database system please make sure to customize your operating database system (page 19)
If you run report scripts that process large quantities of database items, we recommend a 64-bit
Windows installation. In general, it is advisable to use up-to-date hardware taking into account
the number of users who will be accessing the ARIS. For information about hardware and
software requirements, please refer to the ARIS Platform Matrix document (see installation
media or download it
Prerequisites
If you would like to import the license file right now please make sure to have the file saved on
this computer. Otherwise the license must be imported using the Administration.
Procedure
1. Start the ARIS Connect Server installation.
2. Install ARIS Connect Server on the active computer.
3. Specify the port numbers to be used.
4. 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 to ensure optimum load
distribution and better protection against failure. For a productive system it is recommended
to select the Medium number of users or High number of users option.
For demonstration reasons (laptop) we recommend the option Small number of users.
(page 78)
5
5. Select the database system. If you do not check Standard please make sure the database
system has been customized (page 19) before running this setup.
6. After the database system has been customized, select the database management system
and the JDBC driver.
7. Enter the connection parameters. Please use the database name, the application user and the
schema names selected during customizing.
ORACLE (page 21)
6
Microsoft SQL (page 24)
8. Enter the SMTP mail processing parameters.

If you do not do so ARIS will not work properly due to the missing mailing functionality.
You can configure SMTP mail processing (page 76) any time. Some parameters can also be
edited in the Administration (page 51) of this server. Please refer to the Administration online
help.
9. Only if your mail server requires SMTP authentication check the option SMTP authentication
and enter user name and password.
If you enter these parameters but your mail server does not require SMTP authentication, the
connection will be rejected.
10. If you are about to use a proxy server please enter all proxy processing parameters. They can
also be entered using the Administration (page 51) of this server. Please refer to the
Administration online help.
11. Start the installation process.
12. Once after the installation process is completed configure the system (page 51).
13. Click Start > All Programs > ARIS > Administration > Start ARIS Connect Server. This
process will take a while. You can monitor the start process.
14. Click Start > All Programs > ARIS > Administration > Start ARIS Cloud Controller and
enter list to check the status of the processes.
15. After ARIS Connect is running open your browser and enter localhost/umc or <IP address
or fully-qualified host name>/umc. The login dialog opens.
16. Enter the user name superuser and the password superuser. The administration opens.
7
17. Click Logout.

18. Send the URL <IP address or fully-qualified host name>/umc to the ARIS administrator.
ARIS Connect Server is installed, customized and running.
You can stop ARIS Connect server using the Stop ARIS Connect Server link in the Windows
start menu or enter stopall in the ARIS Cloud Controller.
The administrator must import licenses, create users and user groups and assign privileges and
licenses (page 38) for the default tenant. If you have created additional tenants (page 37) users
and licenses must be manages for each tenant. If an ARIS Design Server license is imported
instead of an ARIS Connect license, ARIS Connect functionality will not available.
Update installations are available (page 32). Components will be stopped. After the system has
been updated all components will be started automatically.
8
2.1.2 ARIS Design Server Standalone Installation

remote servers.
This setup will install ARIS Agent, ARIS Design Server, standard database system and
ARIS download clients and provide the default tenant.
operating system (page 17). If you would like to use your Oracle database system or your
Microsoft SQL database system you need to configure your operating database system (page 19)
If you run report scripts that process large quantities of database items, we recommend a 64-bit
Windows installation. In general, it is advisable to use up-to-date hardware taking into account
the number of users who will be accessing the ARIS. For information about hardware and
software requirements, please refer to the ARIS Platform Matrix document (see installation
media or download it
Prerequisites
this computer. Otherwise the license must be imported using the Administration.
Procedure
1. Start the ARIS Design Server installation.
2. Install ARIS Design Server on the active computer.
3. Specify the port numbers to be used.
4. 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 to ensure optimum load
distribution and better protection against failure. For a productive system it is recommended
to select the Medium number of users or High number of users option.
For demonstration reasons (laptop) we recommend the option Small number of users.
(page 78)
5. Select the database system. If you do not check Standard please make sure the database
system has been customized (page 19) before running this setup.
6. After the database system has been customized, select the database management system
9
7. Enter the connection parameters. Please use the database name, the application user and the
schema names selected during customizing.
ORACLE (page 21)
Microsoft SQL (page 24)
8. Enter the SMTP mail processing parameters.

If you do not do so ARIS will not work properly due to the missing mailing functionality.
10
You can configure SMTP mail processing (page 76) any time. Some parameters can also be
edited in the Administration (page 51) of this server. Please refer to the Administration online
help.
9. Only if your mail server requires SMTP authentication check the option SMTP authentication
and enter user name and password.
If you enter these parameters but your mail server does not require SMTP authentication, the
connection will be rejected.
10. If you are about to use a proxy server please enter all proxy processing parameters. They can
also be entered using the Administration (page 51) of this server. Please refer to the
Administration online help.
13. Click Start > All Programs > ARIS > Administration > Start ARIS Design Server. This
process will take a while.
15. After <abs> is running open your browser and enter localhost/umc or <IP address or
fully-qualified host name>/umc. The login dialog opens.
17. Click Logout.
The ARIS Design Server is installed, customized and running.
You can stop ARIS Design Server using the Stop ARIS Design Server link in the Windows start
menu or enter stopall in the ARIS Cloud Controller.
and licenses must be manages for each tenant.
11
2.1.3 ARIS Risk & Compliance Manager Server Installation (Windows

Operating System)
remote servers.
This setup will install ARIS Agent, ARIS Risk & Compliance Manager Server and ARIS
document storage.
The installation procedure is available for a Windows operating system (page 14). If you would
like to use your Oracle database system or your Microsoft SQL database system you need to
configure your operating database system (page 19) before starting the ARIS setup.
If you require different installations, please refer to your local Software AG sales organization
(page 161). Please note that this type of manufacturer-specific or customer-specific change 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.
Prerequisites
this computer.
Procedure
1. Perform the ARIS Risk & Compliance Manager Server installation.
2. Install the server on the active computer.
3. Select the modeling approach you wish to install for ARIS Risk & Compliance Manager.
Attention: You cannot change the modeling approach after installation is complete.
4. If you change the default port numbers please enter free numbers to prevent port conflicts
(page 157).
5. Specify the mail server parameters for outgoing mails. Enter the name of the mail server and
the default e-mail address, if this information is already available.
6. If you enable the event processing and enter all server parameters ARIS Risk & Compliance
Manager will receive e.g. WebMethods events and handle them.
7. Select the database system. If you do not check Standard please make sure to have the
database system customized (page 19) before running this setup.
8. Select the suitable installation option. You need to take the memory requirement into account
to ensure optimum load distribution and better protection against failure.
12
The option Small reserves 1 GB for the application.

The option Medium reserves 4 GB for the application.
The option Large reserves 24 GB for the application.
10. Once after the installation process is completed click Start > All Programs > ARIS >
Administration > Start ARIS Risk & Compliance Manager. This process will take a while.
11. After ARIS Risk & Compliance Manager Server is running open your browser and enter
localhost/umc or <IP address or fully-qualified host name>/umc. The login dialog
opens.
12. Enter the user name system and the password manager. The administration opens.
13. Click Logout.
ARIS Risk & Compliance Manager Server is installed and running.
You can stop the server using the Stop ARIS Risk & Compliance Manager link in the Windows
start menu.
If you already use ARIS Connect and have installed ARIS Risk & Compliance Manager later you
can reconfigure (page 77) your ARIS Risk & Compliance Manager component to your productive
ARIS Connect Server or ARIS Design Server installation. This will make ARIS Risk & Compliance
Manager available for all users of your productive system and only one ARIS document storage
will be in use.
13
2.1.4 ARIS Publisher Server Installation

remote servers.
This setup will install ARIS Agent and ARIS Publisher Server.
operating system (page 17).
The standard installation uses a Derby database system and Apache Tomcat Web Application
Server. With this test system, only one user can access a Publisher export. Swim lane models
cannot be exported using a Derby database. If you are installing ARIS Publisher Server on a Linux
operating system you cannot use a Derby database.
For a productive system, a larger number of users and on a Linux system, you need an Oracle
database system or a Microsoft SQL database system that must be configured for ARIS
Publisher Server (page 26) before starting the ARIS setup. These systems are not included in the
package. Depending on the ARIS Publisher Server license purchased (page 116), these systems
enable all users to simultaneously work on exports.
For demonstration reasons (laptop) we also recommend the ARIS client installation including the
server LOCAL (see Client Installation Guide). If you are about to use your Oracle database
system or your Microsoft SQL database system you need to configure your operating database
system (page 26) before starting the ARIS setup.
If you require different installations, please refer to your local Software AG sales organization
(page 161). Please note that this type of manufacturer-specific or customer-specific change 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.
Prerequisites
Make sure to have the ARIS Publisher Server license file saved on this computer.
Procedure
1. Perform the ARIS Publisher Server installation.
2. Install ARIS Publisher Server on the active computer.
3. Select the ARIS Publisher Server to be installed.
14
4. If you retain the settings of the installation program, the context path and the free port
(19990) to the web server are entered automatically.
5. Select the suitable installation option. You need to take the memory requirement into account
to ensure optimum load distribution and better protection against failure.
The option Small is recommended for a single installation for demonstration purposes e. g. on
a laptop (32-bit VM; 1 GB for the application, 256MB for Derby).
The option Medium reserves 3 GB for the application and 512MB for Derby. The use of Oracle
or Microsoft SQL Server is recommended.
The option Large reserves 8 GB for the application and 1 GB for Derby. The use of Oracle or
Microsoft SQL Server is obligatory.
6. If you use Process Governance please specify the integration parameters.
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 Connect Server or ARIS Design Server and all Process Governance integration
parameters have been entered during the ARIS Publisher Server setup process.
7. Select the database system. If you do not check Standard please make sure to have the
database system customized (page 19) before running this setup.
10. Click Start > All Programs > ARIS > Start ARIS Publisher Server.
11. After ARIS Publisher Server is running open your browser and enter http://<IP address or
fully-qualified host name>:<port number>/businesspublisher, e.g.
http://arispublishersrv:19990/businesspublisher.
12. Start the Administration (page 39) of the ARIS Connect Server or ARIS Design Server and
import the ARIS Publisher Server license file.
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 an 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.
If you already use ARIS Connect or ARIS Design Server and have installed ARIS Publisher Server
later you can force ARIS Publisher Server to use the Administration of your productive ARIS
Connect Server or ARIS Design Server (page 111) installation. Only in this case ARIS document
storage will be available if customized (page 113).
You may change the standard database connection parameters (page 31).
15
2.1.5 ARIS Remote Installations (Windows Operating System)

Before installing servers remotely on a Windows operating system or a Linux operating system
you must provide ARIS Agent to your remote servers.
Procedure
1. Start the ARIS Agent setup on the server that will be used for remote installation. Tis will
provide ARIS Cloud Controller (ACC) (page 61) on this machine.
2. Start the server installation from any Windows system.
3. Select the remote installation option and enter the name of the remote server.
4. If you have changed the remote access password (page 67) you must enter the new password
using the option Enter changed remote access password.
6. Start the server (Start > All Programs > ARIS > Administration). This process will take
a while.
8. After the server is running open your browser and enter <IP address or fully-qualified
host name>/umc. The login dialog opens.
10. Click Logout.
The Server is installed, customized and running.
You can stop enter stopall in the ARIS Cloud Controller.
16
2.1.6 Installing ARIS on a Linux Operating System

Before installing ARIS Connect Server, ARIS Design Server or ARIS Publisher Server on a Linux
operating system you must provide ARIS Agent to your Linux Debian or Red Hat system. To allow
customizing activities additionally provide ARIS Cloud Controller (ACC). Use the *.deb files for
Debian systems and *.rpm files for Red Hat systems. After you have copied and installed the files
start the remote installation from a Windows system.
In RedHat and centos 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
aris soft nofile $max_file_max
aris hard nofile $max_file_max
aris soft nproc unlimited
aris hard nproc unlimited
 /etc/pam.d/su
session required pam_limits.so

As the internal ARIS user running all components has no root privileges all privileged ports
(<1024) cannot be used. To run ARIS under a privileged port you need to redirect the ports (page
66).
Procedure
1. Copy the file aris-cloud-agent_1.0.0-SNAPSHOT_amd64.deb or
aris-cloud-agent-1.0.0-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 ARIS Connect Server
or ARIS Design Server installation.
2. To allow enhanced customizing of ARIS copy the file
aris-acc_1.0.0-SNAPSHOT_amd64.deb or aris-cloud-agent-1.0.0-1.x86_64.rpm
from the installation media to the hard drive of your Linux system.
This file provides ARIS Cloud Controller (ACC) (page 61).
3. Depending on the files you have copied and the type of the Linux system enter the relevant
command to install the files:
dpkg –i aris-cloud-agent_1.0.0-SNAPSHOT_amd64.deb
This command installs ARIS Agent to your Debian system.
dpkg –i aris-acc_1.0.0-SNAPSHOT_amd64.deb
17
This command installs ARIS Cloud Controller (/bin/acc.sh) to your Debian system.
rpm –i aris-cloud-agent-1.0.0-1.x86_64.rpm
This command installs ARIS Agent to your Red Hat system.
rpm –i aris-acc-1.0.0-1.x86_64.rpm
This command installs ARIS Cloud Controller (/bin/acc.sh) to your Red Hat system.
4. If you are not about to use the standard database system, please make sure to customize your
Oracle or Microsoft SQL database system (page 19) before starting the ARIS Server
installation. For an ARIS Publisher Server installation the customizing is mandatory as the
standard database system Derby cannot be used.
5. Start the installation of ARIS Connect Server (page 5), ARIS Design Server (page 9) or ARIS
Publisher Server (page 14) from a Windows system.
6. Select the remote installation option and enter the name of your Linux system.
7. If you have changed the remote access password (page 67) you must enter the new password
using the option Enter changed remote access password.
9. Start ARIS Cloud Controller (acc.sh) and enter startall. This process will take a while.
10. Enter list to check the status of all components.
11. After all processes are running open your browser and enter localhost/umc or <IP address
or fully-qualified host name>/umc. The login dialog opens.
12. Enter the user name system and the password manager. The administration opens.
13. Click Logout.
The ARIS Server is installed, customized and running.
You can stop enter stopall in the ARIS Cloud Controller.
The ARIS administrator should immediately change the password superuser to prevent
unauthorized access. The name superuser cannot be changed. Also the password manager of
the system user system should be changed.
To uninstall ARIS from a Debian system enter dpkg –-purge aris-acc or dpkg –-purge
aris-cloud-agent. To uninstall ARIS from a Ret Hat system enter rpm –e aris-acc or rpm –e
aris-cloud-agent.
18
2.2 Using Oracle or Microsoft SQL Server instead of the Standard

Database System
Please customize the Oracle (page 19) or the Microsoft SQL Server (page 21) database
management system before starting one of the following server setups:
 ARIS Connect Server setup (page 5)
 ARIS Design Server setup (page 9)
 ARIS Risk & Compliance Manager Server setup (page 12)
 Update setup (page 32)
Before performing an ARIS Publisher Server setup please customize the Oracle (page 26) or the
Microsoft SQL Server (page 29) database management system for ARIS Publisher Server.
2.2.1 Customize the Oracle Database

In this chapter the customizing of an Oracle database is described for a Microsoft Windows
operating system. To customize the system on a Linux operating system please use the sh files
instead of the bat files.
If you run ARIS based on Oracle as the database management system, you need to create an
application user (page 21) and create an empty schema for each tenant (page 21) before starting
the ARIS Server setup (page 2).
If you need help in setting up your database system, please contact Software AG
(https://empower.softwareag.com). 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. For information about hardware and software requirements,
To customize the system you need the following components:
 An operating Oracle database.
 The ojdbc6.jar driver. You can download this driver from the Oracle Web Site to a directory of
your choice.
 SQL scripts and all additional files. These scripts and files are located on the installation
medium (Add-ons\DatabaseScripts\Oracle) or they can be downloaded from the ARIS
Download Center
(aris.softwareag.com/ARISDownloadCenter/ARISDownloadCenter?language=en).
 Ensure that SQL*PLUS is available.
19
Warning
If you are about to update your ARIS 9.x version using an Oracle database you must upgrade
your database schema first before starting the server. Otherwise your runtime environment and
data might be harmed and the application may not work anymore.
To do so please use the files on you installation medium under
Add-ons\DatabaseScripts\Oracle\Design&ConnectServer. Base requirement for this
configuration is a correct configured envset.bat.
Execute the cip_update_schema_for_tenant.bat file for MS Windows operating system or
cip_update_schema_for_tenant.sh file for a Unix operating system.
This has to be executed for each tenant separately. Call the file directly on a computer where an
Oracle client is installed in the following syntax:
cip_update_schema_for_tenant.bat <tenant_name>, e.g.
cip_update_schema_for_tenant.bat default
or
cip_update_schema_for_tenant.bat myprojecttenant.
2.2.1.1 Configure envset.bat

Before you create an application user (page 21) and create an empty schema (page 21) to store
the data of one tenant each you may change the default settings.
1. Edit the file envset.bat to specify the connection data of the Oracle instance:
SET CIP_ORA_BIN_PATH=<path to sqlplus.exe>
SET TARGET_HOST=<target_>host> (fully qualified name or IP address)
SET TARGET_PORT=<target_port> (e.g. 1521)
SET TARGET_SERVICE_NAME=<target_service_name> (e.g. the database name ARIS)
2. Edit the following line to change the name of the application user:
SET CIP_APP_USER=ARIS9
SET CIP_APP_PWD=*ARIS!1dm9n#
SET CIP_TENANT_SCHEMA_PWD=*ARIS!1dm9n#yy
3. With the next two lines you specify the DBA user:
SET CIP_INSTALL_USER=system
SET CIP_INSTALL_PWD=manager
4. If your data table space name is different from ARISDATA respectively TEMP for temp table
space, then edit these lines:
SET CIP_TS_DATA=ARISDATA
SET CIP_TS_TEMP=TEMP
After you have saved the changes you can create the application user (page 21).
20
2.2.1.2 Create the Application User

The application user is the oracle user connecting ARIS and the Oracle database. The default user
name is ARIS9. You can change the user name and the password. Therefore you need to
configure the envset.bat (page 20) file before creating the application user.
Run the script cip_create_app_user.bat.
The application user has been created.
This user name and the corresponding password be must be entered during the ARIS Server
setup (page 2) process.
2.2.1.3 Create an Empty Schema for Each Tenant

Two schemes are mandatory. One for the master tenant and one for the default tenant. The
names, e.g .aris_master and aris_default can be modified. The names must be entered later
during the ARIS Server setup (page 2) process. If you need additional tenants (page 37) you
must create additional schemes.
Create the schema objects. Please 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,
e.g.
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 the schema already exists it will be dropped and recreated.
Start the ARIS Server setup (page 2) process, select the database management system ORACLE
After you have set up the schema you need to assign the tenants (page 74) to additionally created
schemes only.
2.2.2 Customize the Microsoft SQL Server System

If you run ARIS Connect Server, ARIS Design Server or ARIS Risk & Compliance Manager Server
based on Microsoft SQL Server as the database management system, you need to configure the
envset.bat file (page 23) and install the database (page 24) using the script files before starting
the ARIS Server setup (page 2). You can also setup the database (page 24) and create an empty
schema for each tenant (page 24) manually.
If you need help in setting up your database system, please contact Software AG
21
you requested and agreed on them. For information about hardware and software requirements,
To customize the system you need the following components:
 An operating Microsoft SQL Server database.
 The Microsoft JDBC Driver sqljdbc4.jar. You can download this driver from the Microsoft Web
Site to a directory of your choice.
 SQL scripts and all additional files. These scripts and files are located on the installation
medium (Add-ons\DatabaseScripts\MSSQL) or they can be downloaded from the ARIS
Download Center
(aris.softwareag.com/ARISDownloadCenter/ARISDownloadCenter?language=en).
22
2.2.2.1 Configure envset.bat

Before you install the database (page 24) to store the data of one tenant each you may change
the default settings.
Edit the file envset.bat to specify the connection data of the Microsoft SQL instance:
REM If you use named instances then append a "\" and the name of your instance
SET MSSQL_SAG_MSSQL_SERVER_NAME=localhost
REM The login name
SET MSSQL_SAG_MSSQL_LOGIN_NAME=localhost\username
SET MSSQL_SAG_DATABASE_NAME=ARIS95DB
SET MSSQL_SAG_FILEGROUP_FILE_DIR=F:\msqldata\ARIS95DB
SET MSSQL_SAG_FILEGROUP_PRIM=%MSSQL_SAG_DATABASE_NAME%PRIM
SET
MSSQL_SAG_FILEGROUP_PRIM_FILE=%MSSQL_SAG_FILEGROUP_FILE_DIR%\%MSSQL_SAG_DATAB
ASE_NAME%PRIM.mdf
SET MSSQL_SAG_FILEGROUP_DATA=%MSSQL_SAG_DATABASE_NAME%DATA
SET
MSSQL_SAG_FILEGROUP_DATA_FILE=%MSSQL_SAG_FILEGROUP_FILE_DIR%\%MSSQL_SAG_DATAB
ASE_NAME%DATA.ndf
SET MSSQL_SAG_FILEGROUP_INDEX=%MSSQL_SAG_DATABASE_NAME%INDEX
SET
MSSQL_SAG_FILEGROUP_INDEX_FILE=%MSSQL_SAG_FILEGROUP_FILE_DIR%\%MSSQL_SAG_DATA
BASE_NAME%INDEX.ndf
SET MSSQL_SAG_FILEGROUP_LOG=%MSSQL_SAG_DATABASE_NAME%LOG
SET
MSSQL_SAG_FILEGROUP_LOG_FILE=%MSSQL_SAG_FILEGROUP_FILE_DIR%\%MSSQL_SAG_DATABA
SE_NAME%LOG.ldf
SET MSSQL_SAG_APP_USER=ARIS9
SET MSSQL_SAG_APP_PWD=*ARIS!1dm9n#
SET MSSQL_SAG_TENANT_DEFAULT=CIP_DEFAULT
SET MSSQL_SAG_TENANT_MASTER=CIP_MASTER
REM
REM The remainder of this script is not intended to get customized.
REM
SET MSSQL_SAG_PARAMS= -b -m 1
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -S %MSSQL_SAG_MSSQL_SERVER_NAME%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v database = %MSSQL_SAG_DATABASE_NAME%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fgprim = %MSSQL_SAG_FILEGROUP_PRIM%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fgdata = %MSSQL_SAG_FILEGROUP_DATA%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fgindex = %MSSQL_SAG_FILEGROUP_INDEX%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fglog = %MSSQL_SAG_FILEGROUP_LOG%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fgprimfile =
"%MSSQL_SAG_FILEGROUP_PRIM_FILE%"
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fgdatafile =
"%MSSQL_SAG_FILEGROUP_DATA_FILE%"
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fgindexfile =
"%MSSQL_SAG_FILEGROUP_INDEX_FILE%"
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v fglogfile =
"%MSSQL_SAG_FILEGROUP_LOG_FILE%"
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v username = %MSSQL_SAG_APP_USER%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v password = %MSSQL_SAG_APP_PWD%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v servername =
%MSSQL_SAG_MSSQL_SERVER_NAME%
SET MSSQL_SAG_PARAMS=%MSSQL_SAG_PARAMS% -v loginname =
%MSSQL_SAG_MSSQL_LOGIN_NAME%
After you have saved the changes, please install the database (page 24).
23
2.2.2.2 Install the Database Automatically

After you have configured the envset.bat file (page 23) you need to execute the inst.bat file.
This will create the database including the two mandatory tenants and the application user.
If you need additional tenants please use the create_schema_for_tenant.bat file. After you
have set up the schema you need to assign the tenants (page 74) to additionally created schemes
only. If you do not use the scripts you can also setup the database (page 24) and create an empty
schema for each tenant manually (page 24).
2.2.2.3 Setup Database Manually

Only if you did not use the envset.bat (page 23) and inst.bat (page 24) files, please setup the
database manually. In this example the database e.g. CIP has been created. Instance and
Database must have a collation with a _CI_ in its name, e.g. Latin1_General_CI_AI.
1. Turn on Snapshot-Isolation and READ COMITTED mode:
ALTER DATABASE CIP SET ALLOW_SNAPSHOT_ISOLATION ON
GO
ALTER DATABASE CIP SET READ_COMMITTED_SNAPSHOT ON
GO
2. Create a login ARIS9 and the user ARIS9 in this database:
CREATE LOGIN ARIS9 WITH PASSWORD=N'*ARIS!1dm9n#', DEFAULT_DATABASE=[CIP]
GO
USE [CIP]
GO
CREATE USER [ARIS9] FOR LOGIN [ARIS9]
GO
2.2.2.4 Create an Empty Schema for Each Tenant Manually

Only if you did not use the envset.bat, inst.bat and the create_schema_for_tenant.bat files,
please create additional schemes manually. Two schemes are mandatory. One for the master
tenant and one for the default tenant. The names, e.g. aris_master and aris_default can be
modified. The names must be entered later during the ARIS Server setup (page 2) process. If you
need additional tenants you must create additional schemes.
Create the schema objects and a user that controls the schemes. The naming convention for that
user is <user name>_<database name>_<schema name>. Grant the privilege to
impersonate on that new schema and user to the user.
Please run these commands for each schema name aris_master, aris_default and additional
tenants.
24
Syntax
USE [<database name>]
GO
CREATE SCHEMA [<database name>_<schema name>]
GO
CREATE USER [<user name>_<database name>_<schema name>] WITHOUT LOGIN
ALTER USER <user name>_<database name>_<schema name> WITH DEFAULT_SCHEMA =
<database name>_<schema name>
GRANT CONTROL ON SCHEMA :: [<database name>_<schema name>] TO [<user
name>_<database name>_<schema name>]GRANT IMPERSONATE ON USER::<user
name>_<database name>__<schema name> TO ARIS9
GRANT CREATE TABLE TO [<user name>_<database name>_<schema name>]
GRANT CREATE VIEW TO [<user name>_<database name>_<schema name>]
GRANT CREATE FUNCTION TO [<user name>_<database name>_<schema name>]
GO
Example
In this example the database CIP is used. The schema name is CIP_MASTER and the user
name is ARIS9.
USE [CIP]
GO
CREATE SCHEMA [CIP_MASTER]
GO
CREATE USER [ARIS9_CIP_MASTER] WITHOUT LOGIN
ALTER USER ARIS9_CIP_MASTER WITH DEFAULT_SCHEMA = CIP_MASTER
GRANT CONTROL ON SCHEMA :: [CIP_MASTER] TO [ARIS9_CIP_MASTER]
GRANT IMPERSONATE ON USER::ARIS9_CIP_MASTER TO ARIS9
GRANT CREATE TABLE TO [ARIS9_CIP_MASTER]
GRANT CREATE VIEW TO [ARIS9_CIP_MASTER]
GRANT CREATE FUNCTION TO [ARIS9_CIP_MASTER]
GO
Start the ARIS Server setup (page 2) process, select the database management system
Microsoft SQL and the JDBC driver.
After you have set up the schema you need to assign the tenants (page 74) to additionally created
schemes.
25
2.3 Using Oracle or Microsoft SQL Server for ARIS Publisher Server
Before performing an ARIS Publisher Server setup please customize the Oracle (page 26) or the
Microsoft SQL Server (page 29) database management system for ARIS Publisher Server.
If you install a database yourself, always follow the instructions provided by the respective
manufacturer, or contact your local Software AG sales organization (page 161). Please consider
the legal notices http://documentation.softwareag.com/legal/.
You may change the database connection parameters (page 31).
2.3.1 Use Oracle Database (Tomcat)

Please adjust your system as required to run ARIS Publisher Server in combination with Apache
Tomcat Web application server and an Oracle database.
Prerequisite
 You have created an Oracle database and configured it as follows. If you install a database
yourself, always follow the instructions provided in the Oracle Installation Guide. We
recommend that you use two separate Oracle databases for ARIS Design Server and ARIS
Publisher. This keeps the two systems from competing for resources, and you achieve better
performance and higher availability.
 Use of the database character set AL32UTF8 is mandatory.
 We recommend a block size of 8K.
 query_rewrite_enabled=true
 query_rewrite_integrity=trusted
 You have created two table spaces: ARISBPDATA (for table data) and ARISBPINDEX (for
index data). To use other names or existing table spaces, you must customize the
configuration file webappserver.cfg (see below). We recommend that you set the table
spaces for automatic, unlimited growth. Otherwise, you run the risk of completely exhausting
the memory in the table spaces, which may cause important functions of ARIS Design Server
and ARIS Publisher to fail. If the option for automatic growth is not set, regular monitoring
(e.g. weekly) of the Oracle instance is required to ensure that the table spaces are manually
increased on time.
 You have created an Oracle user that ARIS Publisher can use to connect to the database. The
name of the Oracle user is assumed to be ARISBP. You can select any password. Enter it -
coded or unencoded - in the configuration file <Installation
path>\server\bin\work\work_businesspublisher_<s, m or
l>\base\webapps\businesspublisher\WEB-INF\Resources.xml (see below). If you prefer
another name, change the name there as well:
CREATE USER ARISBP IDENTIFIED BY ARISBP;
26
 The Oracle user must have the following privileges

GRANT CREATE SESSION TO ARISBP;
GRANT CREATE TABLE TO ARISBP;
GRANT CREATE VIEW TO ARISBP;
GRANT QUERY REWRITE TO ARISBP;
ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPDATA;
ALTER USER ARISBP QUOTA UNLIMITED ON ARISBPINDEX;
 We recommend that you turn off the Oracle recycle bin because large quantities of tables
accumulate there when exports are deleted.
 To encrypt passwords use the ARIS Server Administrator (page 101) command encrypt.
Procedure
1. Open the file Resources.xml in the ARIS Publisher Server installation directory.
2. Ensure that the following entries are specified:
<Context path="/businesspublisher" docBase="installation path>/businesspublisher/"
debug="0" reloadable="false" crossContxt="true">
<Resource name="jdbc/businesspublisherdb" auth="Container"
type="javax.sql.DataSource"
maxActive="30" maxIdle="30" maxWait="1000" initialSize="10"

username="ARISBP" password="ARISBP" 
driverClassName="oracle.jdbc.driver.OracleDriver"
url="jdbc:oracle:thin:@localhost:1521:ARISBP" 
<url proto="http"
location="<Your URL, e. g.
"http://www.ariscommunity.com/group/aris-bpm-blog/feed/teaser">"
proxyAdress="<Your proxy address, e.g. "hades.company.com">"
proxyPort="<Your proxy port>"
refresh="600"/>
</news>
The News area can be customized to meet your requirements. ARIS Customized Solutions will be
pleased to help you with the implementation. For example, you can keep a list of links to the
models or objects that have been changed or created since a specific date.
118
5.5.2.16 Configure views for models

The number of views available to users as links in the Contents module varies according to the
system configuration and model types. Administrators can change the links available for
selection.
If you change configuration files, please note the XML structure. We recommend that you ask
Software AG (https://empower.softwareag.com) to change your configuration.
Procedure
l>/base/webapps/businesspublisher/views/visualisation/default_visualisation.xml and
change the file according to your requirements.
2. Exit and then restart ARIS Publisher Server.
5.5.2.17 Change icons

Icons are used for linked files saved in the icons subdirectory of your ARIS Publisher Server
installation directory. Icons of Microsoft Office products and many other applications and
systems, e.g., Windows system files, Web environment, Acrobat Reader, audio, video, Lotus
Notes, etc., are displayed automatically. For these applications, you do not need any icons in the
directory mentioned above unless you want to use your own icons.
You can change icons or add new ones. To create and edit icons in ICO format, you need a suitable
application. Assign file names that conform to the extension of the relevant application.
To create icons that represent bitmap graphics, Lotus Notes or text files, for example, save the
graphics under the names bmp.ico, nsf.ico, and txt.ico.
5.5.3 Logging
Activities such as imports from ARIS IT Inventory, as well as errors are logged in different files
depending on the component, e.g. inventoryImport-<Version.Build>_0.log. If problems
occur during operation, you can use the log files to find and resolve errors. If you cannot solve the
problems and have a maintenance agreement, please send an error description and the entire
contents of the log and config directories as ZIP files to your local Software AG sales
organization. The log file names and the logging configuration are defined in the file. <ARIS
installation path>/ARIS9.6/server/bin/work/work_businesspublisher_<s, m or l>/base/logs and
/conf.
119
5.6 Process Governance

This chapter describes the configuration of Process Governance.
5.6.1 Provide Executable Governance Process

You can provide executable governace processes for users who use ARIS without Process
Governance extension pack.
Precondition
You have access to a zipped file containing the relevant governance process.
Procedure
Copy the zipped file containing the relevant governance process to the autodeployment folder
on an ARIS Design Server or ARIS Connect server instance.
<ARIS Design Server installation
directory>\server\bin\work\work_apg<number>\base\model
All the tenants of this ARIS Design Server or ARIS Connect server can now use the deployed
governance process.
If you are using several ARIS Design Server or ARIS Connect server instances that should provide
the same governances process, you have to copy this zipped file to the autodeployment folders of
all instances.
Example for an autodepoyment folder

C:\ARIS\server\bin\work\work_apg1\base\model
5.6.2 ARIS Process Board

ARIS Process Board is automatically installed when you install an ARIS Connect server or an ARIS
Design Server.
System requirements
For information about hardware and software requirements, please refer to the ARIS Platform
Matrix document (see installation media or download it
120
5.6.2.1 Configure selectable languages for ARIS Process Board

It is possible to specify which locales are displayed in the list of selectable languages.
Procedure
1. Start (page 61) ARIS Cloud Controller.
2. Stop the relevant runnable, type e.g. stop apg_m.
3. Open the ARIS Process Board configuration file (e.g. <ARIS9.x installation
directory>\server\bin\work\work_apg_m\base\webapps\processboard\WEB-I
NF\tl-configuration.xml).
All supported locales are listed by default in the configuration file.
4. Remove the locales you do not want to use.
 If the configuration file contains the operating system's locale, it will be selected by
default.
 If the configuration file does not contain the operating system's locale, the first locale
specified in the list will be selected.
5. Start the relevant runnable, type e.g. start apg_m.

If the configuration file does not contain any locales, the English (US) locale will be used by
default (the xml locales element is empty).
5.6.2.2 Configure date format

You can format the date to the pattern defined in the locale specific attribute datePattern. In
case the locale specific attribute is not specified, the date format pattern is loaded from the
default date pattern tag of the locale. If both are not defined, the default pattern from the code is
used.
3. Open the ARIS Process Board configuration file (<ARIS9.x installation
directory>\server\bin\work\work_apg_m\base\webapps\processboard\WEB-I
NF\tl-configuration.xml).
All supported locales are listed by default in the configuration file.
4. Define the date pattern for the relevant locale.
You have configured the date format.
121
Example

<locales>
<locale language="en" country="US" name="English (United States)"

datePattern="dd.mm.yyyy" dateTimePattern="dd.mm.yyyy HH:mm:ss" />
<locale language="de" country="DE" name="German (Germany)"
datePattern="dd.mm.yyyy" dateTimePattern="dd.mm.yyyy HH:mm:ss" />
.
.
.
</locales>
5.6.2.3 Customize ARIS Process Board

You can define colors, logos and other styles by changing customizable xml elements in the ARIS
Process Board configuration file tl-configuration.xml.
Procedure
3. Open the <ARIS installation
directory>\server\bin\work\work_apg_<character>\base\webapps\processboa
rd\WEB-INF\tl-configuration.xml file with a text editor, e.g. C:\Program
files\ARIS9.x\server\bin\work\work_apg_m\base\webapps\processboard\WEB
-INF\tl-configuration.xml.
4. Set the element styledeclarations active to true: <styledeclarations active="true">
5. Customize the colors, logos and styles. You can define different customizations for each
tenant. If you do not define a tenant, you customization is used for all tenants. If no
customization is defined, the default colors and styles are used.
Many components can be grouped to special color groups. Constants are introduced to the
XML file to define the color of a complete group of components.
You have defined colors, logos and other styles for ARIS Process Board.
122
5.6.2.4 Call ARIS Process Board

The following URL is used to call ARIS Process Board in the browser:
http://<server name>/processboard
If you have an e-mail integration, this link is automatically sent to a new user when activated. If
you do not use e-mails, you need to communicate the link to all users.
123
5.7 Process-driven Management for SAP® Solutions

To be able to work properly with the products once they have been installed, please note the
following:
 Ensure that the required software and SAP® systems are available (page 124).
 You need SAP® Java Connector (SAP® JCo) (page 128). This connector is used to create an
RFC connection to the SAP® system using SAP® access parameters. For licensing reasons, it
may not be installed automatically.
 When using ARIS Publisher, you must provide SAP® JCo and configure the connection to
SAP® systems (page 111).
 When using installed clients, you must provide SAP® JCo (page 130).
Depending on the features you provide, you must customize the system.
 Use SAP® synchronization (page 131)
 Use customizing transactions/views (page 134)
 Use ARIS Online Guide (page 136)
 Use BI Modeler (page 145)
 Use Publisher exports (page 146)
 Ensure that the users have been created in the SAP® system and have RFC privileges (page
125).
The special SAP® ports sapgw00 3300/tcp and sapdp00 3200/tcp must be enabled in
the Windows Services file of the client computer (C:\Windows/ system32/ drivers/
etc/services). In general, these ports are entered automatically during SAP GUI installation.
 If you use server groups for access (SAP® routers), you need to enter the SAP® ports
manually in consecutive sequence. By default, the syntax for a port number is as follows 3300
plus the <SAP® system number> will be used. If, for example, the system number is 03,
the port number 3303 must be entered. Entries that have not been entered in consecutive
sequence are ignored.
5.7.1 Required Software/SAP® systems

Please ensure that a local SAP GUI for Windows installation exists on all client computers. To run
transactions, you need one of the following SAP systems in one of the following languages:
German (de), English (en), French (fr), Spanish (sp), or Japanese (ja):
 Local SAP GUI for Windows installation, version 7.1 to 7.3
 SAP R/3 4.6 c or d, 4.7
 ECC 5.0/ECC 6.0 (de, en, fr, sp, ja)
 SAP® JCo (page 128) on every client computer ARIS server and download client.
 Transfer the transport requests (synchronization (page 132) and customizing).
124
For Solution Manager synchronization, you also need SAP Java Connector 3.07, or a higher 3.0x
version. It must be installed on your ARIS Design Server or local server.
To perform Solution Manager synchronization, you need SAP Solution Manager, version 4.0, 7.0
or 7.1, with the languages German (de), English (en), French (fr), Spanish (sp), and/or
Japanese (ja). Shortcuts are supported by SAP® synchronization. SAP® Solution Manager
provides these only in version 4.0 SP 15 or higher.
ARIS Online Guide
 Local SAP GUI for Windows installation, version 7.1 to 7.3

 SAP R/3 4.6 c or d, 4.7
 ECC 5.0/ECC 6.0 (de, en, fr, sp, ja)
or SAP® Solution Manager 4.0, 7.0 or 7.1
BI Modeler
The following adjustments are required:

 Transfer the current transport request.
 Ensure that the required software and SAP® systems are available.
System requirements
Please ensure that all computers meet the following requirements:
 Access to SAP BW 7.0 in German (de), English (en), or French (fr)
 The file saplogon.ini is available or SAP GUI for Windows is installed locally (version 7.1 to
7.3)
 The transport request was transferred.
Privileges
The SAP_BW_RFC object is required in the SAP® system. (page 128)
To download query files in PDF format and make them available in ARIS, please share a directory
that ARIS Design Server can also access.
5.7.2 Requirements and privileges in the SAP® system

To guarantee that the data transfer between ARIS and your SAP® systems works properly,
please consider the following points:
 Make sure that the users in the SAP® systems are created and have RFC privileges for the
SAP® synchronization and BI Modeler.
 Make sure that the SAP® ports sapgw00 3300/tcp and sapdp00 3200/tcp are unlocked
in the Services Windows file on the client computer (C:\Windows/ system32/ drivers/ etc/).
This enables RFC access. In general, these ports are entered automatically during SAP® GUI
installation.
125
 If you access via server groups (SAP® router) you need to manually enter the SAP® ports in
consecutive order. The syntax for a port number is 3300 plus the used <SAP® system
number>. If, for example, the system number is 03 you need to enter 3303. Entries that are
not entered in consecutive order are ignored.
5.7.2.1 Privileges for SAP® synchronization

In order for this function to be available you need to assign users to certain roles in the SAP®
system. The users then have the required authorizations. You need to assign the following roles.
 The predefined role SAP_SOLAR01_ALL
 The predefined role SAP_SMSY_ALL
 A role to be defined with RFC privileges
You can create the role to be defined using the PFCG transaction. Assign the authorization
objects S_RFC and S_RFCACL to the role.
Values for authorization object S_RFC
You can see all values to be defined in the following graphic.

Select the Execute activity in the ACTVT section.
The RFC_NAME section shows all names to be entered for the S_RFC authorization object of the
RFC object to be protected. You need to complete the framed entries SDIFRUNTIME, STFC, and
ZIDS/ARIS_SOLAR_001.
126
In the RFC_TYPE section you must select the Function group type.
Values for authorization object S_RFCACL
The S_RFCACL authorization object requires all privileges.
127
5.7.2.2 Privileges for BI Modeler

The following example of an SAP® profile serves as an authorization basis.
5.7.3 Provide SAP® JCo for Process-driven Management for SAP®

Solutions
If you use the SAP® synchronization, BI Modeler or Test Designer you need to provide SAP® JCo
3.0.x containing sapjco3.jar and sapjco3.dll in order to allow the program to connect to the
SAP® systems and provide all functions.
For licensing reasons, files of SAP® JCo may not be automatically installed during installation.
This action will provide sapjco3.jar for download clients, ARIS Design Server and ARIS Connect
Server automatically. Additionally all download client's users must copy the needed sapjco3.dll
file (page 129) to their local machines. For installed clients (page 130) and the server LOCAL
(page 131) the sapjco3.jar file and the sapjco3.dll file must be provided manually.
Procedure
1. Download SAP JCo 3.0.x 32 bit version appropriate for your operating system and for the
runtime environment (JRE) used from the SAP Service Marketplace
(http://service.sap.com/connectors). If you are using a different operating system please
refer to the appropriate download package from SAP AG.
2. Save the zip file, e. g. d:/sapjco30P_9-10005326.zip.
4. Stop ARIS Design Server or ARIS Connect Server or enter stop <InstanceId for the
modeling component> to stop the modeling component abs_s, abs_m or abs_l.
<InstanceId for the modeling component> depends on the system settings of the
installation. To find out the correct entry please enter list and look for one of the entries
abs_s, abs_m or abs_l.
5. Provide sapjco3.jar for download clients and ARIS Design Server/ARIS Connect Server using
this command:
128
enhance <InstanceId for the modeling component> with webappsClasspath local file
<path to the saved zip file>,
e. g.
enhance abs_s with webappsClasspath local file d:/sapjco30P_9-10005326.zip
6. Start <_abs_> or ARIS Connect Server or enter start <InstanceId for the modeling
component> e. g. abs_s, abs_m or abs_l.
sapjco3.jar will be available for download clients, ARIS Design Server and ARIS Connect Server.
All users of download clients must to copy SAP® JCo 3.dll (page 129). Please provide SAP®
JCo for installed clients (page 130) or the server LOCAL (page 131) too.
If you have correctly provided SAP Java Connector SAP JCo 3.0.x but have installed older
runtime libraries of Visual Studio 2005 C/C++, you may have to update
(http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=766a6af7-ec73
-40ff-b072-9112bab119c2) the Microsoft Active Template Library (ATL). Please consider the SAP
notes 1077727 and 1375494 on the SAP Service Marketplace
(http://service.sap.com/connectors).
5.7.4 Provide SAP® JCo for Download Clients

After the sapjco3.jar file was made available for download clients, ARIS Design Server and ARIS
Connect Server (page 128) all download client's users must copy the sapjco3.dll file (page 129)
to their local machines.
Procedure
1. Make sure that a 32-bit JRE version is installed and in use.
3. Copy the file sapjco3.dll next to the Windows operating system libraries.
For information on the Windows operating system, refer to the table below. If you are using a
different operating system, such as Solaris, please refer to the appropriate download package
from SAP AG.
4. Restart the ARIS client.
129

JCo and JRE Windows Processor DLL Windows installation directory

32-Bit 32-Bit x86 sapjco3.dll \system32
32-Bit 64-Bit x86 sapjco3.dll \SysWOW64
5.7.5 Provide SAP® JCo for Locally Installed Clients

Procedure
2. Copy the file sapjco3.dll next to the Windows system libraries. The ARIS client automatically
installs the 32-bit JRE version.
For information on JRE version and Windows system, refer to the table below. If you are using
a different operating system, such as Solaris, please refer to the appropriate download
package from SAP AG.
3. Copy the sapjco3.jar file to the <ARIS installation directory>\client\lib directory.
4. Restart the ARIS client.
sap Jco 3.0.x is available for this installed client. If you intend to use it together with the locally
installed server LOCAL the latter must be provided with the 64-bit version of the SAP®
JCosapjco3 file (page 131) as well.
JCo and JRE Windows Processor DLL Windows installation directory

32-Bit 32-Bit x86 sapjco3.dll \system32
32-Bit 64-Bit x86 sapjco3.dll \SysWOW64
130
5.7.6 Provide SAP® JCo for server LOCAL

If you use installed clients were the sap Jco 3.0.x 32-bit version is already available (page 130),
and you intend to use them together with the locally installed server LOCAL the latter must be
provided with the 64-bit version of the sapjco3.jar file as well.
Procedure
1. Stop the ARIS client.
3. Save the zip file.
4. Extract the sapjco3.jar file to the <ARIS client installation
directory>\LOCALSERVER\bin\work\work_abs_local\base\webapps\abs\WEB-I
NF\lib directory.
5. Copy the 64 bit version oft the sapjco3.dll into the deirectory <Windows installation
directory>-Installationsverzeichn>\system32.
6. Start the ARIS client.
5.7.7 Customizing Features

Depending on the features you provide, you must customize the system.
5.7.7.1 SAP® synchronization

SAP® synchronization is available to you for data synchronization between ARIS and SAP®
Solution Manager in both directions.
 If you want to run the SAP® synchronization you need SAP® Solution Manager and access to
the file saplogon.ini.
131
 Ensure that the current transport request (page 132) has been imported in the SAP® Solution
Manager system that you want to use for synchronization.
 Ensure that the Web services (page 133) for the repository/scenario transfer are enabled in
your SAP® system and properly configured.
5.7.7.1.1 Import transport request (synchronization)

To ensure that SAP® synchronization between ARIS and SAP® Solution Manager is available,
you must import (page 132) the current transport request in the SAP® Solution Manager system.
You find the transport request on the installation media. The function modules are created in the
/IDS/ARIS_SOLAR package.
Procedure
1. Copy the file K<number>.<SAP® system SID> from the installation media to the directory
\sapmnt\trans\cofiles.
2. Copy the file R<number>.<SAP® system SID> from the installation media to the directory
\sapmnt\trans\data. The sapmnt directory usually corresponds to the directory
\usr\sap. If you cannot find the cofiles and data directories under the specified paths, you
can determine the correct path using the DIR_TRANS variable. To do this, log on to the
relevant SAP® Solution Manager system and execute transaction AL11.
To transfer the transport request to the SAP® system using the command line program
TP.EXE, enter the following commands in the specified sequence:
a. TP addtobuffer <SAP® system SID>K<number> [target system SID]
b. TP import <SAP® system SID>K<number> [client on target system]
You can also execute the transport request using the transaction STMS.
Procedure
1. Log on to the relevant SAP® Solution Manager system as system administrator.
2. Execute transaction STMS. This takes you to the Transport Management System.
3. Click Import overview (F5).
4. Double-click the relevant SAP® Solution Manager system. This takes you to the import queue.
5. In the menu, select Extras > Other requests > Add. The Add transport request to
import queue dialog opens.
6. Enter <SAP® system SID>K<number> and confirm. You return to the import overview.
7. Select the transport request.
8. In the menu, select Request > Import. The Import request dialog opens.
132
9. Activate the Options tab and check Ignore invalid component version.
10. Enter the relevant target client and confirm via F8 or Start import.
5.7.7.1.2 Activate Web services

To properly transfer repositories and scenarios from the SAP® system to ARIS databases, you
must enable Web services.
Web services are services that provide functions usually via the Internet protocol http. Web
services are called via URL. A URL consists of a host, a port, and a path (URI) such as
http://solutionmanager:8000/sap/bc/solman/bpr?sap-client=100
Syntax
<protocol type>://<host name>:<port number>/<URI>?sap-client=<CLIENT>
The host name could be solutionmanager, for example. The port number is 8000 and the path
(URI) is /sap/bc/solman/bpr. The client is the SAP® system client.
For SAP® Solution Manager 3.2, you need Support Package 06. Additional information is
available in the SAP® Service Marketplace.
Procedure
1. Start SAP® Solution Manager and call transaction SICF.
2. Right-click default_host > sap > bc > solman, for example, and select Enable service.
When the service is enabled, additional subgroups are visible.
Enabling reveals the URI of the Web service. In this case, it is /sap/bc/solman/bpr. The
protocol type is http. If you right-click bpr and select Display service, the URI is displayed
in the ICF path box and the protocol type on the Service data/Security requirements tab.
The Default option corresponds to the protocol type http, while the SSL option corresponds
to the protocol type https. To use SSL, you need a valid certificate.
133
You can also adjust the URL with the 'External aliases' function
Procedure
1. Start SAP® Solution Manager, and call the SICF transaction.
2. Click the External aliases button.
3. Select a host and create a new external alias (F5). You can adjust the path in the External
alias box.
4. Activate the Service data tab. You can adjust the protocol type in the Security
requirements box.
The Default option corresponds to the protocol type http, while the SSL option corresponds
to the protocol type https. To use SSL, you need a valid certificate.
5. Activate the Target item tab. Select the bpr node for the Business Process Repository. The
previous steps revealed the protocol type and the path of the Web service URL.
6. Call the SMICM transaction to determine the port and host name. To list the available ports,
click Go to > Services in the main menu.
All ports for the different protocol types are displayed. If a protocol is missing or inactive
(Active column), inform your system administrator.
Use this information to form the URL.
5.7.7.2 Start customizing transactions/views

To be able to start customizing transactions and call customizing views from ARIS, you must
import the current transport request into the SAP system. You find the transport request on the
installation media. The function module Z_VIEW_MAINTENANCE_CALL is created in the
function group ZARIS. This function group is assigned to the development class
/IDS/ARIS_ONLINE_GUIDE.
Procedure
1. Copy the file K<number>.<SAP system SID> from the installation media to the directory
2. Copy the file R<number>.<SAP system SID> from the installation media to the directory
\sapmnt\trans\data.
The directory sapmnt normally corresponds to the directory \usr\sap. If you cannot find the
cofiles and data directories under the specified paths, you can determine the correct path
using the DIR_TRANS variable. To do this, log on to the relevant SAP system, and run
transaction AL11.
To transfer the transport request to the SAP system using the command line program TP.EXE,
enter the following commands in the specified sequence:
a. TP addtobuffer <SAP system SID>K<number> [target system SID]
b. TP import <SAP system SID>K<number> [client on target system]
134
You can also execute the transport request using the transaction STMS:
Procedure
1. Log on to the relevant SAP system as a system administrator.
3. Click Import overview.
4. Double-click the relevant SAP system. This takes you to the import queue.
5. In the menu, select Add-ons > Other requests > Append. The Append transport
request to import queue dialog opens.
6. Enter <SAP system SID>K<number> and confirm. You return to the import overview.
135
5.7.7.3 ARIS Online Guide

SAP® system administrators can use ARIS Online Guide to make help on company-specific
transactions available for users of SAP® systems alongside the standard F1 help. For example,
ARIS Online Guide gives you access to documents that were created during customizing or later
to explain complex processes.
 If you plan to use ARIS Online Guide, you must publish your database using ARIS Publisher.
 ARIS Publisher Server must be configured (page 146).
 An executable version of the SAP® GUI and an approved Web browser must be installed.
Once you have executed the client setup and made the created HTML documents available in the
SAP® system, your SAP® system administrator must implement the transactions
/IDS/AOG_ADMIN, /IDS/AOG_USER, and ZEXTHLP in the SAP® system and adapt the Web
server.
To do so, please adjust the following:
1. Import required function modules (page 136).
2. Modify program LSHL2U01 (page 138).
3. Specify settings (page 139).
5.7.7.3.1 Transfer function modules

A transport request is executed to import the required function modules. The current transport
request is located on the installation medium in the directory specified.
Procedure
1. Copy the file K<number>.<SAP® system SID> from the installation media to the directory
2. Copy the file R<number>.<SAP® system SID> from the installation media to the directory
\sapmnt\trans\data. The directory sapmnt normally corresponds to the directory
\usr\sap. If you cannot find the cofiles and data directories under the specified paths, you
can determine the correct path using the DIR_TRANS variable. To do this, log on to the
relevant SAP® system, and run transaction AL11.
To transfer the transport request to the SAP® system using the command line program
TP.EXE, enter the following commands in the specified sequence:
a. TP addtobuffer <SAP® system SID>K<number> [target system SID]
b. TP import <SAP® system SID>K<number> [client on target system]
Procedure
1. Log on to the relevant SAP® system as a system administrator.
136

4. Double-click the relevant SAP® system. This takes you to the import queue.
6. Enter <SAP® system SID>K<number> and confirm. You return to the import overview.
Then assign each of the transactions /IDS/AOG_ADMIN, /IDS/AOG_USER, and
ZEXTHLP a new or existing authorization object.
If you create any new authorization objects, you must include them in suitable authorization
profiles.
137
5.7.7.3.2 Modify program LSHL2U01

After you have imported the required function modules, you must modify the SAP® standard
function HELP_START in program LSHL2U01.
This will provide the F1 help call of ARIS Online Guide. To do this, you need a developer key and
possibly an object key. You can obtain these keys via OSS.
Procedure
1. If required, log on to the relevant SAP® system.
2. Execute transaction SE37.
DATA: l_error_msg LIKE iwerrormsg. " DHB
DATA: l_action LIKE sy-xcode. " *17i
DATA: exit_flg.
DATA: save_help_info_call LIKE help_infos-call.
DATA: ihelpinfo TYPE help_info.
DATA: lv_help_mode TYPE char1.
DATA: lv_window_name TYPE sydatar.
DATA: a_msgv1 LIKE help_infos-msgv1,
a_msgv2 LIKE help_infos-msgv2,
a_msgv3 LIKE help_infos-msgv3,
a_msgv4 LIKE help_infos-msgv4.
* help center
DATA: l_flag_hc_called TYPE as4flag. "note 1135202
*------- CALL MODIFICATION ARIS Online Guide

DATA: loaded TYPE c,
bothhelp TYPE c.
IF help_infos-call CN 'TMV' AND help_infos-call CO 'D' AND help_infos-object

IS NOT INITIAL.
CALL FUNCTION '/IDS/START_ARIS_ONLINE_GUIDE'
EXPORTING
i_program = help_infos-program
IMPORTING
e_help_loaded = loaded
e_both_help = bothhelp.
IF bothhelp NE 'X' AND loaded = 'X'.
EXIT.
ENDIF.
ENDIF.
***************** end of insertion***************
*} INSERT
---Additional code. ---
The F1 help call of ARIS Online Guide is available.
After you have imported support packages into the SAP® system, this modification may be
missing in some cases. The F1 help call of ARIS Online Guide is no longer available then. In this
case, modify LSHL2U01 again.
138
5.7.7.3.3 Specify settings

Once you have imported the required function modules and modified the SAP® standard function
HELP_START, you can use the transactions /IDS/AOG_ADMIN and /IDS/AOG_USER to
specify various settings for the ARIS Online Guide in the SAP® system.
What is the /IDS/AOG_ADMIN transaction used for?
SAP system administrators use the /IDS/AOG_ADMIN transaction to specify default settings
that all users of the client can adopt. Users can specify their own settings with the
/IDS/AOG_USER transaction.
 If you plan to make only the help from ARIS Online Guide available to the above user, enable
the Use ARIS Online Guide check box in the ARIS Online Guide - Administration
settings dialog.
 To provide user access to the ARIS Online Guide help in addition to the F1 help that is available
in the SAP system by default, enable the Show additionally default help check box.
 Enable the Publisher URL overwritable check box to authorize users to change the URL to
the Publisher export.
 Enter required information to access the Publisher export providing ARIS Online Guide.
 Publisher URL
URL to access the published database:
http://<servername>:<port number>/businesspublisher/link.do
e.g. http://aris1:19990/businesspublisher/link.do
 User name
User that is used for login to the Publisher export.
 Password
Password of the login user.
 Language-Key
Value of the LocaleID (page 141) key representing the interface language used in the
Publisher export.
e.g. 1031 = German, 1033 = English
 Profile-Hash
Value of ph key representing the profile used in the Publisher export, e.g. 0mhsu6i.
To determine the values of Profile-Hash and Language-Key open a model in the
Publisher export, right click and select Copy link.
http://publisherserver1:19990/businesspublisher/link.do?login=rkl&password=&localei
d=1031&ph=0mhsu6i&modelguid=55165b80-30c6-11de-3712-00167669f3de
139
What is the /IDS/AOG_USER transaction used for?
Each of the client's users can use the /IDS/AOG_USER transaction to customize the settings
specified by the SAP system administrator with the /IDS/AOG_ADMIN transaction.
 If you only use the help from ARIS Online Guide, enable the Use ARIS Online Guide check
box.
 To provide the ARIS Online Guide help in addition to the F1 help that is available in the SAP
system by default, enable the Show additionally default help check box.
 Enter required information to access the Publisher export providing ARIS Online Guide in the
ARIS Online Guide - User-specific settings dialog:
 Publisher URL
URL to access the published database:
http://<servername>:<port number>/businesspublisher/link.do
e.g. http://aris1:19990/businesspublisher/link.do
Users can change the URL only if the administrator has enabled the Publisher URL
overwritable check box in the ARIS Online Guide - Administration settings dialog.
 User name
User that is used for login to the Publisher export.
 Password
Password of the login user.
 Language-Key
Value of the LocaleID key representing the interface language used in the Publisher
export.
e.g. 1031 = German, 1033 = English
 Profile-Hash
Value of ph key representing the profile used in the Publisher export, e.g. 0mhsu6i.
To determine the values of Profile-Hash and Language-Key open a model in the
Publisher export, right click and select Copy link.
http://publisherserver1:19990/businesspublisher/link.do?login=rkl&password=&localei
d=1031&ph=0mhsu6i&modelguid=55165b80-30c6-11de-3712-00167669f3de
If you have changed the default settings that the system administrator specified and want to
reactivate them, click on Restore default.
140
What is the ZEXTHLP transaction used for?
Each of the client's users can use the ZEXTHLP transaction to activate the ARIS Online Guide the
next time F1 help is called.
If a user has executed this transaction and presses the F1 key, the ARIS Online Guide help is
displayed with the settings specified via the /IDS/AOG_ADMIN and /IDS/AOG_USER
transactions. If the user presses the F1 key again, the standard F1 help of the SAP system is
displayed again.
5.7.7.3.4 System language and locale IDs

The locale ID (LCID (http://msdn.microsoft.com/en-us/goglobal/bb964662.aspx)) designates a
language within a language group.
Language groups and code page are also represented by a number, e.g., code page=1252. The
language group is preceded by a minus sign (-), e.g., -1252.
The table shows a few examples. You can find more information at:
http://msdn.microsoft.com/en-us/library/0h88fahh(VS.85).aspx
(http://msdn.microsoft.com/en-us/library/0h88fahh(VS.85).aspx).
System language LCID

Afrikaans - South Africa 1078
Albanian - Albania 1052
Arabic - Algeria 5121
Arabic - Bahrain 15361
Arabic - Egypt 3073
Arabic - Iraq 2049
Arabic - Jordan 11265
Arabic - Kuwait 13313
Arabic - Lebanon 12289
Arabic - Libya 4097
Arabic - Morocco 6145
Arabic - Oman 8193
Arabic - Qatar 16385
Arabic - Saudi Arabia 1025
Arabic - Syria 10241
Arabic - Tunisia 7169
Arabic - U.A.E. 14337
Arabic - Yemen 9217
Basque - Spain 1069
141

Belarusian - Belarus 1059
Bulgarian - Bulgaria 1026
Catalan - Spain 1027
Chinese - Hong Kong 3076
Chinese - PRC 2052
Chinese - Singapore 4100
Chinese - Taiwan 1028
Croatian - Croatia 1050
Czech - Czech Republic 1029
Danish - Denmark 1030
Dutch - Belgium 2067
Dutch - Netherlands 1043
English - Australia 3081
English - Belize 10249
English - Canada 4105
English - Caribbean 9225
English - Ireland 6153
English - Jamaica 8201
English - New Zealand 5129
English - South Africa 7177
English - Trinidad 11273
English - United Kingdom 2057
English - United States 1033
Estonian - Estonia 1061
Faeroese - Faeroe Islands 1080
Farsi - Iran 1065
Finnish - Finland 1035
French - Belgium 2060
French - Canada 3084
French - France 1036
French - Luxembourg 5132
French - Switzerland 4108
German - Austria 3079
German - Germany 1031
German - Liechtenstein 5127
142

German - Luxembourg 4103
German - Switzerland 2055
Greek - Greece 1032
Hebrew - Israel 1037
Hungarian - Hungary 1038
Icelandic - Iceland 1039
Indonesian - Indonesia 1057
Italian - Italy 1040
Italian - Switzerland 2064
Japanese - Japan 1041
Korean - Korea 1042
Latvian - Latvia 1062
Lithuanian - Lithuania 1063
Norwegian - Norway (Bokmal) 1044
Norwegian - Norway (Nynorsk) 2068
Polish - Poland 1045
Portuguese - Brazil 1046
Portuguese - Portugal 2070
Romanian - Romania 1048
Russian - Russia 1049
Serbian - Serbia (Cyrillic) 3098
Serbian - Serbia (Latin) 2074
Slovak - Slovakia 1051
Slovene - Slovenia 1060
Spanish - Argentina 11274
Spanish - Bolivia 16394
Spanish - Chile 13322
Spanish - Colombia 9226
Spanish - Costa Rica 5130
Spanish - Dominican Republic 7178
Spanish - Ecuador 12298
Spanish - El Salvador 17418
Spanish - Guatemala 4106
Spanish - Honduras 18442
Spanish - Mexico 2058
143

Spanish - Nicaragua 19466
Spanish - Panama 6154
Spanish - Paraguay 15370
Spanish - Peru 10250
Spanish - Puerto Rico 20490
Spanish - Spain (Modern Sort) 3082
Spanish - Spain (Traditional Sort) 1034
Spanish - Uruguay 14346
Spanish - Venezuela 8202
Swedish - Finland 2077
Swedish - Sweden 1053
Thai - Thailand 1054
Turkish - Turkey 1055
Ukrainian - Ukraine 1058
Vietnamese - Vietnam 1066
144
5.7.7.4 BI Modeler
To enable data exchange between ARIS and SAP NetWeaver® Business Warehouse, you must
import the current transport requests into the SAP system.
The files of the workbench transport request and the files of the customizing transport request are
located on the installation media.
If you re-import the transport request in order to update it, you should first delete the contents
of the following tables:
 YARIS_OBJ_ZUO
 YARIS_OBJCHILDBZ
 YARIS_OBJOBJ_NM
 YARIS_OBJ_ATTR
Procedure
1. Import the workbench transport requests in the SAP system before importing the customizing
transport requests. To do this, perform the following steps:
2. Copy the file K<number>.<SAP system SID> to the directory \sapmnt\trans\cofiles.
3. Copy the file R<number>.<SAP system SID> to the directory \sapmnt\trans\data. The
directory sapmnt normally corresponds to the directory \usr\sap. If you cannot find the
cofiles and data directories under the specified paths, you can determine the correct path
using the DIR_TRANS variable. To do this, log on to the relevant SAP system, and run
transaction AL11.
To transfer the transport request to the SAP system using the command line program TP.EXE,
enter the following commands in the specified sequence:
a. TP addtobuffer <SAP system SID>K<number> [target system SID]
b. TP import <SAP system SID>K<number> [client on target system]
The transport request has been transferred.
Using STMS transaction
1. Log on to the relevant SAP system as a system administrator.
4. Double-click the relevant SAP system. This takes you to the import queue.
6. Enter <SAP system SID>K<number> and confirm. You return to the import overview.
145
The transport request has been transferred.
5.7.7.5 ARIS Publisher Server

If you use ARIS Publisher please make sure to configure the SAP connection (page 111).
Users accessing Publisher exports require a local SAP GUI for Windows installation (version 7.1 to
7.3) for the functionality Run transaction. Ensure that the file SAPLOGON.INI is available for
all users. Using the Web service URL, you can open the SAP documentation without SAP GUI
installation.
146
6 Data migration from ARIS version 9.x to ARIS version 9.6

The Process Governance schema migration functionality is available starting from ARIS version
9.6. This data migration keeps the data stored in the database untouched. Only the database
schema is updated according to the data model changes in the new ARIS version 9.6.
You have to backup your system, then install (page 2) the new ARIS version and finally restore
you data again.
Procedure
1. Create a migration directory on the local hard drive of your server with the ARIS installation,
e.g. migration_data. Backup and restore actions should be executed directly on the server.
2. Replace tools directory in the directory <ARIS
installationdirectory>\server\bin\work\work_apg<number>, e.g. C:\Program
Files\Aris9.5\server\bin\work\work_apg1 by tools directory from your installation
medium.
3. Backup your data for all tenants. Type <ARIS
installationdirectory>\server\bin\work\work_apg<number>\tools\bin\y-backu
p-all.bat or <ARIS
installationdirectory>\server\bin\work\work_apg<number>\tools\bin\y-backu
p-all.sh depending on your operating system, e.g. C:\Program
Files\Aris9.5\server\bin\work\work_apg1\tools\bin\y-backup-all.bat.
After a backup is finished, the you will find a separate ZIP archive for each tenant in the
migration directory. Each ZIP archive contains the data for a specific tenant.
4. Deinstall your old ARIS version and delete all remaining files of your old ARIS installation.
5. Install (page 2) the new ARIS version.
6. Restore the data for all available tenants. In your migration directory, type <ARIS
installationdirectory>\server\bin\work\work_apg<number>\tools\bin\y-restor
e-all.bat or <ARIS
installationdirectory>\server\bin\work\work_apg<number>\tools\bin\y-restor
e-all.sh depending on your operating system, e.g. C:\Program
Files\Aris9.5\server\bin\work\work_apg1\tools\bin\y-restore-all.bat.
7. Open the backup.log file in the logs subdirectory of your migration directory to check
whether the restore and migration of the data was successful. This file contains information
about each migration command and about the restore process.
All data of all tenants are migrated to the new ARIS version.
147
7 Data Migration from ARIS version 7.2 to ARIS version 9.x

All data of earlier ARIS version have to be migrated to the new version of ARIS 9.6. There are
different migration scenarios:
 ARIS was used with a local user administration (page 148) in ARIS 7.2 and no Process
Governance was used.
 ARIS was used with LDAP integration (page 149).
 Process Governance was used without the central user management (page 149).
 Process Governance was used with the central user management (page 150).
Procedure
1. Open a command line.
2. Type the following:
register global enhancement <a name for enhancement> <enhancement point> path
"com/dbmsvendor/jdbc/jdbc-driver/<the folder, where the driver is
located>/<jdbc-driver with version>.jar"
Your ARIS installation of version 9.x is now ready for the data migration.
Example
In case the location of the JDBC driver you are currently using with a Postgres database in ARIS
version 7.2, type the following:
register global enhancement MSSQLEnhancement commonsClasspath path "C:\Program
Files\ARIS7.2\server\lib\postgresql-jdbc3.jar"
7.1 Migration of ARIS with a Local User Administration

The user administration is now web based and users are no longer created directory in ARIS. You
have to migrate your local users to the Administration.
Procedure
1. Back up the database in ARIS version 7.2.
2. Restore the database in ARIS version 9.x up to 9.5.
The users are added to the Administration and you can administrate them now there. All
passwords are deleted.
All user groups and permissions are transferred as far as the permissions and functional rights are
the same as in version 7.2. The user group names are composed of the database name and the
user group name.
You have to manually check whether the assignment of user groups and permissions are
migrated correctly and correct them manually if not.
In case you have a mixture of users who are administrated in the central user management of
ARIS version 7.2 and local users, please first refer to Migration of ARIS with Process Governance
with central user management (page 150).
148
7.2 Migration of ARIS with LDAP Integration

In this case it does not matter whether Process Governance was used or not for the user
migration.
You can install the two ARIS versions in parallel and you have to migrate the users to the new
version. In ARIS version 9.x, only deploy and start newly created Governance processes.
Precondition
 In case of having used Process Governance, make sure that there are no governance
processes running when migrating the databases.
 There will be only one tenant per LDAP server.
Procedure
1. Back up the databases you want to migrate to make sure that you can import the process data
later on.
2. Configure your new system with LDAP. Activate the automatic import of users and user
groups.
3. Restore the databases.
Check whether the user credentials and assignment to user groups are correct.
You can start working with your new system.
7.3 Migration of ARIS with Process Governance without

Central User Management
It is important, that there are no Governance processes running when migrating the databases.
Procedure
1. Make sure, that there are no running Governance processes in the affected database.
user group name.
149
7.4 Migration of ARIS with Process Governance with

Central User Management
Precondition
 You need to have access to the data of version 7.2 and version 9.x for the data migration.
Therefore you have to have installed both ARIS version 7.2 and version 9.x in parallel.
 You have enhanced (page 148) you ARIS version 9.x system with the relevant JDBC driver.
Procedure
2. Copy the JDBC driver in the ARIS 9.x installation folder under
ARIS9.5/server/bin/work/work_umcadmin/base/webapps/umc/WEB-INF/lib.
You find this file in the ARIS 7.2 installation folder under ARISGE1.0\tomcat\lib.
3. Migrate the users from the central user management to the Administration using the batch file
y-datadump.bat.
4. Migrate the users from the central user management to the Administration using the batch file
y-datadump.bat (page 59).
user group name.
7.5 Migration of ARIS document storage Data

You can migrate the ARIS document storage contents of version 7.2 to version 9.x.
Precondition
 You need to have access to the data of version 7.2 and version 9.x for the data migration.
Therefore you have to have installed both ARIS version 7.2 and version 9.x in parallel.
 You have enhanced (page 148) you ARIS version 9.x system with the relevant JDBC driver.
Procedure
1. Install (page 2) the ARIS version 9.x in parallel to your version 7.2.
3. Navigate to the \\<ARIS installation folder\server\bin\work\work_<application
instance name>\tools\bin\ folder, e.g
D:\ARIS9.x\server\bin\work\work_ads_m\tools\bin.
150
4. Type y-migration.bat <source folder> <target folder>.

The first parameter is the folder where the data of version 7.2 are located, the second
parameter is the folder for the version 9.x data.
Example
y-migration.bat C:\program files\ARISGE10\data D:\program
files\ARIS9.x\server\bin\work\work_ads_m\tools\bin.
The ARIS document storage data are migrated.
7.6 Migration of Databases, Configuration Elements and Scripts

With ARIS 9.x, you can easily migrate all your data from ARIS 7.2. It’s possible to import filters,
templates, reports, macros and databases with all users. User defined method extensions or
changes can be migrated via Export filter in 7.2 and Import filter in ARIS 9.x.
In ARIS 7.2 all users are managed inside a database. In ARIS 9.x all users, high level permissions
and licenses are managed centrally in the administration. With migration of a 7.2 database, all
users will be added into this administration. If there are users with the same name in different
databases, these conflicts must be solved in the administration after the migration. User groups
represent authorization within a database, therefore they are not consolidated via names like
users. User groups are identified via Database name and user groups name.
Procedure
In ARIS, using the backup functionality in the pop-up menu of a database. If the size of the
backup file (ADB) exceeds 2 GB, errors may occur during restoration.
3. Export filters, templates and script files in ARIS version 7.2.
In ARIS, using the Export functionality in the pop-up menu for a filter (individual back up).
4. Import all files to ARIS version 9.x.
All data will be converted while restoring and importing.
151
8 Notes on Data Security Observance

We do all we can to protect your data. Please ensure that ARIS is integrated correctly in your IT
environment.
In order for communication between ARIS servers and ARIS clients to proceed safely and reliably,
protect your system from unauthorized access with a firewall.
Certain topics pertain to server administrators. You need the relevant privileges for the
installation directory, in order to install and adjust the server configuration.
Other adjustments are carried out by system users or administrators in the Administration.
8.1 Server Administrator

Please consider all of the topics in the check list and make sure, that they are considered after the
installation.
 Block the access to the ARIS installation with a firewall.
 Allow users to only access via HTTP/HTTPS (default ports 80 and 443).
 Use a secure remote access mechanism (SSH, RDP) to work locally with ACC.
 Use the appropriate hardware and adhere to the system requirements.
 Start ARIS Agent 9.x under your own user account/user.
 Under Windows
 Create a new user account in the operating system and start the ARIS Agent 9.x service.
This user account has only limited privileges to operating system services, e.g., the file
system (see table) and user management.
 Remove this user from all user groups.
 Allow the login as a service.
 Enter your user name and password to login as a service.
 Assign access privileges as specified in the table.
 Under Unix/Linux please consider the same topics as mentioned for Windows. Start ARIS
Agent via shell. You might redirect ports (page 66).
152
Make sure that the used OS user account can access only the specified directories.
The path data corresponds with Windows conventions. Slashes (/) are used as separators in
UNIX.
Directory/File Privilege
%TEMP% Read (r), execute (x),
write (w)
(pass on to files)
<ARIS installation directory>\server\bin\work\ Read (r) (pass on to

files and folders
recursively)
<ARIS installation Write (w)

directory>\server\bin\work\work_abs_[s,m,l]\base\logs (pass on to files)
<ARIS installation directory>\ Write (w)

server\bin\work\work_abs_[s,m,l]\base\temp (pass on to files)

directory>\server\bin\work\work_abs_[s,m,l]\base\work (pass on to files)
<ARIS installation
directory>\server\bin\work\work_abs_[s,m,l]\base\webapps\abs\lo Write (w)
g (pass on to files)

directory>\server\bin\work\work_abs_[s,m,l]\base\fonts (pass on to files)

directory>\server\bin\work\work_abs_[s,m,l]\base\temp (pass on to files)
Write (w)
<ARIS installation (pass on to files and
directory>\server\bin\work\postgres_[s,m,l]\pgworkdata folders)

directory>\server\bin\work\work_cloudsearch_[s,m,l]\defaultLog (pass on to files)
Write (w)
<ARIS installation (pass on to files and
directory>\server\bin\work\work_cloudsearch_[s,m,l]\rsindex folders)

directory>\server\bin\work\work_cop_[s,m,l]\base\logs (pass on to files)
153
Directory/File Privilege
Write (w)
(pass on to files and
folders)
Create (c)
(pass on to folders)
Read (r)
(pass on to files)
<ARIS installation Delete (d)

directory>\server\bin\work\work_octopus_[s,m,l]\base\temp (pass on to folders and
files)
Create (c)
<ARIS installation
directory>\server\bin\work\work_octopus_[s,m,l]\base\logs (pass on to folders)

directory>\server\bin\work\work_octopus_[s,m,l]\base\webapps\o (pass on to files)
ctopus\log
Write (w)
(pass on to files and
folders)
Create (c)
(pass on to folders)
Read (r)
(pass on to files)
Delete (d)
<ARIS installation (pass on to folders and
directory>\server\bin\work\work_simulation_[s,m,l]\base files)

directory>\server\bin\work\work_simulation_[s,m,l]\base\logs (pass on to files)

directory>\server\bin\work\work_mashzone_[s,m,l] (pass on to files)
 Enable SSL encryption (page 65)

Encrypt data transmission between ARIS Design Server and the ARIS clients.
 Use an LDAP system for user management
This ensures that your internal company password security guidelines are complied with.
 Pass on passwords in encrypted form only.
To encrypt passwords use the ARIS Server Administrator (page 101) command encrypt.
154
8.2 ARIS Administrator

Please consider all of the topics in the check list and make sure, that they are considered after the
installation and creation of new databases.
 Change the remote access user's password
The remote access user has access to ARIS Cloud Controller (ACC) (page 61). Change the
password (page 67).
 Change the system user's and the superuser's passwords 'manager' and 'superuser'
The system user has all access and function privileges for all database and is automatically
created with every database. The superuser has all privileges in the Administration. Change
the passwords in the user's profiles in the Administration.
 Create additional system users
System users have all function and access privileges in a database. To be on the safe side,
create additional system users besides the system system user. This way you can maintain
the database even if you forget the password for the system user (see help page Create
system user).
 Back up your data (page 35) regularly
Administrators can back up (page 69) all tenant data to a zip file.
Administrators have various options for backing up the data managed on a ARIS Connect
Server or an ARIS Design Server using ARIS Server Administrator (page 101).
Currently, Java can only process files of up to a maximum of 2 GB safely. Thus, errors may
occur with larger backup files (ADB) and during database recovery. If errors occur during
backup or while restoring please use the backup mechanism in your database management
system (DBMS).
 Version your database content
Versioning is used for versioning models. The benefit and purpose of archiving versions of
models is to allow different versions to be accessed.
155
9 Basic Troubleshooting
If you face problems starting ARIS please read the following pages.
9.1 No Access to ARIS
Problem
You cannot access ARIS, even when using a browser on the same machine.
Solution
Use the Start ARIS Connect Server/Start ARIS Design Server link in the start menu. Be
patient, once the command completes, try accessing ARIS again.
9.2 ARIS clients Cannot Perform Connections to Servers Using SSL
Problem
A SSL certificate is available (page 65) but ARIS clients cannot be started using SSL certification.
This may happen due to ARIS clients using Java trust store having trouble verifying the certificate
chain.
Solution
An additional certificate needs to be made available for the load balancer.
1. Download the zip file of the certificate from a certificate authority, e.g. GlobalSign.
3. Stop (page 64) the load balancer component.
4. Enhance the certificate using this command:
enhance <instanceID of the load balancer component> with sslCertificate local file
"<path to the downloaded zip file>"
5. Start (page 64) the load balancer component again.
The SSL certificate is available.
156
9.3 Server Started but No Access to ARIS
Problem
After you have started the server (page 156) you still cannot access ARIS.
Solution
Open the ARIS Cloud Controller (ACC) (page 61) using the link in the start menu. Once the
prompt appears, type list. Check if all components are in state STARTED.
If the output of the list command shows one or more components in state STARTING please wait
a while and type list again.
9.4 Components do Not Start
Problem
Components still are in state STARTING.
Solution
Kill the component using the kill command. For example kill abs_m. Try starting it again with
the start command, e.g. start abs_m.
If the output of the list command shows one or more components in state FAILED or STOPPED.
Type startall. Once the command finishes give the components some time to complete startup
and type list to see their current state.
9.5 Resolving Port Conflicts
Problem
You have killed and restarted (page 157) a FAILED/STARTING component several times but it still
doesn't start up properly.
Solution
Port collisions are a common reason for components not starting up at all or not working properly.
Beware of port conflicts, e.g. web servers or programs like World Wide Web Publishing
Service or Routing and Remote Access might use the ports 80 and 443 by default.
1. Check the log files (page 102) for messages indicating port conflicts.
2. Find out the ports used by an ARIS component using the ACC (page 61) command show
instance <instanceId>,
e.g.
ACC+ localhost>show instance abs_m
ID: abs_m state:STARTED
type:com.aris.modeling.components.y-server-run-prod-9.0.
0-RC108-Trunk-SNAPSHOT)
Configuration parameters:
JAVA_OPTS=-server
-Xrunjdwp:transport=dt_socket,address=9704,server=y,suspend=n
157
JAVA-Dcom.sun.management.jmxremote.port=9604
JAVA-Dcom.sun.management.jmxremote.ssl=false
CATALINA_PORT=10080
JAVA-Dcom.sun.management.jmxremote.authenticate=false
JAVA-XX\:MaxPermSize=256m
JAVA-Dcom.sun.management.jmxremote=/enabled
JAVA-Xmx=8g
zookeeper.connect.retry.time.ms=30000
zookeeper.bundle.type=abs
zookeeper.session.timeout.ms=60000
CATALINA_AJP_PORT=11080
START command was issued at Jun 5, 2013 8:47:11 AM

Average startup time: 192915msec
Autostart: OFF
Desired state: STARTED
ACC+ localhost>
3. Use the Windows netstat command to find ports used by other programs:
netstat –ao |more
4. Look for lines containing the port number(s) of the component that is not starting up properly
and which have the state listening.
Sometimes, two programs might startup and use the same port. Only the first program will be
reachable via this port.
Proto Local Address Foreign Address State PID
TCP 0.0.0.0:9701 MCY137201:0 LISTENING 5524
...
5. Use Windows Task Manager to identify the program that is using that port.
After you have stopped the program causing the conflict or redirected ports (page 66), all ARIS
components will start up properly.
158
10 Known Restrictions
Despite the approval of our software for operation with the listed operating system versions and
other software and hardware requirements, we cannot exclude the possibility of problems arising
from unpredictable incompatibility issues with certain hardware/software combinations.
10.1 Update Setup

your database schema first before starting the server. Otherwise your runtime environment and
data might be harmed and the application may not work anymore.
or
 Updating ARIS Connect Server version 9.0 using the setup is not possible.
 Scheduled reports must be recreated after the update. During the update setup, existing
scheduled reports will be deleted and must be recreated.
 If after the update of a custom configuration the help link doesn’t work anymore (404 error),
it can simply be fixed by modifying the useraction_default.xml file. The help url defined
there is similar to this:
/static/help/{locale}/handling/ca/index.htm#52910.htm
and it should be changed to a version like this:
/static/help/{locale}/handling/connect/ca/index.htm#52910.htm.
The connect directory is missing there. But you also can take a look at a similar, proper
configuration in the default configuration.
10.2 Process Governance

You can use Process Governance with up to 1000 process instances running in parallel. But the
number may differ depending on the complexity of the running process (e. g. self-created
reports).
159
10.3 Right-to-left (RTL)

Right-to-left, top-to-bottom text is not officially supported. Arabic or Hebrew can be used with
ARIS 9.5, but not all functionality support Right-to-left.
10.4 Tenant Names

Please only use ASCII characters. Special characters and characters e. g. in Chinese, Cyrillic or
Arabic cannot be used.
160
11 Support
If you have any questions on specific installations that you cannot perform yourself, contact your
local Software AG sales organization.
By Telephone
If you have a valid support contract, you can contact us internationally at:
+800 ARISHELP
The "+" stands for the prefix required in a given country to dial an international connection.
Example for dialing within Germany with a direct extension line:
00 800 2747 4357
By Web Interface
https://empower.softwareag.com (https://empower.softwareag.com)
161
12 Glossary
GUID
Globally Unique Identifier (GUID).
The GUID is a character set that uniquely identifies elements worldwide.
JAAS
Java Authentication and Authorization Service (JAAS).
This is a Java interface, which provides services for the authentication and for the access in Java
programs. JAAS supports a user based authentication.
OTP
One-Time-Pad (OTP).
This one-tine encryption is a symmetric encryption method to transfer messages. Its
characteristic is that the length of the encryption key is at least as long as the message itself.
OTP is considered information technology secure and cannot be broken.
SAML
Security Assertion Markup Language (SAML).
XML framework to exchange authentication information. SAML provides features to describe and
transfer security based information.
SSL
Secure Socket Layer (SSL).
Security software to encrypt data that are exchanged between programs.
SSO
Single Sign-on.
Using SSO has the advantage that a user only has to log in once to the network. The user need
only one login name and password to access all computers, services and programs whose usage
is allowed.
162
System Database
This database manages the content of the configuration and evaluations nodes displayed on
ARIS' Administration tab, e. g. filters, templates and font formates as well as ARIS method
content and scripts.
The database is created while the first user logs in using an ARIS client. This content is available
in all ARIS databases within this tenant.
Tenant
A logical container into which users and groups are placed. It can represent a customer, a
department or another group of users. Tenants do not share any data.
Only users of tenant master are allowed to create, update or delete other tenants.
TLS
Transport Layer Security (TLS).
TLS is known under the name of Secure Sockets Layer (SSL). It is an encryption protocol to
ensure a secure data transfer through the Internet.
163

ARIS Server Installation and Administration Guide - 0 PDF

Uploaded by

Copyright:

Available Formats

ARIS Server Installation and Administration Guide - 0 PDF

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

ARIS Server Installation and Administration Guide - 0 PDF

Uploaded by

Copyright:

Available Formats

Server Installation and Administration

3 Tenant Management ............................................................................................ 37

4 User and License Management .............................................................................. 38

5.2 Logging ................................................................................................... 102

8 Notes on Data Security Observance ...................................................................... 152

9 Basic Troubleshooting ......................................................................................... 156

10 Known Restrictions ............................................................................................. 159

11 Support ............................................................................................................ 161

12 Glossary ........................................................................................................... 162

Warnings are highlighted.

Please consider the legal notices http://documentation.softwareag.com/legal/.

2.1 Available Setups

ARIS Design Server Setup (standalone) (page 9)

ARIS Risk & Compliance Manager Server Setup (page 12)

ARIS Publisher Server Setup (page 14)

Installing ARIS on a Linux Operating System (page 17)

2.1.1 ARIS Connect Server Installation

Microsoft SQL (page 24)

8. Enter the SMTP mail processing parameters.

17. Click Logout.

2.1.2 ARIS Design Server Standalone Installation

Microsoft SQL (page 24)

8. Enter the SMTP mail processing parameters.

2.1.3 ARIS Risk & Compliance Manager Server Installation (Windows

The option Small reserves 1 GB for the application.

2.1.4 ARIS Publisher Server Installation

2.1.5 ARIS Remote Installations (Windows Operating System)

2.1.6 Installing ARIS on a Linux Operating System

$max_file_max = "ulimit –n"

session required pam_limits.so

2.2 Using Oracle or Microsoft SQL Server instead of the Standard

2.2.1 Customize the Oracle Database

2.2.1.1 Configure envset.bat

2.2.1.2 Create the Application User

2.2.1.3 Create an Empty Schema for Each Tenant

2.2.2 Customize the Microsoft SQL Server System

2.2.2.1 Configure envset.bat

2.2.2.2 Install the Database Automatically

2.2.2.3 Setup Database Manually

2.2.2.4 Create an Empty Schema for Each Tenant Manually

2.3.1 Use Oracle Database (Tomcat)

 The Oracle user must have the following privileges

username="ARISBP" password="ARISBP" <!-- where you use the Oracle user

4. Ensure that the following entries are correctly specified:

2.3.2 Use Microsoft SQL Database

2.3.3 Change Database Connection Parameters

2.4 Update Installation

Systems with Process Governance

Using the Standard Database System

Using Oracle or Microsoft SQL as Database System

ARIS Publisher Server

Update Linux Installation

2.5 Back up and Restore Data

On the Administration tab, using the Backup functionality.

Method, configuration, and queries

In ARIS Server Administrator, using the backupsystemdb command.

Queries and ad hoc analyses

On the Administration tab with the function Back up analysis data.

For server installations: