Proyecto GlassFish - Introducción

GlassFish Community

Creación del proyecto GlassFish V2.1.1
Para GlassFish V3, consulte las páginas sobre creación y compilación AQUÍ
Requisitos para crear GlassFish
Guía de inicio rápido
Instrucciones de creación completas
Creación de GlassFish con NetBeans IDE
Creación desde la rama o bifurcación
Descripción general de los objetivos Maven de GlassFish

Esta página describe cómo crear GlassFish V2. Aquí hay enlaces útiles si deseas informar sobre un error o solicitar una función o característica. Podrás consultar la directiva de gobernabilidad aquí.

Instrucciones completas sobre cómo crear GlassFish V2

GlassFish se puede crear con NetBeans o mediante las opciones de la línea de comandos. El artículo siguiente tiene más información sobre creación y desarrollo del proyecto GlassFish con NetBeans. Las opciones de la línea de comandos para crear GlassFish figuran a continuación.

Requisitos previos para crear GlassFish.

Los usuarios deberán tener Maven (1.0.2) instalado: esto creará el repositorio local que Maven necesita para almacenar las dependencias de GlassFish.
El usuario debe tener un inicio de sesión en java.net y debe tener acceso al repositorio CVS para el proyecto GlassFish.
El usuario debe iniciar sesión en el repositorio GlassFish CVS una vez (para que CVS guarde la contraseña en el archivo .cvspass en el directorio de inicio del usuario).
Se debe instalar J2SE 5.0 (1.5.0_12), configurado como una variable env de JAVA_HOME presente en la ruta binaria. Recomendamos que se utilice la versión más reciente que esté disponible.
La configuración del cliente cvs se realizará según las instrucciones de java.net.

Pasos para la creación de GlassFish:

El primer paso es comprobar las dependencias del módulo y los archivos comunes utilizados en el sistema de creación de la compilación y editar el archivo de propiedades.

% mkdir workspace
% cd workspace
% cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SJSAS91_FCS_BRANCH glassfish/bootstrap

Esta acción comprobará project.xml, maven.xml, project.properties y los archivos comunes a los que se hace referencia desde project.xml.

Se debe crear workspace/glassfish/bootstrap/build.properties o bien, para conseguir un espacio de trabajo de GlassFish reutilizable, un proceso único consiste en crear ${HOME}/build.properties (Unix) o bien %HOMEPATH%\build.properties (Windows) y establecer las siguientes variables: (se puede obtener el valor %HOMEPATH% si se ejecuta el comando: echo %HOMEPATH% o se ejecuta "set" y se busca la variable HOMEPATH (Windows)).
Se deben definir dos variables glassfish, glassfish.os.name y glassfish.cvs.username tal como se indica más arriba.
glassfish.os.name= <Nombre del SO, los posibles valores son: WINNT, SunOS, Linux, SunOS_X86, Darwin>
glassfish.cvs.username= <java.net id>

Por ejemplo, en Windows XP Professional:

glassfish.os.name=WINNT

glassfish.cvs.username=carlavmott

A continuación, hay que verificar las fuentes.

% cd glassfish/bootstrap
% maven checkout

Limitación conocida: algunas de las fuentes necesarias para la creación de GlassFish podrían no estar disponibles en java.net inmediatamente (por ejemplo, MQ, ORB, JWSDP 2.0, etc.). Se tratarán como dependencias binarias por el momento. Consulte el paso siguiente para ver cómo se utilizan las dependencias binarias. También se puede recuperar un subconjunto de los módulos llamando a:

% maven checkout -Dmodules=[lista de los nombres de los módulos separados por comas]

Los nombres de los módulos están en esta página.

Inicie la secuencia de arranque de la imagen del servidor (un conjunto de secuencias de comandos y archivos jar que se utilizan para ejecutar glassfish). Los desarrolladores pueden seleccionar la opción "bootstrap" de inicio de secuencia de arranque, que descarga el servidor pre-generado y crea solamente subconjuntos de los módulos. Otra opción, "bootstrap-all" (iniciar todas las secuencias de arranque) consiste en crear el servidor desde cero y generar todos los módulos para verificar los cambios en las versiones de las dependencias binarias y las dependencias entre los módulos.

Opción bootstrap-all: crea todos los módulos desde la fuente.

% maven bootstrap-all

Opción bootstrap: para crear un módulo propio mediante un servidor pre-generado.

% maven bootstrap

Este paso es optativo si ya ha instalado una compilación probada de GlassFish. Para utilizar la compilación probada tendrá que configurar las propiedades en glassfish/project.properties.

glassfish.image.version=<<versión de la compilación>>

Esto provocará que el sistema de la compilación "apunte" a esa instalación. Esta propiedad también se puede agregar a ${HOME}/build.properties

Se debe generar el código fuente comprobado. El orden de la compilación estará dirigido por un archivo común de configuración que se comprueba en el paso 2, situado más arriba. En este paso se actualizará la imagen al final de la compilación de cada módulo.

% maven build

Siempre puede generar un subconjunto de los módulos al invocar:

% maven build -Dmodules=[lista de los nombres de módulos separados por comas]

o yendo a ../[nombre de módulo] e invocando:

% maven build

A continuación hay que configurar el tiempo de ejecución del servidor GlassFish. Con este paso se creará la secuencia de comandos asadmin, se ejecutará create-domain, etc., lo que es necesario para ejecutar el servidor GlassFish.

% maven configure-runtime   (la opción predeterminada es el modo de instalación silencioso)

Si desea especificar información de configuración común (por ejemplo, números de puertos, etc.), utilice configure-runtime en modo detallado o explicativo.

% maven configure-runtime -Dinteractive

En general, sólo necesitará ejecutar este comando una vez. Los casos en los que se cambie el entorno de dominios necesitarán una reconfiguración, consulte las preguntas frecuentes de FAQ para obtener más información. Los valores predeterminados para la configuración del tiempo de ejecución se pueden encontrar en glassfish/bootstrap/project.properties:

domain.name="domain1"
instance.name="server"
admin.user="admin"
admin.password="adminadmin"
admin.port="4848"
instance.port"="8080"
orb.port="3700"
imq.port="7676"
https.port="8181"

El objetivo de Maven 'configure-runtime' creará un dominio de una sola instancia, similar a GlassFish V1. Si desea crear un dominio en modo clúster de GlassFish V2, ejecute los siguientes comandos:
% maven configure-cluster

Inicie el servidor mediante el comando siguiente. Todos los servidores de GlassFish se encuentran en el directorio <glassfish.root>/publish/bin Para obtener más documentación sobre cómo administrar el servidor, consulte la documentación de la serie Sun Java System Application Server PE, versión 8. Una gran cantidad del contenido que ahí está todavía concierne a la versión 9. Nota: actualmente GlassFish sólo admite opciones de la línea de comandos para todas las plataformas.

% asadmin start-domain

Limpieza del servidor.

% maven clobber

Esta acción eliminará todas las secuencias de comandos y los archivos jar utilizados para hacer funcionar el servidor. Eliminará todos los elementos bajo glassfish.home y después de hacer esto, tendrá que volver al paso 2.

Limpieza de la compilación o el servidor: puede utilizar cualquiera de los tres objetivos arriba citados durante el proceso de desarrollo. Actualice las fuentes con su IDE favorito y emplee cualquiera de los siguientes comandos en el espacio de trabajo ya creado para llevarlo a su estadio original, donde volver a crear o reconstruir y verificar los cambios.

Para limpiar los módulos que se borrarán, hay que crear archivos generados como .class, .properties y cuando estén listos para ser recompilados, tendrá que ejecutar el siguiente comando:
```
% maven clean (o maven -Dmodules=mail,activation clean)
```
Para limpiar el servidor configurado anteriormente en el paso 5, utilice el comando que aparece a continuación para la limpieza de servidores, que elimina Administration Server, domain1 y conserva el servidor en el estado en que se instaló originalmente. Elimina los archivos sustituidos por tokens de nueva generación presentes en ${glassfish.home}/bin, config.directories
```
% maven clean-config
```
Puede utilizar "maven clean-config" si desea comprobar los cambios relacionados con el dominio y con el inicio de Administration Server. El objetivo "clobber" se puede usar para eliminar el servidor y obtener un servidor nuevo. "clean" se puede usar para eliminar los archivos de creación listos para compilar.

Ejecutar las pruebas Quicklook: las pruebas de Quicklook están pensadas para proporcionarle al desarrollador un modo de comprobar las principales funciones del servidor de aplicaciones y de ejecutar una comprobación de coherencia para cerciorarse de que no hay ningún elemento principal que falle.

Comprobar los archivos de comprobación necesarios de glassfish/appserv-tests, como se muestra a continuación.

% cd glassfish/bootstrap
% maven checkout-quicklook

Configuración de APS_HOME. Éste es el directorio en el que se ha comprobado el espacio de trabajo, incluido el nombre de raíz de dicho espacio de trabajo (p.ej., /workspace/appserv-tests)

Configuración de S1AS_HOME. Éste es el directorio de instalación para el servidor GlassFish (p.ej., /workspace/publish/glassfish)

Las propiedades de la instalación se encuentran en ${APS_HOME}/config.properties para que coincida con la instalación (por ejemplo, admin.password, http.port, etc.). Si ha cambiado algún valor predeterminado, modifique este archivo config.properties.

Asegúrese de que el servidor NO esté funcionando antes de ejecutar las pruebas, si ya está en ejecución, deténgalo.

Ejecute la prueba:

% cd $APS_HOME
% maven runtest

Abra el archivo ${APS_HOME}/test_results.html en un explorador y examine los resultados.

Puede encontrar las instrucciones detalladas para ejecutar las pruebas de Quicklook AQUÍ.

No olvide verificar la wiki de preguntas frecuentes GlassFish Build FAQ si se encuentra con dificultades.

Compatibilidad con IDE

Crear y desarrollar GlassFish con NetBeans 4.1.

Para obtener más información, consulte las directrices del espacio de trabajo y los procedimientos de confirmación. También puede utilizar FishEye para investigar qué cambios se han producido en el espacio de trabajo.

Creación de GlassFish V2.1, SGES21_FS_BRANCH :

Éstos son los pasos para la creación de una rama o bifurcación GlassFish Branch:
% mkdir workspace % cd workspace % cvs -d :pserver:<userid>@cvs.dev.java.net:/cvs checkout -r SGES21_FCS_BRANCH glassfish/bootstrap

Como glassfish/bootstrap/project.properties de la rama SGES21_FCS_BRANCH tiene una variable "glassfish.cvstag" establecida como "glassfish.cvstag=SGES21_FCS_BRANCH". Las fuentes de la rama o bifurcación FCS se comprobarán y crearán según corresponda.

Defina dos variables, glassfish.os.name y glassfish.cvs.username tal como se explica más arriba.

A continuación:
% cd glassfish/bootstrap % maven checkout bootstrap-all build configure-runtime

Puede decidir qué objetivo ejecutar entre bootstrap (inicio de la secuencia de arranque) y bootstrap-all de entre los comandos arriba citados, para lo que puede consultar los detalles aquí.

Vista general de los objetivos de GlassFish Maven:

Nombre del objetivo	Comando utilizado normalmente	Descripción
bootstrap	maven -Dmodules=admin bootstrap checkout build	Descargue el archivo glassfish-image-SNAPSHOT.jar y descomprima el archivo en ${glassfish.home}(imagen del servidor) para crear módulos individuales.
bootstrap-all	maven checkout bootstrap-all build	Instala una imagen de glassfish vacía que solamente contiene las dependencias binarias, a continuación descarga dependencias binarias individuales que se descomprimen en ${glassfish.home} y genera todos los módulos desde fuentes.
checkout	maven checkout	Comprobación de un módulo
build	maven build	Creación del módulo
configure-runtime	maven configure-runtime	Configuración de ${glassfish.home} con un dominio de una única instancia
configure-cluster	maven configure-cluster	Configuración de un dominio con funciones de clúster para GlassFish V2
clean	maven clean clobber	Limpieza del módulo
clobber	maven clobber	Limpia la imagen del servidor de GlassFish; elimina el directorio ${glassfish.home. Es necesario utilizarlo con "bootstrap-all" para conseguir una nueva imagen y limpiar las imágenes de servidores que estén dañadas.
clean-config	maven clean-config	Limpia el servidor. Elimina domain1 y los archivos sustituidos por tokens de bin,config.
-Dmodules=	maven -Dmodules=admin bootstrap checkout build	Limpia/comprueba/genera sólo algunos módulos: maven -Dmodules={lista separada por comas} nombre del objetivo.