Instalación de Contribute Publishing Server con la opción de Instalación de archivo WAR

Generación del archivo WAR mediante un instalador

El primer paso en la Instalación de archivo WAR para CPS consiste en utilizar un instalador para generar un archivo WAR y los archivos de datos asociados en una estructura de directorios. El instalador también configura los archivos WAR para que hagan referencia a los archivos de datos instalados.

Para utilizar el instalador de CPS para generar un archivo WAR (Windows):

1. Descargue el instalador.

2. Haga doble clic en el archivo para iniciar el instalador.

3. Lea y acepte el contrato de licencia para continuar con la instalación.

4. En la ventana Método de instalación, seleccione la opción de instalación de archivo WAR.

5. Acepte la ubicación de instalación predeterminada o haga clic en Elegir para seleccionar otra ubicación.

   La ubicación predeterminada es: C:/Archivos de programa/Macromedia/Contribute Publishing Server

6. Cuando se le pregunte, introduzca una contraseña administrativa para restringir el acceso a la consola de CPS.

   Esta contraseña no es la misma que se utiliza para proteger el rol de administrador de Contribute, por lo que es recomendable anotarla.

7. Tras revisar la pantalla Resumen, haga clic en Cerrar.

   El instalador crea una estructura de directorios que incluye un archivo WAR y los archivos de datos asociados.

8. Ya está preparado para desplegar el archivo WAR.

   Para obtener más información, consulte Despliegue del archivo WAR..

Para utilizar el instalador de CPS para generar un archivo WAR (Unix):

1. Descargue el archivo de instalación.

2. En el indicador de comando, introduzca el siguiente comando para establecer permisos de ejecución para el script de shell de instalación de JRun:

   chmod +x pubserver-linux.bin

   Nota: Si va a instalar en la plataforma Solaris, escriba solaris en lugar de linux en el comando.

3. Introduzca el siguiente comando para ejecutar el script de instalación de JRun:

   sh ./pubserver-linux.bin

   Nota: Si va a instalar en la plataforma Solaris, escriba solaris en lugar de linux en el comando.

   El instalador extrae los archivos de instalación y después ejecuta el script de instalación.

4. Lea las pantallas del contrato de licencia y acepte el contrato para continuar con la instalación.

5. En la pantalla Método de instalación, seleccione la opción de instalación de archivo WAR.

6. En la pantalla Carpeta de instalación, acepte la ubicación de instalación predeterminada o introduzca una ubicación distinta.

7. En la pantalla Contraseña de administrador, introduzca una contraseña administrativa para restringir el acceso a la consola de CPS.

   Esta contraseña no es la misma que se utiliza para proteger el rol de administrador de Contribute, por lo que es recomendable anotarla.

8. Revise la pantalla Resumen y presione Intro cuando esté preparado para iniciar la instalación.

   El instalador crea una estructura de directorios que incluye un archivo WAR y los archivos de datos asociados.

9. Ya está preparado para desplegar el archivo WAR.

   Para obtener más información, consulte Despliegue del archivo WAR..

Despliegue del archivo WAR.

Una vez generado el archivo WAR, puede desplegarlo en el servidor de aplicaciones J2EE.

La aplicación CPS debe ejecutarse desde una estructura de directorios expandida. La manera de desplegar el archivo WAR y de crear la estructura de directorios expandida varía en función del servidor de aplicaciones J2EE. Normalmente se utilizan dos métodos:

1. Desplegar el archivo WAR comprimido en un directorio de trabajo.

   En algunos servidores de aplicaciones J2EE (como IBM WebSphere), el proceso de despliegue expande el archivo WAR en un directorio de trabajo a partir del cual el directorio expandido se considera la aplicación. En estos servidores de aplicaciones, se despliega el archivo WAR comprimido y el trabajo en la estructura de directorio resultante.

2. Expanda el archivo WAR y despliegue la estructura expandida como directorio de trabajo.

   En otros servidores de aplicaciones (como JRun 4, BEA WebLogic y JBoss), se expande manualmente el archivo WAR y, a continuación, se despliega la estructura de directorio expandida, que se convierte en el directorio de trabajo.

   Nota: La razón por la que debe expandir el archivo WAR y después desplegar la estructura expandida en un directorio de trabajo en determinados servidores de aplicaciones Java es que hay que evitar que el servidor extraiga el archivo WAR comprimido en un directorio temporal cada vez que se inicia el servidor. Si esto sucediera, los datos de aplicación almacenados en el archivo ckm.xml se sobrescriben cada vez que el servidor extraiga el archivo WAR comprimido en un directorio temporal.

   El método de despliegue que utilice dependerá del servidor de aplicaciones.

   Para obtener más información sobre cómo desplegar un archivo WAR, consulte la documentación del servidor de aplicaciones Java.

   El procedimiento siguiente ilustra el despliegue de CPS en un servidor JRun 4.

   Nota: En el siguiente procedimiento se supone que hay una versión de JRun 4 previamente instalada.

Para desplegar el archivo WAR en un servidor JRun 4:

1. Expanda manualmente el archivo pubserver.war en la carpeta de instalación.

    En el indicador de comando, cambie a la carpeta de instalación de CPS.

2. Cree el directorio de trabajo con el siguiente comando:

   mkdir pubserver-war (UNIX)

   o

   md pubserver-war (Windows)

   1. Cambie al directorio de trabajo con el siguiente comando:

      cd pubserver-war 

   2. Expanda el archivo WAR en el directorio de trabajo con el siguiente comando:

      java_home/bin/jar -xvf ../pubserver.war 

      donde java_home es el directorio raíz del entorno de tiempo de ejecución de Java (JRE).

3. Si el servidor JRun no está ejecutándose, inícielo.

4. Abra un navegador Web e introduzca el URL de la consola de administración de JRun.

   Si utiliza la ubicación de instalación predeterminada, el URL es: http://localhost:8000.

   Se mostrará en el navegador Web la consola de administración de JRun.

5. Introduzca el nombre de usuario y la contraseña del administrador de JRun.

6. Expanda el icono Default server en el panel de la izquierda y después haga clic en el icono J2EE Components.

7. Haga clic en Add en el panel Web Applications.

8. Para ir al directorio de trabajo que creó (pubserver-war), haga clic en Browse o introduzca la ruta en el campo de texto Source File Path.

   Ver gráfico a tamaño completo

   
   

9. Haga clic en Deploy.

   Se desplegará el directorio de trabajo en JRun y se mostrará la pantalla de resumen de componentes J2EE.

   Nota: En la sección General Settings, compruebe que el valor de Context Path está establecido en /contribute.
   

   
   

10. Haga clic en Logging en el panel de la izquierda.

    Aparecerá el visor del registro Revise el registro para asegurarse de que el servidor se inició correctamente.

11. Si no utilizó un instalador para generar el archivo WAR y configurar las ubicaciones de archivos de CPS, consulte Configuración de las ubicaciones de archivos de CPS; si utilizó un instalador, puede omitir este paso, a menos que haya cambiado la ubicación de almacenamiento de los datos de CPS.

12. Ya está preparado para conectarse a la consola de CPS y configurar CPS.

    Para obtener más información, consulte Configuración de Contribute Publishing Server (sólo CPS).

Despliegue de CPS en servidores de aplicaciones JBoss (Macintosh)

JBoss es un servidor de aplicaciones Java de código abierto que se suele desplegar en servidores de Macintosh OS X. Adobe recomienda expandir manualmente el archivo pubserver.war de la carpeta de instalación y copiar el archivo WAR expandido a la carpeta: <JBoss_home>/server/default/deploy.

Para desplegar CPS en el servidor de aplicaciones JBoss:

1. Detenga el servidor de aplicaciones JBoss abriendo una ventana de terminal y ejecute el script shutdown.sh.

   % <JBoss_home>/server/bin/shutdown.sh 

2. Expanda manualmente el archivo pubserver.war y copie el archivo WAR expandido a la carpeta <JBoss_home>/server/default/deploy.

3. Cree una carpeta denominada "database".

   Es aquí donde almacenará la información de usuario y conexión.

4. Cree el archivo database.xml en la carpeta database. Si utiliza un directorio de usuarios basado en archivo, asegúrese de que el archivo user_directory.xml también está en la carpeta database. De manera predeterminada, el contenido del archivo user_directory.xml será similar al siguiente:

   <?xml version="1.0" encoding="UTF-8"?> 
   <directory> 
   </directory>

5. En el indicador de comando, cambie a la carpeta WEB-INF/config en el directorio de trabajo de CPS.

6. Abra el archivo ckm.xml en un editor de texto.

   Nota: Puede cambiar la ubicación de la carpeta database y los archivos de registro de errores en función de sus necesidades de despliegue.

7. Cambie la ruta a <home_directory> para indicar la carpeta que creó en el paso 3 como carpeta para almacenar la información de usuario y de conexión.

   El ejemplo siguiente cambia la ruta de la carpeta database a: < Macintosh HD>/Contribute Publishing Server/database.

   Nota: Si ya añadió la información de usuario y conexión en CPS, mueva esa información desde la ubicación actual a la nueva ubicación establecida.

   Por ejemplo:

   <plugin_fileDatabase> 
   <home_directory><Macintosh HD>/Contribute Publishing Server/database 
   </home_directory> 
   </plugin_fileDatabase>

8. Cambie la ruta a <logger_settings> para indicar dónde desea almacenar los registros de errores y salida de CPS.

   Por ejemplo:

   <out> 
       <file><Macintosh HD>/Contribute Publishing Server/logs/out.log</file> 
   </out> 
   <err> 
       <file><Macintosh HD>/Contribute Publishing Server/err.log</file> 
   </err> 

9. Guarde y cierre ckm.xml, y después reinicie el servidor de aplicaciones JBoss.

   Para reiniciar JBoss, ejecute el script run.sh en una ventana de terminal.

   % <JBoss_home>/server/bin/run.sh 

10. Ya está preparado para conectarse a la consola de CPS y configurar CPS.

    Con un navegador Web, vaya al siguiente URL: https://<server>/8080/cps/<context_root>/admin.

    Reemplace las variables <server> y <context_root> por el nombre de dominio (o la dirección IP) del servidor y el nombre de la raíz del contexto CPS (el nombre del archivo WAR).

    Para obtener más información, consulte Configuración de Contribute Publishing Server (sólo CPS).

Configuración de las ubicaciones de archivos de CPS

CPS almacena información de usuario y de conexión junto con los registros en el sistema de archivos local, e indica dónde se almacenan dichos archivos.

Para configurar el archivo WAR:

1. En el indicador de comando, cambie a la carpeta WEB-INF\config en el directorio de trabajo de CPS.

2. Abra el archivo ckm.xml en un editor de texto.

3. Cambie la ruta a <home_directory> para indicar dónde desea almacenar la información de usuario y de conexión.

   Nota: Si ya añadió la información de usuario y conexión en CPS, mueva esa información desde la ubicación actual a la nueva ubicación establecida.

4. Cambie la ruta a <logger_settings> para indicar dónde desea almacenar los registros de errores y salida de CPS.

   Por ejemplo:

   <out> 
       <file>C:\Contribute Publishing Server\logs\out.log</file> 
   </out> 
   <err> 
       <file>C:\Contribute Publishing Server\err.log</file> 
   </err> 

5. Guarde y cierre ckm.xml, y después reinicie el servidor de aplicaciones JBoss.

6. Ya está preparado para conectarse a la consola de CPS y configurar CPS.

   Para obtener más información, consulte Configuración de Contribute Publishing Server (sólo CPS).