After you have installed and configured ARIS Connector for SAP Solutions, you can modify the settings if required. If you have configured a connection to your test system, you can add your productive SAP system.
Warning
Do not change the SAPConfiguration.json file manually. The file is automatically updated with your settings by the command line interface.
Open the <ARIS Connector for SAP Solutions installation directory>\conf\UpdateSAPConfiguration.json file in a text editor. The parameters are described in the UpdateSAPConfiguration.md file.
Specify all highlighted values, such as:
Enter the name of the related SAP system.
If you use multiple SAP systems, you must specify a unique alias value for each SAP system.
Enter the SAP server URL to SAP Solution Manager 7.2.
Syntax: https://<solution manager server name>:<port>), for example, https://sapsolman72.us.co.abc:50001.
You can retrieve the SAP server URL from the corresponding SAP System using the SCIF or the SOLDOC executables. Just copy the URL up to the port number.
,
User name which is used to log on to the SAP® system.
"password" : "password_set_with_configure_connector",
You must not specify your SAP password. Encrypted credentials will be generated and specified using the command line interface.
Enter the number of the SAP® Client. The number can be obtained from your SAP® administrator.
Optionally connects to a different SAP Client other than the default client. If you do not enter a number, you are connected to the default client.
,
Code for the language that is used to log on to the SAP® system.
Examples
E = English, D = German, or F = French.
Defines whether Allow untrusted server access is enabled (true) or disabled (false).
You are required to enable Allow untrusted server access only if connections fail due to a security certificate error but you use https on a trusted server. Security certificate errors can occur if you use self-signed certificates.
To add another SAP system, add the following lines:
"alias" : "",
"serverUrl" : "",
"user" : "",
"password" : "",
"client" : "",
"language" : "",
Defines whether Allow untrusted server access is enabled (true) or disabled (false).
You are required to enable Allow untrusted server access only if connections fail due to a security certificate error but you use https on a trusted server. Security certificate errors can occur if you use self-signed certificates.
Specify the values as required.
If your SAP password was changed or if you added anothwr SAP system to the ARIS Connector for SAP Solutions, you must encrypt and submit the password value missing in the UpdateSAPConfiguration.json file.
Open a command prompt box or a Linux terminal in the <ARIS Connector for SAP Solutions installation directory>\bin folder.
To encrypt and enter the missing SAP password into the UpdateSAPConfiguration.json file, in the command prompt window or a Linux terminal, enter:
ConfigureConnector.bat/.sh -sys <value of the alias parameter> -usr <value of the user parameter> -pwd <password> <confirm password>
For example, for Windows: .\ConfigureConnector.bat -sys SM01 -usr ARIS_SAP_SYNC_USER -pwd ******** ********
While you are entering your password, it will be visible.
If your SAP password was changed or if you added anothwr SAP system to the ARIS Connector for SAP Solutions, you must encrypt and submit the password value missing in the UpdateSAPConfiguration.json file.
Open a command prompt box or a Linux terminal in the <ARIS Connector for SAP Solutions installation directory>\bin folder.
To update the ARISConfiguration.json file used by ARIS Connector for SAP Solutions, depending on your operating system, enter: .\configureConnector.bat -upd or ./configureConnector.sh -upd
The settings were changed. If any issues occurred, the command line interface shows error messages. The links lead you to the
.If any issues occurred, the command line interface shows error messages. The messages are logged in the ConnectorCLI.log file.
The links lead you to the problem solution.
You tried to encrypt and enter the SAP password into the UpdateSAPConfiguration.json file, but the user specified in the command is not specified in the file. Make sure to use the value of the related user parameter specified in the UpdateSAPConfiguration.json file for encryption.
The required configuration file is missing in the <ARIS Connector for SAP Solutions installation directory>/conf folder.
A file operation related to the corresponding configuration file failed. The exception was added to the log file.
You specified a configuration parameter using a wrong minimum or maximum value. The error message contains the valid range. To get detailed information about the use of all parameters, open the related *.md file.
A mandatory configuration parameter is missing. The error message contains the missing parameter.
You configured multiple SAP systems using identical alias values. For each SAP system, you must specify a unique alias value.
A save file operation related to the corresponding configuration file failed. The exception was added to the log file.
You must specify a valid SAP server URL as a value for the serverUrl parameter and a capital letter as a value for the language parameter. The values are used to connect to the SAP system that is specified as an alias using the ARIS Connector for SAP Solutions. To get detailed information about the use of all parameters, open the UpdateSAPConfiguration.md file.
You specified SAP connection parameters that are not valid.
You specified the value of the language parameter incorrectly. Make sure to use one capital letter. To get detailed information about the use of all parameters, open the UpdateSAPConfiguration.md file.
You specified the value of the arisCloudUrl parameter incorrectly. The URL has wrong syntax. To get detailed information about the use of all parameters, open the UpdateARISConfiguration.md file.
The value of the clientCredentials parameter is not valid. Copy the credentials of the related ARIS Connector for SAP Solutions from ARIS Architect. The value must have the syntax <client ID>/<client secret>. The value consists of the Client ID and the Client secret, separated by a forward slash (/).
The stored encrypted password could no longer be decrypted using the key.secret file that is located in the <ARIS Connector for SAP Solutions installation directory>/conf folder. Most likely, the secret key was changed. This happens if you deleted the key.secret file and restarted ARIS Connector for SAP Solutions. In this case, a new key.secret file is created using a new key and you must encrypt all credentials again. To do so, use these commands: ConfigureConnector.bat -crd <Copied credential from ARIS Architect>, ConfigureConnector.bat -sys <alias> -usr <user> -pwd <password> <repeated password>, ConfigureConnector.bat -upd.
The connection to the SAP system failed due to a problem other than an authentication issue.
The connection to ARIS failed. Possible causes can be a wrong arisCloudUrl, wrong clientCredentials, wrong certificate (cacerts, located in the <ARIS Connector for SAP Solutions installation>/jre/lib/security folder), network issues.
The log files are located in <ARIS Connector for SAP Solutions installation directory>\logs folder.
Connector.log contains information logged during the startup of ARIS Connector for SAP Solutions and about the connected SAP system.
ConnectorCLI.log contains messages logged by the command line interface.
ConnectorCommunication.log contains messages related to the communication between ARIS Connector for SAP Solutions and ARIS.
SCCService.log contains messages logged by the startup process.