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

# はじめに

前回（より時間は経ってしまいましたが）は、WindowsへのOn-prem Agentのインストールについて説明しました。

https://qiita.com/tabimoba/items/2ce6dd12f81341de336b

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

# 注意事項

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/f47923f6-7fd4-0c07-d8dd-e8af937ff2f0.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)

## ７．ディストリビューションにあわせて、ファイルのダウンロートとインストール、あるいはディストリビューションのパッケージリポジトリ設定を行います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/81ebc883-d7ff-f37e-d75a-31eb39566859.png)

### tar.gz：ディストリビューション非依存
#### １）上記「Download installer」を右クリックし、「リンクのアドレスをコピー」をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/adca9968-2995-f37a-210b-7e6aa392c259.png)


#### ２）以下の通りコマンドの入力を進めます。

```sh
$ sudo -s
# cd /opt
# wget <Download installerのリンク先URL（上記手順で「リンクのアドレスをコピー」したURL）>
# tar zxvf workato-agent-linux-amd64-x.xx.x.tar.gz
# mv workato-agent-linux-amd64-x.xx.x workato
# groupadd -r workato
# useradd -c "Workato On-Premise Agent" -g workato -s /sbin/nologin -r -d /opt/workato-agent workato
# chown -R workato:workato /opt/workato-agent
```

### rpm：Redhat系（RHEL, RockyLinux, AlmaLinux, CentOS7等）をお使いの場合

https://docs.workato.com/on-prem/groups/add-agent/linux-rpm.html#on-premise-agent-installation-using-rpm-linux-package

### deb：Debian系（Debian, Ubuntu等）をお使いの場合

https://docs.workato.com/on-prem/groups/add-agent/linux-deb.html

## ８．Workatoへ戻り、「Download agent key」をクリック、証明書をダウンロードします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/70c2f420-9fb3-00c1-4316-837bba19dc85.png)

## ９．ダウンロードした証明書をエージェントのインストール先へコピー（アップロード）します。
転送用のソフトウェアはどのようなものでも構いませんが、Windowsの場合はTeraTermを使用するのが手軽です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/50e0f630-dffe-b898-5a3e-4e7780dcdf8e.png)

## １０．アップロードした証明書ファイルを展開し、展開されたファイルを所定のディレクトリへ移動します。

### tar.gz
以下のコマンドを実行します。

```sh
# unzip cert.zip
# mv cert.key /opt/workato-agent/conf/
# mv cert.pem /opt/workato-agent/conf/
```

### rpm, deb
以下のコマンドを実行します。

```sh 
# unzip cert.zip
# mv cert.key /etc/workato-agent/
# mv cert.pem /etc/workato-agent/
```

## サービスとして登録し、On-prem Agentを起動します。
### tar.gz

#### １）以下のコマンドを入力し、systemdのユニットファイルを作成します。

```ini
# sudo cat > /lib/systemd/system/workato-agent.service <<EOF
# Systemd unit file for default Workato On-Premise Agent
#
# To create clones of this service:
# DO NOTHING, use workato@.service instead.

[Unit]
Description=Workato On-Premise Agent
After=syslog.target network.target

[Service]
Type=simple
WorkingDirectory=/opt/workato
ExecStart=/usr/bin/java -Djava.security.egd=file:/dev/urandom -cp "/opt/workato/lib/*" com.workato.agent.Main
User=workato

[Install]
WantedBy=multi-user.target
EOF
```

#### ２）以下のコマンドを実行します。

```sh 
# systemctl start workato-agent.service
# systemctl enable workato-agent.service
```

### rpm, deb
以下のコマンドを実行します。

```sh 
# systemctl start workato-agent.service
# systemctl enable workato-agent.service
```

## １１．Workatoへ戻り、「Next」をクリックします。
(6) Move to server, (7)Setup OPA, (8)Run agent 全て「Next」をクリックして進めます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/c6c86ff0-e42b-b6c9-234e-5eb6a320cd96.png)
↓
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/4b3bc817-e3d7-4642-4bd1-abc7580bdd15.png)
↓
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/64876/464b479f-ce4a-8a5b-f85b-47424ac66308.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/groups/add-agent.html

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

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