Oracle Management Cloud: Agentインストールしてみてみた

[Oracle Management Cloud (OMC)](https://docs.oracle.com/cd/E83857_01/paas/management-cloud/index.html)は、運用データセット全体に対して機械学習と大規模データ技術を活用する、次世代の統合モニタリング、管理、アナリティクス・クラウド・サービスです。
![概要01.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/d0527d03-f28f-c0b0-3a5d-5d5920f8404b.png)
![概要02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/af13789f-78c4-59b1-24d4-b6f3b7a68786.png)
今回、Oracle Cloud Infrastructure(OCI)に作成した Computeと Database Cloud Service(DBCS)を管理してみたいので、まずはOMCを作成して各インスタンスへAgentをインストールしてみてみます。


#■ OMC作成
1) OCIコンソール画面
OCIコンソールメニューから、[プラットフォームサービス] > [Management Cloud]をクリック
![01_OMC作成.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/a35c7df0-8ef0-33f4-58da-490fcc715cdf.png)


2) Instances in Oracle Management Cloud Service画面
[Create Instance]をクリック
![02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/72932e32-63b9-62df-654f-b02269359a70.png)


3) Create Instance画面
以下項目を入力し、[Create]をクリック

	・Name: OMC名
	・Notification Mail: OMC通知先Mail Address

![03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/61b79b75-6848-10fb-dfa6-1c65799f154b.png)

4) OMC作成完了
![05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/72e60663-c32b-9b88-3c4b-ec682ccd9f1d.png)


5) OMCコンソール画面
作成したOMCインスタンスをクリックするとOMCコンソール画面へ遷移します
![06.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/a9f68b31-98a8-31e4-5c02-22f28595ee46.png)


#■ Agent設定
OCIコンソールから、Agentのzipファイルをダウンロードし、管理対象インスタンスへUploadしてインストールします
##● Agent手順概要
より詳しい要件等は[Agent手順概要](https://docs.oracle.com/en/cloud/paas/management-cloud/emaig/you-begin.html#GUID-CCB1E995-2BE8-428F-80B9-548C33BD9E0A)を確認

	- 前提条件を確認
	- クラウド・エージェントをダウンロード
	- 登録キーを作成またはダウンロード
	- 応答ファイル設定（.rspファイル）
	- クラウドエージェントをインストール
	- 監視するエンティティを定義して追加

・

##● Agentダウンロード

1) Oracle Management Cloud Agents画面
[Administration] > [Agent] をクリックし、左にあるリストアイコンから、[Download Agents]をクリック
![03.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/06d0fffa-5270-3266-d419-77fe78e64533.png)



2) Agent Software Download画面
以下項目を入力し、必要なOSのCloud Agentをクリック
![04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/4df5f868-db59-12fb-647f-0cb8623d58ed.png)


3) Download画面
適当なところにファイルをDownload
![05.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/30f8f72f-a8c3-f0d9-1648-933b71b479e9.png)

##● Agentインストール
1) Agent Installインスタンスへログイン

```shell
[mac-book:~ user]$ ssh -id id_rsa opt@tokyo-inst01
```

2) Agent デイレクトリ作成
Agentインストールディレクトリを作成

```shell
[opc@tokyo-inst01 tmp]$ mkdir /opt/omc
```


3) Agent zipファイル転送
Downloadしたzipファイルをインストールするインスタンスへ転送

```shell
[mac-book:~ user]$ scp -i ~/id_rsa  cloudagent_linux.x64_1.53.0.zip opc@10.0.0.2:/home/opt/omc
	cloudagent_linux.x64_1.53.0.zip
```

4) zipファイル転送確認

```shell
[opc@tokyo-inst01 ~]$ ls -l /opt/omc
	合計 315564
	-rw-r--r--. 1 opc docker 323133937  4月 12 03:52 cloudagent_linux.x64_1.53.0.zip
```

5) unzip

```shell
[opc@tokyo-inst01 tmp]$ unzip cloudagent_linux.x64_1.53.0.zip
	Archive:  cloudagent_linux.x64_1.53.0.zip
	inflating: unzip
	inflating: AgentDeployment.sh
	inflating: agentimage.properties
	inflating: agent.rsp
	inflating: agent_software_build.xml
	extracting: agentcoreimage.zip
	inflating: AgentInstall.sh
```

6) unzip確認

```shell
[opc@tokyo-inst01 tmp]$ ls -l
	合計 631244
	-rwxrwxr-x. 1 opc docker     31781  1月  4 20:13 AgentDeployment.sh
	-rwxr-xr-x. 1 opc docker     10122  1月  4 20:13 AgentInstall.sh
	-rw-rw-r--. 1 opc docker      2327  1月  4 20:13 agent.rsp
	-rw-rw-r--. 1 opc docker      1525  1月  4 20:12 agent_software_build.xml
	-rw-rw-r--. 1 opc docker 323048651  1月  4 20:13 agentcoreimage.zip
	-rw-rw-r--. 1 opc docker       226  1月  4 20:13 agentimage.properties
	-rw-r--r--. 1 opc docker 323133937  4月 12 03:52 cloudagent_linux.x64_1.53.0.zip
	-rwxr-xr-x. 1 opc docker    145976  1月  4 20:13 unzip
```


##● Registration Keysダウンロード
応答ファイル設定（.rspファイル）の必要項目Registration Keysを取得

1）Oracle Management Cloud Agents画面
OMC コンソール画面から、[Administration] > [Agent] をクリックし、左にあるリストアイコンから、[Manage Registration Keys]をクリック
![06_RegistrationKey.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/0880b88d-1123-f599-e638-ce788c7b0744.png)



2) Registration Keys画面
以下項目を入力し、[Create New Key]をクリック

	・Name: 任意の名前を設定

![06_RegistrationKey02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/4263876e-76b8-3160-2760-95649c5d0985.png)


3) Registration Keys画面
作成した Registration Keysの右側にあるリストアイコンから、Downloadをクリック
![06_RegistrationKey04.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/be9b3284-8c26-86ba-6305-cebb1a7e3dc0.png)


4) Registration Keys確認

```shell
[mac-book:~ user]$ cat registrationKey.txt
	RegVeTE30PC0tpUCsxp_3fZge
```

##● 応答ファイル設定（.rspファイル）
1) TENANT_NAMEとOMC_URL確認
応答ファイル設定するための環境パラメータ TENANT_NAMEとOMC_URLは、[Administration] > [Agent] > [Download Agent]に移動し、[Agent Type]ドロップダウンリストからAgent Typeを選択すると各パラーメーターが表示されるので、メモします
![06_RegistrationKeyパラメータ確認.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/7e22410c-4579-f8a0-a4f2-66b1cd385a26.png)

2) 応答ファイル(agent.rsp)設定
zip解凍した応答ファイルagent.rspの必要以下項目を設定
・参考: [クラウドエージェントをインストールするためのパラメーター](https://docs.oracle.com/en/cloud/paas/management-cloud/emaig/response-file-cloud-agent.html)

	・TENANT_NAME: 上記でOMC画面で確認した値を設定
	・OMC_URL: 上記でOMC画面で確認した値を設定
	・AGENT_REGISTRATION_KEY: ダウンロードしたRegistration Keys値を設定
	・AGENT_PORT: デフォルト値は 4461

```shell
[opc@tokyo-inst01 tmp]$ vi /home/opt/omc/agent.rsp

	TENANT_NAME=e456d064563aee2b6f14b53923e0bd01963
	AGENT_REGISTRATION_KEY=RegVeTE30PC0tpUCsxp_3fZge
	OMC_URL=https://omc-eb4631ad286a4eb92de9c.api.omc.ocp.oraclecloud.com/
	AGENT_PORT=4461
```

##● Cloud Agentをインストール

1) インストール

```shell
[opc@tokyo-inst01 tmp]$ ./AgentInstall.sh
	Unzipping agent software, this may take some time...
	Installing Cloud Agent...
	Cloud Agent parameter validation started...
	Cloud Agent pre-requisite checks started...
	Cloud Agent base directory creation started...
	Security artifacts download started...
	Cloud Agent setup started...
	Registering Cloud Agent...
	Starting Cloud Agent...
	Cloud Agent started.
	Cloud Agent installation completed.
	Cloud Agent post installation checks started.
	Cloud Agent is up and running.
	Cloud Agent is communicating to Oracle Management Cloud.
	Cloud Agent is monitored in Oracle Management Cloud.
	Cloud Agent post installation checks completed.
	To start Cloud Agent upon Operating System restart include '/home/opc/tmp/omcagent/agent_inst/bin/omcli start agent' in the start-up scripts.
	For further details please refer http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_agent.
```


2) インストールディレクトリ確認

```shell
[opc@tokyo-inst01 omc]$ ls -l
	合計 631316
	-rwxrwxr-x. 1 opc docker     31781  1月  4 20:13 AgentDeployment.sh
	-rwxr-xr-x. 1 opc docker     10122  1月  4 20:13 AgentInstall.sh
	-rwxr--r--. 1 opc docker      9148  4月 12 04:02 AgentInstall_20210412040200.log
	-rwxr--r--. 1 opc docker     24481  4月 12 04:02 AgentInstall_20210412040243.log
	-rwxr--r--. 1 opc docker     24911  4月 12 04:11 AgentInstall_20210412041146.log
	-rw-r--r--. 1 opc docker       193  4月 12 04:13 agent.rsp
	-rw-rw-r--. 1 opc docker      2327  1月  4 20:13 agent.rsp.org
	-rw-rw-r--. 1 opc docker      1525  1月  4 20:12 agent_software_build.xml
	-rw-rw-r--. 1 opc docker 323048651  1月  4 20:13 agentcoreimage.zip
	-rw-rw-r--. 1 opc docker       226  1月  4 20:13 agentimage.properties
	-rw-r--r--. 1 opc docker 323133937  4月 12 03:52 cloudagent_linux.x64_1.53.0.zip
	drwxr-xr-x. 7 opc docker      4096  4月 12 04:13 omcagent
	drwxr-----. 3 opc docker        19  4月 12 04:13 oracle_emd
	-rwxr-xr-x. 1 opc docker    145976  1月  4 20:13 unzip
```

##● Agent起動確認

```shell
[opc@tokyo-inst01 ~]$ /opt/omc/omcagent/agent_inst/bin/omcli status agent
	ulimit for open file descriptors is currently set to 1024.  It must be atleast 4096
	Oracle Management Cloud Agent
	Copyright (c) 1996, 2020 Oracle Corporation.  All rights reserved.
	---------------------------------------------------------------
	Version                : 1.53.0
	State Home             : /opt/omc/omcagent/agent_inst
	Log Directory          : /opt/omc/omcagent/agent_inst/sysman/log
	Binaries Location      : /opt/omc/omcagent/core/1.53.0
	Process ID             : 2763
	Parent Process ID      : 1718
	URL                    : https://tokyo-inst01.publicsubnet01.vcn10000.oraclevcn.com:4461/emd/main/
	Started at             : 2021-04-15 04:10:42
	Started by user        : opc
	Operating System       : Linux version 4.14.35-2025.400.9.el7uek.x86_64 (amd64)
	Data Collector enabled : false
	Sender Status              : FUNCTIONAL
	Gateway Upload Status      : FUNCTIONAL
	Last successful upload     : 2021-04-15 05:01:48
	Last attempted upload      : 2021-04-15 05:01:47
	Pending Files (MB)         : 0
	Pending Files              : 3
	Backoff Expiration         : (none)
	Dispatched Work Encryption : ENABLED

	---------------------------------------------------------------
	Agent is Running and Ready
```

#■ DBCSへCloud Agentインストール
Database Cloud Service も OCI Computeと同様の手順でインストール


1) Agentインストール

```shell
[opc@dbcs01 tmp]$ ./AgentInstall.sh
	Unzipping agent software, this may take some time...
	Installing Cloud Agent...
	Cloud Agent parameter validation started...
	Cloud Agent pre-requisite checks started...
	Cloud Agent base directory creation started...
	Security artifacts download started...
	Cloud Agent setup started...
	Registering Cloud Agent...
	Starting Cloud Agent...
	Cloud Agent started.
	Cloud Agent installation completed.
	Cloud Agent post installation checks started.
	Cloud Agent is up and running.
	Cloud Agent is communicating to Oracle Management Cloud.
	Cloud Agent is monitored in Oracle Management Cloud.
	Cloud Agent post installation checks completed.
	To start Cloud Agent upon Operating System restart include '/tmp/omcagent/agent_inst/bin/omcli start agent' in the start-up scripts.
	For further details please refer http://www.oracle.com/pls/topic/lookup?ctx=en/cloud/paas/management-cloud&id=deploy_agent.
```


2) Agentインストール確認

```shell
[opc@dbcs01 bin]$ /opt/omc/omcagent/agent_inst/bin/omcli status agent
	ulimit for open file descriptors is currently set to 1024.  It must be atleast 4096
	Oracle Management Cloud Agent
	Copyright (c) 1996, 2020 Oracle Corporation.  All rights reserved.
	---------------------------------------------------------------
	Version                : 1.53.0
	State Home             : /opt/omc/omcagent/agent_inst
	Log Directory          : /opt/omc/omcagent/agent_inst/sysman/log
	Binaries Location      : /opt/omc/omcagent/core/1.53.0
	Process ID             : 98300
	Parent Process ID      : 98143
	URL                    : https://dbcs01.publicsubnet01.vcn10000.oraclevcn.com:4461/emd/main/
	Started at             : 2021-04-12 13:12:14
	Started by user        : opc
	Operating System       : Linux version 4.1.12-124.47.3.el7uek.x86_64 (amd64)
	Data Collector enabled : false
	Sender Status              : FUNCTIONAL
	Gateway Upload Status      : FUNCTIONAL
	Last successful upload     : 2021-04-12 13:30:50
	Last attempted upload      : 2021-04-12 13:30:49
	Pending Files (MB)         : 0
	Pending Files              : 2
	Backoff Expiration         : (none)
	Dispatched Work Encryption : ENABLED

	---------------------------------------------------------------
	Agent is Running and Ready
```



#■ Agent自動再起動設定
今回のOSはLinux 7 なので、systemd機能でAgentを自動起動できるようにします

##● 自動起動スクリプト例
自動スクリプトは環境によって異なることがあるので、応じて設定

###1) systemdファイル omcagent.service作成

```shell
[opc@tokyo-inst01 ~]$ sudo vi /etc/systemd/system/omcagent.service
	[Unit]
	Description=Oracle Management Cloud Agent Service

	[Install]
	WantedBy=multi-user.target

	[Service]
	User=opc
	Group=opc
	LimitNOFILE=10000
	LimitNPROC=10000
	ExecStart=/opt/omc/omcagent/agent_inst/bin/omcli start agent
	ExecStop=/opt/omc/omcagent/agent_inst/bin/omcli stop agent
	ExecReload=/opt/omc/omcagent/agent_inst/bin/omcli reload agent
	StandardOutput=syslog
	StandardError=syslog
	Restart=on-abnormal
	RemainAfterExit=yes
```


###2) omcagent.service作成確認

```shell
[opc@tokyo-inst01 ~]$ ls -l /etc/systemd/system/omcagent.service
	-rw-r--r--. 1 root root 352  4月 12 14:03 /etc/systemd/system/omcagent.service
```

###3) omcagent.service自動起動設定

```shell
[opc@tokyo-inst01 system]$ sudo systemctl enable omcagent.service
	Created symlink from /etc/systemd/system/multi-user.target.wants/omcagent.service to /etc/systemd/system/omcagent.service.
```

###4) omcagent.service起動

```shell
[root@tokyo-inst01 system]# systemctl start omcagent.service
```

###5) omcagent.service起動確認

```shell
[root@tokyo-inst01 system]# systemctl status omcagent.service
	● omcagent.service - Oracle Management Cloud Agent Service
	Loaded: loaded (/etc/systemd/system/omcagent.service; enabled; vendor preset: disabled)
	Active: active (running) since 月 2021-04-12 16:15:08 UTC; 15s ago
	Process: 3900 ExecStop=/opt/omc/omcagent/agent_inst/bin/omcli stop agent (code=exited, status=0/SUCCESS)
	Main PID: 26020 (omcli)
	CGroup: /system.slice/omcagent.service
			├─26020 /bin/sh -f /opt/omc/omcagent/agent_inst/bin/omcli start agent
			├─26021 /bin/sh -f /opt/omc/omcagent/agent_inst/bin/emctl start agent
			├─26022 /bin/sh -f /opt/omc/omcagent/core/1.53.0/bin/emctl start agent
			├─26035 /opt/omc/omcagent/core/1.53.0/perl/bin/perl /opt/omc/omcagent/core/1.53.0/bin/emctl.pl start agent
			├─26194 /opt/omc/omcagent/core/1.53.0/perl/bin/perl /opt/omc/omcagent/core/1.53.0/bin/emwd.pl agent /opt/omc/omcagen...
			├─26316 /opt/omc/omcagent/core/1.53.0/jdk/jre/bin/java -Xmx142M -XX:MaxPermSize=128M -server -Djava.security.egd=fil...
			├─26481 sh -c /opt/omc/omcagent/core/1.53.0/bin/emdctl status agent >/dev/null 2>&1
			├─26482 /opt/omc/omcagent/core/1.53.0/bin/emdctl status agent
			└─26483 /opt/omc/omcagent/core/1.53.0/jdk/jre/bin/java -Xmx256m -server -Djava.security.egd=file:///dev/./urandom -D...

	4月 12 16:15:08 dbcs01 systemd[1]: Started Oracle Management Cloud Agent Service.
	4月 12 16:15:08 dbcs01 omcli[26020]: Oracle Management Cloud Agent
	4月 12 16:15:08 dbcs01 omcli[26020]: Copyright (c) 1996, 2020 Oracle Corporation.  All rights reserved.
```


##● omcagent.service自動起動確認
OS再起動してAgentが自動起動することを確認

###1) OS再起動

```shell
[root@tokyo-inst01 system]# shutdown -h now
	・・・< OS再起動 >・・・
```

###2) 自動起動確認
OS再起動後、Agentが自動起動していることを確認

```shell
[root@tokyo-inst01 system]# /opt/omc/omcagent/agent_inst/bin/omcli status agent
	ulimit for open file descriptors is currently set to 1024.  It must be atleast 4096
	Oracle Management Cloud Agent
	Copyright (c) 1996, 2020 Oracle Corporation.  All rights reserved.
	---------------------------------------------------------------
	Version                : 1.53.0
	State Home             : /opt/omc/omcagent/agent_inst
	Log Directory          : /opt/omc/omcagent/agent_inst/sysman/log
	Binaries Location      : /opt/omc/omcagent/core/1.53.0
	Process ID             : 2763
	Parent Process ID      : 1718
	URL                    : https://tokyo-inst01.publicsubnet01.vcn10000.oraclevcn.com:4461/emd/main/
	Started at             : 2021-04-15 04:10:42
	Started by user        : opc
	Operating System       : Linux version 4.14.35-2025.400.9.el7uek.x86_64 (amd64)
	Data Collector enabled : false
	Sender Status              : FUNCTIONAL
	Gateway Upload Status      : FUNCTIONAL
	Last successful upload     : 2021-04-15 05:01:48
	Last attempted upload      : 2021-04-15 05:01:47
	Pending Files (MB)         : 0
	Pending Files              : 3
	Backoff Expiration         : (none)
	Dispatched Work Encryption : ENABLED

	---------------------------------------------------------------
	Agent is Running and Ready
```


#■ OMCコンソール: インスタンス確認
OMCコンソールで、Agentインストールしたインスタンスが登録されていることを確認

1) Oracle Management Cloud Agents画面
[Administration] > [Agent] > [Cloud Agent]タブをクリックし、Agentインストールしたインスタンスが登録されていることを確認
登録されたインスタンス右にあるリストアイコンから、[View Details]をクリック
![10_DBCSインスト追加確認.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/b47005b8-331c-40ad-21b9-8100cdee2b68.png)


2) View Details画面
![10_DBCSインスト追加確認02.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/8d9a0727-a79b-5ff4-c8ec-64c4043f1f38.png)




3) Monitoring: Entities画面
OMCコンソール [Home] > [Monitoring] > [Entities] をクリック
登録されたインスタンスのステータス(状態)を確認できます
![11_Monitiring.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/109087/c92fc22a-aeeb-d8c8-6045-6d2906363d3b.png)

#■ 参考
・[Oracle Management Cloud Agentsのインストールと管理](https://docs.oracle.com/cd/E83857_01/paas/management-cloud/emaig/you-begin.html#GUID-EC54BA43-3246-4DDD-B769-74314978E3E8)
・[Oracle Management Cloud スタート・ガイド](https://docs.oracle.com/cd/E83857_01/paas/management-cloud/index.html)
・[Oracle Management Cloud まとめ](https://qiita.com/western24/items/1e44bfcaa77f3251a263)