【Oracle】JMS（Java Management Services) 設定マニュアル 2025年7月現在。

Oracle JMS Installer (macOS Aarch64 v9.0.123) – Troubleshooting & Install Guide

This guide is based on real-world installation of Java Management Service (JMS) and Oracle Management Agent (OMA) on macOS (Apple Silicon) using the v9.0.123 installer.

現在、インストーラーを使った設定が可能となっており、従来と比べ、設定は非常に簡単となっております。
以前、インストールした古いエージェントのクリーンアップ作業から始めましょう！

✅ 1. Prerequisites

Requirement	Value
OS	macOS (Apple Silicon, Aarch64)
Installer folder	jms_setup_v9.0.123_macos-aarch64 (untarred)
Config file	JMS_configuration.rsp
Run as	sudo (root required)

---

🧼 2. Full Cleanup Steps (Before Reinstalling)

Run the following commands in Terminal:

sudo launchctl remove com.oracle.macs.agent.mgmt_agent 2>/dev/null
sudo rm -rf /Library/Oracle/mgmt_agent
sudo rm -rf /Library/Oracle/JMSInstallScript
sudo rm -f /Library/LaunchDaemons/com.oracle.macs.agent.mgmt_agent.plist
sudo rm -f /etc/sudoers.d/91-mgmt-agent-external-plugins
sudo rm -f /Library/Oracle/jms_mgmt_agent_java8
sudo rm -f /Library/Oracle/java/usagetracker.*
sudo rm -rf /tmp/oracle.mgmt_agent*

Then:

sudo reboot

---

📂 3. Required Folder Structure

Example layout in your working directory:

jms/
├── JMS_configuration.rsp
└── jms_setup_v9.0.123_macos-aarch64/
    ├── setupJMS.sh
    ├── app/
    ├── runtime/
    ├── README.txt
    └── uninstaller.sh

Make sure:

• JMS_configuration.rsp is outside the jms_setup_* folder
• You run the script from inside jms_setup_v9.0.123_macos-aarch64

---

▶️ 4. Installation Command

cd jms_setup_v9.0.123_macos-aarch64
sudo ./setupJMS.sh --configuration-file-path=../JMS_configuration.rsp --force

---

⚠️ 5. Common Errors & Fixes

Message	Cause	Fix
unzip: cannot find or open , .zip	Corrupted temp or missing file	Use --force and confirm folder layout
Agent already installed	Residual old files	Run full cleanup first
Diagnostics have failed	Pre-check failed	Use --force
omcli: command not found	Incomplete install	Cleanup and re-run
Management Agent not found	Partial install	Cleanup and retry

---

🔍 6. Verifying the Installation

sudo launchctl print system/com.oracle.macs.agent.mgmt_agent | grep state

Should return:

state = running

Optional – check logs:

tail -f /Library/Oracle/mgmt_agent/agent_inst/logs/agent.log

---

☁️ 7. OCI Console Confirmation

Go to:

OCI Console → Observability & Management → Java Management → Fleets → Managed Instances

Your macOS host should appear in ~5–10 minutes.

---

🧹 8. Uninstall

cd jms_setup_v9.0.123_macos-aarch64
sudo ./uninstaller.sh --configuration-file-path=../JMS_configuration.rsp

---

📄 Log File Locations

Installation logs:

/Library/Oracle/JMSInstallScript/JMSInstallerLogs-<timestamp>.log

Agent logs:

/Library/Oracle/mgmt_agent/agent_inst/logs/