Crear el ejemplo de Plants by WebSphere 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 e iSeries 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 e iSeries.

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

Todos los clientes de WebSphere Application Server (Application Server) para z/OS e iSeries 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 e iSeries sin una conversión de EBCDIC a ASCII. 

Cómo empezar

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.

Realice una copia de seguridad del directorio <raíz_perfil>/samples  antes de intentar modificar o volver a generar 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

Los ejemplos están instalados en los siguientes directorios:


<raíz_perfil>/samples/src/PlantsByWebSphere Contiene el código fuente del ejemplo de Plants by WebSphere.
<raíz_perfil>/samples/lib/PlantsByWebSphere Contiene los archivos archivadores Web (WAR), los archivos archivadores Java (JAR) y el archivo PlantsByWebSphere.ear final del ejemplo de Plants by WebSphere. Este directorio se crea después de volver a crear el ejemplo de Plants by WebSphere.
<raíz_perfil>/samples/javadoc/PlantsByWebSphere Contiene la documentación del Javadoc. Este directorio se crea después de volver a crear el ejemplo de Plants by WebSphere.
<raíz_perfil>/samples/bld/PlantsByWebSphere Contiene los archivos de clase generados. Utilice estos archivos de clases para generar el archivo PlantsByWebSphere.ear final. Este directorio se crea después de volver a crear el ejemplo de Plants by WebSphere.

Volver a crear e instalar el ejemplo

El ejemplo de Plants by WebSphere se instala automáticamente con WebSphere Application Server. No es necesario que cree el ejemplo de Plants by WebSphere antes de utilizarlo. Las instrucciones que se proporcionan a continuación describen los pasos para volver a crear el ejemplo, junto con información adicional para modificarlos.


Ejecutar el script de creación del ejemplo
Transferir el archivo PlantsByWebSphere.ear que se ha vuelto a crear
Eliminar y volver a instalar el archivo PlantsByWebSphere.ear

Ejecutar el script de creación del ejemplo

Para volver a crear este ejemplo, verifique que raíz_perfil/bin está en la variable de entorno PATH. 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/PlantsByWebSphere.
  3. Ejecute el script de creación del ejemplo:

  4. Escriba el siguiente mandato:


    <raíz_perfil>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      <raíz_perfil>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      . <raíz_perfil>/samples/bin/PlantsByWebSphere/buildplantsby.sh

Ya se ha creado el ejemplo.

El archivo buildplantsby.bat y el script buildplantsby.sh en el directorio raíz_perfil/samples/bin/PlantsByWebSphere establecen la información de vía de acceso de clases adecuada y ejecutan el programa de utilidad de creación Ant. ANT lee los archivos build.xml, que describen cómo crear el ejemplo. Consulte el sitio Web de Jakarta para obtener documentación adicional sobre Ant.

Información importante  Durante el proceso de creación, sólo se vuelven a crear los archivos de clases que tengan cambios. Los demás archivos de clase se vuelven a empaquetar en el nuevo archivo EAR.

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

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

  1. Busque y vuelva a crear el archivo EAR en el directorio <raíz_perfil>/samples/lib/PlantsByWebSphere
  2. Abra una sesión de FTP en WebSphere Application Server para z/OS o iSeries de la plataforma de desarrollo
  3. Vaya al directorio <raíz_perfil>/samples/lib/PlantsByWebSphere
    Es posible que deba crear el directorio si no existe.
  4. Si existe el archivo PlantsByWebSphere.ear, suprímalo de modo que se pueda grabar el archivo actualizado.
    del PlantsByWebSphere.ear
  5. bin
  6. put PlantsByWebSphere.ear
  7. quit

Eliminar y volver a instalar el archivo PlantsByWebSphere.ear

Por omisión, el ejemplo de Plants by WebSphere se instala en el directorio raíz_perfil/installedApps/<nombre de célula>, donde <nombre de célula> es el nombre de la célula donde se ha instalado la aplicación. Vuelva a instalar el ejemplo como se describe en los pasos siguientes:

  1. Detenga el servidor de aplicaciones.
  2. Elimine el archivo EAR del ejemplo de Plants by WebSphere:
    1. Escriba los siguientes mandatos:

      cd <raíz_perfil>\bin
      setupCmdLine

      cd <raíz_perfil>/bin
      . ./setupCmdLine.sh

      En las plataformas z/OS:
      cd <raíz_perfil>/bin
      . ./setupCmdLine.sh

      En las plataformas iSeries:
      cd <raíz_perfil>/bin
      . ./setupCmdLine

      donde <raíz_perfil> representa el directorio de instalación del perfil.
    2. Escriba el siguiente mandato para desinstalar la aplicación (raíz_perfil/bin debe estar en la variable PATH):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      En las plataformas z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      En las plataformas iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Vuelva a instalar el ejemplo de Plants by WebSphere:
    • Cambie al directorio raíz_perfil/samples/lib/PlantsByWebSphere.
    • Localice el archivo PlantsByWebSphere.ear.
    • Escriba el siguiente mandato:

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node',
      '<nodo>', '-server', '<servidor>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node',
      '<nodo>', '-server', '<servidor>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.

      En las plataformas z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node',
      '<nodo>', '-server', '<servidor>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      En plataformas iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node',
      '<nodo>', '-server', '<servidor>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      donde <nodo> es el nombre del nodo y <servidor> es el nombre del servidor donde se va a instalar el ejemplo.
  4. Inicie el servidor de aplicaciones.

 

Ahora se desplegará en el servidor de aplicaciones el archivo PlantsByWebsphere.ear que se ha vuelto a crear.