Tareas de administración de Management Gateway

Puede que algunas tareas de administración sean necesarias después de instalar un gateway de gestión.

Actualizar propiedades de gateway de gestión

Puerto de Gateway de Gestión

El gateway de gestión está configurado para aceptar tráfico en un puerto específico que se especifica mediante la propiedad GatewayPort del archivo gateway.properties.

En las plataformas Linux, el archivo gateway.properties se encuentra en: /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/config.
En las plataformas Windows, el archivo gateway.properties se encuentra en: C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\config.

Para cambiar el valor del puerto de Management Gateway, edite el archivo gateway.properties y sustituya el valor actual de la propiedad GatewayPort por el número de puerto deseado.

Después de cambiar el archivo gateway.properties, se debe reiniciar el servicio de gateway de gestión.

Para Oracle Linux 6, utilice: /sbin/initctl restart mgmt_gateway
Para Oracle Linux 7, utilice: systemctl restart mgmt_gateway

Para Windows, utilice:

net stop mgmt_gateway
net start mgmt_gateway

Si cambia el valor de la propiedad GatewayPort, se debe cambiar cualquier agente de gestión que utilice ese gateway de gestión para utilizar el nuevo valor de puerto. Para obtener más información, consulte Actualización de agentes de gestión después de los cambios en la configuración del gateway de gestión.

Credenciales de Gateway de Gestión

El gateway suele estar configurado para utilizar credenciales: el nombre de usuario y la contraseña son necesarios para conectarse a él.

Estas credenciales se almacenan en carteras de Oracle. Para obtener información sobre cómo agregar, actualizar o suprimir credenciales, consulte Configurar credenciales de gateway de gestión.

Si cambian las credenciales del gateway de gestión, se debe cambiar cualquier agente de gestión que utilice el gateway de gestión para utilizar las nuevas credenciales. Para obtener más información, consulte Actualización de agentes de gestión después de cambios en la configuración del gateway de gestión.

Configurar credenciales de gateway de gestión

En esta sección se describe cómo gestionar las credenciales que pueden ser necesarias para Management Gateway.

Management Gateway almacena información confidencial, como credenciales, en carteras de Oracle Wallet.

Después de instalar una instancia de Management Gateway, puede que necesite configurar las credenciales.

Nota

Si se han realizado cambios mediante los comandos de la CLI, se debe reiniciar el gateway. Para obtener información sobre los comandos de la CLI, consulte Referencia de comandos de CLI de Oracle Cloud Infrastructure.

Adición o actualización de credenciales

Para agregar credenciales o actualizar las existentes, utilice el script gateway_credentials con la operación upsertCredentials.

Linux: el script gateway_credentials.sh se encuentra en el directorio /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/bin.
Windows: el script gateway_credentials.bat se encuentra en el directorio C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\bin.

Cree un archivo de texto con el nombre de usuario y la contraseña para el gateway:
```
GatewayUsername=<USER_NAME>
GatewayPassword=<USER_PASSWORD>
```
Por ejemplo:
```
GatewayUsername=oracle2
GatewayPassword=welcomepwd
```
Por ejemplo, puede guardar el archivo de texto como cred.properties.

Agregue credenciales mediante un archivo de texto.

Para Linux, utilice:

gateway_credentials.sh -o upsertCredentials

Por ejemplo, puede ejecutar lo siguiente en Linux con el archivo cred.properties:

cat cred.properties | sudo -u mgmt_agent sh /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/bin/gateway_credentials.sh -o upsertCredentials

Para Windows, utilice:

gateway_credentials.bat -o upsertCredentials

Por ejemplo, puede ejecutar lo siguiente en Windows con el archivo cred.properties:

type cred.properties | C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\bin\gateway_credentials.bat -o upsertCredentials

Suprima el archivo de texto creado en el paso 1.

El archivo de texto contiene información confidencial. Los clientes son responsables de suprimir el archivo de texto de credenciales después de completar la operación de adición o actualización de credenciales.

Supresión de credenciales

Para suprimir credenciales, utilice el script gateway_credentials con la operación deleteCredentials.

Linux:

El script gateway_credentials.sh se encuentra en el directorio /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/bin.

Sintaxis:

gateway_credentials.sh -o deleteCredentials

Ejemplo:

sudo -u mgmt_agent sh /opt/oracle/mgmt_agent/plugins/GatewayProxy/stateDir/bin/gateway_credentials.sh -o deleteCredentials

Ventanas:

El script gateway_credentials.bat se encuentra en el directorio C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\bin.

Sintaxis:

gateway_credentials.bat -o deleteCredentials

Ejemplo:

C:\Oracle\mgmt_agent\plugins\GatewayProxy\stateDir\config\bin\gateway_credentials.bat -o deleteCredentials

Nota

Al suprimir las credenciales no se suprime la cartera que incluyera las credenciales.

Actualizar agentes de gestión después de los cambios en la configuración del gateway de gestión

Si cambia la configuración de Management Gateway, puede que también tenga que cambiar Management Agent.

Host de gateway: si el gateway se mueve a otro host o si se cambia el nombre del host de gateway, se deben cambiar los agentes que utilicen el gateway para utilizar el nuevo nombre de host.

En este caso, el parámetro de Management Agent GatewayServerHost se debe actualizar para utilizar el nuevo gateway.
Puerto de gateway: si cambia el valor del puerto de gateway, se debe cambiar cualquier agente que utilice el gateway para utilizar el nuevo valor de puerto.

En este caso, el parámetro de Management Agent GatewayServerPort se debe actualizar para utilizar el nuevo puerto de gateway.
Credenciales de gateway: si se cambian las credenciales necesarias para conectarse al gateway de gestión (como el nombre de usuario y la contraseña), se debe cambiar cualquier agente que utilice el gateway para utilizar las nuevas credenciales. Para obtener más información, consulte Tipo de credencial para gateways y proxies de gestión y Agregar o actualizar credenciales.

Actualizar credenciales de proxy para Management Gateway

Puede actualizar las credenciales de proxy externo existentes para el gateway de gestión.

Requisitos:

El gateway de gestión se debe configurar con un proxy mediante las siguientes dos propiedades:

ProxyHost
ProxyPort

Por ejemplo:

ProxyHost=myproxy.example.com
ProxyPort=80

Paso 1: Crear cuerpo de solicitud para actualizar las credenciales de proxy

Proporcione el nuevo nombre de usuario y contraseña en el archivo de credenciales mediante las siguientes propiedades:

ProxyUser: nombre de usuario para la autenticación con el proxy.
ProxyPassword: contraseña del usuario para la autenticación con el proxy.

Nota

Las propiedades de las credenciales anteriores distinguen entre mayúsculas y minúsculas.

Consulte el siguiente archivo de credenciales de ejemplo sample-proxycreds.json:

{"source":"agent.%%agentId%%",
"name":"ManagementAgent-Proxy",
"type":"ProxyCreds",
"description":"Proxy Credentials",
"properties":[
{"name":"ProxyUser","value":"<UserName>"},
{"name":"ProxyPassword","value":"<Password>"}]}

Paso 2: Ejecute el comando para actualizar las credenciales de proxy

Ejecute el siguiente comando para actualizar las credenciales de proxy mediante el archivo de ejemplo anterior:

Para Linux:

cat sample-proxycreds.json | sudo -u mgmt_agent /opt/oracle/mgmt_agent/agent_inst/bin/credential_mgmt.sh -o upsertCredentials -s Agent

Para Windows:

type sample-proxycreds.json | C:\oracle\mgmt_agent\agent_inst\bin\credential_mgmt.bat -o upsertCredentials -s Agent

Paso 3: Reiniciar gateway de gestión

Para Linux:
```
sudo systemctl restart mgmt_gateway
```

Para Windows:

net stop mgmt_gateway
net start mgmt_gateway

Nota

El gateway de gestión utiliza las credenciales para comunicarse con los servicios de Oracle Cloud Infrastructure. Cambiar su formato o eliminar las credenciales puede tener un efecto negativo en la capacidad del gateway de gestión para volver a comunicarse con los servicios de Oracle Cloud Infrastructure.

Activar lotes para Management Gateway

Después de instalar Management Gateway, puede activar los lotes para proporcionar una gestión mejor y más rápida de las cargas de registro en el servicio Logging Analytics.

Para activar los lotes, agregue la siguiente propiedad en el archivo gateway.properties:

BatchingEnabled=true

Después de actualizar el archivo gateway.properties, se debe reiniciar el servicio Management Gateway. Para reiniciarlo, ejecute lo siguiente:

Para Oracle Linux 6, utilice: /sbin/initctl restart mgmt_gateway
Para Oracle Linux 7, utilice: systemctl restart mgmt_gateway

Cambio de versión de Management Gateway

Cambie de versión del gateway en Linux

Para cambiar la versión de un gateway en Linux, realice lo siguiente:

Descargue la última versión del archivo RPM que contiene el archivo de descarga de software. Para obtener más información, consulte Descarga del software Management Gateway.
Para actualizar el gateway, ejecute el comando rpm con la opción de cambio de versión: rpm -U.
```
sudo rpm -U <rpm_file_name.rpm>
```

Actualizar gateway en Windows

Para cambiar la versión de un gateway en Windows:

Conéctese como usuario Administrator y abra una ventana de símbolo del sistema.
Descargue la última versión del archivo ZIP que contiene el archivo de descarga del software del agente. Para obtener más información, consulte Descarga del software Management Gateway.
Desplácese hasta el directorio donde haya descargado el archivo ZIP del software del agente de gestión y descomprímalo en cualquier ubicación que desee.

Para actualizar el gateway, ejecute el script installer.bat con la opción -u:

installer.bat -u

Por ejemplo: C:\Users\test_agent>installer.bat -u

El resultado es similar al siguiente:

JAVA_HOME found at: C:\Program Files\Java\jdk1.8.0_321
Executing upgrade
        Unpacking software zip
        Copying files to destination dir (C:\Oracle\mgmt_agent)
        Updating communication wallet       
        Creating mgmt_gateway service

Management Gateway upgrade successful
The Oracle Management Gateway service is starting....
The Oracle Management Gateway service was started successfully.

Documentación de Oracle Cloud Infrastructure