# SOAPコネクターと依存関係のインストール
SOAPコネクターとその依存関係をインストールするには、以下の手順を完了してください:
これらの依存関係をインストールした後、接続のセットアップを行うことができます。
# ステップ1:オンプレミスエージェント(OPA)のセットアップ
オンプレミスエージェント(OPA)のセットアップを行ってください。クラウドプロファイルまたは接続プロファイルのいずれかを使用できますが、いずれの場合もOPAがインストールされているマシンのconfig.yml
を手動で編集できる必要があります。
すでにOPAをセットアップ済みの場合は、ステップ2に進んでください。
# ステップ2:OPA拡張機能のインストール
オンプレミスエージェントのセットアップが完了したら、以下の手順を実行してOPA拡張機能をインストールしてください:
- ステップ2.1:オンプレミスエージェントの場所を特定する
- ステップ2.2:Java Development Kit(JDK)のインストール
- ステップ2.3:SOAP拡張パッケージのダウンロード
- ステップ2.4:OPAと拡張機能の設定
- ステップ2.5:OPAの再起動
# ステップ2.1:オンプレミスエージェントの場所を特定する
ファイルシステム上でOPAディレクトリを特定してください。一般的な場所は次のとおりです:
- Unix系オペレーティングシステム:
/opt/workato
- Windows:
C:\Program Files\Workato Agent
- macOS: 位置は異なります。
$ ls /opt/workato
bin conf jre lib lib_ext
このガイドの残りの部分では、このパスを$OPA
として参照します。
# ステップ2.2:Java Development Kit(JDK)のインストール
まず、JDKがすでにインストールされているかどうかを確認してください。バージョンは17以上である必要があります。一般的な場所は次のとおりです:
- Linux:
/usr/lib/java
- Ubuntu:
/usr/share/java/
- Windows:
C:\Program Files\Java\jdk-<リリース>
- macOS: ディストリビューションによって場所が異なります。例:
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
$ ls /usr/lib/java
bin conf include jmods legal lib release
JDKのインストールが実際にJDKであり、単なるJREではないことを確認してください。これはApache CXFによって必要とされるためです。javac
バイナリが存在するかどうかで確認できます:
$ ls /usr/lib/java/bin/java*
bin/java bin/javac bin/javadoc bin/javap
JDKのバージョン17以上がまだインストールされていない場合は、JDKの配布 (opens new window)からいくつか選択し、インストール手順に従ってください。
JDKをインストールした後、JDKフォルダをリストアップしてインストールが正常に行われたことを確認してください:
$ ls /path/to/jdk
bin conf include jmods legal lib release
# ステップ2.3:SOAP拡張パッケージのダウンロード
SOAP拡張機能は、2つのJARファイルからなるパッケージで、以下のURLからダウンロードできます:
以下のコマンドを使用してパッケージをダウンロードし、JARファイルを$OPA/ext
フォルダに移動します。ここで$OPA
は、オンプレミスエージェントがインストールされているディレクトリを表します。
$ curl -o soap-extension.zip https://workato-opa-extensions.s3.amazonaws.com/soap-extensions/soap-extension-latest.zip
$ unzip soap-extension.zip -d $OPA/ext
SOAP拡張機能の両方のファイルが$OPA/ext
に存在することを確認してください:
$ ls $OPA/ext | grep soap_extension
soap_extension.jar
soap_extension_client.jar
古いバージョンのインストール
古いバージョンのSOAP拡張機能をインストールする必要がある場合は、このディレクトリ (opens new window)からパッケージをダウンロードしてください。
# ステップ2.4:OPAと拡張機能の設定
OPAの設定ファイルは$OPA/conf/config.yml
です。SOAP拡張機能を使用するためには、以下の手順に従って設定ファイルを更新する必要があります。この手順は、OPAがクラウドプロファイルまたは接続プロファイルを使用して構成されている場合に適用されます。
classpath
をSOAP拡張機能のJARファイルが存在するフォルダのパス(通常は$OPA/ext
で、$OPA
はオンプレミスエージェントがインストールされているディレクトリを表します)に設定してください:
server:
classpath: /opt/workato/ext
SOAP拡張機能を登録してください:
extensions:
soap:
controllerClass: com.workato.extension.soap.ExtensionController
OPAがJDKを見つけることができるようにしてください。デフォルトでは、SOAP拡張機能は次の場所でJDKをチェックします:
JDK_HOME
環境変数jdk.home
システムプロパティ
または、JDKのパスを明示的に設定してください:
extensions:
soap:
controllerClass: com.workato.extension.soap.ExtensionController
jdkHome: /path/to/jdk
# ステップ2.5:OPAを再起動する
OPAのドキュメントに従って、OPAを停止し、再起動します。
# ステップ3:SOAPコネクタをインストールする
OPAとSOAP拡張を設定した後、SOAPコネクタをインストールできます。
Workatoアカウントにログインします。
インストールを選択します。
リリースコネクタを選択します。
追加情報
Last updated: 2024/2/13 16:59:53