Instalando un agente de Enterprise Manager para una base de datos TimesTen

Este es un pequeño instructivo para instalar un agente de Enterprise Manager 11g para una base de datos TimesTen 11; este instructivo asume que ya descargaste el agente en la máquina cliente y configuraste el Management Plug-in for Oracle TimesTen In-Memory Database en tu servidor Enterprise Manager.

Primero, tienes que configurar un archivo de respuestas para hacer una instalación silenciosa; una instalación con OUI debe ser suficientemente sencilla como para tener que explicarla aquí. En el directorio response bajo el directorio donde descomprimiste el software del agente deberás encontrar un archivo additional_agent.rsp, cópialo y cambia al menos estos campos:

timesten@myserver $ diff additional_agent.rsp my.rsp
41,42c41,42
< SECURITY_UPDATES_VIA_MYORACLESUPPORT=
< DECLINE_SECURITY_UPDATES=
---
> SECURITY_UPDATES_VIA_MYORACLESUPPORT=FALSE
> DECLINE_SECURITY_UPDATES=TRUE
85c85
< ORACLE_AGENT_HOME_LOCATION=
---
> ORACLE_AGENT_HOME_LOCATION=/myagent
169,170c169,170
< OMS_HOST=
< OMS_PORT=
---
> OMS_HOST=myoemserver
> OMS_PORT=4889

A continuación, corre runInstaller con el nombre completo de tu archivo de respuestas:

timesten@myserver $ cd /myagent/linux_x64/agent
timesten@myserver $ ./runInstaller -silent -responseFile /myagent/linux_x64/response/my.rsp

De esta forma instalarás un agente en el directorio /myagent; no olvides correr como root el script de configuración root.sh después de terminar la ejecución de runInstaller:

root@myserver # /myagent/agent11g/root.sh

Si quieres verificar que el agente está corriendo y comunicándose con el servidor de Grid Control, ejecuta emctl y pon atención al mensaje Last successful upload:

timesten@myserver $ cd /myagent/agent11g/bin/
timesten@myserver $ ./emctl status agent
Oracle Enterprise Manager 11g Release 1 Grid Control 11.1.0.1.0 
Copyright (c) 1996, 2010 Oracle Corporation.  All rights reserved.
---------------------------------------------------------------
Agent Version     : 11.1.0.1.0
OMS Version       : 11.1.0.1.0
Protocol Version  : 11.1.0.0.0
Agent Home        : /myagent/agent11g
Agent binaries    : /myagent/agent11g
Agent Process ID  : 5493
Parent Process ID : 14892
Agent URL         : http://myserver:3872/emd/main/
Repository URL    : http://myoemserver:4889/em/upload/
Started at        : 2011-11-29 09:48:12
Started by user   : timesten
Last Reload       : 2011-11-29 11:50:40
Last successful upload                       : 2011-11-29 12:53:25
Total Megabytes of XML files uploaded so far :    13.84
Number of XML files pending upload           :        0
Size of XML files pending upload(MB)         :     0.00
Available disk space on upload filesystem    :    66.57%
Last successful heartbeat to OMS             : 2011-11-29 12:53:29
---------------------------------------------------------------
Agent is Running and Ready

Si por alguna razón necesitas cambiar la configuración del agente entonces detén el agente, edita los archivos emd.properties y targets.xml, y opcionalmente borra archivos previos:

timesten@myserver $ cd /myagent/agent11g/bin
timesten@myserver $ ./emctl stop agent
Oracle Enterprise Manager 11g Release 1 Grid Control 11.1.0.1.0 
Copyright (c) 1996, 2010 Oracle Corporation.  All rights reserved.
Stopping agent ... stopped.
timesten@myserver $ cd ..
timesten@myserver $ vi sysman/config/emd.properties
timesten@myserver $ vi sysman/emd/targets.xml
timesten@myserver $ cd sysman/emd
timesten@myserver $ rm -rf recv/* protocol.ini lastupld.xml collection/* state/* cputrack/* agntstmp.txt upload/* ../log/* emagent_storage.config core* sqlnet.log *sql
timesten@myserver $ cd /myagent/agent11g/bin
timesten@myserver $ ./emctl start agent
Oracle Enterprise Manager 11g Release 1 Grid Control 11.1.0.1.0 
Copyright (c) 1996, 2010 Oracle Corporation.  All rights reserved.
Starting agent ..... started.

Después de estos pasos debes de poder ver la computadora y su agente en Grid Control en la pestaña Targets, opción All Targets. Pero para agregar una nueva base de datos TimesTen a Enterprise Manager primero tienes que configurar la contraseña del agente en Preferences -> Preferred Credentials -> ícono Agent's Set Credentials; en esa página tienes que encontrar tu nuevo agente y llenar los campos Host Username y Host Password. A continuación tienes que ir a la página Setup -> Management Plug-ins y presionar el ícono de deploy del TimesTen management plug-in, en la siguiente página agregar el nuevo agente y presionar el botón Next, y finalmente el botón Finish en la última página.

Ahora deberás poder agregar la base de datos TimesTen seleccionando la liga del agente en la página Targets; podría haber un retraso en la aparición de la opción TimesTen In Memory Database 11g en el menú desplegable Add para que lo tomes en cuenta. En esa página tienes que seleccionar la opción TimesTen In Memory Database 11g del menú Add, y llenar los campos TimesTen instance name, Data Source Name, TimesTen user name y TimesTen password. Finalmente, presiona el botón Test Connection y el botón OK para completar la operación.

Y si eres nuevo en TimesTen y no tienes idea de cuál podría ser el nombre de la instancia y de la fuente de datos, pero el usuario de TimesTen tiene declarada la variable de entorno TT_HOME, hay sólo una base de datos en el servidor, y sabes el nombre del usuario de la base de datos y su password, puedes adivinar el nombre de la instancia de TimesTen y la fuente de datos de esta manera:

timesten@myserver $ basename $TT_HOME
tt1121
timesten@myserver $ ttstatus | grep Data
Data store /TimesTen/DataStore/MyDataStore/MyDataStore

Más información:

Meeting Hardware Requirements
Meeting Package, Kernel Parameter, and Library Requirements