Workato：On-prem Agentでオンプレミスと接続する（Windowsへのエージェントインストール）

# はじめに

前回は、On-prem Agentの概要について説明しました。

https://qiita.com/tabimoba/items/120e01177f4b147761da

今回は、Windowsへのエージェントインストール方法について説明します。

# 注意事項

TLSインスペクションを行うセキュリティ製品が導入されている環境においては、On-prem agentが動作しない（利用できない）場合があります。
そのような環境においては、セキュリティ製品の設定変更が必要となる場合があります。
セキュリティ製品に関すること、セキュリティ製品の設定変更に関することは、所属されている組織の情報システム部門等へご確認ください。

# 手順
## １．「Tools」-「On-prem groups」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/4fb7b0d0-12c6-f942-77cc-4d50b9dfe38e.png)

## ２．「Create HA on-prem group」または「New group」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/2d6e3993-c2dd-b455-5d4b-eaa8006665c9.png)

## ３．Group nameに任意の名称を入力し、「Create group」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/b371f9d7-64f4-9fa5-c0b8-3ca5d24891b4.png)

## ４．「Add on-prem agent」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/c80a36ef-4d1c-1108-07aa-3d1d095e1eaf.png)

## ５．Agent nameにエージェント名（任意の名称）を入力し、Operating systemでエージェントインストール先環境のOSを選択し、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/7bb1c78f-c9eb-5eb1-0cf5-31bde740dd0c.png)

## ６．「I have read and agree to the above End User License Agreement」にチェックを入れ、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/d98ecd7b-faf6-7786-3013-cee22cd9e1ab.png)

## ７．「Download installer」をクリックし、ファイルをダウンロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/076471cf-f635-bb7f-61b2-917b2cce1714.png)

## ８．ダウンロードしたファイルを実行し、インストールを進めます。
### Windows
#### １）インストーラーを実行します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/117c25d9-7566-1c00-8036-297cfd994ac9.png)

#### ２）「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/813caed0-1ef7-a7a1-3f45-fe55e3e504c9.png)

#### ３）インスタンス名（任意の名称）を入力し、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/28639203-ee0e-8865-4f5a-c8eef044e046.png)

#### ４）インストール先を確認し、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/25a34fff-9cee-df2b-a092-4d67d25323ec.png)

#### ５）スタートメニューの登録先フォルダを確認し、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/a53fbd93-9437-02f0-e2ce-06f672af4cc8.png)

#### ６）設定を変更せず、そのまま「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/34031028-d223-968e-f664-8eb84719b5f0.png)

#### ７）「Install」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/f2b45d7a-0ec8-8e02-07bc-2fed69738285.png)

#### ８）インストールが開始します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/c0f63a01-6274-3a7b-bd50-6392ed0cada9.png)


#### ９）「Finish」をクリックして、インストールを完了します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/b074df72-3b88-6e52-e6c7-53b523972465.png)


## ９．Workatoへ戻り、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/d30eff05-6c2f-f5cb-2e17-e239fd1b001d.png)

## １０．「Download agent key」をクリック、証明書をダウンロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/fadf6263-32c3-2cfb-70af-eaacdef6df1e.png)

## １１．証明書ファイルを展開します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/64f77557-fe18-a2a3-ddfe-84b9a66e99bc.png)

## １２．Workatoのインストール先フォルダを開き、「conf」フォルダを開きます。
通常は、`C:\Program Files\Workato Agent <Instance name>` にインストールされます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/745cbb07-f9f8-208b-d75e-3acf3e00dc98.png)

※ `<Instance name>`は、インストール時に指定した名称です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/7d6bf26e-2d69-a88a-4378-a24e89188b09.png)

## １３．証明書ファイルをconfフォルダへコピーします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/42d927a0-0684-1e82-129c-fa0e2c673e60.png)

## １４．スタートボタンを押下し、「Workato」-「Run <Instance name> Agent (console)」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/473e069f-11de-7555-07bd-9fb844eef0a3.png)

## １５．エラーなくOn-prem Agentが実行できることを確認します。
※エラーが発生した場合は、証明書ファイルが正しく配置されていること、設定ファイルに誤りがないことを確認ください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/f52b6aab-994b-378f-1be5-ebb9ccfd1dbb.png)

問題ないことを確認後、「×」ボタンをクリックし、ウインドウを閉じます。

## １６．Windowsのスタートボタンをクリックし、「Windows管理ツール」－「サービス」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/dc0cc438-8e42-ada2-72f9-0d40a66a9239.png)

## １７．Workato on-prem agentサービスを右クリックし、「Start」または「開始」をクリックし、サービスをスタートします。
Workato on-prem agentのサービス名は、`Workato on-prem agent <Instance name>` です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/fa18506f-d754-a874-428f-ed428c8354c3.png)

※サービススタート時に以下のようなエラーが表示された際は、証明書ファイルが正しく配置されていること、設定ファイルに誤りがないことを確認ください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/cfc4aff2-0ba0-916d-5bb1-aa3e2b5bd323.png)

## １８．Workatoへ戻り、「Next」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/e16b07aa-b7e8-a407-defe-bbd74bf2eb75.png)

## １９．「Next」をクリックし、次へ進みます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/7775244a-ae00-ff7f-b53b-daeb5e11e724.png)

## ２０．「Test agent」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/4bf49adb-dbaf-52ee-7cbb-3072ef85864a.png)

## ２１．テストが成功したことを確認し、「Done」をクリックします。
※テストに失敗した場合は、設定を確認してください。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/f35ceecf-6a21-9859-e8dd-b65d4afd8c78.png)

## ２２．エージェントが追加され、ステータスが「Active」であることを確認します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/5ba5275f-a2de-f788-2cf2-9fafcca36d42.png)

# 参考

https://docs.workato.com/on-prem/agents/setup.html

https://docs.workato.com/on-prem/agents/run.html