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

# はじめに（Preface）
Windowsインスタンスへの、Secure Agent のインストール手順を説明します。
This article introduces how to install a Secure Agent onto a Windows 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を使ったダウンロードは不要です。
:::

# Secure Agent のインストール（Windows編）
この項では、Windows OSの場合の手順を説明します。
１．ダウンロードしたSecure Agentインストーラーを**管理者として実行**します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/a9a6dd8c-a951-1926-856c-0d3d59fd0184.png)
２．インストールウィザードが起動します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/7c1aab44-c441-208d-594e-31957fb6025b.png)
３．言語を選択します。（日本語も選択可能）
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/59daf71b-90a9-ba6c-7894-d74d3d86e9bd.png)
４．Secure Agentをインストールするパスを指定します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/baeeb87d-4e9d-2842-5caf-e278578eae18.png)
５．確認して**インストール**をクリックします。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/09da2696-0a88-2a39-8314-693a4e184a3d.png)
６．インストール中です。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/59e79b6a-0798-ef74-a107-43978ebcb8a4.png)
７．**IDMCのユーザー名**と**インストールトークン**を入力して、Secure AgentをIDMCに登録します。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/d2d98019-5b05-1a7b-2aac-36bc6e226ebf.png)
８．これで、インストールとIDMCへの登録が完了しました。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/5721c3b8-653e-7925-2511-ba8a2c1183b4.png)

:::note warn
<b>「準備ができていないサービスがあります」の表示</b>
この状態でSecure AgentのインストールとIDMCへの登録は完了していますが、
インストール直後はバックグラウンドで関連サービスの起動プロセスと必要ファイルのダウンロードが続いているため、このような表示になっています。
:::

９．しばらく待っていると、バックグラウンドで行われていた起動プロセスが完了して、
　　**すべてのサービスが稼働中です**の表示に変わります。
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/b7971960-f12b-4d72-81fa-8943aa1a8118.png)

:::note info
<b>データ処理中にローカルファイルを読み書きしたい場合</b>
Secure Agentを、対象ファイルの操作権限があるアカウントで動かす必要があります。
アカウントは、<INS>Informatica Cloud Secure Agent</INS> サービスのプロパティ画面で変更可能です。
:::
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/87cb3f08-382e-3de1-cc7d-d87cc29d67b0.png)
![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/3520588/02b39e29-d817-db17-cb57-39f0731bfd0e.png)

# 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.