More than 3 years have passed since last update.

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

Last updated at 2021-04-15Posted at 2021-04-15

Oracle Management Cloud (OMC)は、運用データセット全体に対して機械学習と大規模データ技術を活用する、次世代の統合モニタリング、管理、アナリティクス・クラウド・サービスです。

今回、Oracle Cloud Infrastructure(OCI)に作成した Computeと Database Cloud Service(DBCS)を管理してみたいので、まずはOMCを作成して各インスタンスへAgentをインストールしてみてみます。

■ OMC作成

OCIコンソール画面
OCIコンソールメニューから、[プラットフォームサービス] > [Management Cloud]をクリック
Instances in Oracle Management Cloud Service画面
[Create Instance]をクリック
Create Instance画面
以下項目を入力し、[Create]をクリック

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

OMC作成完了
OMCコンソール画面
作成したOMCインスタンスをクリックするとOMCコンソール画面へ遷移します

■ Agent設定

OCIコンソールから、Agentのzipファイルをダウンロードし、管理対象インスタンスへUploadしてインストールします

● Agent手順概要

より詳しい要件等はAgent手順概要を確認

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

・

● Agentダウンロード

Oracle Management Cloud Agents画面
[Administration] > [Agent] をクリックし、左にあるリストアイコンから、[Download Agents]をクリック
Agent Software Download画面
以下項目を入力し、必要なOSのCloud Agentをクリック
Download画面
適当なところにファイルをDownload

● Agentインストール

Agent Installインスタンスへログイン

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

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

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

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

[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

zipファイル転送確認

[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

unzip

[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

unzip確認

[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]をクリック

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

・Name: 任意の名前を設定

Registration Keys画面
作成した Registration Keysの右側にあるリストアイコンから、Downloadをクリック
Registration Keys確認

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

● 応答ファイル設定（.rspファイル）

TENANT_NAMEとOMC_URL確認
応答ファイル設定するための環境パラメータ TENANT_NAMEとOMC_URLは、[Administration] > [Agent] > [Download Agent]に移動し、[Agent Type]ドロップダウンリストからAgent Typeを選択すると各パラーメーターが表示されるので、メモします
応答ファイル(agent.rsp)設定
zip解凍した応答ファイルagent.rspの必要以下項目を設定
・参考: クラウドエージェントをインストールするためのパラメーター

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

[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をインストール

インストール

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

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

[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起動確認

[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と同様の手順でインストール

Agentインストール

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

Agentインストール確認

[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作成

[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作成確認

[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自動起動設定

[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起動

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

5) omcagent.service起動確認

[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再起動

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

2) 自動起動確認

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

[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インストールしたインスタンスが登録されていることを確認

Oracle Management Cloud Agents画面
[Administration] > [Agent] > [Cloud Agent]タブをクリックし、Agentインストールしたインスタンスが登録されていることを確認
登録されたインスタンス右にあるリストアイコンから、[View Details]をクリック
View Details画面
Monitoring: Entities画面
OMCコンソール [Home] > [Monitoring] > [Entities] をクリック
登録されたインスタンスのステータス(状態)を確認できます

■ 参考

・Oracle Management Cloud Agentsのインストールと管理
・Oracle Management Cloud スタート・ガイド
・Oracle Management Cloud まとめ

You get articles that match your needs
You can efficiently read back useful information
You can use dark theme

What you can do with signing up