![]() | |
Sun Java System Application Server Enterprise Edition 8.1 2005Q1 |
Guía de inicio rápido
Le damos la bienvenida a la Guía de inicio rápido de Sun Java System Application Server Enterprise Edition 8.1 2005Q1. Esta guía está destinada a desarrolladores, administradores de sistemas y administradores de Application Server que deseen conocer las funciones del software Sun Java System Application Server Enterprise Edition 8.1 2005Q1.
Para obtener la versión más reciente de este documento, consulte la versión en línea en docs.sun.com en:
http://docs.sun.com/app/docs/prod/sjs.asse
Esta guía describe los procedimientos básicos y avanzados para usar Application Server. Los procedimientos se presentan en el orden en el que se deben llevar a cabo. Los procedimientos básicos, que normalmente requieren menos de 45 minutos, aparecen en las siguientes secciones:
Los procedimientos avanzados, que normalmente requieren unos 45 minutos, aparecen en las siguientes secciones:
Los apartados finales de esta guía incluyen instrucciones acerca de la Limpieza y Más información.
La siguiente tabla describe cuáles son los nombres de las variables y las rutas predeterminadas para los directorios que se usan en esta guía. Los nombres de las variables aparecen en la primera columna y las rutas predeterminadas, en la segunda.
Acerca de la administración de Application ServerApplication Server pone las siguientes herramientas a disposición de los administradores para que puedan gestionar las instancias de servidor y los clústeres que se ejecutan en varios hosts:
Estas herramientas se conectan con un servidor llamado Domain Administration Server, que es una instancia de Application Server especialmente designada para actuar como intermediaria en todas las tareas administrativas. Domain Administration Server proporciona una única interfaz segura para validar y ejecutar los comandos administrativos con independencia de la interfaz que se use.
Un dominio es un conjunto de datos de configuración, aplicaciones implementadas y equipos con un administrador designado. La definición de dominio abarca y controla el funcionamiento de varias aplicaciones, instancias autónomas de servidor de aplicaciones y clústeres que, potencialmente, pueden estar distribuidos por varios equipos. Si está instalado Domain Administration Server, un dominio predeterminado llamado domain1 se instala siempre. En esta guía se usa dicho dominio predeterminado.
Para llevar a cabo casi todos los procedimientos aquí descritos, deberá usar la consola de administración.
Inicio de Domain Administration ServerEste tema, que es el primero de los tres temas básicos, incluye los siguientes procedimientos:
Inicio del servidor de administración
Para iniciar el servidor de administración, siga el siguiente procedimiento:
- Agregue el directorio dir_instalación/bin/ a la variable de entorno PATH:
C Shell:
setenv PATH dir_instalación/bin:$PATH
Bourne Shell:
PATH=dir_instalación/bin:$PATH
export PATH- Defina la variable de entorno de usuario de administración de forma que no tenga que escribirla para cada comando:
C Shell:
setenv AS_ADMIN_USER usuario_admin
Bourne Shell:
AS_ADMIN_USER=usuario_admin
export AS_ADMIN_USER- Inicie el servidor introduciendo este comando desde el dir_instalación:
asadmin start-domain domain1
Cuando se le solicite la contraseña de administración y la contraseña maestra, escriba las contraseñas proporcionadas durante la instalación.
- Aparece un mensaje en el que se le indica que Domain Administration Server se está iniciando:
Iniciando el dominio domain1, espere. Se está redirigiendo el registro a domain_dir/domain1/logs/server.log...- Una vez que se ha completado el proceso de inicio, verá un mensaje adicional:
Se ha iniciado el domain1
Inicio de sesión en la consola de administración
La consola de administración es una interfaz basada en navegador que simplifica una serie de tareas de administración y configuración. Normalmente, se utiliza para:
Para obtener más información acerca del uso de la consola de administración, consulte la ayuda en línea o Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Administration Guide.
Para iniciar la sesión en la consola de administración:
- Escriba esta dirección URL en el navegador:
https://host_local:4849/asadmin
Como la consola de administración es una aplicación Web segura, deberá usar https en lugar de http.
Sustituya la variable host_local por el nombre del sistema en el que se esté ejecutando Domain Administration Server.
4849 es el número de puerto predeterminado de la consola de administración. Si ha cambiado el número de puerto durante la instalación, utilice ese número.
- Cuando aparezca la ventana de inicio de sesión, introduzca el nombre de usuario y la contraseña de administración.
- Haga clic en “Inicio de sesión”.
Cuando aparece la consola de administración, tiene un aspecto parecido a éste:
En el panel de la izquierda, se seleccionan los elementos que se van a gestionar desde el árbol proporcionado. En el panel de la derecha, se muestran varias tareas administrativas calificadas como “comunes”.
Visualización del archivo de registro
Las instancias de Application Server y Domain Administration Server crean registros anotados en el sistema de archivos. De forma predeterminada, se registran todos los errores, las advertencias y los mensajes con información útil. Para ver el archivo de registro del servidor de administración:
- En la lista “Tareas comunes” del panel de la derecha, haga clic en “Buscar archivos de registro” para abrir una nueva ventana del navegador para el visor de registros.
- En la ventana del visor de registros, seleccione el servidor en la lista desplegable “Nombre de la instancia” y haga clic en “Buscar”. Se muestran las entradas más recientes del archivo de registro de Domain Administration Server.
- Examine el contenido y busque mensajes WARNING o SEVERE que indiquen que se ha producido algún problema al iniciar el servidor.
Puede cerrar el visor de registros en cualquier momento. Después de crear los clústeres e implementar las aplicaciones, debe examinar los archivos de registro para ver si ha fallado alguna de las operaciones. El visor de registros se puede usar para ver los archivos de registro de cualquier instancia de Application Server que esté en el dominio.
Para obtener más información acerca del archivo de registro, consulte Sun Java System Application Server Enterprise Edition 8.1 2005Q1 Administration Guide.
En este apartado ha iniciado Domain Administration Server y ha confirmado que se está ejecutando. También ha iniciado sesión en la consola de administración y ha usado el visor de registros. Si no desea continuar, puede interrumpir aquí su aprendizaje con la guía rápida.
Creación de un clústerEn este apartado, el segundo de los tres temas básicos, se explica cómo crear un clúster que contenga dos instancias de Application Server. Para facilitar el funcionamiento, el clúster se ejecuta por completo en un solo equipo. Este tema contiene los siguientes procedimientos:
Inicio del agente de nodo
Un agente de nodo es un proceso ligero que se ejecuta en cada equipo que participa en el dominio administrativo de Application Server. El agente del nodo es responsable de iniciar y detener las instancias del servidor en el host. También colabora con Domain Administration Server para crear nuevas instancias de Application Server.
Se necesita un agente de nodo en un equipo para cada dominio administrativo de Application Server al que pertenezca el equipo. Si elige el componente del agente de nodo durante la instalación, se creará un agente de nodo predeterminado llamado nombre_host.
Para iniciar el agente de nodo predeterminado:
- En una ventana de terminal, escriba este comando:
asadmin start-node-agent nombre_host
Sustituya la variable nombre_host por el nombre del host en el que se está ejecutando Application Server.
- Cuando se le solicite, proporcione la contraseña maestra.
El agente de nodo se inicia y establece una conexión con Domain Administration Server. Si Domain Administration Server no se está ejecutando, puede que el agente no logre iniciarse.
Definición de clúster
Un clúster es un grupo de instancias de servidor que suele estar en varios hosts y que comparten configuración, recursos y aplicaciones. Un clúster facilita el equilibrio de carga en varias instancias de servidor y garantiza una alta disponibilidad gracias a la recuperación ante fallos. Puede crear clústeres que abarquen varios equipos y administrarlos con la ayuda del proceso del agente de nodo en cada equipo. En esta guía, para simplificar el proceso, el clúster del ejemplo estará en un host que será el mismo en el que se ejecuta Domain Administration Server.
Debe haber iniciado ya el proceso del agente de nodo en cada equipo, tal y como se describe en el apartado anterior. Cuando especifique instancias durante una creación de clúster, debe asociar la instancia a un agente de nodo que esté en ejecución para el equipo en el que desea ejecutar dicha instancia. Los nombres del agente de nodo y de la instancia deben ser exclusivos en todos los clústeres y deben estar creados en un dominio.
Para crear un clúster:
- Si todavía no lo ha hecho, inicie sesión en la consola de administración en https://host_local:4849.
Sustituya la variable host_local por el nombre del sistema en el que se esté ejecutando Domain Administration Server.
4849 es el número de puerto predeterminado de la consola de administración. Si ha cambiado el número de puerto durante la instalación, utilice ese número.
- En el panel de la derecha, en “Tareas comunes”, haga clic en “Crear un clúster nuevo” para mostrar la página de entrada “Crear clúster”.
- Escriba FirstCluster como el nombre del nuevo clúster.
- En la lista desplegable de plantillas de configuración disponibles, seleccione la configuración predeterminada y elija Hacer una copia de la configuración seleccionada.
- Haga clic en el botón “Agregar” dos veces con objeto de crear dos entradas para especificar dos instancias para el clúster.
- Escriba i1 e i2 como nombres de las instancias. El nombre del agente de nodo se rellena automáticamente con el nombre del equipo local.
Se mostrará una pantalla como ésta:
- Haga clic en “Aceptar”. El proceso de creación puede llevar varios minutos.
Nota
Este ejercicio requiere la asignación automática de los números de puerto para HTTP, HTTPS, IIOP e IIOPS. Si lo desea, podrá cambiarlos posteriormente.
Cuando el proceso de creación haya finalizado, se mostrará una página que indica que el clúster se ha creado correctamente y aparecerá FirstCluster en el árbol del panel de la izquierda. Se ha efectuado una copia de la plantilla de configuración default-config de este clúster y se le ha asignado el nombre FirstCluster-config.
- En el panel de la izquierda, amplíe la visualización de los clústeres y seleccione FirstCluster para que se muestre la página de información general de los clústeres.
- Haga clic en la ficha “Instancias” para mostrar las instancias que ha creado (i1 e i2).
En este apartado ha creado un clúster sencillo en un único equipo. También puede crear clústeres distribuidos en varios equipos usando estos mismos pasos básicos (siempre y cuando tenga el software instalado y el agente de nodo se esté ejecutando en cada equipo).
Si no desea continuar, puede interrumpir aquí su aprendizaje con la guía rápida.
Implementación de una aplicaciónEste tema, que es el tercero de los tres temas básicos, incluye los siguientes procedimientos:
Implementación de la aplicación de ejemplo
En esta guía se usa la aplicación de ejemplo clusterjsp para mostrar las funciones de equilibrado de carga mediante ruta Web.
- Haga clic en el botón de inicio para acceder a la página “Tareas comunes” si no está en ella.
- En el panel de la derecha, en “Tareas comunes”, haga clic en “Implementar aplicación empresarial”.
- En el cuadro de texto “Archivo para cargar”, haga clic en “Examinar” y vaya a dir_instalación/samples/ee-samples/highavailability/apps/clusterjsp/clusterjsp.ear.
- Haga clic en “Siguiente” para mostrar la página “Implementar aplicación empresarial”.
- Vaya hacia abajo hasta el apartado “Destinos”.
- Seleccione “FirstCluster” en la lista “Disponible” y haga clic en “Agregar” para moverlo a la lista “Seleccionados”.
- Haga clic en “Aceptar”.
La aplicación clusterjsp está ahora implementada en FirstCluster.
Esta pantalla confirma que la aplicación clusterjsp está ahora implementada en FirstCluster.
Verificación de la aplicación en clúster
En este paso, debe iniciar el clúster y comprobar si la aplicación está accesible en las dos instancias.
Para iniciar el clúster:
- En el árbol del panel de la izquierda, haga clic en el nodo FirstCluster en “Clústeres”.
- En el panel de la derecha, haga clic en la ficha “General” si aún no está habilitada.
- Haga clic en el botón “Iniciar instancias” para iniciar el clúster.
- Verifique que se haya iniciado comprobando que el campo “Estado” cambia para indicar qué instancias se están ejecutando.
Para acceder a la aplicación en cada instancia:
- Escriba esta dirección URL en el navegador:
http://host_local:puerto/clusterjsp
Sustituya la variable host_local por el nombre del sistema en el que se esté ejecutando Domain Administration Server.
Sustituya la variable puerto por el valor de HTTP-LISTENER-PORT para i1. En este ejemplo se usa http://host_local:38081/clusterjsp.
- Agregue algunos datos de atributo de sesión.
- Compruebe la información que se muestra acerca de la sesión y del host. Por ejemplo:
- Agregue algunos datos de sesión y haga clic en el botón “Agregar a sesión”.
- Repita este procedimiento para la instancia i2; para ello, escriba esta dirección URL en su navegador:
http://host_local:38080/clusterjsp
En este apartado ha implementado una aplicación en un clúster y ha comprobado que la aplicación está disponible en todas las instancias del clúster.
¡Enhorabuena! Ha completado los procedimientos básicos de esta guía de inicio rápido. Si no desea continuar con los procedimientos avanzados, puede interrumpir aquí su aprendizaje con la guía rápida.
Configuración del equilibrador de cargaUn equilibrador de carga se implementa normalmente delante de un clúster. Realiza estas funciones:
- Permite expandir horizontalmente una aplicación o un servicio por varios hosts físicos (o lógicos) y sigue mostrándose ante el usuario como una única dirección URL.
- Permite aislar al usuario de los fallos de host o de los bloqueos del servidor cuando se usa con la replicación de sesión.
- Mejora la seguridad al ocultar la red interna al usuario.
Application Server incluye complementos de equilibrado de carga para servidores Web conocidos como Apache y Sun Java System Web Server.
Este apartado proporciona instrucciones acerca de cómo descargar y configurar el software Sun Java System Web Server para que actúe como equilibrador de carga para el clúster de Application Server. Para completar este apartado, debe tener memoria suficiente para ejecutar un Web Server en su sistema, además de Domain Administration Server y las dos instancias de Application Server que creó anteriormente siguiendo los procedimientos de esta guía. Se recomienda usar un sistema que tenga entre 512 Mbytes y 1024 Mbytes de memoria para completar este apartado.
Este tema contiene los siguientes procedimientos:
Instalación del software de Web Server
Si ya tiene instalado el software de Web Server y puede identificar una instancia de Web Server que actúe como equilibrador de carga, tome nota de la ubicación de esta instancia en el sistema de archivos y pase a Instalación del complemento del equilibrador de carga.
Si usa el software de Sun Java Enterprise System, Web Server se selecciona automáticamente para su instalación cuando elige instalar el complemento de equilibrador de carga. Sin embargo, también puede instalar el software de Web Server siguiendo estos pasos:
- Inicie el programa de instalación de Java Enterprise System.
- Seleccione el componente Sun Java System Web Server en la página “Selección de componentes”.
- Elija la opción “Configurar ahora” para que se le pregunte por la configuración de Web Server durante la instalación.
- Cuando se le solicite, defina una instancia predeterminada de Web Server.
Si usa Sun Java System Application Server o si no tiene acceso al programa de instalación de Sun Java Enterprise System, siga estos pasos para instalar el software de Web Server:
- Vaya a http://www.sun.com/downloads. Vaya al encabezado “Web & Proxy Servers” y haga clic en “Web Servers”.
- Descargue Web Server 6.1 Service Pack 2 o superior para la plataforma y la configuración regional que necesite.
Para ello, debe iniciar sesión con una contraseña y un nombre de usuario que estén registrados en MySunSM, Sun StoreSM, SunSolveSM o el centro de asistencia en línea. Si no dispone de cuenta para iniciar sesión, puede registrarse en línea.
- Siga las instrucciones para instalar el software de Web Server. Debe seguir estos pasos:
- Durante el proceso de instalación de Web Server se configura Administration Server para Web Server y también se establece la instancia predeterminada de Web Server.
Instalación del complemento del equilibrador de carga
Para instalar el complemento de equilibrador de carga:
- Ejecute el programa de instalación para la distribución de software que está usando: el software de Sun Java Enterprise System o el de Sun Java System Application Server independiente.
- Cuando se le pregunte qué componentes desea instalar, seleccione el complemento de equilibrado de carga.
En el programa de instalación de Sun Java Enterprise System, deberá expandir el elemento de Application Server para ver el complemento de equilibrado de carga. No está seleccionado de forma predeterminada para su instalación.
Creación de una configuración de equilibrador de carga
Vuelva ahora a interactuar con Domain Administration Server del servidor de aplicaciones. Para este apartado necesita un entorno de ejecución de shell.
- Cree una configuración de equilibrador de carga que se llame MyLbConfig destinada al clúster FirstCluster:
asadmin create-http-lb-config --target FirstCluster MyLbConfig
- Active el clúster FirstCluster y la aplicación clusterjsp implementada en él para el equilibrado de carga HTTP:
asadmin enable-http-lb-server FirstCluster
asadmin enable-http-lb-application --name clusterjsp FirstCluster
- Cree un comprobador de salud para el equilibrador de carga, que señala cuándo se recupera una instancia que se ha desactivado.
asadmin create-http-health-checker --interval 10 --config MyLbConfig FirstCluster
El intervalo es el número de segundos que el comprobador de salud espera entre cada comprobación de una instancia que no goza de buena salud.
- Exporte la configuración a un archivo loadbalancer.xml
asadmin export-http-lb-config --config MyLbConfig loadbalancer.xml
- Copie loadbalancer.xml en dir_instalación_Web_Server/https-nombre_host/config/loadbalancer.xml
Inicio del equilibrador de carga
Si la instancia de Web Server que actúa como equilibrador de carga no se está ejecutando ya, inicie el software de Web Server usando este comando:
Si la instancia de Web Server que actúa como equilibrador de carga no se está ejecutando ya, reinicie el software de Web Server usando este comando:
Verificación del equilibrado de carga
- Para mostrar la primera página de la aplicación clusterjsp, escriba esta dirección URL en el navegador:
http://host_local:puerto_Web_Server/clusterjsp
Sustituya la variable host_local por el nombre del sistema en el que se esté ejecutando Web Server.
Sustituya la variable puerto_Web_Server por el valor del atributo del puerto del elemento LS de dir_instalación_Web_Server/https-nombre_host/config/server.xml. Para este ejemplo, el puerto que se usa es 38000.
Aparece una página similar a la que se muestra en el apartado Verificación de la aplicación en clúster.
- Compruebe la información que se muestra acerca de la sesión y del host. Por ejemplo:
- El número de puerto del servidor es 38000, el puerto de Web Server. El equilibrador de carga ha reenviado la solicitud en las dos instancias del clúster.
- La utilización de un software de explorador distinto, o un explorador en una máquina distinta, crea una nueva sesión. Las solicitudes desde el mismo explorador están “pegadas” y van a la misma instancia.
Estas sesiones se deben distribuir a las dos instancias del clúster. Puede comprobarlo mirando en los archivos de registro de acceso al servidor, que están ubicados aquí:
- Instalación de Solaris Java Enterprise System:
/var/opt/SUNWappserver/nodeagents/nombre_nodo_agente/i1/logs/access/server_access_log
/var/opt/SUNWappserver/nodeagents/nombre_nodo_agente/i2/logs/access/server_access_log- Instalación de Linux Java Enterprise System:
/var/opt/sun/appserver/nodeagents/nombre_nodo_agente/i1/logs/access/server_access_log
/var/opt/sun/appserver/nodeagents/nombre_nodo_agente/i2/logs/access/server_access_log- Instalaciones independientes de Application Server:
dir_instalación/nodeagents/nombre_nodo_agente/i1/logs/access/server_access_log
dir_instalación/nodeagents/nombre_nodo_agente/i2/logs/access/server_access_log- Agregue un par nombre-valor (Name=Name Value=Duke) para almacenar en HttpSession.
- Haga clic en el botón “Agregar a datos de sesión”.
- Compruebe que los datos de sesión se hayan agregado.
En este apartado, ha creado una instancia para usarla como equilibrador de carga y ha realizado una configuración de equilibrio de carga. También ha verificado el equilibrio de carga.
Para configurar y comprobar una recuperación ante fallos de sesión HTTP, vaya a Configuración de alta disponibilidad mediante recuperación ante fallos.
LimpiezaPara limpiar el sistema, debe desinstalar Application Server realizando los pasos que figuran en Opción 1: Desinstalación, o bien eliminar el clúster de ejemplo que acaba de crear llevando a cabo el procedimiento Opción 2: Eliminación del clúster de ejemplo.
Precaución
Si tiene previsto completar la sección Información acerca de clústeres de alta disponibilidad y HADB, no limpie la instalación ahora. En su lugar, inicie la sección Información acerca de clústeres de alta disponibilidad y HADB y cuando haya terminado, realice la limpieza utilizando los procedimientos que encontrará en dicha sección.
Opción 1: Desinstalación
Para llevar a cabo una desinstalación completa:
- Detenga los procesos de Application Server usando estos comandos:
asadmin stop-cluster FirstCluster
asadmin stop-node-agent hostname
asadmin stop-domain domain1
En este momento, todos los procesos relacionados con Application Server deben estar detenidos.
- Desinstale Application Server.
En una instalación de Java Enterprise System, ejecute var/sadm/prod/entsys/uninstall y siga los pasos indicados en el asistente para la desinstalación.
En una instalación de Application Server independiente, ejecute dir_instalación/uninstall y siga los pasos indicados en el asistente para la desinstalación.
- Si ha instalado Web Server para este ejercicio, detenga la instancia de Web Server que actúa como equilibrador de carga y desinstale el producto Web Server. Puede detener la instancia de la siguiente forma:
dir_instalación_Web_Server/https-nombre_host/stop
- Si desea desinstalar Web Server, ejecute el programa de desinstalación desde dir_instalación_Web_Server.
Opción 2: Eliminación del clúster de ejemplo
Para eliminar sólo FirstCluster (el clúster de ejemplo de alta disponibilidad) y la aplicación de ejemplo usada durante este ejercicio:
- Detenga los procesos de Application Server y limpie la configuración:
asadmin stop-cluster FirstCluster
asadmin disable-http-lb-server FirstCluster
asadmin delete-http-lb-ref --config MyLbConfig FirstCluster
asadmin delete-http-lb-config MyLbConfig
asadmin delete-instance i1
asadmin delete-instance i2
asadmin delete-cluster FirstCluster
asadmin undeploy clusterjsp
- Detenga la instancia de Web Server que actúa como equilibrador de carga:
dir_instalación_Web_Server/https-nombre_host/stop
- Cambie el nombre del archivo loadbalancer.xml ubicado en dir_instalación_Web_Server/https-nombre_host/config a loadbalancer.xml.sav
¡Enhorabuena! Ha finalizado la Guía de inicio rápido de Application Server.
Más informaciónHay disponibles más recursos para aprender y utilizar el software Application Server. Por ejemplo: