[IDMC] Secure Agent のインストール手順（Linux編）

# はじめに（Preface）
Linuxインスタンスへの、Secure Agent のインストール手順を説明します。
This article introduces how to install a Secure Agent onto a Linux instance.

# 用語（Words）

:::note info
<b>Secure Agent</b>
:::

+ **IDMC**と連携してデータ処理を実行するエージェントソフトウェア。
+ 幅広いプラットフォーム (AWS, Azure, GCP, on-premises, etc.) で動作。
+ 複数のSecure Agentをグループ化して負荷分散や冗長化が可能。
+ 詳しくは、<INS><a href="https://qiita.com/naka34/items/b55e67731c9df7b562d2">Qiita解説記事</a></INS>を参照。

https://qiita.com/naka34/items/b55e67731c9df7b562d2

:::note info
<B>IDMC</B>
:::

+ **Informatica**社が法人や官公庁向けに提供しているクラウドサービス。
+ <INS>I</INS>ntelligent <INS>D</INS>ata <INS>M</INS>anagement <INS>C</INS>loud の略。
+ データ活用ソリューションの統合プラットフォーム。
+ 詳しくは、<INS><a href="https://qiita.com/tabe77/items/cb24d22775928727bf82">Qiita解説記事</a></INS> を参照。

https://qiita.com/tabe77/items/cb24d22775928727bf82

:::note infor
<b>Informatica</b>
:::

+ 日本語読みは<b>インフォマティカ</b>。
+ 法人や官公庁向けにデータ活用ソリューションを開発・販売する独立系ベンダー。
+ 米国カリフォルニア州に本社を置き、ニューヨーク証券取引所に上場。
+ 詳しくは、<INS><a href="https://en.wikipedia.org/wiki/Informatica">Wikipedia（英語）</a></INS>または <INS><a href="https://www.scsk.jp/sp/informatica/informatica_scsk/">SCSK社の記事</a></INS> を参照。

https://www.scsk.jp/sp/informatica/informatica_scsk/

# Secure Agent インストールトークンの取得
:::note info
<B>インストールトークン</B>
・インストールトークンは、IDMCとSecure Agentのペアリングに使う事前共有鍵です。
・IDMCの管理者サービス画面で発行し、Secure Agentのインストール時に使います。
:::
IDMCにログインして<b>管理者</b>サービス画面を表示します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/06f91737-a50b-697d-2af1-b148ee5ffbe7.png)

<b>ランタイム環境</b>タブで、<b>インストールトークンの生成</b>ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/7f83aba8-f48d-cdc4-0892-d6c764bae031.png)

<b>インストールトークン</b>が表示されたら、<b>コピー</b>ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/b2b7db16-346b-fab0-9945-b0dc2a7b2c9d.png)

# Secure Agent インストーラーのダウンロード

<b>ランタイム環境</b>タブで、<b>Secure Agentのダウンロード</b>ボタンをクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/7f83aba8-f48d-cdc4-0892-d6c764bae031.png)

インストール先のOSを選択して、<b>ダウンロード</b>をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/4f37e07b-f32b-1c14-c4b5-e84970d725aa.png)

:::note info
<B>Informaticaのリポジトリから直接ダウンロードする方法</B>
・Informaticaのリポジトリからインストーラーを直接ダウンロードすることもできます。
　その場合、この項で説明したIDMCのGUIを使ったダウンロードは不要です。
・次の項では、Linux OSでwgetを使ってコマンドでダウンロードしています。
:::

# Secure Agent のインストール（Linux編）

LinuxインスタンスにSSHでログインします。ここではSSHクライアントとしてMobaXtermを使います。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/5c87355c-27d3-1589-1f6c-1fe6bb57db4a.png)

使用しているOSは、Red Hat Enterprise Linux Server release 7.7 です。
```
[*******@ip-10-75-**-** ~]$ cat /etc/redhat-release
Red Hat Enterprise Linux Server release 7.7 (Maipo)
```

インストール用のユーザーを作成します。
```
[*******@ip-10-75-**-** ~]$ sudo useradd infa

We trust you have received the usual lecture from the local System
Administrator. It usually boils down to these three things:

    #1) Respect the privacy of others.
    #2) Think before you type.
    #3) With great power comes great responsibility.

[sudo] password for *******:
```

作成したユーザーとしてログインします。
```
[*******@ip-10-75-**-** ~]$ su - infa
Password:
```

Secure Agent のインストーラーを、Informatica のサーバーからダウンロードします。

:::note info
<B>ダウンロード元のURL</B>
利用中のIDMCのPOD（≒リージョン）により異なります。
今回は、https://na1.dm-us.informaticacloud.com/saas/download/installer/linux64/agent64_install_ng_ext.bin を指定します。
:::
```
[infa@ip-10-75-**-** ~]$ wget https://na1.dm-us.informaticacloud.com/saas/download/installer/linux64/agent64_install_ng_ext.bin
```
ネットワークの疎通に問題がなければ、以下のようにダウンロードが進みます。
サイズは150 MB程度です。
```
--2023-08-02 17:29:12--  https://na1.dm-us.informaticacloud.com/saas/download/installer/linux64/agent64_install_ng_ext.bin
Resolving na1.dm-us.informaticacloud.com (na1.dm-us.informaticacloud.com)... 99.83.225.209, 75.2.30.109
Connecting to na1.dm-us.informaticacloud.com (na1.dm-us.informaticacloud.com)|99.83.225.209|:443... connected.
HTTP request sent, awaiting response... 302
Location: https://common.dm-us.informaticacloud.com/package-manager/files/binary/agent64_install_ng_ext/6608/linux64/agent64_install_ng_ext.6608.bin [following]
--2023-08-02 17:29:13--  https://common.dm-us.informaticacloud.com/package-manager/files/binary/agent64_install_ng_ext/6608/linux64/agent64_install_ng_ext.6608.bin
Resolving common.dm-us.informaticacloud.com (common.dm-us.informaticacloud.com)... 44.229.211.46, 34.215.62.0
Connecting to common.dm-us.informaticacloud.com (common.dm-us.informaticacloud.com)|44.229.211.46|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 151096308 (144M) [application/octet-stream]
Saving to: ‘agent64_install_ng_ext.bin’

100%[====================================================================================================================================================================>] 151,096,308 2.79MB/s   in 1m 41s

2023-08-02 17:30:56 (1.42 MB/s) - ‘agent64_install_ng_ext.bin’ saved [151096308/151096308]
```
ダウンロード完了後、インストーラー（agent64_install_ng_ext.bin）のパーミッションを777にします。
```
[infa@ip-10-75-**-** ~]$ chmod 777 agent64_install_ng_ext.bin
```
インストーラーを実行します。
```
[infa@ip-10-75-**-** ~]$ ./agent64_install_ng_ext.bin
```
インストールプロセスが順調に進むと、以下のメッセージが表示されます。
```
Preparing to install
Extracting the JRE from the installer archive...
Unpacking the JRE...
Extracting the installation resources from the installer archive...
Configuring the installer for this system's environment...

Launching installer...


Graphical installers are not supported by the VM. The console mode will be used instead...

===============================================================================
Informatica Cloud Secure Agent                   (created with InstallAnywhere)
-------------------------------------------------------------------------------

Preparing CONSOLE Mode Installation...




===============================================================================
Choose Install Folder
---------------------

Where would you like to install?

  Default Install Folder: /home/infa/infaagent

ENTER AN ABSOLUTE PATH, OR PRESS <ENTER> TO ACCEPT THE DEFAULT
      :



===============================================================================
Pre-Installation Summary
------------------------

Please Review the Following Before Continuing:

Product Name:
    Informatica Cloud Secure Agent

Install Folder:
    /home/infa/infaagent

Disk Space Information (for Installation Target):
    Required:      302,462,109 Bytes
    Available: 104,494,039,040 Bytes

PRESS <ENTER> TO CONTINUE:
```
Enterキーを押して先に進みます。
```
===============================================================================
Installing...
-------------

 [==================|==================|==================|==================]
 [------------------|------------------|------------------|------------------]



===============================================================================
Generating Agent Token...

Please Wait
-----------



===============================================================================
Creating softlink...

Please Wait
-----------



===============================================================================
File permission

Please Wait
-----------



===============================================================================
Installation Complete
---------------------

Congratulations. Informatica Cloud Secure Agent has been successfully
installed to:

/home/infa/infaagent

To start the agent, go to directory "<agent_directory>/apps/agentcore" and
then run "infaagent startup". Check the infaagent.log file
for errors, and then visit the Informatica Cloud site to verify that the
agent is active.

PRESS <ENTER> TO EXIT THE INSTALLER:
```
Enterキーを押して、インストールを完了します。
続いて、Secure Agentがインストールされたディレクトリを確認します。
デフォルトでは、/home/(インストールに使用したLinuxアカウント名)/infaagent/apps/agentcore/ です。
```
[infa@ip-10-75-**-** ~]$ cd /home/infa/infaagent/apps/agentcore/
[infa@ip-10-75-**-** agentcore]$ ll
total 56
drwxr--r--. 3 infa infa  4096 Aug  2 17:41 66.08
-rwxr--r--. 1 infa infa    78 Jun  8 16:05 abortAgentCore.sh
-rwxr--r--. 1 infa infa  2442 Jun  8 16:01 agent_start.sh
drwxr--r--. 2 infa infa   160 Aug  2 17:41 conf
-rwxr--r--. 1 infa infa   483 Jun  8 16:05 consoleAgentManager.sh
-rwxr--r--. 1 infa infa   143 Jun  8 16:01 customUninstallScript.sh
drwxr--r--. 2 infa infa     6 Aug  2 17:41 data
-rwxr--r--. 1 infa infa    88 Jun  8 16:05 generateAgentToken.sh
-rwxr--r--. 1 infa infa 15953 Jun  8 16:05 infaagent
-rwxr--r--. 1 infa infa   238 Jun  8 16:01 infaagent.sh
drwxr--r--. 2 infa infa     6 Aug  2 17:41 logs
-rwxr-xr-x. 1 infa infa   409 Jun  8 16:05 proxydetection.sh
-rwxr--r--. 1 infa infa  1413 Jun  8 16:05 runAgentCore.sh
-rwxr--r--. 1 infa infa   695 Jun  8 16:05 version.sh
```
Secure Agentを起動します。
```
[infa@ip-10-75-**-** agentcore]$ ./infaagent startup
```
続いて、Secure AgentをIDMCに登録します。
この際、先にIDMCから取得しておいたインストールトークンを使用します。
```
[infa@ip-10-75-**-** agentcore]$ ./consoleAgentManager.sh configureToken (IDMCのユーザー名) (インストールトークン)
```
ログインに成功すると、以下のメッセージが表示されます。
これで、IDMCにSecure Agentが登録されました。
```
Login with token
```

# IDMC上で Secure Agent の登録完了と起動完了を確認

続いて、IDMC上でSecure Agentの登録状態を確認します。

１．ブラウザでIDMCにログインして<b>管理者</b>サービス画面を表示します。
２．<b>ランタイム環境</b>タブを開きます。
３．一覧に新しいSecure Agentが表示されていれば、IDMCへの登録は成功しています。

:::note info
<B>Secure Agentの名前</B>
デフォルトで、Secure Agentインストール先のホスト名になります。
後から任意の名前に変更することも可能です。
:::

:::note warn
<B>Secure Agentのステータス</B>
「実行されていないサービスがあります」となっていることにお気付きでしょうか？
:::

Secure Agentの名前部分がリンクになっていますので、クリックしてSecure Agentの詳細を見てみます。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/d0233748-d579-ded6-d259-ef97203d5c0e.png)
エージェントサービスの詳細のステータスが**起動中**と表示されています。
実は、この状態でSecure AgentのインストールとIDMCへの登録は完了していますが、
まだ起動中の為このような表示になっています。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/21694265-f3d5-2d6a-7c3c-732bdf0abb4e.png)
しばらく待つと、起動プロセスが全て完了して以下のような表示に変わります。
これでSecure Agentの全てのサービスが正常に立ち上がりました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/5340c07b-9b8d-05bf-c9e9-ce3573098ca0.png)

# 振り返り（Look-back）
Secure Agent のインストールを、以下のステップで行いました。
１．IDMCからインストールトークンを取得
２．Secure Agentをダウンロード（IDMCのGUI上で取得 or リポジトリから直接取得）
３．Secure Agentをインストール
４．Secure AgentをIDMCに登録（インストールトークン使用）
５．IDMC上で Secure Agent の登録完了と起動完了を確認

# 参考リンク（References）
・Secure Agentのインストール（Informatica社の公式ドキュメント）

https://docs.informatica.com/ja_jp/integration-cloud/data-integration/current-version/_getting-started_cloud-data-integration_current-version_ditamap/GUID-0DE1AE2D-F1A6-401A-987C-D45E7EE43AAF.html

# おことわり（Disclaimer）
投稿する記事は私個人の見解であり所属する会社の公式な見解ではありません。
All articles I post onto Qiita are based on just my personal understanding or opinion. That means the articles are not expressed as an official opinion of the company I am belonging to or have belonged to.