ARIS サーバー接続設定の変更

ARIS Connector for SAP Solutions をインストールおよび設定したら、必要な場合は設定を変更できます。ARIS サーバー と ARIS Connector for SAP Solutions の間に接続を確立するには、ARIS クラウド URL とプロジェクト ルーム名を指定する必要があります。デフォルトでは、この情報は Software AG から電子メールで届きます。

  1. テキスト エディターで <ARIS Connector for SAP Solutions インストール ディレクトリ\conf\UpdateARISConfiguration.json ファイルを開きます。パラメーターは UpdateARISConfiguration.md ファイルに記述されています。ARISConfiguration.json ファイルは編集しないでください。

  2. ARIS クラウド URL とプロジェクト ルーム名のみを指定します。デフォルトでは、これらは Software AG から電子メールで届きます。設定を変更するには、疑問符内のパラメーターの後に値を設定します。

    "arisCloudUrl": "https://mc.ariscloud.com",

    "projectRoom": "default",

    "clientCredentials" : "password_set_with_configure_connector"

    セキュリティの理由から、このファイルで clientCredentials の値を指定することはできません。

  3. ファイルを保存します。

  4. arisCloudUrl または projectRoom の値を変更しただけでは、clientCredentials が依然として有効です。ARIS Connector for SAP Solutions が削除されてから再び追加された場合のみ、不足する clientCredentials の暗号化と入力をする必要があります

    不足する資格情報を指定するには、UpdateARISConfiguration.json ファイルで不足している clientCredentials 値を暗号化および送信する必要があります。

    1. ARIS Architect で、[ARIS] から 管理の表示 [管理] をクリックします。

    2. [ナビゲーション] バーがまだアクティブでない場合は、バー パネルで ナビゲーション [ナビゲーション] をクリックします。

    3. グループ [SAP]、[ARIS Connectors for SAP Solutions] の順にフォルダーを開きます。

    4. [開始] タブ バーで関連するコネクタを選択し、表示 [資格情報の表示] をクリックします。

    5. [資格情報のコピー] をクリックして、ダイアログ ボックスを閉じます。

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

    7. 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 ファイルを復元できない場合は、資格情報を再び暗号化して送信する必要があります。そうでない場合、接続を確立できません。

  5. 設定を更新します。

    SAP パスワードが変更された場合、あるいは別の SAP システムを ARIS Connector for SAP Solutions に追加した場合は、UpdateSAPConfiguration.json ファイルで不足する password 値を暗号化および送信する必要があります。

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

    2. ARIS Connector for SAP Solutions で使用される ARISConfiguration.json ファイルを更新するには、オペレーティング システムに応じて「.\ConfigureConnector.bat -upd」または「./ConfigureConnector.sh -upd」と入力します。

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

問題が発生した場合は、コマンド ライン インターフェイスにエラー メッセージが表示されます。メッセージは 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 にはスタートアップ プロセスによって記録されたメッセージが含まれます。