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/