OCI et Windows sur place

Cette section décrit les étapes de configuration de l'agent de gestion Oracle et de déploiement des plugiciels JMS sur un hôte Windows OCI ou sur place à l'aide du script d'installation. Les parcs JMS ne prennent pas en charge Oracle Cloud Agent pour Windows OCI. Par conséquent, le script installe OMA sur toutes les plates-formes Windows.

Préalables :

Exécutez le script d'installation avec les privilèges d'administrateur.

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 de la fonction de suivi de l'utilisation Java à l'avenir pour ajouter ou supprimer user.name de la section additionalProperties.
Installez l'agent avec la configuration Fréquence de télémétrie inférieure JMS.
Dans les systèmes binaires Windows 64, vous avez la possibilité d'utiliser la fréquence de télémétrie par défaut MACS au lieu de la fréquence de télémétrie inférieure JMS. Remplacez la valeur du paramètre low-telemetry-interval par false dans le script d'installation. La valeur par défaut est true.
Créez la variable d'environnement OVERRIDE_VERSION_CHECK si elle n'est pas présente et réglez-la à true sur les instances Windows 10, en remplaçant la vérification de version du service d'agent de gestion. Le service d'agent de gestion ne prend en charge que le service de gestion Java sur la plate-forme Windows 10.

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, 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 on Application Servers like WebLogic and Tomcat servers. 
                             Default value is 'true'. 
--force-32bit-installer      Force 32 bit Management Agent installation. Use this parameter to monitor a 32 bit Windows instance.
--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.
--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   Path to management agent installation file if it isn't in the same folder as the install script. 
                             Use the absolute path and not a relative path. For example, --use-agent-installer-path="C:\User\vmUser\Downloads"
--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. 
                             Use the absolute path and not a relative path. Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path="C:\Program Files\Java\jdk1.8.0_451").  
--low-metrics-frequency      Installs the agent with low frequency telemetry configuration instead of MACS default frequency. 
                             Default value is 'true'. Applicable on Windows 64 bit instances only. 
--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

Ouvrez PowerShell en tant qu'administrateur.

Note

PowerShell version 5.1 ou toute version inférieure à 7 est requise pour exécuter le programme d'installation ou le script d'installation.
Pour vous assurer que vous disposez des autorisations appropriées pour exécuter le script, entrez Set-ExecutionPolicy RemoteSigned et répondez A.

(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 :

.\JMS_YourFleetName_windows.ps1 --diagnostic

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

Échec du diagnostic :

======================================================================================================
Diagnostic Summary
======================================================================================================
User has administrator privileges? : Yes
Powershell version meets requirements? : Yes
Certified OS? : 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 from provided OCI endpoint.
Certificate verification has been passed? : Unknown 
The certificate check was skipped. Can't read certificate from provided OCI endpoint.
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Available Java for agent installation ? : Yes
Management Agent installer available? : Yes
======================================================================================================
Diagnostics have failed. Please resolve all issues and run the deployMgmtAgent.ps1 script again.

Diagnostic réussi :

======================================================================================================
Diagnostic Summary
======================================================================================================
User has administrator privileges? : Yes
Powershell version meets requirements? : Yes
Certified OS? : Yes
Able to reach OCI endpoint? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
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 questions avec des solutions ou des recommandations.

Accédez au dossier dans lequel vous avez téléchargé le script et le logiciel de l'agent de gestion. Exécutez le script à l'aide de la commande suivante :
```
.\JMS_YourFleetName_windows.ps1
```
- Si l'installation réussit, un message similaire à celui qui suit s'affiche :
```
...
Agent was successfully registered using key YourFleetName (ocid1.managementagentinstallkey.oc1.<ocid hash>) and assigned to fleet YourFleetName (ocid1.jmsfleet.oc1.<ocid hash>)
Management Agent with plugins installation has been completed.
```
- Si l'agent est déjà installé, le script mettra à jour le logiciel de l'agent à la dernière version, le cas échéant. Si les plugiciels JMS ne sont pas encore déployés, déployez les plugiciels Suivi de l'utilisation Java et Java Management Service manuellement, comme décrit dans la rubrique Déployer un plugiciel de service à l'aide de la page Agents. Ou, vous pouvez réinstaller l'agent avec le déploiement du plugiciel JMS; exécutez le script avec le paramètre --force.
(Facultatif) Entrez les informations suivantes pour vérifier si l'installation a réussi : Get-Service -name mgmt_agent.

Les fichiers journaux se trouvent dans le répertoire C:\Oracle\mgmt_agent\plugins\jm\stateDir\log.

Documentation sur Oracle Cloud Infrastructure

OCI et Windows sur place