macOS Local

Esta seção descreve as etapas para configurar o Oracle Management Agent e implantar os plug-ins JMS no host macOS usando o script de instalação.

Pré-requisitos:

Execute o script de instalação com sudo ou acesso administrativo e conceda a permissão Acesso Total ao Disco.

Observação

Por padrão, o script de instalação irá:
  • Gere o rastreador de uso com funcionalidade adicional para coletar a propriedade user.name para melhor identificação de aplicativos em execução em Servidores de Aplicativos como WebLogic e Tomcat. Se não quiser ativar esse recurso, atualize o parâmetro --enable-user-name=false no script de instalação. Você pode modificar o arquivo de propriedades do Rastreador de Uso do Java no futuro para adicionar ou remover user.name da seção additionalProperties.
  • Desative o modo FIPS (Federal Information Processing Standards) para plug-ins. Para ativar o modo FIPS em relams USGov, atualize o parâmetro --enable-fips-mode=true no script de instalação.
  • Instale o agente com a frequência de telemetria inferior do JMS.

Execute o comando --help para exibir a descrição de opções, como ativar ou desativar nome de usuário, definições de proxy, FIPS etc.

Estes são os parâmetros opcionais juntamente com a descrição:

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

Etapas

  1. (Verificação de diagnóstico opcional) Navegue até a pasta em que você salvou o script de instalação e o software do agente de gerenciamento. Execute o script usando o comando a seguir:
    $ sudo bash ./JMS_YourFleetName_macos.sh --diagnostic
    Dependendo do sistema operacional e do tipo de agente, os resultados serão semelhantes a:

    Falha no diagnóstico:

    ======================================================================================================
    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
    
    O diagnóstico foi concluído com sucesso:
    ======================================================================================================
    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.

    Consulte Executando Diagnósticos de Instalação do Agente para obter a lista completa de critérios verificados durante o diagnóstico, juntamente com soluções ou recomendações.

  2. Navegue até a pasta em que você salvou o script de instalação e o software do agente de gerenciamento. Execute o script usando o comando a seguir:
    $ sudo bash ./JMS_YourFleetName_macos.sh
    • Se a instalação for bem-sucedida, você verá uma mensagem semelhante à seguinte:
      ...
      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>).
      
    • Caso o agente já esteja instalado, o script atualizará o software do agente para a versão mais recente, se aplicável. Se os plug-ins JMS ainda não tiverem sido implantados, implante os plug-ins Java Usage Tracking e Java Management Service manualmente, conforme descrito na Página Implantar um Plug-in de Serviço Usando Agentes. Ou você pode reinstalar o agente junto com a implantação do plug-in JMS; execute o script com o parâmetro --force.
  3. (Opcional) Para verificar se o agente de gerenciamento está em execução, digite:
    $ sudo launchctl print system/com.oracle.macs.agent.mgmt_agent | grep state
    Os resultados mostrarão:
    state = running

    Você também pode exibir a console para verificar se o agente de gerenciamento está em execução. Consulte Visão Geral da Console de Management Agents para obter mais informações.

    Os arquivos de log estão localizados no diretório /Library/Oracle/mgmt_agent/plugins/jm/stateDir/log.