Cambio del nombre del sistema gestionado por el agente

Existen distintos procedimientos para cambiar el nombre de sistema gestionado para los distintos agentes de Cloud APM. Para algunos agentes, cambiar el nombre de sistema gestionado significa cambiar el nombre de host o el nombre de instancia de agente (o ambos) en el nombre de sistema gestionado. Para otros agentes, se requieren procedimientos específicos para cambiar el nombre de sistema gestionado.

Antes de empezar

Familiarícese con los formatos de nombre de sistema gestionado y las restricciones de nomenclatura tal como se describen en Nombres de sistema gestionado.

Acerca de esta tarea

Para la mayoría de agentes de Cloud APM, puede utilizar el parámetro CTIRA_HOSTNAME para cambiar el nombre de host utilizado en el nombre de sistema gestionado. Para cambiar el nombre de instancia de agente en el nombre de sistema gestionado para agentes de múltiples instancias, puede utilizar el parámetro de configuración del agente. Si ha configurado el agente, debe volver a configurarlo para asignar un nombre de instancia de agente diferente. Tras volver a configurar el agente, no podrá recuperar los datos recopilados mediante la instancia de agente anterior.

Es posible que no pueda cambiar el nombre de sistema gestionado en un único procedimiento, según qué parte del nombre de sistema gestionado desee cambiar.

Para averiguar el método de cambio de nombre de sistema gestionado para el agente que le interesa, consulte Tabla 1.

Excepción: El cambio de nombre de sistema gestionado no está soportado en Agente de HTTP Server, Agente de Node.js o Agente de Synthetic Playback

Tabla 1. Métodos de cambio de nombre de sistema gestionado para agentes de Cloud APM
Agente	Método de cambio de nombre de sistema gestionado
Agente de Amazon EC2	Utilice el parámetro de configuración de agente para cambiar el nombre de subnodo EC2 en el nombre de sistema gestionado, consulte Parámetros de configuración para el Agente de Amazon EC2.
Agente de Amazon ELB	Cree una nueva instancia de agente con un nuevo nombre de instancia para cambiar el nombre de sistema gestionado.
Agente de Azure Compute	Utilice el parámetro de configuración de agentes para cambiar el nombre de subnodo en el nombre de sistema gestionado. Consulte Parámetros de configuración para el Agente de Azure Compute.
Agente de Cassandra	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Cisco UCS	Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia de agente, consulte Parámetros de configuración del agente.
Agente de Citrix VDI	Utilice el parámetro de configuración de agentes para cambiar el nombre de sitio de Citrix, consulte Parámetros de configuración para el Agente de Citrix VDI.
Agente de Db2	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de DataPower	Utilice el parámetro de configuración de agentes para cambiar el nombre de sistema gestionado, consulte Configuración del Agente de DataPower.
Agente de DataStage	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Hadoop	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de HMC Base	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de IBM® Cloud	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de IBM Integration Bus	Especificación de un nombre de sistema gestionado exclusivo para el Agente de IBM Integration Bus
Agente de JBoss	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Linux KVM	Utilice los parámetros de configuración de agentes, consulte Configuración de la supervisión de Linux KVM.
Agente de sistema operativo Linux	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft .NET	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft Active Directory	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft Exchange Server	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft Hyper-V Server	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft IIS	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft Office 365	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Microsoft SQL Server	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Microsoft SharePoint Server	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de MongoDB	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de MySQL	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de NetApp Storage	Utilice los parámetros de configuración de agentes, consulte Configuración de la supervisión de NetApp Storage.
Agente de OpenStack	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Oracle Database	Utilice los parámetros de configuración de agentes, consulte Configuración de la supervisión de base de datos de Oracle.
Agente de PHP	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de PostgreSQL	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de RabbitMQ	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Supervisión de tiempo de respuesta	Especificación de un nombre de sistema gestionado exclusivo para el Agente de Supervisión de tiempo de respuesta
Agente de Ruby	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de SAP	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de SAP HANA Database	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de SAP NetWeaver Java™ Stack	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Siebel	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Skype for Business Server (anteriormente conocido como agente de Microsoft Lync Server)	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de Sterling File Gateway	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Sterling Connect Direct	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de Tomcat	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de sistema operativo UNIX	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.
Agente de WebSphere Applications	Para cambiar el nombre de host en el nombre de sistema gestionado, consulte Cómo cambiar el nombre de host utilizado en el nombre de sistema gestionado para la instancia de agente de WAS. Para cambiar el nombre de alias de servidor en el nombre de sistema gestionado, vuelva a configurar el agente. Consulte Reconfiguración interactiva del recopilador de datos.
Agente de WebSphere Infrastructure Manager	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado. Utilice el parámetro de configuración de agentes para cambiar el nombre de instancia en el nombre de sistema gestionado.
Agente de WebSphere MQ	Especificación de nombres de sistema gestionado exclusivos para varios gestores de colas
Agente de sistema operativo Windows	Utilice el parámetro CTIRA_HOSTNAME para cambiar el nombre de host en el nombre de sistema gestionado. Consulte Cambio del nombre de host en el nombre de sistema gestionado.

Cambio del nombre de host en el nombre de sistema gestionado

Acerca de esta tarea

No es una práctica común cambiar el nombre de host en el nombre de sistema gestionado. El nombre de host se detecta y establece automáticamente durante la configuración del agente. Cambie el nombre de host en el nombre de sistema gestionado sólo cuando sea necesario y asegúrese de que el valor que especifica no causa truncamientos debido a restricciones de nomenclatura del nombre del sistema gestionado.

Procedimiento

Detenga todas las instancias existentes del agente y espere a que la Consola de Cloud APM muestre que el agente o sus subnodos está fuera de línea. Si no tiene ninguna instancias de agente existente, continúe con el paso siguiente.

Para obtener más información sobre cómo detener instancias de agente, consulte Utilización de mandatos de agente.
Si el agente es un agente de una sola instancia, siga estos pasos para cambiar el parámetro CTIRA_HOSTNAME. El valor que especifique para el parámetro CTIRA_HOSTNAME es el valor que se aplica a todas las instancias del agente nuevo.
1. Realice una copia de seguridad del archivo siguiente:
  - dir_instalación/config/cp.environment
  - dir_instalación/TMAITM6_x64/kpccma.ini
  donde:
  - dir_instalación es el directorio de instalación del agente.
  - pc es el código de agente de dos caracteres. Consulte la Tabla de nombres de agente y códigos de agente.
2. Edite el archivo cambiando el valor del parámetro CTIRA_HOSTNAME tal como se indica a continuación, donde nombre_host_nuevo es la serie personalizada que se utiliza en lugar del nombre de host real del equipo donde se ha instalado el agente.
  - CTIRA_HOSTNAME=nuevo_nombre_host
  - CTIRA_HOSTNAME=nombre_host_nuevo .TYPE=REG_EXPAND_SZ
3. Guarde los cambios.
Si el agente es un agente de varias instancias, siga estos pasos para cambiar el parámetro CTIRA_HOSTNAME. Normalmente, todas las instancias de agente de un sistema utilizan el mismo valor de nombre de host. Si necesita que las instancias de agente utilicen valores diferentes, varíe el valor asignado a CTIRA_HOSTNAME al ejecutar este paso.
1. Realice una copia de seguridad de los archivos siguientes:
  - dir_instalación/config/pc_instancia.environment
  - dir_instalación/TMAITM6_x64/kpccma_instancia.ini
2. Edite el archivo y cambie el valor del parámetro CTIRA_HOSTNAME tal como se indica a continuación:
  - CTIRA_HOSTNAME=nuevo_nombre_host
  - CTIRA_HOSTNAME=nombre_host_nuevo .TYPE=REG_EXPAND_SZ
3. Guarde los cambios.
Reconfigure las instancias de agente existentes.
Inicie todas las instancias de agente.

Qué hacer a continuación

Cuando haya cambiado el nombre de sistema gestionado del agente, inicie la Consola de Cloud APM y modifique sus aplicaciones eliminando el nombre de sistema gestionado anterior de las aplicaciones y añadiendo el nuevo nombre de sistema gestionado en su lugar.