Para un entorno típico en el que quiera supervisar todas las aplicaciones Ruby on Rails del sistema de forma automática, no tiene que proporcionar más información de configuración que el nuevo nombre de instancia. En un entorno típico, configure el agente con los valores predeterminados.

1. Para configurar el agente, especifique:
   dir_instalación/bin/ruby-agent.sh config nombre_instancia dir_instalación/samples/ruby_silent_config.txt
   Donde nombre_instancia es el nombre que desea dar a la instancia y dir_instalación es el directorio de instalación del Agente de Ruby. El directorio de instalación predeterminado es /opt/ibm/apm/agent.

   Antes de ejecutar el mandato config, asegúrese de que el archivo ruby_silent_config.txt , especialmente el parámetro de KKM_RUBY_RUNTIME_BIN_LOCATION, está correctamente configurado.

   El valor del parámetro KKM_AUTO_DETECT_RUBY_APPLICATIONS se puede establecer como Y solo para una instancia de agente. Para otras instancias, establezca el valor como N.

2. Para iniciar el agente, especifique:
   dir_instalación/bin/ruby-agent.sh start nombre_instancia

Si tiene varios tiempos de ejecución de Ruby instalados en el sistema, tendrá que especificar el tiempo de ejecución que se va a utilizar para recopilar datos de las aplicaciones Ruby. El entorno de ejecución de Ruby seleccionado debe ser compatible con la versión de Rails utilizada en la aplicación. Para especificar el entorno de ejecución por utilizar, configure el agente con valores personalizados.

1. Para configurar el agente, especifique:
   dir_instalación/bin/ruby-agent.sh config nombre_instancia
   Donde nombre_instancia es el nombre que desea dar a la instancia y dir_instalación es el directorio de instalación del Agente de Ruby. El directorio de instalación predeterminado es /opt/ibm/apm/agent.
2. Cuando se le solicite Editar agente de supervisión para los valores de Ruby, especifique 1 para continuar.
3. Cuando se le solicite la ubicación del directorio bin de tiempo de ejecución de Ruby, especifique el directorio binario. Por ejemplo, /usr/local/rvm/rubies/ruby-2.0.0-p247/bin si utiliza Ruby Version Manager (RVM).
4. Cuando se le pregunte Permitir que el agente de Ruby detecte de forma automática todas las aplicaciones actuales de Ruby on Rails, especifique Y (sí) o N (no) para continuar.
   Nota: Esta función solo se puede habilitar en una instancia de agente. Cuando configura otras instancias, especifique N para inhabilitar esta función y continúe.
5. Cuando se le solicite el Servidor de aplicaciones de Rails, pulse Intro para aceptar el valor predeterminado de ruby o especifique el valor del servidor que usa conforme a la lista siguiente:
   • Para los servidores Webrick, acepte el valor predeterminado o especifique ruby; si Rails está instalado por Ruby Stack, especifique .ruby.bin.
   • Para los servidores Passenger, especifique passenger.
   • Para los servidores Unicorn, especifique unicorn.
   • Para los servidores Puma, especifique puma.
   • Para los servidores Thin, si las aplicaciones se han iniciado mediante el comando thin start, acepte el valor predeterminado para usar ruby; si las aplicaciones se han iniciado mediante el comando thin start -d, especifique thin; si Rails está instalado por Ruby Stack y las aplicaciones se han iniciado ejecutando el comando thin start, especifique .ruby.bin.
6. Cuando se le solicite el origen de datos de Socket, pulse Intro para aceptar el valor predeterminado de 0 y utilizar el puerto efímero.
7. Cuando se le solicite Editar los valores de 'aplicación_Ruby', especifique 5 para salir.
8. Para iniciar el agente, especifique:
   dir_instalación/bin/ruby-agent.sh start nombre_instancia

Si prefiere supervisar un subconjunto de aplicaciones Ruby, edite todas las aplicaciones Ruby que quiera supervisar por separado.

1. Para configurar el agente, especifique:
   dir_instalación/bin/ruby-agent.sh config nombre_instancia
   Donde nombre_instancia es el nombre que desea dar a la instancia y dir_instalación es el directorio de instalación del Agente de Ruby. El directorio de instalación predeterminado es /opt/ibm/apm/agent.
2. Cuando se le solicite Editar agente de supervisión para los valores de Ruby, especifique 1 para continuar.
3. Cuando se le solicite la ubicación del directorio bin de tiempo de ejecución de Ruby, pulse Intro para continuar.
4. Cuando se le pregunte Permitir que el agente de Ruby detecte de forma automática todas las aplicaciones actuales de Ruby on Rails, especifique Y (sí) o N (no) para continuar.
   Nota: Esta función solo se puede habilitar en una instancia de agente. Cuando configura otras instancias, especifique N para inhabilitar esta función y continúe.
5. Cuando se le solicite el Servidor de aplicaciones de Rails, pulse Intro para aceptar el valor predeterminado de ruby o especifique el valor del servidor que usa conforme a la lista siguiente:
   • Para los servidores Webrick, acepte el valor predeterminado o especifique ruby; si Rails está instalado por Ruby Stack, especifique .ruby.bin.
   • Para los servidores Passenger, especifique passenger.
   • Para los servidores Unicorn, especifique unicorn.
   • Para los servidores Puma, especifique puma.
   • Para los servidores Thin, si las aplicaciones se han iniciado mediante el comando thin start, acepte el valor predeterminado para usar ruby; si las aplicaciones se han iniciado mediante el comando thin start -d, especifique thin; si Rails está instalado por Ruby Stack y las aplicaciones se han iniciado ejecutando el comando thin start, especifique .ruby.bin.
6. Cuando se le solicite el origen de datos de Socket, pulse Intro para aceptar el valor predeterminado de 0 y utilizar el puerto efímero.
7. Cuando se le solicite Editar los valores de 'aplicación_Ruby', especifique 1 para especificar una aplicación.
8. Cuando se le solicite, escriba el nombre de aplicación Ruby.
9. Cuando se le solicite, especifique el directorio de inicio de la aplicación Ruby, por ejemplo: /root/Ruby/myApp.
10. Para la última solicitud, Avanzado (seleccione una sección para alterar temporalmente los valores), puede especificar q para salir.
11. Para iniciar el agente, especifique:
    dir_instalación/bin/ruby-agent.sh start nombre_instancia
    Nota: Si tiene varios tiempos de ejecución Ruby instalados y quiere supervisar aplicaciones Ruby específicas, puede definir una alteración de tiempo de ejecución en la aplicación o subnodo Ruby. Como ejemplo, se da por supuesto que tiene dos tiempos de ejecución instalados y cuatro aplicaciones, tres de las cuales utilizan un tiempo de ejecución y una utiliza el otro tiempo de ejecución. En este caso, defina el tiempo de ejecución que se utiliza con más frecuencia en el nivel de agente y defina la alteración temporal de la aplicación que utiliza un tiempo de ejecución diferente.