接続設定の変更

ARIS Connector for SAP Solutions をインストールおよび設定すると、<ARIS Connector for SAP Solutions インストール ディレクトリ>\conf フォルダーに設定ファイルがあります。

上記の設定ファイルは、任意のテキスト エディターを使用して編集できます。 パラメーターは対応する .md ファイルに記述されています。

警告

ARISConfiguration.json 設定ファイルと SAPConfiguration.json 設定ファイルは手動で編集しないでください。これらのファイルは ARIS Connector for SAP Solutions によって使用されます。更新とアクティブ化は、コマンド ライン インターフェイスのみを使用して行う必要があります。

接続を設定したら、UpdateARISConfiguration.json と UpdateSAPConfiguration.json の設定ファイルで行った変更を ARIS Connector for SAP Solutions で使用される ARISConfiguration.json と SAPConfiguration.json の設定ファイルに転送する必要があります。

必要条件

ARIS Connector for SAP Solutions が実行中です。

手順

  1. <ARIS Connector for SAP Solutions インストール ディレクトリ\bin フォルダーで、コマンド プロンプト ボックスまたは Linux ターミナルを開きます。

  2. オペレーティング システムに応じて、「.\configureConnector.bat -upd」または「./configureConnector.sh -upd」と入力します。

接続設定がアクティブになります。

これで、VPN 接続を使用しなくても ARIS と SAP システムの間でデータを転送できます。そのため、ARIS Connector for SAP Solutions で処理されるソリューション設定を作成する必要があります。

セキュリティの理由から、設定ファイルに暗号化されていないパスワードを指定することはできません。コマンド ライン インターフェイスを使用して、パスワードの暗号化と指定を自動的に行います。

コマンド ライン インターフェイスを使用して、設定ファイルにある暗号化された資格情報 (clientCredential パラメーターと password パラメーターなど) を設定します。資格情報は、ARIS Enterprise テナント と SAP システムに対して ARIS Connector for SAP Solutions を認証するのに使用されます。

警告

UpdateARISConfiguration.json、ARISConfiguration.json、UpdateSAPConfiguration.json、SAPConfiguration.json のファイルにある資格情報を手動で変更しないでください。

必要条件

ARIS Connector for SAP Solutions が実行中です。

手順

  1. <ARIS Connector for SAP Solutions インストール ディレクトリ\bin フォルダーで、コマンド プロンプト ボックスまたは Linux ターミナルを開きます。

  2. UpdateARISConfiguration.json ファイルで不足している clientCredentials 値を暗号化および送信するには、「

    ConfigureConnector.bat/.sh -crd <ARIS Architect からコピーしたクライアント資格情報キー>」と入力します。

    Linux の場合の例: ./ConfigureConnector.sh -crd 378ae18d-8d4d-499b-8579-1bd4601d30f0/15502484-88ab-4cb2-920f-153d21ab5915

    問題が発生した場合は、コマンド ライン インターフェイスにエラー メッセージが表示されます。リンクにより、問題の解決に誘導されます。

    問題が発生した場合は、コマンド ライン インターフェイスにエラー メッセージが表示されます。メッセージは ConnectorCLI.log ファイルに記録されます。

    リンクにより、問題の解決に誘導されます。

    SAP_CONFIGURATION_DIFFERENT_USERS

    SAP パスワードを暗号化し、UpdateSAPConfiguration.json ファイルに入力しようとしたが、コマンドで指定されたユーザーがファイルでは指定されていません。暗号化に関する UpdateSAPConfiguration.json ファイルで指定されている 関連 user パラメーターの値の使用を確認します。

    CONFIG_FILE_MISSING_P_CFG_NAME

    必要な設定が、<ARIS Connector for SAP Solutions インストール ディレクトリ>/conf フォルダーで不足しています。

    CONFIG_FILE_INVALID_P_CFG_NAME

    対応する設定ファイルに関係するファイル操作がエラーになりました。例外がログ ファイルに追加されました。

    CONFIG_VALUE_OUT_OF_BOUNDS_P_CFG_NAME_P_NAME_P_VALUE_P_MIN_P_MAX

    適切でない最小値または最大値を使用して設定パラメーターを指定しました。エラー メッセージには有効な範囲が含まれます。すべてのパラメーターの使用に関する詳細情報を得るには関連する *.md ファイルを開きます。

    CONFIG_VALUE_NOT_SET_P_CFG_NAME_P_NAME

    必須の設定パラメーターが不足しています。エラー メッセージには不足しているパラメーターが含まれます。

    SAP_CONFIG_ALIAS_NOT_UNIQUE_P_CFG_NAME_P_ALIAS

    同一の alias 値を使用して複数の SAP システムを設定しました。各 SAP システムには、一意の alias 値を指定する必要があります。

    CONFIG_FILE_COULD_NOT_PERSIST

    対応する設定ファイルに関係するファイルの保存操作がエラーになりました。例外がログ ファイルに追加されました。

    SAP_CONFIG_CONNECTION_PARAMETERS_NOT_CORRECT

    serverUrl パラメーターの値として有効な SAP サーバー URL を、language パラメーターの値には大文字を指定する必要があります。値は、ARIS Connector for SAP Solutions を使用して alias として指定される SAP システムへの接続に使用されます。 すべてのパラメーターの使用に関する詳細情報を得るには、UpdateSAPConfiguration.md ファイルを開きます。

    SAP_CONFIG_AUTHENTICATION_PARAMETERS_NOT_CORRECT

    有効でない SAP 接続パラメーターを指定しました。

    SAP_CONFIG_LANGUAGE_PARAMETER_NOT_CORRECT

    不適切な言語パラメーターの値を指定しました。大文字 1 文字の使用を確認します。 すべてのパラメーターの使用に関する詳細情報を得るには、UpdateSAPConfiguration.md ファイルを開きます。

    ARIS_CONFIG_URL_NOT_VALID

    不適切な arisCloudUrl パラメーターの値を指定しました。URL の構文が不適切です。すべてのパラメーターの使用に関する詳細情報を得るには、UpdateARISConfiguration.md ファイルを開きます。

    ARIS_CONFIG_CLIENT_CREDENTIALS_NOT_VALID

    clientCredentials パラメーターの値が有効ではありません。関連する ARIS Connector for SAP Solutions の資格情報を ARIS Architect からコピーします。値の構文は <クライアント ID>/<クライアント シークレット> である必要があります。値は、クライアント ID とクライアント シークレットで構成され、フォワード スラッシュ (/) で区切られます。

    ENCRYPTION_GENERAL

    保存された暗号化済みパスワードは、<ARIS Connector for SAP Solutions インストール ディレクトリ>/conf/ フォルダーにある key.secret ファイルを使用しても復号できなくなりました。最も可能性があるのは、シークレット キーが変更されたためです。これは、key.secret ファイルを削除してから ARIS Connector for SAP Solutions を再起動すると発生します。この場合、新しいキーを使用して新しい key.secret ファイルを作成し、すべての資格情報をもう一度暗号化する必要があります。そのためには、以下のコマンドを使用します。ConfigureConnector.bat -crd <ARIS Architect からコピーした資格情報>, ConfigureConnector.bat -sys <エイリアス> -usr <ユーザー> -pwd <パスワード> <パスワードの繰り返し>, ConfigureConnector.bat -upd

    SAP_INSTALLATION_CHECK_ERROR

    SAP システムとの接続が、認証以外の問題でエラーになりました。

    ARIS_AUTHORIZATION_ERROR and ARIS_AUTHENTICATION_FAILED_ERROR

    ARIS への接続がエラーになりました。考えられる原因には、不適切な arisCloudUrl、不適切な clientCredentials、不適切な証明書 (<ARIS Connector for SAP Solutions インストール/jre/lib/security フォルダーにある cacerts)、ネットワークの問題があります。

    ログ ファイルは <ARIS Connector for SAP Solutions インストール ディレクトリ>\logs にあります。

    • Connector.log には、ARIS Connector for SAP Solutions のスタートアップ時と、接続されている SAP システムに関する情報が記録されます。

    • ConnectorCLI.log には、コマンド ライン インターフェイスによって記録されたメッセージが含まれます。

    • ConnectorCommunication.log には、ARIS Connector for SAP Solutions と ARIS との間の通信に関するメッセージが含まれます。

    • SCCService.log にはスタートアップ プロセスによって記録されたメッセージが含まれます。

    資格情報を暗号化すると、ARIS Connector for SAP Solutions は <ARIS Connector for SAP Solutions インストール ディレクトリ>\conf フォルダーに key.secret ファイルを作成します。その後、key.secret ファイルが暗号化に使用されます。

    このファイルのバックアップは必ず作成してください。これを含むキーを変更することはできません。key.secret ファイルを conf フォルダーから削除すると、暗号化された資格情報を持つ暗号化キーが保存されなくなるため、このファイルは復元可能である必要があります。これが、ARIS Connector for SAP Solutions の再起動時にこのファイルが必須である理由です。暗号化に使用された key.secret ファイルを復元できない場合は、資格情報を再び暗号化して送信する必要があります。そうでない場合、接続を確立できません。

  3. コマンド プロンプト ウィンドウまたは Linux ターミナルで不足している SAP パスワードを暗号化および入力するには、「

    ConfigureConnector.bat/.sh -sys <alias パラメーターの値> -usr <user パラメーターの値> -pwd <パスワード> <パスワードの確認>」と入力します。

    Windows の場合の例: .\ConfigureConnector.bat -sys SM01 -usr ARIS_SAP_SYNC_USER -pwd ******** ********

    入力中のパスワードは表示されます。

UpdateARISConfiguration.json ファイルで使用される暗号化された clientCredentials パラメーターと、UpdateSAPConfiguration.json ファイルで使用される password パラメーターが設定されています。

ARIS Connector for SAP Solutions を使用して設定ファイルを更新するために、関連するコマンドを実行します。

接続の設定後に、接続をアクティブ化します

接続を設定したら、UpdateARISConfiguration.json と UpdateSAPConfiguration.json の設定ファイルで行った変更を ARIS Connector for SAP Solutions で使用される ARISConfiguration.json と SAPConfiguration.json の設定ファイルに転送する必要があります。

必要条件

ARIS Connector for SAP Solutions が実行中です。

手順

  1. <ARIS Connector for SAP Solutions インストール ディレクトリ\bin フォルダーで、コマンド プロンプト ボックスまたは Linux ターミナルを開きます。

  2. オペレーティング システムに応じて、「.\configureConnector.bat -upd」または「./configureConnector.sh -upd」と入力します。

接続設定がアクティブになります。

これで、VPN 接続を使用しなくても ARIS と SAP システムの間でデータを転送できます。そのため、ARIS Connector for SAP Solutions で処理されるソリューション設定を作成する必要があります。