Instalar o Management Gateway
Siga estas instruções para instalar o gateway de gerenciamento.
Fazer Download do Software do Management Gateway
Execute as seguintes etapas para fazer download do software do gateway:
-
Na home page Management Agent, clique em Downloads e Chaves no menu esquerdo para exibir o painel Download de Software.
O painel Download de Software é exibido na parte superior da página.
-
O painel Download de Software lista todos os softwares disponíveis para download para o Management Agent e o Management Gateway.
Selecione o sistema operacional no qual o Management Gateway será instalado na coluna Download.
-
Clique no link específico do seu sistema operacional para fazer download do arquivo de software do Management Gateway.
Por exemplo, clique em Gateway for LINUX para Linux ou Gateway for WINDOWS para Windows.
O arquivo de software do gateway de gerenciamento agora é salvo no seu host.
Para verificar a integridade do arquivo, verifique se o valor da coluna Soma de Verificação SHA-256 corresponde à saída do seguinte comando: sha256sum <download_file.rpm>
O URL de download da imagem do software do Gateway só está disponível por meio do comando da CLI agent-image list
ou da API ListManagamentAgents
com autenticação do OCI válida. Para obter detalhes, consulte Fazer Download do Software do Gateway Usando a CLI.
Fazer Download do Software do Gateway Usando a CLI
- Obtenha o valor
object-url
usando o comando da CLI agent-image list com a opção--install-type GATEWAY
.oci management-agent agent-image list --compartment-id <tenancyId> --install-type GATEWAY
O valor
object-url
de retorno é semelhante ao seguinte:https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_gateway.rpm
Anote os valores <namespace> e <bucketName> acima.
- Faça download do software do Management Gateway com o principal autenticado do OCI usando os valores <namespace> e <bucketName> da Etapa 1:
oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-x86_64/latest/oracle.mgmt_gateway.rpm --file oracle.mgmt_gateway.rpm
Para verificar a integridade do arquivo, verifique se o valor da coluna SHA-256 Checksum corresponde à saída do seguinte comando:
sha256sum <download_file>
A Interface de Linha de Comando (CLI) do Oracle Cloud Infrastructure (OCI) é uma ferramenta de interface de linha de comando. Para obter mais informações, consulte CLI (Command Line Interface).
Para obter o valor
object-url
, você também pode usar a API do Management Agent ListManagementAgentImages
com a opção installType=GATEWAY
.
Criar uma Chave de Instalação
É necessário criar uma chave de instalação antes de executar a instalação do Management Gateway.
Uma chave de instalação é emitida para o domínio de identidades e valida a autenticidade da instalação. Verifique se ela foi criada antes de iniciar o processo de instalação do Management Gateway.
Para obter detalhes sobre como criar uma chave de instalação, consulte Criar Chave de Instalação.
Esta etapa pode ser realizada apenas uma vez. Você pode usar a mesma chave de instalação para instalações do Management Gateway e do Management Agent.
Configurar um Arquivo de Resposta para o Management Gateway
O script de instalação do Management Gateway usa um arquivo de resposta para ler os parâmetros específicos do seu ambiente.
Revisar Parâmetros do Management Gateway
É necessário um arquivo de resposta contendo os parâmetros do gateway ao executar o script de configuração do gateway.
A seção a seguir descreve os parâmetros suportados no arquivo de resposta:
Tabela 7-2 Parâmetros do Arquivo de Resposta
Nome do Parâmetro | Tipo de Parâmetro | Descrição |
---|---|---|
ManagementAgentInstallKey |
Obrigatório | Chave de instalação necessária para validar a identidade do domínio e a autenticidade da instalação. |
AgentDisplayName |
Opcional | O nome para exibição do gateway que está sendo instalado. Este é um valor exclusivo. Se não for especificado, o sistema designara um valor padrão. |
BatchingEnabled |
Opcional | Ele ativa o recurso de criação de lotes durante a instalação do Management Gateway.
Use o |
CredentialWalletPassword |
Opcional | Senha da wallet do gateway quando o usuário fornece uma senha personalizada para a wallet armazenar informações confidenciais.
O tamanho mínimo da senha é de 8 caracteres com as seguintes especificações:
Todos os caracteres da senha devem estar entre os caracteres definidos acima. Por exemplo, se a senha contiver o caractere |
GatewayPort |
Opcional | O número da porta usado pelos agentes, incluindo Management Agents, ao estabelecer conexão com o Management Gateway. Se esse número de porta não for especificado, o valor será definido como 4480 por padrão. |
GatewayUsername |
Opcional | O nome de usuário usado para autenticação no servidor do Gateway. Se for fornecido, todos os clientes precisarão fornecer esse nome de usuário para autenticação. Se não for fornecido, a autenticação não será necessária para o gateway. |
GatewayPassword |
Opcional | A senha usada para autenticação no servidor do Gateway. Se for fornecido, todos os clientes precisarão fornecer essa senha para autenticação. Se não for fornecido, a autenticação não será necessária para o gateway. |
GatewayCertOcid |
Opcional |
OCID do certificado do OCI que será usado para suporte HTTPS do Gateway. O certificado deve estar no mesmo compartimento em que o Gateway está sendo instalado. |
GatewayCertCommonName |
Opcional | O usuário forneceu um Nome de Domínio Totalmente Qualificado (FQDN) do host do Management Gateway que será usado como "Nome Comum" durante o processo de criação automática de certificado (consulte Processo de Criação Automática de Certificado) como parte da instalação.
Por padrão, o Management Gateway assume |
ProxyHost |
Opcional | Nome do host ou endereço do proxy ou firewall externo. O Management Gateway usará esse host de proxy (servidor) para conexão com o OCI.
Se for fornecido, o parâmetro |
ProxyPort |
Opcional | Número da porta do servidor proxy do proxy ou firewall externo. Se for fornecido, o parâmetro ProxyHost também deverá ser fornecido.
|
ProxyUser |
Opcional | Nome de usuário para autenticação com o proxy ou firewall externo. Se for fornecido, o parâmetro ProxyPassword também deverá ser fornecido.
|
ProxyPassword |
Opcional | Senha do usuário para autenticação com o proxy ou firewall externo. Se for fornecido, o parâmetro ProxyUser também deverá ser fornecido.
|
ProxyRealm |
Opcional | O realm de autenticação para o proxy ou firewall externo. |
DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}] |
Opcional | A associação de metadados de tag se estiver usando tags no OCI. O administrador de tags cria e gerencia todas as tags que os usuários aplicam aos recursos. Os usuários devem ter políticas de tag definidas.
O namespace de tag é um contêiner para suas chaves de tag. A chave de tag é uma chave dentro do seu namespace; você deve criar chaves de tag para tags definidas em um namespace. Para tags definidas, o valor da tag tem um tipo que pode ser uma string ou uma lista de strings. Ao definir o tipo de valor da tag, se o tipo definido for uma string, qualquer valor poderá ser informado. Ao passo que, se for uma lista de strings, esse valor deverá ser uma das strings dessa lista. |
FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}] |
Opcional | A associação de metadados de tag se estiver usando tags no OCI.
Ela consiste em uma chave e um valor. A chave é qualquer nome que você use para fazer referência à tag. Valor é o valor que o usuário que aplica a tag adiciona à chave da tag. Para Alta Disponibilidade, é recomendável configurar esse parâmetro. Para obter detalhes, consulte Configurar um Arquivo de Resposta para Alta Disponibilidade do Management Gateway. Para o Agente Associado, se houver um Agente de Gerenciamento se conectando por meio desse Gateway de Gerenciamento, adicione uma tag com o nome Por exemplo: |
importTrustedCertsDirectory |
Opcional |
Localização dos certificados CA Raiz adicionais no formato PEM. Use esse parâmetro se quiser adicionar mais certificados de CA Raiz no formato PEM. O Management Gateway pesquisou nesse local e adicionou os certificados durante o tempo de instalação. Por exemplo: |
Criar um Arquivo de Resposta para Instalação do Management Gateway
Antes de continuar, verifique se você revisou e entendeu as informações fornecidas em Revisar Parâmetros do Management Gateway.
Para instalar e configurar gateways, você precisa criar um arquivo de resposta e executar um script usando o arquivo de resposta recém-criado que apontará o gateway para a região do OCI correta e permitirá que um recurso seja criado para o gateway.
Para criar um arquivo de resposta, use uma das seguintes opções:
Opção 1: Fazer download de um modelo de arquivo de resposta para criar um arquivo de resposta
Você pode fazer download de um arquivo de modelo contendo os parâmetros de gateway que podem ser salvos e usados como um arquivo de resposta durante a instalação do gateway.
-
Clique em Download e Chaves no menu esquerdo para abrir o painel Chaves de Instalação. Na lista de chaves de instalação, selecione a chave que deseja submeter a download.
-
No lado direito da chave selecionada, clique no menu de ação
e selecione Fazer Download da Chave para o Arquivo.
Um arquivo é submetido a download. Para obter mais informações, consulte Fazer Download da Chave de Instalação.
Ao fazer download da chave de instalação para um arquivo, o arquivo submetido a download contém vários parâmetros, incluindo o valor da chave de instalação específica.
- Abra o arquivo usando um editor de texto, revise-o e edite os parâmetros obrigatórios do gateway. Consulte Verificar Parâmetros do Management Gateway.
- Remova o parâmetro
Service.plugin.*
. Este é um parâmetro específico do agente. Ele só é usado para instalações do agente. - Remova o comentário (remova o símbolo
#
do início da linha) dos parâmetros do gateway necessários para a configuração específica do gateway e atualize os valores dos parâmetros do gateway. Por exemplo, os seguintes parâmetros:GatewayPort
,GatewayUsername
eGatewayPassword
devem ser adicionados ao arquivo. - Remova (adicione o símbolo
#
no início da linha) ou remova os parâmetros que você não precisa para sua configuração específica do gateway. - Salvar o arquivo de resposta atualizado. Por exemplo, ele pode ser salvo como arquivo de resposta
gateway.rsp
.
Opção 2: Criar um arquivo de resposta usando um editor de texto
É possível criar um arquivo de resposta manualmente usando um editor de texto. Por exemplo, você pode criar um arquivo usando o editor de texto de sua preferência, adicionar os parâmetros de gateway necessários para a configuração do gateway ao arquivo de resposta e salvá-lo. Por exemplo, o arquivo de resposta pode ser salvo como gateway.rsp
.
gateway.rsp
:managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5
Depois de criar o arquivo de resposta usando qualquer uma das opções acima, verifique as permissões do arquivo e certifique-se de que ele tenha permissões de leitura para o usuário mgmt_agent
.
Instalar o Management Gateway
Instalar o Management Gateway no arquivo RPM
do Linux
-
Faça log-in como um usuário com privilégios
sudo
. -
Instale o software do Management Gateway.
Navegue até o diretório em que você fez download do arquivoRPM
do Management Gateway e execute o seguinte comando para instalar o arquivoRPM
:sudo rpm -ivh <rpm_file_name.rpm>
Por exemplo:
sudo rpm -ivh oracle.mgmt_gateway-<VERSION>.rpm
A saída será semelhante à seguinte:Preparing... ################################# [100%] Checking pre-requisites Checking if any previous gateway service exists Checking if OS has systemd or initd Checking available disk space for gateway install Checking if /opt/oracle/mgmt_agent directory exists Checking if 'mgmt_agent' user exists Checking Java version JAVA_HOME is not set or not readable to root Trying default path /usr/bin/java Java version: 1.8.0_282 found at /usr/bin/java Checking gateway version Updating / installing... 1:oracle.mgmt_gateway-<VERSION>################################# [100%] Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent) Initializing software from template Checking if JavaScript engine is available to use Creating 'mgmt_gateway' daemon Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0 Setup gateway using input response file (run as any user with 'sudo' privileges) Usage: sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=[FULL_PATH_TO_INPUT.RSP] Gateway install successful
O processo de instalação faz o seguinte:- Um novo usuário chamado
mgmt_agent
é criado. Este será o usuário do Management Gateway. Se o usuáriomgmt_agent
já existir, o processo de instalação o utilizará para instalar o software do gateway. - Todos os arquivos do gateway são copiados e instalados pelo usuário
mgmt_agent
. O diretório da base de instalação é o diretório em que o gateway está instalado. O diretório é criado como parte do processo de instalação do gateway em/opt/oracle/mgmt_agent
. - Por padrão, o daemon/serviço
mgmt_gateway
é ativado e iniciado automaticamente após a instalação do gateway.
Os arquivos de log da instalação do gateway estão localizados no diretório/opt/oracle/mgmt_agent/installer-logs
. Para exibir os arquivos de log ou quaisquer outros arquivos de instalação, faça log-in como usuáriomgmt_agent
executando o seguinte:sudo -u mgmt_agent sh
- Um novo usuário chamado
-
Configure o Management Gateway executando o script
setupGateway.sh
usando um arquivo de resposta.sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>
A saída será semelhante à seguinte:sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<user_home_directory>/gateway.rsp Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Gateway Found service plugin(s): [GatewayProxy] Starting gateway... Gateway started successfully Starting plugin deployment for: [GatewayProxy] Deploying service plugin(s)......Done. GatewayProxy : Successfully deployed external plugin Gateway setup completed and the gateway is running. In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway Please make sure that you delete <user_home_directory>/gateway.rsp or store it in secure location. Creating Wallets Wallets created successfully Waiting for Gateway to start... Gateway Proxy started successfully
Para obter mais informações sobre a criação de arquivos de resposta, consulte Criar um Arquivo de Resposta para Instalação do Management Gateway.
Instalar o Management Gateway no arquivo ZIP
do Linux
ZIP
, execute as seguintes etapas:
O local de instalação padrão está no volume
/opt
. Se você preferir usar um volume externo para instalar o Management Gateway, consulte Instalar o Management Gateway em um Volume Externo usando o Arquivo ZIP do Linux.
-
Extraia o software do Management Gateway.
Navegue até o diretório em que você fez download do arquivo
ZIP
do software do Management Gateway e descompacte-o em qualquer local preferencial. -
Faça log-in como um usuário com privilégios
sudo
. -
Instale e configure o Management Gateway executando o script
installer.sh
fornecendo um arquivo de resposta. Para obter informações sobre como criar um arquivo de resposta, consulte Criar um Arquivo de Resposta.Navegue até o diretório em que você removeu o arquivoZIP
do software do Management Gateway e execute o seguinte:sudo ./installer.sh
Por exemplo:
sudo ./installer.sh
A saída será semelhante à seguinte:sudo ./installer.sh Checking pre-requisites Checking if any previous gateway service exists Checking if OS has systemd or initd Checking available disk space for gateway install Checking if /opt/oracle/mgmt_agent directory exists Checking if 'mgmt_agent' user exists 'mgmt_agent' user already exists, the gateway will proceed installation without creating a new one. Checking Java version JAVA_HOME is not set or not readable to root Trying default path /usr/bin/java Java version: 1.8.0_272 found at /usr/bin/java Checking agent version Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent) Initializing software from template Checking if JavaScript engine is available to use Creating 'mgmt_gateway' daemon Gateway Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0 Setup gateway using input response file (run as any user with 'sudo' privileges) Usage: sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=[FULL_PATH_TO_INPUT.RSP] Gateway install successful
- Configure o Management Gateway executando o script
setupGateway.sh
usando um arquivo de resposta.sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=<full_path_of_response_file>
A saída será semelhante à seguinte:sudo /opt/oracle/mgmt_agent/agent_inst/bin/setupGateway.sh opts=/u01/oracle/management_agent/input.rsp Validating response file Successfully validated response file /opt/oracle/mgmt_agent/agent_inst/bin/setupAgent.sh opts=/u01/oracle/management_agent/input.rsp Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Gateway Found service plugin(s): [GatewayProxy] Starting gateway... Gateway started successfully Starting plugin deployment for: [GatewayProxy] Deploying service plugin(s).........Done. GatewayProxy : Successfully deployed external plugin Gateway setup completed and the gateway is running. In the future gateway can be started by directly running: sudo systemctl start mgmt_gateway Please use OCI CLI or OCI Management Agent console to validate the successful activation of your agent. Please make sure that you delete /u01/oracle/management_agent/input.rsp or store it in secure location. Checking for plugin to be deployed Plugin deployed successfully Setting up Gateway Creating gateway system properties file Creating properties file Creating or validating certificates Waiting for Management Gateway to create or validate certificates ... Creating wallets Wallets created successfully Waiting for Management Gateway to setup ... Management Gateway Plugin set up successfully.
Para obter mais informações sobre a criação de arquivos de resposta, consulte Criar um Arquivo de Resposta para Instalação do Management Gateway.
Instalar o Management Gateway em um Volume Externo usando o Arquivo ZIP
do Linux
Em alguns ambientes Linux, o volume /opt
tem espaço em disco limitado e não pode ser usado para instalar software. Nesses casos, você pode instalar o Management Gateway em um volume externo usando o arquivo ZIP
do Linux e criando um link simbólico.
Para instalar o Management Gateway em um volume externo no Linux, faça o seguinte:
- Crie o diretório de instalação do Management Gateway em um volume externo.
Por exemplo:
sudo mkdir -p /devext/oracle/mgmt_agent
No exemplo acima,
/devext
é um volume externo. - Crie um link simbólico no diretório
/opt/oracle
para apontar para o volume externo.Antes de executar o comando abaixo, confirme se o diretório
/opt/oracle
já existe.Por exemplo:sudo ln -s /devext/oracle/mgmt_agent /opt/oracle/mgmt_agent
- Confirme se o download do arquivo
ZIP
do software Linux do Management Gateway foi feito. Para obter detalhes, consulte Fazer Download do Software do Management Agent. - Alterne para um shell raiz, defina a variável de ambiente
OPT_ORACLE_SYMLINK = true
e instale o software do Management Gateway como usuário raiz.sudo /bin/bash export OPT_ORACLE_SYMLINK=true ./installer.sh
Por exemplo:sudo /bin/bash export OPT_ORACLE_SYMLINK=true ./installer.sh
- Depois que o processo de instalação for concluído, verifique se o usuário do Linux
mgmt_agent
é o proprietário do local de instalação do Management Gateway.stat -c '%U' /opt/oracle/mgmt_agent mgmt_agent sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst mgmt_agent
Instalar o Management Gateway no Windows
-
Extraia o software do Management Gateway.
Navegue até o diretório em que você fez download do arquivo
ZIP
do software do Management Gateway e descompacte-o em qualquer local de sua preferência. -
Faça log-in como um usuário Administrador e abra uma janela de Prompt de Comando.
-
Instale o Management Gateway executando o script
installer.bat
.installer.bat
A saída será semelhante à seguinte:Checking pre-requisites Checking if previous gateway service exists Checking if C:\Oracle\mgmt_agent\agent_inst directory exists Checking if C:\Oracle\mgmt_agent\agent_inst\plugins directory exists Checking Java version Java version: 1.8.0_371 found at C:\Program Files\Java\jdk-1.8 Checking if C:\Oracle\mgmt_agent\231214.1713 directory exists Executing install Unpacking software zip Copying files to destination dir (C:\Oracle\mgmt_agent) Initializing software from template Checking if JavaScript engine is available to use Creating mgmt_gateway service Gateway install successful Setup gateway using input response file Usage: C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat [FULL_PATH_TO_INPUT.RSP]
- Configure o Management Gateway executando o script
setupGateway.bat
usando o arquivo de resposta.<Management_Agent_path>\setupGateway.bat <full_path_of_response_file>
Por exemplo:C:\Oracle\mgmt_agent\agent_inst\bin\setupGateway.bat c:\tmp\input.rsp
A saída é semelhante à seguinte:Validating response file Validating certificate properties Successfully validated response file Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Gateway Found service plugin(s): [GatewayProxy] The Oracle Management Gateway service is starting... The Oracle Management Gateway service was started successfully. Starting plugin deployment for: [GatewayProxy] Deploying service plugin(s)...Done. GatewayProxy : Successfully deployed external plugin Management Gateway setup completed and is running In the future agent can be started by directly running: NET START mgmt_gateway Please use OCI CLI or OCI Management Agent console to validate the successful activation of your agent." Please make sure that you delete C:\tmp\input.rsp or store it in secure location. Checking for plugin to be deployed Plugin deployed successfully Setting up Gateway Creating gateway system properties file Creating properties file Creating or validating certificates Waiting for Management Gateway to create or validate certificates ... Waiting for Management Gateway to create or validate certificates ... Waiting for Management Gateway to create or validate certificates ... Waiting for Management Gateway to create or validate certificates ... Waiting for Management Gateway to create or validate certificates ... Wallets created successfully Waiting for Management Gateway to setup ... Management Gateway Plugin set up successfully.
- Um novo diretório é criado como parte do processo de instalação do agente:
C:\Oracle\mgmt_agent
. - O diretório base de instalação do agente é o diretório em que o gateway será instalado.
Por padrão, o gateway é instalado no diretório
C:\Oracle
. O diretório padrão pode ser alterado definindo a variável de ambienteAGENT_INSTALL_BASEDIR
antes de executar o scriptinstaller.bat
. - Os arquivos de log da instalação do Management Gateway estão localizados nos diretórios
C:\Oracle\mgmt_agent\installer-logs
eC:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\logs
.
Verificar a Instalação do Management Gateway
Verificar a Instalação do Management Gateway Usando a Interface do Usuário
Para verificar a instalação do agente usando a interface do usuário, execute as seguintes etapas:
-
Na página principal Management Agents, clique em Agentes no menu esquerdo.
A página Agentes e Gateways é exibida com uma lista de todos os agentes e gateways instalados.
Para ver apenas os gateways, vá para o menu esquerdo e use os Filtros: Use o filtro
Install Type
e selecioneGateway
.Todos os gateways são exibidos.
-
Na lista Agentes e Gateways, procure o gateway que foi instalado recentemente usando a coluna Criado em que exibe a data da instalação do agente ou a coluna Host que exibe o nome do host em que o gateway foi instalado.
Verificar a Instalação do Management Gateway Usando a Interface de Linha de Comando
Verificar a Instalação do Management Gateway Usando a Interface de Linha de Comando no Linux
- Faça log-in no host usando um usuário com privilégios
sudo
. - Execute o seguinte comando:
Para o Oracle Linux 6:
sudo /sbin/initctl status mgmt_gateway
Para o Oracle Linux 7:
sudo systemctl status mgmt_gateway
Para obter mais detalhes, verifique o arquivo de log:
/opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/log/mgmt_gateway.log
.
Verificar a Instalação do Management Gateway Usando a Interface de Linha de Comando no Windows
- Faça log-in no host
- Execute o seguinte comando:
sc query mgmt_gateway
Para obter mais detalhes, verifique o arquivo de log:
/opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/log/mgmt_gateway.log
.