macOS sur place

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

Préalables :

Exécutez le script d'installation avec l'autorisation sudo ou d'administration et accordez l'autorisation Accès complet au disque.

Note

Par défaut, le script d'installation :

Générez un suivi de l'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 voulez pas activer cette fonction, mettez à jour le paramètre --enable-user-name=false dans le script d'installation. Vous pouvez modifier le fichier de propriétés du traceur d'utilisation Java ultérieurement pour ajouter ou supprimer user.name de la section additionalProperties.
Désactiver le mode FIPS (Federal Information Processing Standards) pour les plugiciels. Pour activer le mode FIPS dans les relais USGov, mettez à jour le paramètre --enable-fips-mode=true dans le script d'installation.
Installez l'agent avec la fréquence de télémétrie inférieure JMS.

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

Voici les paramètres facultatifs ainsi que la description :


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

Étapes

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

$ sudo bash ./JMS_YourFleetName_macos.sh --diagnostic

Selon le système d'exploitation et le type d'agent, les résultats seront similaires à :

Échec 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 réussi :

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

Voir 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 de l'agent de gestion. Exécutez le script à l'aide de la commande suivante :
```
$ sudo bash ./JMS_YourFleetName_macos.sh
```
- Si l'installation réussit, vous verrez un message similaire au suivant :
```
...
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 mettra à jour le logiciel de l'agent vers la dernière version, le cas échéant. Si les plugiciels JMS ne sont pas encore déployés, déployez manuellement les plugiciels Java Usage Tracking et Java Management Service, comme décrit dans la section Déployer un plugiciel de service à l'aide de la page Agents. Vous pouvez également réinstaller l'agent avec le déploiement du plugiciel 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, entrez :
```
$ 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, voir Aperçu de la console des agents de gestion.

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

Documentation sur Oracle Cloud Infrastructure

macOS sur place