Skip to main content

ARIS Technical Help

Migrate solution configuration to ARIS Connector for SAP Solutions

After you have updated ARIS to a version that provides the use of ARIS Connector for SAP Solutions, such as ARIS 10 Service Release 18 or later, you must create a new connector in ARIS Architect and migrate your connectors.

Prerequisite

Procedure. Procedure

  1. In ARIS Architect, click ARIS > Show Administration Administration.

  2. Click Navigation Navigation in the bar panel if the Navigation bar is not activated yet.

  3. Open the Group SAP > Solution configurations (Solution Manager 7.2) folder.

  4. Open the SAP server icon SAP® Server structure in which the solution is managed. The solution configurations for this SAP® Server are displayed.

  5. Delete the related SAP® Server. This removes your old solution configurations.

      Warning

      Note that you must delete all solution configurations that you will replace by your new ARIS Connector for SAP Solutions. Make sure that only one configuration is available, either in the Group SAP >Solution configurations (Solution Manager 7.2) folder or in the Group SAP > ARIS Connectors for SAP Solutions folder.

    1. Open the folder Group SAP > ARIS Connectors for SAP Solutions.

    2. In the Start tab bar, click New New > Connector.

    3. Enter the name of the connector.

    4. Enter a description text, to provide more details if required, and click OK. The connector is created and a dialog is displayed, showing the credentials that you must pass on later as an encrypted value.

    5. Click Copy credentials and close the dialog.

    6. Open a command prompt box or a Linux terminal in the <ARIS Connector for SAP Solutions installation directory>\bin folder.

    7. Execute the startup.bat or the startup.sh script.

      If ARIS Connector for SAP Solutions does not start due to port conflicts, change the port number in the ConnectorConfiguration.json file (<ARIS Connector for SAP Solutions installation directory>\conf).

    8. To encrypt and submit the missing clientCredentials value in the UpdateARISConfiguration.json file, enter:

      ConfigureConnector.bat/.sh -crd <client-credentials key copied from ARIS Architect>

      For example, for Linux: ./ConfigureConnector.sh -crd 378ae18d-8d4d-499b-8579-1bd4601d30f0/15502484-88ab-4cb2-920f-153d21ab5915

      When you encrypt credentials, ARIS Connector for SAP Solutions creates a key.secret file in the <ARIS Connector for SAP Solutions installation directory>\conf folder. The key.secret file from now on is used for encryption.

        Warning

        Make sure to back up this file. You must not change the key it contains. If you delete the key.secret file from the conf folder so that the encryption key is not stored with the encrypted credentials, you must be able to restore the file. This is because this file is mandatory when ARIS Connector for SAP Solutions is restarted. If you cannot recover the key.secret file that was used for encryption, you must re-encrypt and submit the credentials. Otherwise, connections cannot be established.

      1. Update the configuration.

        The connection parameters and encrypted credentials that you already have provided are specified in the configuration files. Finally, you must update the ARISConfiguration.json and SAPConfiguration.json files on the command line.

          Warning

          You must not edit the ARISConfiguration.json and SAPConfiguration.json files manually.

          To update the configuration, in the command prompt window or a Linux terminal that you opened earlier, enter: .\ConfigureConnector.bat -upd or ./ConfigureConnector.sh -upd.

          All entries are checked and configuration files are updated. The connection configuration is activated.

          1. Restore your solution configurations. In ARIS Architect, click ARIS > Show Administration Administration.

          2. Open the Group SAP > ARIS Connectors for SAP Solutions folder. If ARIS Connector for SAP Solutions is not yet available in ARIS Architect, check the status of the connector, review the logged messages, or refresh (F5) the view.

          3. Select the SAP server icon SAP® Server or solution and click Resume Restore in the Start tab bar. The Restore configuration dialog opens.

          4. Select the database in which the branch is managed and select the configuration you wish to restore. You only need to select the database if you are logged into several databases for which configurations can be restored.

          5. Select the start object of the solution and click OK. The configuration has been restored.

          6. Restore the configurations in turn.

              Warning

              Do not use the Import functionality to restore configurations in ARIS Connector for SAP Solutions using solution configurations exported from the Solution configurations (Solution Manager 7.2) folder.

            The solutions are available to users for transferring data between ARIS and SAP® Solution Manager 7.2. SAP credentials are no longer required because authentication is handled by ARIS Connector for SAP Solutions.

            If your ARIS Connector for SAP Solutions configuration requires changes, use the ConfigureConnector.bat or ConfigureConnector.sh script to start the command-line interface.