OCI Linux

この項では、Oracle Cloud Agentを設定し、インストール・スクリプトを使用してOracle Linuxコンピュート・インスタンスにJMSプラグインをデプロイするステップについて説明します。異なるリージョンまたはテナンシ、およびその他のサポートされているLinuxプラットフォーム内のOracle Linuxインスタンスの場合は、オンプレミスLinuxの手順に従ってOracle Management Agentを設定します。

ノート

OCI Linuxインスタンスをフリートにオンボーディングするための推奨アプローチは、フリートの「管理対象インスタンスの追加」アクションを「管理対象インスタンス」ビューで使用することです。管理エージェントのインストールおよびJMSプラグインのデプロイの手動方法のOCI Linuxの項の手順を参照してください。
OCIインスタンス・プールの場合、OCIインスタンス・プールの各インスタンス部分にエージェントを個別に設定する必要があります。

前提条件:

sudoまたは管理アクセス権を使用してインストール・スクリプトを実行します。
OCI Linuxインスタンスでインストール・スクリプトを実行する前に、次のポリシーが追加されていることを確認してください。
```
 ALLOW dynamic-group JMS_DYNAMIC_GROUP TO MANAGE instances IN
    COMPARTMENT <instance_compartment_ocid>
```

手順は、JMS用のOCI Linuxインスタンスの設定を参照してください。

ノート

デフォルトでは、インストール・スクリプトは次のようになります。

WebLogicやTomcatなどのアプリケーション・サーバーで実行されているアプリケーションをより適切に識別するためにuser.nameプロパティを収集する追加機能を使用して、使用状況トラッカを生成します。この機能を有効にしない場合は、インストール・スクリプトのパラメータ--enable-user-name=falseを更新します。将来、Java Usage Trackerプロパティ・ファイルを変更して、additionalPropertiesセクションにuser.nameを追加または削除できます。
プラグインの連邦情報処理標準(FIPS)モードを無効にします。USGovリラムでFIPSモードを有効にするには、インストール・スクリプトでパラメータ--enable-FIPS-mode=true を更新します。
MACS default telemetry frequencyを使用してエージェントをインストールします。

--helpコマンドを実行して、ユーザー名、プロキシ設定、FIPSなどを有効化または無効化するオプションの説明を表示します。

次に、説明とともにオプション・パラメータを示します。


-u, --uninstall               Uninstall plug-ins, delete configuration files or restore originals from backups and exit.
-r, --reinstall               Uninstall plug-ins, delete configuration files or restore originals from backups and continue installation.
-h, --help                    Print usage message end exit.
--diagnostic                  Determine if prerequisite conditions are met on the host machine to allow successful 
                              agent installation and plug-in deployment.
--enable-user-name            Generate usage tracker with additional functionality to collect the 'user.name' property for better identification 
                              of applications running on Application Servers like WebLogic and Tomcat servers. 
                              Default value is 'true'. 
--enable-fips-mode            Enable FIPS mode for plug-ins in USGov realms.
                              Format is --enable-fips-mode=true|false (for example, --enable-fips-mode=false).
                              Modify /etc/environment and create a line with ENV_AGENT_PLUGIN_FIPS_APPROVED=true or false.
                              Default value is false.
--install-management-agent    Installation of OMA on the OCI compute instance.                               
--uninstall-management-agent  Uninstallation of OMA on the OCI compute instance.                                 
--reinstall-management-agent  Force OMA installation on the OCI compute instance and remove existing OMA.                               
--proxy-host                  Add proxy host to curl commands, add or replace line 'ProxyHost = VALUE' in install key before Management Agent setup.
                              Format is --proxy-host="VALUE" (for example, --proxy-host="100.0.0.10").
                              Default is no proxy.
--proxy-port                  Add proxy port to curl commands, add or replace line 'ProxyPort = VALUE' in install key before Management Agent setup.
                              Format is --proxy-port="VALUE" (for example, --proxy-port="8050").
--proxy-user                  Add proxy user to curl commands, add or replace line 'ProxyUser = VALUE' in install key before Management Agent setup.
                              Format is --proxy-user="VALUE" (for example, --proxy-user="opc").
--proxy-password              Add proxy password to curl commands, add or replace line 'ProxyPassword = VALUE' in install key before Management Agent setup.
                              Format is --proxy-password="VALUE" (for example, --proxy-password="example").
--proxy-realm                 Add or replace line 'ProxyRealm = VALUE' in install key before Management  Agent setup.
                              Format is --proxy-realm="VALUE" (for example, --proxy-realm="OC1").
--use-agent-installer-path    Path to management agent installation file if it isn't in the same folder as the install script.
--use-java-path               Specify the Oracle Java 8 installation path for agent installation.  
                              If the path is not specified, the script will attempt to find a suitable Oracle Java 8 installation path from the file system. 
                              Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path=/usr/java/jdk1.8.0_361)).

ステップ

(オプションの診断チェック)インストールスクリプトおよび管理エージェントソフトウェアを保存したフォルダに移動します。次のコマンドを使用してスクリプトを実行します。

$ sudo bash ./JMS_YourFleetName_linux.sh --diagnostic

オペレーティング・システムおよびエージェント・タイプに応じて、結果は次のようになります。

診断に失敗しました:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI endpoint? : No
	Check your internet connection and proxy setting.
Is clock sync with OCI platform? : Unknown
	The clock sync check was skipped. Can't read headers as provided OCI endpoint is not reachable.
Certificate verification has been passed? : Unknown
	The certificate check was skipped. Can't read certificate as provided OCI endpoint is not reachable.
Prerequisites for Oracle Cloud Agent were installed? : No
	OCI Metadata and Instance Config are not available but are required for installation.
	Try to manually install 'oci-metadata' and run the JMS_YourFleetName_linux_updated.sh script again.
	Or force Management Agent installation on the instance using the '--install-mgmt-agent' argument.
Meets Java requirement? : No
	Management Agent requires a minimum Oracle JDK 1.8 (1.8.0_281). The recommended version is 1.8.0_361 or later.
	Try to install Java manually and run the JMS_YourFleetName_linux_updated.sh script again.
Valid Management Agent installer? : No
	Found 0 files with the 'oracle.mgmt_agent*.rpm' pattern in the /home/opc folder.
	Run the JMS_YourFleetName_linux_updated.sh script again with the '--use-agent-installer-path' parameter.
Existing Management Agent has been detected? : No
=================================================================================================================================================================================
Diagnostics have failed. Please resolve all issues and run script JMS_YourFleetName_linux_updated.sh again.
Please refer troubleshooting guide https://docs.oracle.com/en-us/iaas/jms/doc/troubleshooting.html for more details.

A copy of this installation log can be found at /var/log/oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log

診断は正常に完了:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI endpoint? : Yes
Certificate verification has been passed? : Yes
Is clock sync with OCI platform? : Yes
Meets Java requirement? : Yes
Certified OS for Oracle Cloud Agent? : Yes
Oracle Cloud Agent has been detected? : Yes
=======================================================================================================================================================
Diagnostics have finished running and no error occurred.

A copy of this installation log can be found at /var/log/oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log

解決策または推奨事項を含む質問の完全なリストは、エージェント・インストール診断の実行を参照してください。

インストールスクリプトおよび管理エージェントソフトウェアを保存したフォルダに移動します。次のコマンドを使用してスクリプトを実行します。

$ sudo bash ./JMS_YourFleetName_linux.sh

インストールが成功すると、次のようなメッセージが表示されます。

...
Management Agent installation has been completed.
Management Agent plugin 'Java Management Service' installation has been completed.
Management Agent plugin 'Java Usage Tracking' installation has been completed.
Management Agent was successfully registered using key YourFleetName (ocid1.managementagentinstallkey.oc1.iad.<ocid hash>).Assigned JMS Fleet is YourFleetName (ocid1.jmsfleet.oc1.iad.<ocid hash>).

(オプション)管理エージェントが実行されているかどうかを確認するには、Linuxマシンで次のスクリプトを実行します。
```
curl -H "Authorization: Bearer Oracle" http://169.254.169.254/opc/v2/instance/
```
169.254.169.254は、OCIコンピュート・インスタンスMetadataサービスのIPアドレスです。
インストールが成功すると、次のようなメッセージが表示されます。
```
{    
 "desiredState": "ENABLED",
 "name": "Management Agent"
},
{
 "desiredState": "ENABLED",
 "name": "Oracle Java Management Service"
}
```

ログ・ファイルは、/var/log/oracle-cloud-agent/plugins/oci-jms/ディレクトリにあります。

Oracle Cloud Infrastructureドキュメント