Creación del ejemplo de BeenThere con la herramienta de creación Ant


Portabilidad de J2EE
Volver a crear los ejemplos que se suministran en esta galería
Cómo empezar
Identificar la estructura de directorios
Volver a crear e instalar el ejemplo

Portabilidad de J2EE

Una de las grandes ventajas del desarrollo de aplicaciones en una plataforma J2EE es la portabilidad.  Todos los programas de ejemplo de la galería de ejemplos se desarrollan en una estación de trabajo y se ejecutan en los sistemas z/OS sin que cambie una línea del código Java.  Al crear aplicaciones J2EE en sistemas Intel o UNIX, el desarrollador puede eliminar los retos de EBCDIC en ASCII o las conversiones de archivos de ASCII a EBCDIC.  La disponibilidad de las herramientas facilita a los desarrolladores la escritura y las pruebas en una estación de trabajo de desarrollo, así como la instalación de los archivos EAR (Enterprise Archive) en los sistemas z/OS.

Volver a crear los ejemplos que se suministran en esta galería

Todos los clientes de WebSphere Application Server (Application Server) para z/OS tienen derecho al soporte de Application Server para multiplataformas. Si instala el producto WebSphere Application Server base y los ejemplos en una de las plataformas soportadas por este paquete, podrá ver la galería de ejemplos. La única excepción es cuando pulsa nombre_ejemplo > Créelo con Ant > plataforma > Volver a crear e instalar el archivo sample.ear, que aparecen instrucciones para volver a crear el archivo EAR en esta plataforma.   Como los archivos de texto en un archivo EAR (XML, xmi, archivos JSP (JavaServer Pages), entre otros) deben estar en formato ASCII, es más fácil editar esos archivos en una máquina ASCII.   Si realiza cambios en una máquina ASCII, a continuación, puede desplegar e instalar el archivo EAR resultante en la plataforma z/OS sin una conversión de EBCDIC a ASCII. 



Guía de iniciación

Instale WebSphere Application Server en la plataforma distribuida que prefiera e indique que desea instalar también las aplicaciones de ejemplo del servidor de aplicaciones.

Haga una copia de seguridad del directorio <raíz_perfil> antes de intentar modificar o volver a crear los ejemplos. Cree un archivo zip del directorio samples. Podrá restaurar el directorio samples a su estado original con tal sólo descomprimir el archivo zip.



Identificar la estructura de directorios

La estructura de directorios de creación del ejemplo es la siguiente:


raíz_perfil/samples/src/BeenThere Contiene el código fuente del ejemplo de BeenThere.
raíz_perfil/samples/lib/BeenThere Contiene el archivo BeenThere.ear del ejemplo de BeenThere.
raíz_perfil/samples/javadoc/BeenThere Contiene la documentación Javadoc que se genera al crear el ejemplo de BeenThere.
raíz_perfil/samples/bld/BeenThere Contiene los archivos de clase generados. Utilice estos archivos de clases para generar el archivo BeenThere.ear final. El directorio bld se crea después de volver a crear el ejemplo de BeenThere.



Volver a crear e instalar el ejemplo

Las instrucciones que se proporcionan a continuación describen los pasos para volver a crear el ejemplo.


Ejecutar el script de creación del ejemplo

Siga estos pasos para ejecutar el script de creación del ejemplo que vuelve a crear el ejemplo:

  1. Abra un indicador de mandatos.
  2. En la línea de mandatos, cambie al directorio raíz_perfil/samples/src/BeenThere.
  3. Ejecute el script de creación del ejemplo:

  4. Escriba el mandato siguiente:

    raíz_perfil\samples\bin\BeenThere\buildBeenThere.bat

    Escriba el mandato siguiente:

    . raíz_perfil/samples/bin/BeenThere/buildBeenThere.sh

    • En las plataformas de desarrollo Windows, escriba el mandato siguiente:

      raíz_perfil\samples\bin\BeenThere\buildBeenThere.bat

    • En las plataformas de desarrollo UNIX y Linux, escriba el mandato siguiente:

      . raíz_perfil/samples/bin/BeenThere/buildBeenThere.sh
    Escriba el mandato siguiente:

    . raíz_perfil/samples/bin/BeenThere/buildBeenThere.sh

Ya se ha creado el ejemplo.

Encuentre el script buildBeenThere.bat o buildBeenThere.sh del directorio raíz_perfil/samples/bin/BeenThere. Los scripts establecen la información de classpath adecuada y ejecutan el programa de utilidad de creación Ant. El programa de utilidad Ant lee los archivos build.xml, que describen cómo se crean los ejemplos. Consulte el sitio Web de Jakarta para obtener documentación adicional sobre Ant.

Transferir el archivo BeenThere.ear que se ha vuelto a crear

Utilice FTP (File Transfer Protocol) para transferir el archivo EAR binario al servidor z/OS utilizando las siguientes instrucciones.

  1. Busque y vuelva a crear el archivo EAR en el directorio <raíz_perfil>/samples/lib/BeenThere
  2. Abra una sesión de FTP en WebSphere Application Server para z/OS de la plataforma de desarrollo
  3. Cambie al directorio <raíz_perfil>/samples/lib/BeenThere
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

Eliminar y volver a instalar el archivo BeenThere.ear

Vuelva a instalar el ejemplo como se describe en los pasos siguientes:


  1. Para iniciar la consola administrativa abra el navegador Web y vaya a la página http://<nombre_sistprpal>:9060/ibm/console donde <nombre_sistprpal> es el nombre de sistema principal o la dirección IP donde se ejecuta el gestor de despliegue.
  2. Para iniciar la consola administrativa abra el navegador Web y vaya a la página http://<nombre_sistprpal>:9060/ibm/console donde <nombre_sistprpal> es el nombre de sistema principal o la dirección IP donde se ejecuta el gestor de despliegue.
  3. Para iniciar la consola administrativa abra el navegador Web y vaya a la página http://<nombre_sistprpal>:9080/admin donde <nombre_sistprpal> es el nombre de sistema principal o la dirección IP donde se ejecuta el gestor de despliegue.
  4. Para iniciar la consola administrativa abra el navegador Web y vaya a la página http://<nombre_sistprpal>:9060/ibm/console donde <nombre_sistprpal> es el nombre de sistema principal o la dirección IP donde se ejecuta el gestor de despliegue.
  5. Pulse Servidores > Clústeres.
  6. Seleccione todos los clústeres.
  7. Pulse Detener.
  8. Pulse Aplicaciones > Aplicaciones de empresa.
  9. Seleccione la aplicación BeenThere.
  10. Pulse Desinstalar.
  11. Pulse Guardar en la parte superior del panel principal en la consola administrativa.
  12. Pulse Guardar.
  13. Efectúe los pasos para Instalar el archivo BeenThere.ear.

Ahora se desplegará en los servidores de aplicaciones el archivo BeenThere.ear que se ha vuelto a crear.