Sur site macOS

Cette section décrit les étapes de configuration de l'agent de gestion Oracle et de déploiement des modules d'extension JMS sur l'hôte macOS à l'aide du script d'installation.

Prérequis :

Exécutez le script d'installation avec sudo ou un accès administratif et accordez le droit d'accès complet au disque.

Remarque

Par défaut, le script d'installation :

Générez un suivi d'utilisation avec des fonctionnalités supplémentaires pour collecter la propriété user.name afin de mieux identifier les applications exécutées sur des serveurs d'applications tels que WebLogic et Tomcat. Si vous ne souhaitez pas activer cette fonctionnalité, mettez à jour le paramètre --enable-user-name=false dans le script d'installation. Vous pouvez modifier le fichier de propriétés Java Usage Tracker ultérieurement pour ajouter ou enlever user.name de la section additionalProperties.
Désactiver le mode FIPS (Federal Information Processing Standards) pour les plug-ins. Pour activer le mode FIPS dans les relams USGov, mettez à jour le paramètre --enable-fips-mode=true dans le script d'installation.
Installez l'agent avec une fréquence de télémétrie JMS inférieure.

Exécutez la commande --help pour afficher la description des options telles que l'activation ou la désactivation du nom utilisateur, des paramètres de proxy, FIPS, etc.

Les paramètres facultatifs et la description sont les suivants :


-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                Determines if prerequisite conditions are met on the host machine to allow for successful agent installation or upgradation, and plug-in deployment. 
                            Installation attempt will be skipped.
--enable-user-name          Generate usage tracker with additional functionality to collect the user.name property for better
                            identification of applications running in Application Servers like Weblogic and Tomcat servers.
                            If you want to disable this feature, update the parameter --enable-user-name=false in the installation script.
                            Alternatively, modify /Library/Application Support/Oracle/Java/usagetracker.properties and add or remove 'user.name' in 'additionalProperties'.
                            Default value is true.
--enable-fips-mode          Enable FIPS mode for plugins in USGov realms.
                            Format is --enable-fips-mode=true|false (for example, --enable-fips-mode=false).
                            Modify /etc/bashrc and create a line with ENV_AGENT_PLUGIN_FIPS_APPROVED=true or false.
                            Without this parameter script won't change anything in /etc/bashrc file.
--ignore-unsupported        The setup will proceed on an unsupported platform. 
                            Installation might be successful, but not all functionality might work as intended.
--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. All proxy parameters are optional.
--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-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").
--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").
--use-agent-installer-path  Use this file to set up Management Agent. Optional parameter.
                            If exists, script won't try to find installation files in current folder.   
                            Use the absolute path and not a relative path. For example, --use-agent-installer-path="User/testuser/Downloads"
--use-java-path             Use the Java Installation on this path to set up Management Agent. Optional parameter
                            Use the absolute path and not a relative path. Format is --use-java-path="JAVA_PATH" 
                            (for example, --use-java-path=/Library/Java/JavaVirtualMachines/jdk1.8.jdk/Contents/Home). 
--use-agent-display-name    Specify the name to be displayed on the MACS console of your Management Agent.
                            If the name is not specified, the script will generate the name automatically.

Etapes

(Vérification de diagnostic facultative) Accédez au dossier dans lequel vous avez enregistré le script d'installation et le logiciel d'agent de gestion. Exécutez le script à l'aide de la commande suivante:

$ sudo bash ./JMS_YourFleetName_macos.sh --diagnostic

En fonction du système d'exploitation et du type d'agent, les résultats sont similaires à :

Echec du diagnostic :

======================================================================================================
Diagnostic Summary
======================================================================================================
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
Available Java for agent installation ? : Yes
Management Agent installer available? : No
	Script JMS_YourFleetName_macos.sh can't find the Management Agent installer /kkk.
	Check if the path /kkk exists and check 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_macos.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 /Library/Oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log

Diagnostic terminé :

======================================================================================================
Diagnostic Summary
======================================================================================================
User has sudo/root privileges? : 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
Existing Management Agent has been detected? : No
Available Java for agent installation ? : Yes
Management Agent installer available? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

Reportez-vous à Exécution des diagnostics d'installation d'agent pour obtenir la liste complète des critères vérifiés lors des diagnostics, ainsi que des solutions ou des recommandations.

Accédez au dossier dans lequel vous avez enregistré le script d'installation et le logiciel d'agent de gestion. Exécutez le script à l'aide de la commande suivante:
```
$ sudo bash ./JMS_YourFleetName_macos.sh
```
- Si l'installation est terminée, un message semblable au suivant s'affiche :
```
...
Management Agent installation has been completed with 'Java Usage Tracking service plugin (Service.plugin.jms)'
JMS basic features will be enabled on this instance.
Management Agent installation has been completed with 'Java Management service plugin (Service.plugin.jm)'
JMS advanced features can be enabled on this instance.
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>).
```
- Si l'agent est déjà installé, le script met à jour le logiciel de l'agent vers la dernière version, le cas échéant. Si les modules d'extension JMS ne sont pas encore déployés, déployez manuellement les modules d'extension Java Usage Tracking et Java Management Service comme décrit dans la section Déploiement d'un module d'extension de service à l'aide de la page Agents. Vous pouvez également réinstaller l'agent avec le déploiement de module d'extension JMS. Exécutez le script avec le paramètre --force.
(Facultatif) Pour vérifier si l'agent de gestion est en cours d'exécution, saisissez :
```
$ sudo launchctl print system/com.oracle.macs.agent.mgmt_agent | grep state
```
Les résultats afficheront :
```
state = running
```
Vous pouvez également afficher la console pour vérifier si l'agent de gestion est en cours d'exécution. Pour plus d'informations, reportez-vous à Présentation de la console Agents de gestion.

Les fichiers journaux se trouvent dans le répertoire /Library/Oracle/mgmt_agent/plugins/jm/stateDir/log.

Documentation Oracle Cloud Infrastructure

Sur site macOS