Sun Java logo     Anterior      Contenido      Índice      Siguiente     

Sun logo
de actualización de Sun Java Enterprise System 5 para UNIX 

Capítulo15
Portal Server

En este capítulo se describe cómo actualizar Portal Server a Java ES 5 (Versión 5): Sun Java System Portal Server 7.1.

Este capítulo proporciona una visión general de las consideraciones que hay que tener en cuenta para la actualización de las diferentes rutas de actualización admitidas por la Versión 5. Se tratan las actualizaciones tanto en el sistema operativo Solaris como en Linux.


Visión general de la actualización de Portal Server

En esta sección se describen los siguientes aspectos generales de Portal Server que afectan a la actualización a Java ES 5 (Versión 5):

Acerca de Portal Server de Java ES Versión 5

El componente Portal Server de Java ES Versión 5 representa un avance importante en relación con la Versión 4, ya que incluye una serie de nuevas mejoras y funciones. Gran parte de estos cambios se realizaron en una Versión intermedia (IFR, Interim Feature Release) posterior a la Versión 4. La Versión 5 sólo presenta ligeros cambios en las funciones en relación con la versión IFR. Para obtener información sobre las mejoras y las nuevas funciones de la versión IFR, consulte Sun Java System Portal Server 7.1 Release Notes, http://docs.sun.com/doc/819-4986/6n4l3f365?a=view. En concreto, se ha sustituido la interfaz administrativa de línea de comandos de la Versión 4 por el comando psadmin.

Guía de actualización de Portal Server

La Tabla 15-2 muestra las rutas de actualización compatibles de Portal Server para Java ES Versión 5. Esta tabla hace referencia tanto al sistema operativo Solaris como a Linux.

Tabla 15-2  Rutas de actualización a Java ES 5 (Versión 5): Portal Server 7.1  

Versión de Java ES

Portal Server Versión

Enfoque general

Reconfiguración necesaria

Versión intermedia (IFR)

Sun Java System Portal Server IFR 7.0 2005Q4

Actualización directa:
Se realiza mediante la aplicación de revisiones y, a continuación, el uso de una secuencia de comandos de actualización.

Las personalizaciones deben aplicarse de nuevo manualmente.

Versión 4

Sun Java System Portal Server 6.3.1 2005Q4

Actualización directa:
Se realiza mediante una secuencia de comandos de actualización.

Las personalizaciones deben aplicarse de nuevo manualmente.

Versión 3

Sun Java System Portal Server 6.3.1 2005Q1

Actualización directa:
Se realiza mediante una secuencia de comandos de actualización.

Las personalizaciones deben aplicarse de nuevo manualmente.

Versión 2

Sun Java System Portal Server
6.3 2004Q2

Actualización directa:
Se realiza mediante una secuencia de comandos de actualización.

Las personalizaciones deben aplicarse de nuevo manualmente.

Versión 1

Sun ONE Portal Server 6.2 (2003Q4)

Sin actualización directa:
Aunque puede realizarse actualizando primero a la Versión 3 y, a continuación, de la Versión 3 a la Versión 5.

Datos de configuración

Versiones anteriores de Java ES

 

Sin actualización directa.

 

Datos de Portal Server

La siguiente tabla muestra el tipo de datos que puede verse afectado por una actualización del software de Portal Server.

Tabla 15-3  Portal Server Uso de datos 

Tipo de datos

Ubicación

Uso

Datos de configuración

PortalServer6Config-base/

Configuración de Portal Server.

Archivos de configuración y control de acceso al contenedor web

Web Server 7.0 (Java ES Versión 5)Archivos
server.policy y server.xml en
WebServer7Config-base/https-configName/config

Web Server 6.x (Java ES Versión 2, 3 y 4)Archivos
server.policy y server.xml en
WebServer6-base/https-hostname/config

Application Server 8.x (Java ES Versión 3, 4 y 5):Archivos
server.policy y domain.xml en
AppServer8Config-base/domains/domainName/config

Application Server 7.x (Java ES Versión 2):Archivos
server.policy y server.xml en
AppServer7Config-base/domains/domainName/config

Configuración de la instancia del contenedor web de Portal Server

Datos de personalización

PortalServer6Config-base/desktop

Archivos JAR para módulos personalizados

Escritorio de ejemplo personalizado de Portal Server

Esquema de directorio

Configuración de servicios

Datos de usuario

Directory Server

Portal Server depende de las configuraciones de los servicios, como Portal Desktop, y de los datos de perfil del usuario almacenados en un directorio.

Datos de aplicación dinámicos

Ninguna

Portal Server no almacena de forma persistente datos de aplicación como, por ejemplo, el estado de la sesión.

Estrategia de actualización para Portal Server

La estrategia utilizada para la actualización de Portal Server depende normalmente de las diferentes consideraciones descritas en el Chapter 1, "Planificación de las actualizaciones": ruta de actualización, dependencias entre los componentes de Java ES, actualización selectiva frente a actualización completa, implementaciones de varias instancias, etc.

En esta sección se particulariza la discusión general en torno a Portal Server presentando una serie de problemas que pueden influir en el plan de actualización de Portal Server.

Problemas de compatibilidad

La Versión 5 de Portal Server presenta cambios para la interfaz pública en el comando psadmin utilizado para administrar los componentes de Portal Server y Portal Server Secure Remote Access. Consulte Sun Java System Portal Server 7.1 Command-Line Reference, http://docs.sun.com/doc/819-5030.

Por lo tanto, la Versión 5 de Portal Server no es compatible con las versiones anteriores ni con las versiones anteriores de los componentes de Portal Server Secure Remote Access (incluidos la puerta de enlace de SRA, proxy Rewriter y proxy Netlet), excepto durante el periodo de transición en el que se realiza la actualización por turnos de las implementaciones de varias instancias. Todas las instancias de Portal Server deben sincronizarse, junto con las instancias de los componentes de Portal Server Secure Remote Access, en Java ES Versión 5.

Además, los componentes individuales de Portal Server, incluido el componente de acceso móvil, no son compatibles con las versiones anteriores; todos deben sincronizarse a Java ES Versión 5.

Además, existe una incompatibilidad entre las estructuras de datos de Directory Server utilizadas por la Versión 5 de Portal Server y las versiones anteriores de Portal Server . Esta incompatibilidad afecta a la actualización por turnos de varias instancias de Portal Server que utilicen los mismos datos de Directory Server.

Dependencias de Portal Server

Las dependencias de Portal Server con respecto a otros componentes de Java ES pueden afectar al procedimiento de actualización y reconfiguración del software de Portal Server. Por ejemplo, los cambios en las interfaces o las funciones de Portal Server pueden requerir las versiones actualizadas de los componentes de los que depende Portal Server. La actualización de dichos componentes será necesaria en función de la ruta de actualización específica.

Portal Server presenta relaciones de dependencia con los siguientes componentes de Java ES:

Problemas de la actualización selectiva

Aunque Java ES Versión 5 admite generalmente la actualización selectiva de todos los componentes en un equipo, el hecho de que Portal Server presente relaciones de dependencia con muchos otros componentes de Java ES dificulta en gran medida la posibilidad de certificar combinaciones arbitrarias de los componentes entre diversas versiones comerciales de Java ES.

Por este motivo, Portal Server admite un conjunto restringido de escenarios de actualización en relación con Access Manager y los contenedores web.

Escenarios de actualización del contenedor web

Portal Server puede implementarse en un contenedor web proporcionado por Web Server o Application Server. Por lo tanto, la actualización de Portal Server a la Versión 5 puede complicarse debido a la posibilidad de tener que actualizar también a la Versión 5 el contenedor web en el que se ha implementado. En este sentido, hay una serie de escenarios posibles de actualización del contenedor web, que se enumeran en la siguiente tabla.

Tabla 15-4  Escenarios de actualización del contenedor web para la actualización de Portal Server

Escenario

Contenedor web en el que se ha implementado originalmente Portal Server

Contenedor web en el que se ha implementado Portal Server después de la actualización

Rutas de actualización pertinentes de
Portal Server: actualización desde

Escenario 1

Web Server 6.x

Web Server 6.x

Versión 2
Versión 3
Versión 4
IFR 7.0

Escenario 2

Web Server 6.x

Web Server 7.0

Versión 2
Versión 3
Versión 4

Escenario 3

Application Server 8.1

Application Server 8.1

Versión 3
Versión 4
IFR 7.0

Escenario 4

Application Server 8.1

Application Server 8.2

Versión 3
Versión 4
IFR 7.0

Escenario 5

Application Server 7x

Application Server 8.2

Versión 2

Al realizar la actualización de Portal Server (por ejemplo, al utilizar la secuencia de comandos psupgrade), debe asegurarse de proporcionar los valores adecuados al escenario de actualización de la Tabla 15-4 que se aplique, sobre todo cuando se realice una actualización importante de la versión del contenedor web.

Actualización doble

Se pueden realizar actualizaciones dobles en las que se actualiza tanto Portal Server como el sistema operativo (como se describe en Actualizaciones dobles: Java ES y software del sistema operativo) utilizando el método de actualización de sistema operativo en vigor.

  1. Copia de seguridad de los datos existentes de Portal Server.
  2. Consulte la ubicación de los datos esenciales en Datos de Portal Server.

  3. Actualice el sistema operativo.
  4. La actualización deja el sistema de archivos existentes.

  5. Actualice Portal Server a la Versión 5.
  6. Consulte la sección adecuada de este capítulo, dependiendo de la ruta de actualización.


Actualización de Portal Server desde Java ES  Versión 4

En esta sección, se incluye información sobre la actualización de Portal Server desde Java ES 2005Q4 (Versión 4) a Java ES 5 (Versión 5).


Nota

Esta sección no aborda la siguiente situación especial: Portal Server se ha implementado un contenedor web Application Server y se ha actualizado de la Versión 2 a la Versión 3 o 4 antes de efectuar la actualización a la Versión 5. La ruta de actualización mencionada anteriormente no se permite en la actualidad.


En esta sección, se describen los siguientes temas:

Introducción

Al actualizar Java ES de la Versión 4 Portal Server a la Versión 5, tenga en cuenta los siguientes aspectos relacionados con el proceso de actualización:

Actualización de la Versión 4 de Portal Server

En esta sección se describe cómo realizar una actualización de Portal Server de Java ES Versión 4 a Java ES Versión 5 en las plataformas Solaris y Linux. Cuando un tema haga referencia a procedimientos específicos para una plataforma, se indicará el sistema operativo al que se aplica. En esta sección, se describen los siguientes temas:

Tareas previas a la actualización de la Versión 4

Antes de actualizar Portal Server, debe realizar las tareas siguientes:

Verifique la información sobre la versión actual

Para verificar la versión actual de Portal Server, utilice el siguiente comando:

Actualización de las dependencias de Portal Server

Por lo general, se recomienda actualizar todos los componentes de Java ES de un sistema informático (y de un entorno informático) a Java ES Versión 5.

Aunque la Versión 5 de Portal Server es compatible con la Versión 4 de los componentes compartidos de Java ES, es necesario actualizar estos componentes debido a que la secuencia de comandos psupgrade utilizada para actualizar Portal Server requiere la Versión 5 del componente compartido ANT.

Si decide actualizar alguna de las dependencias de los componentes de productos de Portal Server a la Versión 5, deberán actualizarse todas (consulte Problemas de la actualización selectiva). Las dependencias deben actualizarse en el orden siguiente (omitiendo aquéllas que es posible que ya se hayan actualizado) antes de actualizar Portal Server.

  1. Componentes compartidos.  Las instrucciones para sincronizar los componentes compartidos de Java ES en la Versión 5 están disponibles en Actualización de los componentes compartidos de Java ES.
  2. Directory Server.  Las instrucciones para actualizar Directory Server a la Versión 5 están disponibles en el Chapter 5, "Directory Server".
  3. Software del contenedor web.  Las instrucciones para actualizar Web Server o Application Server están disponibles en el Chapter 7, "Web Server" y el Chapter 11, "Application Server", respectivamente.

  4. Nota

    Al actualizar los contenedores web de terceros como, por ejemplo, los de Weblogic y WebSphere, puede interrumpirse Portal Server, ya que el proceso de actualización del contenedor sobrescribe las personalizaciones realizadas en estos contenedores para poder utilizar Portal Server.

    En ese caso, debe volver a instalar y configurar Portal Server para los entornos de contenedor web actualizados.


  5. Access Manager (Access Manager SDK).  Las instrucciones para actualizar Access Manager a la Versión 5 están disponibles en el Chapter 14, "Access Manager".
  6. Portal Server Secure Remote Access.  Las instrucciones para actualizar Portal Server Secure Remote Access a la Versión 5 están disponibles en el Chapter 16, "Portal Server Secure Remote Access".
  7. Java DB.  Las instrucciones para actualizar Java DB a la Versión 5 están disponibles en el Chapter 8, "Java DB".
  8. Service Registry.  Las instrucciones para actualizar Service Registry a la Versión 5 están disponibles en el Chapter 12, "Service Registry".
  9. Communications Express.   Las instrucciones para actualizar Communications Express a la Versión 5 están disponibles en la Sun Java Communications Suite Upgrade Guide, http://docs.sun.com/doc/819-7561.
Obtenga las contraseñas y la información de configuración necesarias

En función del escenario de actualización del contenedor web (consulte la Tabla 15-4), la secuencia de comandos psupgrade necesita que introduzca la información sobre las contraseñas y otros datos de configuración del contenedor web. La Tabla 15-6 muestra la información necesaria para los diferentes escenarios de actualización del contenedor web. Asegúrese de recopilar la información pertinente antes de comenzar el proceso de actualización de Portal Server.

Tabla 15-6  Información necesaria para la secuencia de comandos psupgrade según el escenario de actualización del contenedor web 

Información

Escenario de actualización1

Web Server 7.x valores de ejemplo:
Escenario 2

Application Server 8.x valores de ejemplo:
Escenario 52

Actualización de Portal Server en Web Server 7.0 (sí/no)

2

N/D

Directorio de instalación del contenedor web

2 y 5

WebServer7-base

AppServer8Install-base

Nombre de la instancia del servidor virtual del contenedor web

2

https-configName2

N/D

Nombre de la instancia del contenedor web

5

N/D

server1

Directorio de la instancia del contenedor web

2

WebServer7Config-base/
https-
configName4/

N/D

Directorio de implementación de la instancia de Portal Server

5

N/D

AppServer8Config-base/
domains/domainName

Puerto de la instancia del contenedor web

2 y 5

80

80

Protocolo de la instancia del contenedor web

2 y 5

http

http

Nombre de configuración del contenedor web

2

configName4

N/D

Nombre de dominio del contenedor web

5

N/D

domain1

Directorio raíz de documentos del contenedor web

2 y 5

WebServer7Config-base/
https-
configName4/docs/

AppServer8Config-base/
domains/domainName/
docroot

Nombre del host de administración del contenedor web

2 y 5

localhost

localhost

Puerto de administración del contenedor Web

2 y 5

8989

4848

Protocolo de administración del contenedor web

2 y 5

https

https

Id. de usuario de administración del contenedor web

2 y 5

admin

admin

Contraseña de administración del contenedor web

De 2 a 5

 

 

Contraseña maestra del contenedor web

De 3 a 5

N/D

 

Contraseña del administrador de directorios (cn=Directory manager)

De 1 a 5

 

 

Contraseña de usuario del registro de SRA3

De 1 a 5

 

 

Contraseña de administración de Access Manager

De 1 a 5

 

 

Contraseña de ldapuser de Directory Server

De 1 a 5

 

 

Id. de instancia de Portal Server4

De 1 a 5

 

 

1El escenario de actualización del contenedor web núm. 5 se aplica a la actualización de Portal Server desde la Versión 2.

2El valor predeterminado de configName es hostName.domainName.

3Esta información es necesaria para configurar los componentes de Portal Server Secure Remote Access cuando se instalan junto con Portal Server.

4Debe especificarse un valor exclusivo que no sea nulo para este parámetro. Los valores deben ser alfanuméricos y pueden incluir un guión (-).

Copia de seguridad de la información de configuración de la Versión 4 de Portal Server

Al actualizar Portal Server a la Versión 5, no es necesario reconfigurar el software de Portal Server. Sin embargo, como medida de protección, la secuencia de comandos psupgrade realiza una copia de seguridad de los directorios en los que se almacena la información de configuración:

Registre la configuración de la Máquina virtual de Java (JVM)

Antes de realizar la actualización de Portal Server, registre la siguiente configuración de JVM del contenedor web si es distinta de los valores predeterminados:

La ubicación de la configuración de JVM depende del contenedor web, como se indica en la siguiente tabla.

Tabla 15-7  Ubicación de la configuración de JVM

Contenedor web

Archivo de configuración

Versión 2, 3 y 4 de
Web Server (6.x)

WebServer6-base/https-instanceName/config/server.xml

Componente de producto de la
Web Server (7.0)

WebServer7Config-base/https-configName/config/server.xml

Versión 3, 4 y 5 de
Application Server (8.x)

AppServer8Config-base/domains/domainName/config/domain.xml

Instancia de Application Server
administrada por el agente del nodo

AppServer8Config-base/nodeagents/nodeagentName/config/
domain.xml

Deberá comprobar más adelante que no se haya modificado esta configuración de JVM como resultado del proceso de actualización de Portal Server.

Elimine la configuración del equilibrador de carga

En aquellos casos en los que se acceda a las instancias de Portal Server mediante un equilibrador de carga, el valor de la propiedad LOAD_BALANCER_URL que se utiliza para configurar ese acceso puede interferir en la actualización de Portal Server. Por lo tanto, debe modificarse esta configuración antes de realizar la actualización. Para modificar la configuración de la propiedad LOAD_BALANCER_URL:

  1. Debe distinguir cuáles de los siguientes archivos de configuración residen de forma local (algunos de los cuales admiten componentes de Portal Server Secure Remote Access que pueden instalarse localmente):
  2. PortalServer6Config-base/PSConfig.properties
    PortalServer6Config-base/GWConfig.properties  (si la puerta de enlace es local)
    PortalServer6Config-base/RWPConfig.properties  (si proxy Rewriter es local)
    PortalServer6Config-base/NLPConfig.properties  (si Netlet Proxy es local)

  3. Registre el valor actual de la propiedad LOAD_BALANCER_URL en estos archivos de configuración.
  4. Modifique el valor de la propiedad LOAD_BALANCER_URL para que señale a la instancia de Portal Server pertinente:
  5. LOAD_BALANCER_URL=portalHostName:port/portal

Elimine la configuración de Directory Proxy Server

En aquellos casos en los que las instancias de Portal Server accedan a Directory Server mediante una instancia de Directory Proxy Server, la configuración de host y número de puerto de Directory Proxy Server debe modificarse antes de realizar la actualización y, a continuación, restablecerse a sus valores originales una vez realizada la actualización.

Para modificar la configuración adecuada:

  1. Registre el valor actual de las propiedades DS_HOST y DS_PORT en el siguiente archivo de configuración de Access Manager:
  2. AccessManagerConfig-base/config/AMConfig.properties

  3. Modifique el valor de las propiedades DS_HOST y DS_PORT para que señalen directamente a la instancia de Directory Server pertinente.

Actualización de la Versión 4 de Portal Server (Solaris)

En esta sección se abordan diversas consideraciones que afectan al proceso de actualización de Portal Server, además de una descripción del propio procedimiento.

Consideraciones sobre la actualización (Solaris)

Al actualizar el software de Portal Server a la Versión 5, es preciso tener en cuenta las siguientes consideraciones:

Procedimiento de actualización (Solaris)

El procedimiento que se describe a continuación hace referencia a Portal Server en el equipo en el que se vaya a realizar la actualización.

  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Si aún no ha realizado esta tarea, sincronice todos los componentes compartidos a la Versión 5.
  4. Las instrucciones están disponibles en el Chapter 2, "Actualización de los componentes compartidos de Java ES".

    Este paso es un prerrequisito necesario para ejecutar la secuencia de comandos psupgrade, que se describe en el Step 8.

  5. Detenga todas las instancias de Portal Server Secure Remote Access Gateway, Rewriter Proxy o Netlet Proxy que podrían estar en ejecución de forma local.
  6. PortalServer6-base/bin gateway stop
    PortalServer6-base/bin netletd stop
    PortalServer6-base/bin rwproxyd stop

    Compruebe que se hayan detenido los procesos:

    Puerta de enlace: netstat -an | grep 443
    Proxy Rewriter: netstat -an | grep 10443
    Proxy Netlet: netstat -an | grep 10555

  7. Asegúrese de que se esté ejecutando Access Manager si se ha implementado en un contenedor web distinto del contenedor en el que se haya implementado Portal Server.
  8. Si aún no se está ejecutando, inicie el contenedor web en el que se haya implementado Portal Server para iniciar esta aplicación.
  9. Web Server 6.x:
    WebServer-base
    /https-instanceName/start

    Web Server 7.0:
    Admin Server--
    WebServer7Config-base/admin-server/bin/startserv
    Instance Server--
    WebServer7Config-base/https-configName/bin/startserv

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin start-domain --user admin_ID
         --password password domainName

  10. Establezca las dos variables de entorno (ANT_HOME y JAVA_HOME) necesarias para la secuencia de comandos psupgrade. Por ejemplo,
  11. export ANT_HOME=/usr/sfw
    export JAVA_HOME=/usr/jdk/entsys-j2se

  12. Asegúrese de que dispone del espacio de intercambio adecuado en el equipo.
  13. Normalmente, el espacio de intercambio suele establecerse en el doble de la cantidad de memoria RAM física.

  14. Ejecute la secuencia de comandos psupgrade desde la distribución de Java ES Versión 5.
  15. cd os_arch/Products/portal_svr/Tools/upgrade/bin
    ./psupgrade

    donde os_arch coincide con la plataforma como, por ejemplo, Solaris_sparc.


    Nota

    Si ejecuta accidentalmente psupgrade desde el directorio os_arch incorrecto, deberá anular el procedimiento de la siguiente forma:

      1. Acceda al directorio os_arch correcto.
      2. Invierta los cambios efectuados en los datos de Portal Server.
      3. ./psupgrade rollback

        Proporcione las contraseñas y los parámetros necesarios.

      4. Ejecute psupgrade una vez más.

    La secuencia de comandos psupgrade detecta los paquetes de traducción y los componentes de Portal Server instalados, llama al programa de instalación de Java ES para instalar los nuevos paquetes y realiza una consulta en el sistema para detectar la ubicación, el número de puerto y otros datos acerca del contenedor web en el que se vayan a implementar las aplicaciones web de Portal Server. En función del escenario de actualización del contenedor web (consulte la Tabla 15-4), la secuencia de comandos le solicitará que introduzca la información adicional necesaria para implementar Portal Server en el contenedor web adecuado.

    La Tabla 15-6 muestra la información solicitada para los diferentes escenarios de actualización del contenedor web, incluidos en la Tabla 15-4.


    Nota

    Asegúrese de introducir los valores correctos para los parámetros de psupgrade, ya que no se puede retroceder para cambiarlos y, además, es muy difícil deshacer los cambios efectuados por la secuencia de comandos psupgrade. Para invertir los cambios realizados en los datos de Portal Server, debe ejecutar

      ./psupgrade rollback

    antes de intentar ejecutar de nuevo psupgrade.


  16. Si es necesario, restablezca la configuración de JVM del contenedor web.
  17. Para asegurarse de que la configuración de JVM admita la Versión 5 de Portal Server, realice los siguientes pasos:

    1. Compruebe que la configuración de JVM del contenedor web para Portal Server que se ha registrado antes de realizar la actualización no se haya modificado como resultado del proceso de actualización.
    2. Consulte Registre la configuración de la Máquina virtual de Java (JVM).

    3. Si se ha modificado la configuración, restablézcala a los valores registrados antes de realizar la actualización.
    4. Asegúrese de que se incluya la siguiente configuración de JVM, aunque no se haya establecido anteriormente:

      <jvm-options>-XX:MaxPermSize=256m</jvm-options>
      <jvm-options>-XX:+CMSPermGenSweepingEnabled</jvm-options>
      <jvm-options>-XX:+CMSClassUnloadingEnabled</jvm-options>

  18. Detenga y reinicie el contenedor web.
  19. Aunque no sea necesario en determinadas situaciones, al reiniciar el contenedor web, se garantiza que Portal Server se inicie de forma limpia.

    1. Detenga el contenedor web de la siguiente forma:
    2. Web Server 6.x:
      WebServer-base
      /https-instanceName/stop

      Web Server 7.0:
      Admin Server--
      WebServer7Config-base/admin-server/bin/stopserv
      Instance Server--
      WebServer7Config-base/https-configName/bin/stopserv

      Application Server 8.x:
      AppServer8-base
      /bin/asadmin stop-domain --user admin_ID
           --password password domainName

    3. Reinicie el contenedor web mediante los comandos que aparecen en el Step 5.

Actualización de la Versión 4 de Portal Server (Linux)

En esta sección se abordan diversas consideraciones que afectan al proceso de actualización de Portal Server, además de una descripción del propio procedimiento.

Consideraciones sobre la actualización (Linux)

Al actualizar el software de Portal Server a la Versión 5, se deben tener en cuenta las mismas consideraciones que en la plataforma Solaris (consulte Consideraciones sobre la actualización (Solaris)), excepto que, en el sistema operativo Linux, la Versión 5 de Portal Server se instala en la misma ruta que la Versión 4. Por lo tanto, la secuencia de comandos psupgrade elimina todos los RPM anteriores al instalar los RPM de la Versión 5.

Procedimiento de actualización (Linux)

El procedimiento que se describe a continuación hace referencia a Portal Server en el equipo en el que se vaya a realizar la actualización.


Precaución

En Linux, la actualización de Java ES Versión 4 a la Versión 5 no se puede anular. Asegúrese de realizar una copia de seguridad del sistema antes de llevar a cabo el siguiente procedimiento.


  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Si aún no ha realizado esta tarea, sincronice todos los componentes compartidos a la Versión 5.
  4. Las instrucciones están disponibles en el Chapter 2, "Actualización de los componentes compartidos de Java ES".

    Este paso es un prerrequisito necesario para ejecutar la secuencia de comandos psupgrade, que se describe en el Step 8.

  5. Detenga todas las instancias de Portal Server Secure Remote Access Gateway, Rewriter Proxy o Netlet Proxy que podrían estar en ejecución de forma local.
  6. PortalServer6-base/bin gateway stop
    PortalServer6-base/bin netletd stop
    PortalServer6-base/bin rwproxyd stop

    Compruebe que se hayan detenido los procesos:

    Puerta de enlace: netstat -an | grep 443
    Proxy Rewriter: netstat -an | grep 10443
    Proxy Netlet: netstat -an | grep 10555

  7. Asegúrese de que se esté ejecutando Access Manager si se ha implementado en un contenedor web distinto del contenedor en el que se haya implementado Portal Server.
  8. Si aún no se está ejecutando, inicie el contenedor web en el que se haya implementado Portal Server para iniciar esta aplicación.
  9. Web Server 6.x:
    WebServer-base
    /https-instanceName/start

    Web Server 7.0:
    Admin Server--
    WebServer7Config-base/admin-server/bin/startserv
    Instance Server--
    WebServer7Config-base/https-configName/bin/startserv

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin start-domain --user admin_ID
         --password password domainName

  10. Establezca las dos variables de entorno (ANT_HOME y JAVA_HOME) necesarias para la secuencia de comandos psupgrade. Por ejemplo,
  11. export ANT_HOME=/opt/sun
    export JAVA_HOME=/usr/jdk/entsys-j2se

  12. Asegúrese de que dispone del espacio de intercambio adecuado en el equipo.
  13. Normalmente, el espacio de intercambio suele establecerse en el doble de la cantidad de memoria RAM física.

  14. Ejecute la secuencia de comandos psupgrade desde la distribución de Java ES Versión 5.
  15. cd os_arch/Products/portal_svr/Tools/upgrade/bin
    ./psupgrade

    donde os_arch coincide con su plataforma como, por ejemplo, Linux_x86.

    La secuencia de comandos psupgrade detecta los paquetes de traducción y los componentes de Portal Server instalados, llama al programa de instalación de Java ES para instalar los nuevos paquetes y realiza una consulta en el sistema para detectar la ubicación, el número de puerto y otros datos acerca del contenedor web en el que se vayan a implementar las aplicaciones web de Portal Server. En función del escenario de actualización del contenedor web (consulte la Tabla 15-4), la secuencia de comandos le solicitará que introduzca la información adicional necesaria para implementar Portal Server en el contenedor web adecuado.

    La Tabla 15-6 muestra la información solicitada para los diferentes escenarios de actualización del contenedor web, incluidos en la Tabla 15-4.


    Nota

    Asegúrese de introducir los valores correctos para los parámetros de psupgrade, ya que no se puede retroceder para cambiarlos y, además, es muy difícil deshacer los cambios efectuados por la secuencia de comandos psupgrade. Aviso: realice una copia de seguridad del sistema antes de ejecutar la secuencia de comandos psupgrade.


  16. Modifique el archivo de configuración PortalServer7Config-base/platform.conf.default.
  17. Copie la línea en la que aparece gateway.logging.password del siguiente archivo, del que psupgrade realizó una copia de seguridad:

    PortalServer6Config-base.bak/platform.conf.default

    y coloque la línea en PortalServer7Config-base/platform.conf.default.

  18. Si es necesario, restablezca la configuración de JVM del contenedor web.
  19. Para asegurarse de que la configuración de JVM admita la Versión 5 de Portal Server, realice los siguientes pasos:

    1. Compruebe que la configuración de JVM del contenedor web para Portal Server que se ha registrado antes de realizar la actualización no se haya modificado como resultado del proceso de actualización.
    2. Consulte Registre la configuración de la Máquina virtual de Java (JVM).

    3. Si se ha modificado la configuración, restablézcala a los valores registrados antes de realizar la actualización.
    4. Asegúrese de que se incluya la siguiente configuración de JVM, aunque no se haya establecido anteriormente:

      <jvm-options>-XX:MaxPermSize=256m</jvm-options>
      <jvm-options>-XX:+CMSPermGenSweepingEnabled</jvm-options>
      <jvm-options>-XX:+CMSClassUnloadingEnabled</jvm-options>

  20. Detenga y reinicie el contenedor web.
  21. Aunque no sea necesario en determinadas situaciones, al reiniciar el contenedor web, se garantiza que Portal Server se inicie de forma limpia.

    1. Detenga el contenedor web de la siguiente forma:
    2. Web Server 6.x:
      WebServer-base
      /https-instanceName/stop

      Web Server 7.0:
      Admin Server--
      WebServer7Config-base/admin-server/bin/stopserv
      Instance Server--
      WebServer7Config-base/https-configName/bin/stopserv

      Application Server 8.x:
      AppServer8-base
      /bin/asadmin stop-domain --user admin_ID
           --password password domainName

    3. Reinicie el contenedor web mediante los comandos que aparecen en el Step 5.

Verificación de la actualización

Puede verificar la instalación de los paquetes de la Versión 5 mediante el siguiente comando:

Consulte la Tabla 15-5 para obtener los valores de salida.

Para verificar la actualización completa, asegúrese que aparezca Portal Desktop y que la utilidad de administración psadmin funcione como se describe en el documento.

También puede comprobar los siguientes archivos de registro de la actualización:

Tareas posteriores a la actualización de la Versión 4

Tenga en cuenta los procedimientos posteriores a la actualización necesarios para abordar las siguientes situaciones:

Migre los datos personalizados de web-src

Si ha agregado datos personalizados como, por ejemplo, imágenes, archivos de javascript u otros archivos para crear portal.war en el siguiente directorio:

PortalServer6-base/web-src

debe copiar estos archivos adicionales en el directorio correspondiente de la Versión 5 de Portal Server:

PortalServer7-base/web-src

Vuelva a implementar las aplicaciones de portlet personalizadas

Si ha creado e implementado aplicaciones de portlet personalizadas, estos portlets deben implementarse de nuevo manualmente una vez completada la actualización a la Versión 5 de Portal Server. Aunque existirán entradas del perfil de visualización y se mostrará el nombre del canal, no podrá ver el contenido hasta que vuelva a implementar los portlets personalizados.

Vuelva a implementar los portlets con el siguiente comando:

PortalServer7-base/bin/psadmin deploy-portlet

Puede confirmar la nueva implementación buscando el archivo .war y los archivos XML correspondientes en la siguiente ubicación:

PortalServer7Data-base/portals/Upgraded/war

Migre las aplicaciones de portlet personalizadas

Las aplicaciones de portlet personalizadas basadas en la infraestructura de interfaz de usuario proporcionada por Sun Java Web Console (SJWC) deben migrarse manualmente a la Versión 5 e implementarse de nuevo.

En concreto, este requisito se aplica a las cuatro aplicaciones web distribuidas con Portal Server como aplicaciones de portlet de ejemplo destinadas a personalizarse e instalarse en un portal: filesharing, surveys, wiki, rssportlet. Durante la actualización, las versiones de estas aplicaciones de portlet de ejemplo cuyos errores se han solucionado se ubican en el área de aplicaciones de portlet del disco. Si ha personalizado estas aplicaciones de portlet para su propio uso, deberá migrarlas manualmente a la Versión 5 e implementarlas de nuevo, ya que el proceso de actualización de Portal Server no las administra.

Algunas de estas aplicaciones de ejemplo (filesharing y surveys) se implementan de forma predeterminada y están disponibles para los usuarios al crearse una comunidad.

Puede actualizar, personalizar y volver a implementar las aplicaciones de portlet basadas en SJWC mediante el siguiente procedimiento. La aplicación de portlet filesharing se utiliza como ejemplo:

  1. Extraiga los archivos jar de la Versión 5 de SJWC.
    1. mkdir /tmp/lh
    2. cd /tmp/lh
    3. /usr/jdk/entsys-j2se/bin/jar xvf    PortalServer7-base/portlet/communityportlets.war
         WEB-INF/lib/commons-beanutils.jar
         WEB-INF/lib/commons-collections-3.1.jar
         WEB-INF/lib/commons-digester.jar
         WEB-INF/lib/commons-logging.jar
         WEB-INF/lib/dataprovider.jar WEB-INF/lib/jsf-api.jar
         WEB-INF/lib/jsf-impl.jar WEB-INF/lib/webui.jar
    4. Cambie el nombre de uno de los archivos.
    5. mv WEB-INF/lib/commons-collections-3.1.jar
      WEB-INF/lib/commons-collections.jar

  2. Encuentre la aplicación de portlet filesharing.
  3. cd PortalServer7Config-base/portals/portal1/portletapps/filesharing

  4. Incluya las bibliotecas de SJWC actualizadas.
  5. jar uvf src/filesharing.war.tokenized -C /tmp/lh WEB-INF

  6. Personalice la aplicación de portlet filesharing.
  7. ant customize

  8. Vuelva a implementar la aplicación de portlet filesharing.
    1. PortalServer7-base/bin/psadmin undeploy-portlet -u amadmin
      -f passwordfile -p
      portal_id -i instance_id -g filesharing
    2. ant deploy
    3. Acceda al siguiente directorio (en función del contenedor web):
    4. Application Server 8.x:

      AppServer8Config-base/domains/domain1/applications/j2ee-modules/
      communityportlets/WEB-INF

      Web Server 6.x:

      WebServer6-base/https-instanceName/webapps/https-instanceName/
      communityportlets/WEB-INF

      Web Server 7.x:

      WebServer7Config-base/https-configName/web-app/https-configName/
      communityportlets/WEB-INF

    5. Abra el archivo sun-web.xml y agregue la siguiente línea justo antes de la última línea (es decir, delante de la etiqueta final sun-web-app):
    6. <class-loader delegate="false"/>

    7. Repita el Step c y el Step d para el archivo sun-web.xml ubicado en filesharing/WEB-INF.
  9. Repita del Step 2 al Step 5 para la aplicación surveys y las demás aplicaciones de portlet personalizadas basadas en la estructura de SJWC.
  10. Reinicie el contenedor web.
Corregir vínculos en marcador y canales de aplicación

Al actualizar la Versión 4 de Portal Server a la Versión 5, el marcador y los canales de aplicación tienen vínculos duplicados. Para solucionar estos vínculos, lleve a cabo el siguiente procedimiento.

  1. Inicie una sesión en PSConsole.
  2. En la ficha Tareas comunes, haga clic en Gestionar canales y contenedores.
  3. Seleccione DeveloperSample [Org] como DN y haga clic en Aceptar.
  4. Seleccione JSPTabContainer [predeterminado] como tipo de vista.
  5. En MyFrontPageTabPanelContainer, haga clic en Canal de aplicación.
  6. Aparecerán las propiedades del canal de aplicación en el lateral derecho.

    Para ver las propiedades de una configuración local específica, haga clic en Preferencias de tabla y proporcione el valor de la configuración local: de, fr, es, ja, ko, zh, zh_CN, zh_TW.

  7. Edite la propiedad userApps.
    1. En la propiedad userApps haga clic en el vínculo [Editar valores...]
    2. Aparecerá una ventana emergente con las aplicaciones existentes.

    3. Elimine de la lista las aplicaciones siguientes.
    4. NetMail Lite
      NetMail

    5. Agregue a la lista la aplicación siguiente:
    6. NetFile

    7. Haga clic en Guardar y, a continuación, en Cerrar.
  8. Edite la propiedad de destino.
    1. En la propiedad de destino haga clic en el vínculo [Editar valores...]
    2. Aparecerá una ventana emergente con los destinos existentes.

    3. Elimine de la lista los destinos siguientes:
    4. NetMailLite|
      NetMailServlet?nsid=newHTMLSessionNetMailLite|
      NetMailServlet?nsid=newHTMLSession

      NetMail|NetMailServlet?nsid=newAppletSession

    5. Elimine el duplicado de los siguientes destinos:
    6. Instant Messenger (Java WebStart)|
      IMLaunch?provider=IMChannel&launch=jnlp&last=false

      Instant Messenger (Navegador)|
      IMLaunch?provider=IMChannel&launch=plugin&last=false

    1. Agregue a la lista el destino siguiente:

      NetFile|/portal/NetFileApplet?Refer=java2

    1. Haga clic en Guardar y, a continuación, en Cerrar.
Corrija el acceso al servidor de búsqueda

Al actualizar la Versión 4 de Portal Server a la Versión 5, el servidor de búsqueda se separa de Portal Server y, por lo tanto, se cambia la URL de acceso al servidor de búsqueda.

Por lo tanto, debe modificar manualmente los perfiles de visualización de todos los canales del portal que implementen las interfaces "SearchProvider" o "DiscussionProvider" como por ejemplo, "Search", "DiscussionLite", "Discussions" y el canal de Instant Messaging. En concreto, debe modificar la propiedad searchServer de estos canales en cualquier nivel de rol u organizativo en los que aparezca dentro del perfil de visualización para que haga referencia correctamente al servidor de búsqueda. Modifique el valor de searchServer de la siguiente forma:

Además, para el canal de Instant Messaging, debe actualizarse la propiedad de configuración del servidor de Instant Messaging, iim_arch.portal.search, con la nueva URL del servidor de búsqueda.

Restablezca la configuración de Directory Proxy Server

Si las instancias de Portal Server han accedido a Directory Server mediante una instancia de Directory Proxy Server, debe restablecerse la configuración de host y número de puerto de Directory Proxy Server a los valores originales que presentaban antes de la actualización. Consulte la sección Elimine la configuración de Directory Proxy Server, en la que se modificaron los valores de estas propiedades como preparación para la actualización.

Registre manualmente los componentes de Portal Server Secure Remote Access

Si detecta que se ha incluido en la salida estándar una excepción de puntero nulo al final de proceso de actualización, esto quiere decir que el registro de los componentes de Portal Server Secure Remote Access (si hay alguno) ha fallado:

En ese caso, puede registrar (habilitar) manualmente los componentes de Portal Server Secure Remote Access ejecutando el siguiente comando:

PortalServer7-base/bin/psadmin provision-sra -u amadminUser -f passwordFile
    -p
Portal_ID --gateway-profile profileName --enable

Habilite el canal URLScrapper

Al actualizar de la Versión 4 a la Versión 5, debe habilitar el canal URLScrapper. Utilice el siguiente procedimiento:

  1. Inicie una sesión en la consola de Portal Server.
  2. Haga clic en la ficha Portal y, a continuación, en el portal actualizado.

  3. En el menú desplegable Seleccionar DN, seleccione Nivel superior (Global) y haga clic en el vínculo Descargar perfil de visualización.
  4. Almacene el archivo descargado en una ubicación temporal.

  5. Encuentre com.sun.portal.providers.urlscraper.URLScraperProvider.
  6. Encuentre la parte de XML que empieza por:
  7. <Provider advanced="false" class="com.sun.portal.providers.urlscraper.URLScraperProvider"

    y termina por:

    </Provider>

  8. Sustituya la parte de XML del Step 4 por lo siguiente:
  9. <Provider advanced="false" class="com.sun.portal.providers.urlscraper.URLScraperProvider" container="false" lock="false" merge="fuse" name="URLScraperProvider" version="2">

    <Properties advanced="false" lock="false" merge="fuse" name="_properties" propagate="true">

    <String advanced="false" lock="false" merge="replace" name="title" propagate="true" value="UrlScraper Channel"/>

    <String advanced="false" lock="false" merge="replace" name="description" propagate="true" value="This is a test for urlscraper"/>

    <Boolean advanced="true" lock="false" merge="replace" name="isEditable" propagate="true" value="false"/>

    <Boolean advanced="true" lock="false" merge="replace" name="isTopLevel" propagate="true" value="false"/>

    <String advanced="true" lock="false" merge="replace" name="editType" propagate="true" value="edit_subset"/>

    <Boolean advanced="true" lock="false" merge="replace" name="enableUBT" propagate="true" value="false"/>

    <String advanced="false" lock="false" merge="replace" name="urlScraperRulesetID" propagate="true" value="default_ruleset"/>

    <String advanced="false" lock="false" merge="replace" name="width" propagate="true" value="thick"/>

    <String advanced="true" lock="false" merge="replace" name="refreshTime" propagate="true" value="0"/>

    <String advanced="true" lock="false" merge="replace" name="helpURL" propagate="true" value="en/desktop/urlscrpr.htm"/>

    <String advanced="false" lock="false" merge="replace" name="url" propagate="true" value=""/>

    <String advanced="false" lock="false" merge="replace" name="fontFace1" propagate="true" value="Sans-serif"/>

    <String advanced="false" lock="false" merge="replace" name="productName" propagate="true" value="Sun JavaTM System Portal Server 7"/>

    <Boolean advanced="false" lock="false" merge="replace" name="cookiesToForwardAll" propagate="true" value="true"/>

    <String advanced="false" lock="false" merge="replace" name="inputEncoding" propagate="true" value="UTF-8"/>

    <Collection advanced="false" lock="false" merge="fuse" name="cookiesToForwardList" propagate="true"/>

    <Integer advanced="false" lock="false" merge="replace" name="timeout" propagate="true" value="100"/>

    <String advanced="true" lock="false" merge="replace" name="formData" propagate="true" value=""/>

    <Boolean advanced="true" lock="false" merge="replace" name="isHttpAuth" propagate="true" value="false"/>

    <String advanced="true" lock="false" merge="replace" name="loginUrl" propagate="true" value=""/>

    <String advanced="true" lock="false" merge="replace" name="loginFormData" propagate="true" value=""/>

    <String advanced="true" lock="false" merge="replace" name="uid" propagate="true" value=""/>

    <String advanced="true" lock="false" merge="replace" name="password" propagate="true" value=""/>

    <ConditionalProperties advanced="false" condition="client" lock="false" merge="fuse" propagate="true" value="HTML">

    <ConditionalProperties advanced="false" condition="locale" lock="false" merge="fuse" propagate="true" value="en">

    <String advanced="true" lock="false" merge="replace" name="helpURL" propagate="true" value="en/desktop/urlscrpr.htm"/>

    <String advanced="false" lock="false" merge="replace" name="url" propagate="true" value=""/>

    </ConditionalProperties>

    <String advanced="true" lock="false" merge="replace" name="helpURL" propagate="true" value="en/desktop/urlscrpr.htm"/>

    <String advanced="false" lock="false" merge="replace" name="url" propagate="true" value=""/>

    </ConditionalProperties>

    <ConditionalProperties advanced="false" condition="locale" lock="false" merge="fuse" propagate="true" value="en">

    <String advanced="false" lock="false" merge="replace" name="title" propagate="true" value="UrlScraper Channel"/>

    <String advanced="false" lock="false" merge="replace" name="description" propagate="true" value="This is a test for urlscraper"/>

    </ConditionalProperties>

    </Properties>

    </Provider>

  10. Guarde y cargue el archivo modificado.
Cambio en la página de cierre de sesión

La página de cierre de sesión de la Versión 5 de Portal Server presenta cambios en relación con la anterior página de cierre de sesión de Access Manager. Tenga en cuenta que estos cambios no representan un defecto del software.

Anulación de la actualización (Solaris)

En esta sección, se describen diversas consideraciones que afectan al procedimiento que permite deshacer la actualización de Portal Server, además de una descripción del propio procedimiento.

Consideraciones sobre la anulación de la actualización (Solaris)

El procedimiento para anular la actualización a la Versión 5 consiste en restablecer la instalación de la Versión 4 en PortalServer6-base y volver a implementar las aplicaciones web de la Versión 4.

Procedimiento de anulación de la actualización (Solaris)
  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Restablezca Directory Server al estado que presentaba antes de la actualización.
  4. Utilice las utilidades de la GUI y la línea de comandos de copia de seguridad/restablecimiento de Directory Server. Consulte el capítulo sobre copia de seguridad y restablecimiento de Directory Server, incluido en la Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide, http://docs.sun.com/doc/819-0995.

  5. Detenga Portal Server deteniendo su contenedor web.
  6. Web Server 6.x:
    WebServer-base
    /https-instanceName/stop

    Web Server 7.0:
    Admin Server--
    WebServer7Config-base/admin-server/bin/stopserv
    Instance Server--
    WebServer7Config-base/https-configName/bin/stopserv

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin stop-domain --user admin_ID
         --password password domainName

  7. Elimine los paquetes de la Versión 5 de Portal Server.
    1. Inicie el programa de desinstalación de Java ES.
    2. /var/sadm/prod/SUNWentsys5/uninstall

    3. Seleccione todos los componentes instalados de Portal Server.
    4. Confirme la opción de desinstalación que desee.
    5. Salga del programa de desinstalación de Java ES.
  8. Reinicie Portal Server reiniciando su contenedor web.
  9. Web Server 6.x:
    WebServer-base
    /https-instanceName/start

    Web Server 7.0:
    Admin Server--
    WebServer7Config-base/admin-server/bin/startserv
    Instance Server--
    WebServer7Config-base/https-configName/bin/startserv

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin start-domain --user admin_ID
         --password password domainName

  10. Vuelva a implementar las aplicaciones web de la Versión 4 de Portal Server mediante el siguiente comando de la distribución de Java ES Versión 5:
  11. cd os_arch/Products/portal_svr/Tools/upgrade/bin
    ./psupgrade rollback

    donde os_arch coincide con la plataforma como, por ejemplo, Solaris_sparc.

    El comando psupgrade rollback anula la implementación de las aplicaciones web de la Versión 5 de Portal Server y vuelve a implementar las aplicaciones web de la Versión 4 de Portal Server.

    El comando implementa de nuevo el contenido de PortalServer6-base/web-src en /var/PortalServe6-base/https-hostName/deploy-dir/web-apps. Por lo tanto, todas las personalizaciones realizadas en la aplicación web Portal Server deben efectuarse primero en /web-src e implementarse a continuación en /web-apps. Todos los cambios que haya realizado en /web-apps deben repetirse en /web-src antes de ejecutar el comando psupgrade rollback ; de lo contrario, se sobrescribirán dichos cambios.

  12. Detenga y reinicie el contenedor web.
  13. Aunque no sea necesario en determinadas situaciones, al reiniciar el contenedor web, se garantiza que Portal Server se inicie de forma limpia.

Anulación de la actualización (Linux)

Como, para actualizar a la Versión 5, es necesario eliminar los archivos binarios de la Versión 4, es muy difícil deshacer la actualización en Linux.

Un enfoque de anulación de la actualización consistiría en crear un sistema paralelo y probarlo antes de intentar realizar una actualización. Si necesita anular la actualización, puede restablecer este sistema paralelo.

Actualización de varias instancias

En algunas arquitecturas de implementación, Portal Server se implementa en varios sistemas informáticos para proporcionar escalabilidad y mejorar la disponibilidad. Por ejemplo, es posible que las instancias de Portal Server se ejecuten en varios equipos con un equilibrador que distribuya la carga.

Si utiliza instancias de Portal Server con equilibrado de carga, puede realizar una actualización por turnos en la que se actualicen las instancias de Portal Server secuencialmente sin necesidad de interrumpir el servicio, como se describe a continuación. Este procedimiento tiene en cuenta la siguiente limitación: La Versión 4 de Portal Server no funciona con los datos de directorios de la Versión 5 de Portal Server.

La arquitectura de implementación mostrada en la Figura 15-1 servirá para ilustrar el procedimiento de anulación de la actualización de las instancias de la Versión 4 de Portal Server a la Versión 5.


Nota

Para las arquitecturas que incluyan componentes de Portal Server Secure Remote Access, consulte Actualización de varias instancias.


En la arquitectura de la Figura 15-1, se accede a varias instancias de Portal Server mediante un equilibrador de carga para proporcionar disponibilidad y escalabilidad. Las instancias de Portal Server acceden, a su vez, a las instancias de Access Manager mediante un equilibrador de carga. Las instancias de Access Manager y Access Manager SDK acceden a un directorio configurado para la repetición de varias réplicas principales (MMR). Aunque se pueden utilizar otros esquemas de repetición de Directory Server, MMR es una función representativa de los servicios de directorios escalables y de alta disponibilidad.

En la Figura 15-1 se agrupan las diversas instancias de Portal Server, Access Manager y Directory Server para facilitar la explicación del proceso de actualización. Portal Server 2, representa, por ejemplo, de la segunda a un número "n" de instancias de Portal Server.

Figura 15-1  Ejemplo de arquitectura de implementación de varias instancias de Portal Server

Diagrama que muestra la arquitectura de implementación de ejemplo de varias instancias de Portal Server que acceden a varias instancias de Access Manager.

La actualización por turnos de la Versión 4 a la Versión 5 de Portal Server se realiza de la siguiente forma:

  1. Si va a realizar una actualización de la Versión 4 a la Versión 5 de Access Manager, realice una actualización por turnos, como se describe en Actualización de varias instancias. Tenga en cuenta que, al actualizar de la Versión 4 a la Versión 5 de Portal Server, no es necesario que actualice Access Manager de la Versión 4 a la Versión 5.
  2. Configure Portal Server 2 para que señale a Directory Server 2 en lugar de a Directory Server 1.
  3. Para mayor brevedad, al realizar los pasos posteriores “Portal Server 2” significará Portal Server 2 hasta Portal Server n.

  4. Actualice Portal Server 1.
    1. Deshabilite Portal Server 1 en el Equilibrador de carga B.
    2. Las solicitudes ya no se enrutarán a Portal Server 1.

    3. Deshabilite la función MMR de Directory Server.
    4. Directory Server 2 ya no se sincronizará con Directory Server 1.

    5. Actualice Access Manager SDK 1B a la Versión 5.
    6. Utilice el procedimiento descrito en Actualización sólo de Access Manager SDK de la Versión 4.

    7. Actualice Portal Server 1 a la Versión 5.
    8. Realice la actualización de la instancia de Portal Server, como se describe enActualización de la Versión 4 de Portal Server, teniendo en cuenta lo siguiente:

      • Tome nota de forma especial de la siguiente tarea previa a la actualización: Elimine la configuración del equilibrador de carga.
      • Antes de realizar la actualización, confirme que el valor de am.encryption.pwd del archivo AccessManagerConfig-base/config/AMConfig.properties es igual para la instancia local de Access Manager SDK que para la instancia remota asociada de Access Manager.
      • Asegúrese de proporcionar un valor exclusivo que no sea nulo para el parámetro Portal Instance ID solicitado por psupgrade para cada instancia de Portal Server que se va a actualizar.
      • Los datos de Portal Server para Directory Server 1 se actualizan a la Versión 5.

    9. Habilite Portal Server 1 en el Equilibrador de carga B.
    10. Las solicitudes se volverán a enrutar a Portal Server 1.

  5. Actualice Portal Server 2.
    1. Deshabilite Portal Server 2 en el Equilibrador de carga B.
    2. Las solicitudes ya no se enrutarán a Portal Server 2.

    3. Restablezca la configuración de Portal Server 2 para que señale a Directory Server 1.
    4. Actualice Access Manager SDK 2B a la Versión 5.
    5. Utilice el mismo procedimiento descrito en el Step c.

    6. Actualice Portal Server 2 a la Versión 5.
    7. Utilice el mismo procedimiento descrito en el Step d.

    8. Habilite Portal Server 2 en el Equilibrador de carga B.
    9. Las solicitudes se volverán a enrutar a Portal Server 2.

  6. Habilite la función MMR de Directory Server.
  7. Los datos de Portal Server para Directory Server 2 se sincronizarán ahora con Directory Server 1.


Actualización de Portal Server desde Java ES Versión 3

El procedimiento de actualización del componente Portal Server de Java ES 2005Q1 (Versión 3) a la Versión 5 es igual que el procedimiento de actualización de la Versión 4 de Portal Server a la Versión 5, con las siguientes excepciones:

Tarea previa a la actualización de la Versión 3: actualización de las dependencias de Portal Server

Al actualizar Portal Server desde la Versión 3, debe actualizar tanto Access Manager como el contenedor web (Web Server o Application Server) a la Versión 4 o 5 antes de actualizar Portal Server. Además, no puede dejar ninguna dependencia en la Versión 3 ni actualizar algunas dependencias a la Versión 4 y el resto a la Versión 5. Para obtener más información, consulte Problemas de la actualización selectiva.

Deben actualizarse las siguientes dependencias en el orden mostrado a continuación.

  1. Componentes compartidos.  Las instrucciones para actualizar los componentes compartidos de Java ES a la Versión 5 están disponibles en el Chapter 2, "Actualización de los componentes compartidos de Java ES".
  2. Directory Server.  Las instrucciones para actualizar Directory Server a la Versión 5 están disponibles en el Chapter 5, "Directory Server".
  3. Software del contenedor web.  Las instrucciones para actualizar Web Server o Application Server están disponibles en el Chapter 7, "Web Server" y el Chapter 11, "Application Server", respectivamente.

  4. Nota

    Al actualizar los contenedores web de terceros como, por ejemplo, los de Weblogic y WebSphere, puede interrumpirse Portal Server, ya que el proceso de actualización del contenedor sobrescribe las personalizaciones realizadas en estos contenedores para poder utilizar Portal Server.

    En ese caso, debe volver a instalar y configurar Portal Server para los entornos de contenedor web actualizados.


  5. Access Manager (Access Manager SDK).  Las instrucciones para actualizar Access Manager a la Versión 5 están disponibles en el Chapter 14, "Access Manager".

Actualización de la Versión 3 de Portal Server

Para actualizar Portal Server de la Versión 3 a la Versión 5, siga las instrucciones que aparecen en Actualización de Portal Server desde Java ES  Versión 4 y sustituya toda referencia a la Versión 4 por la Versión 3.

Tareas posteriores a la actualización de la Versión 3

Al actualizar Portal Server de la Versión 3 a la Versión 5, debe realizar, además de las procedimientos posteriores a la actualización descritos en Tareas posteriores a la actualización de la Versión 4, los procedimientos necesarios para abordar las siguientes situaciones:

Suscripción a un debate

La suscripción a un debate en una comunidad no se realizará satisfactoriamente a menos que edite las propiedades de nivel superior del perfil de visualización global para agregar la siguiente propiedad de cadena:

helpURL=en/desktop/usedesk.htm

Utilice el siguiente procedimiento:

  1. Cree un archivo "snippet" XML de perfil de visualización, helpUrl.xml:
  2. <?xml version="1.0" encoding="utf-8" ?>
      <!DOCTYPE DisplayProfile SYSTEM "jar://resources/psdp.dtd">
        <Propiedades>
          <String name="helpURL" value="en/desktop/usedesk.htm" />
        </Properties>

  3. Ejecute las propiedades del perfil de visualización global con el siguiente comando:
  4. ./psadmin modify-dp -u amadminUser -f /tmp/passwordFile -p portal_ID
        -m -g helpUrl.xml

    donde la opción -m es necesaria para no sobrescribir todo el perfil de visualización global.

Actualización de varias instancias

En algunas arquitecturas de implementación, Portal Server se implementa en varios sistemas informáticos para proporcionar escalabilidad y mejorar la disponibilidad. Por ejemplo, es posible que las instancias de Portal Server se ejecuten en varios equipos con un equilibrador que distribuya la carga.

Si utiliza instancias de Portal Server con equilibrado de carga, puede realizar una actualización por turnos en la que se actualicen las instancias de Portal Server secuencialmente sin necesidad de interrumpir el servicio, como se describe a continuación. Este procedimiento tiene en cuenta la siguiente limitación: La Versión 3 de Portal Server no funciona con los datos de directorios de la Versión 5 de Portal Server.

Para realizar una actualización por turnos de la Versión 3 a la Versión 5 de Portal Server, siga las instrucciones que aparecen en Actualización de varias instancias y sustituya toda referencia a la Versión 4 por la Versión 3. Además, debe actualizar también Access Manager, como se describe en el Step 1.


Actualización de Portal Server desde Java ES Versión 2

En esta sección se incluye información sobre la actualización del componente Portal Server de Java ES 2004Q2 (Versión 2) a la Versión 5. El proceso es similar al de la actualización de la Versión 4 a la Versión 5 de Portal Server, a excepción de algunos cambios que se describen en las siguientes secciones:

Tareas previas a la actualización de la Versión 2

Las tareas previas a la actualización de la Versión 2 de Portal Server son iguales a las descritas en Tareas previas a la actualización de la Versión 4, a excepción de la actualización de las dependencias de Portal Server.

Al actualizar Portal Server desde la Versión 2, debe actualizar tanto Access Manager como el contenedor web (Web Server o Application Server) a la Versión 4 o 5 antes de actualizar Portal Server. Además, no puede dejar ninguna dependencia en la Versión 2 ni actualizar algunas dependencias a la Versión 4 y el resto a la Versión 5. Para obtener más información, consulte Problemas de la actualización selectiva.

En concreto, el contenedor web debe actualizarse desde la Versión 2, lo que implica que sólo se admiten los escenarios 2 y 5 de la Tabla 15-4 al ejecutar la secuencia de comandos psupgrade.

Deben actualizarse las siguientes dependencias en el orden mostrado a continuación.

  1. Componentes compartidos.  Las instrucciones para actualizar los componentes compartidos de Java ES a la Versión 5 están disponibles en el Chapter 2, "Actualización de los componentes compartidos de Java ES".
  2. Directory Server.  Las instrucciones para actualizar Directory Server a la Versión 5 están disponibles en el Actualización de Directory Server desde Java ES Versión 2.
  3. Software del contenedor web.  Las instrucciones para actualizar Web Server o Application Server están disponibles en el Chapter 7, "Web Server" y el Chapter 11, "Application Server", respectivamente.

  4. Nota

    Al actualizar los contenedores web de terceros como, por ejemplo, los de Weblogic y WebSphere, puede interrumpirse Portal Server, ya que el proceso de actualización del contenedor sobrescribe las personalizaciones realizadas en estos contenedores para poder utilizar Portal Server. En ese caso, debe volver a instalar y configurar Portal Server para los entornos de contenedor web actualizados.


  5. Access Manager (Access Manager SDK).  Las instrucciones para actualizar Access Manager a la Versión 5 están disponibles en el Chapter 14, "Access Manager".

Actualización de la Versión 2 de Portal Server

El procedimiento de actualización de Portal Server de la Versión 2 a la Versión 5 depende del contenedor web en el que se implemente el software de Portal Server, como se describe en las siguientes secciones.

Actualización de la Versión 2 de Portal Server: contenedor web Web Server

Para actualizar Portal Server a la Versión 5, al implementarlo en el contenedor web Web Server, siga las instrucciones que aparecen en Actualización de Portal Server desde Java ES  Versión 4 y sustituya toda referencia a la Versión 4 por la Versión 2.

Sin embargo, si Portal Server se implementa en la Versión 5 de Web Server (Web Server 7.0), debe realizar los siguientes pasos antes de actualizar la Versión 2 de Web Server:

  1. Inicie una sesión en la consola de administración de Web Server.
  2. Haga clic en Editar servidores virtuales > Aplicaciones web.
  3. Elimine todas las aplicaciones web implementadas con un URI que incluya /portal o /portalsamples.
  4. Haga clic en Guardar.
  5. Haga clic en Implementación pendiente.

Actualización de la Versión 2 de Portal Server: contenedor web Application Server

Si se actualiza la Versión 2 de Portal Server a la Versión 5, al implementarlo en el contenedor web Application Server, se actualiza Application Server de la Versión 2 a la Versión 5.

La instancia de Application Server de la Versión 2 en la que se implementó originalmente Portal Server (instanceName) se migra a un agente del nodo creado por el proceso de actualización de Application Server a la Versión 5. Para actualizar Portal Server en esta instancia de Application Server actualizada, es necesario llevar a cabo los siguientes pasos:

  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Si aún no ha realizado esta tarea, sincronice todos los componentes compartidos a la Versión 5.
  4. Las instrucciones están disponibles en el Chapter 2, "Actualización de los componentes compartidos de Java ES".

    Este paso es un prerrequisito necesario para ejecutar la secuencia de comandos psupgrade, que se describe en el Step 9.

  5. Detenga todas las instancias de Portal Server Secure Remote Access Gateway, Rewriter Proxy o Netlet Proxy que podrían estar en ejecución de forma local.
  6. PortalServer6-base/bin gateway stop
    PortalServer6-base/bin netletd stop
    PortalServer6-base/bin rwproxyd stop

    Compruebe que se hayan detenido los procesos:

    Puerta de enlace: netstat -an | grep 443
    Proxy Rewriter: netstat -an | grep 10443
    Proxy Netlet: netstat -an | grep 10555

  7. Asegúrese de que se esté ejecutando Access Manager si se ha implementado en un contenedor web distinto del contenedor en el que se haya implementado Portal Server.
  8. Si aún no se está ejecutando, inicie el contenedor web en el que se haya implementado Portal Server para iniciar esta aplicación.
    1. Si aún no se ha iniciado, inicie Domain Administration Server (DAS).
    2. AppServer8-base/bin/asadmin start-domain --user admin_ID
           --password password domainName

    3. Inicie la instancia actualizada de Application Server en la que se haya implementado Portal Server (instanceName), si aún no se está ejecutando esa instancia del servidor.
    4. Para ello, inicie el agente del nodo en el que se ha migrado la instancia de Application Server actualizada:

      AppServer8-base/bin/asadmin start-node-agent --user admin_ID
           --password password nodeagentName

      En los comandos anteriores y en los pasos siguientes, se utilizan las siguientes convenciones:

    5. donde nodeagentName presenta el formatohostName_domainName, , pero es sólo de forma predeterminada hostName.
    6. La variable de nombre de dominio, domainName, predeterminada es domain1.
    7. La variable de nombre de instancia, instanceName , predeterminada es server1
  9. Anule la implementación de los componentes de Portal Server.
  10. AppServer8-base/bin/asadmin undeploy --user admin_ID
         --password password --target instanceName portal

    AppServer8-base/bin/asadmin undeploy --user admin_ID
         --password password --target instanceName portletsamples

  11. Establezca las dos variables de entorno (ANT_HOME y JAVA_HOME) necesarias para la secuencia de comandos psupgrade. Por ejemplo,
  12. SO Solaris:

    export ANT_HOME=/usr/sfw
    export JAVA_HOME=/usr/jdk/entsys-j2se

    SO Linux:

    export ANT_HOME=/opt/sun
    export JAVA_HOME=/usr/jdk/entsys-j2se

  13. Asegúrese de que dispone del espacio de intercambio adecuado en el equipo.
  14. Normalmente, el espacio de intercambio suele establecerse en el doble de la cantidad de memoria RAM física.

  15. Ejecute la secuencia de comandos psupgrade desde la distribución de Java ES Versión 5.
  16. cd os_arch/Products/portal_svr/Tools/upgrade/bin
    ./psupgrade

    donde os_arch coincide con la plataforma como, por ejemplo, Solaris_sparc.


    Nota

    Si ejecuta accidentalmente psupgrade desde el directorio os_arch incorrecto, deberá anular el procedimiento de la siguiente forma:

      1. Acceda al directorio os_arch correcto.
      2. Invierta los cambios efectuados en los datos de Portal Server.
      3. ./psupgrade rollback

        Proporcione las contraseñas y los parámetros necesarios.

      4. Ejecute psupgrade una vez más.

    La secuencia de comandos psupgrade llama al programa de instalación de Java ES para instalar los nuevos paquetes y realiza una consulta en el sistema para detectar la ubicación, el número de puerto y otros datos acerca del contenedor web en el que se vayan a implementar las aplicaciones web de Portal Server. En función del escenario de actualización del contenedor web (consulte la Tabla 15-4), en este caso, el escenario 5, la secuencia de comandos le solicitará que introduzca la información adicional necesaria para implementar Portal Server en el contenedor web adecuado.

    La Tabla 15-6 muestra la información solicitada al actualizar la Versión 2 de Application Server a la Versión 5 (escenario 5).


    Nota

    Asegúrese de introducir los valores correctos para los parámetros de psupgrade, ya que no se puede retroceder para cambiarlos y, además, es muy difícil deshacer los cambios efectuados por la secuencia de comandos psupgrade. Para invertir los cambios realizados en los datos de Portal Server, debe ejecutar

      ./psupgrade rollback

    antes de intentar ejecutar de nuevo psupgrade.


  17. Detenga la instancia de Domain Administration Server (DAS) y el agente del nodo que se iniciaron en el Step 5.
  18. AppServer8-base/bin/asadmin stop-domain --user admin_ID
         --password password domainName

    AppServer8-base/bin/asadmin stop-node-agent --user admin_ID
         --password password nodeagentName

  19. Reinicie la instancia de Domain Administration Server (DAS), el agente del nodo y la instancia del servidor que se detuvieron en el Step 10.

  20. Nota

    Asegúrese de iniciar de forma independiente el agente del nodo mediante la opción startinstances=false antes de iniciar la instancia del servidor, como se indica a continuación.


    AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password password domainName

    AppServer8-base/bin/asadmin start-node-agent --port DASportNumber      --startinstances=false --user admin_ID --password password nodeagentName

    AppServer8-base/bin/asadmin start-instance --port DASportNumber      --user admin_ID --password password  instanceName

    El valor predeterminado de DASportNumber es 4848.

Tareas posteriores a la actualización de la Versión 2

Al actualizar Portal Server de la Versión 2 a la Versión 5, debe realizar, además de las procedimientos posteriores a la actualización descritos en Tareas posteriores a la actualización de la Versión 4, los procedimientos necesarios para abordar las siguientes situaciones:

Configuración del inicio de sesión único

Después de actualizar Portal Server desde la Versión 2, fallarán los canales de comunicación de Portal Desktop como, por ejemplo, Correo, Calendario y Libreta de direcciones, que utilicen la metaplantilla "ssoadapter" para acceder al servidor de servicios de fondo.

Por ejemplo, si ha modificado la metaplantilla "ssoadapter" de correo de la Versión 2, SUN-UWC-MAIL, con una configuración específica para Messaging Server y, a continuación, ha realizado una actualización a la Versión 5, existirán dos metaplantillas "ssoadapter" de SUN-UWC-MAIL: una pertenece a la Versión 2, que no se ha modificado, y la otra pertenece a la Versión 5. Observará que hay metaplantillas "ssoadapter" duplicadas en la consola de Portal Server y en la interfaz de línea de comandos de psadmin, ambas con el mismo nombre.

Los canales que utilicen las metaplantillas "ssoadapter" no podrán establecer una conexión con el servidor de servicios de fondo para recuperar los datos.

Para solucionar este problema debe recuperar los datos de la metaplantillas "ssoadapter", cambiar el nombre de las entradas duplicadas y, a continuación, sustituir los datos modificados. Utilice el siguiente procedimiento:

  1. Exporte los datos de la metaplantillas "ssoadapter".
  2. Puede usar la utilidad amadmin para exportar los datos de servicios de Access Manager, como se indica a continuación:

    1. Cree un archivo de solicitud de amadmin, /tmp/ssoadapter-template-gets.xml.
    2. La utilidad usará este archivo para recuperar los datos de las metaplantillas "ssoadapter":

      <?xml version="1.0" encoding="ISO-8859-1"?>
      <!DOCTYPE Requests
        PUBLIC "-//iPlanet//iDSAME 5.0 Admin CLI DTD//EN"
        "jar://com/iplanet/am/admin/cli/amAdmin.dtd"
        >
        <Requests>
          <SchemaRequests serviceName="SunSSOAdapterService"     SchemaType="global">
            <GetServiceDefaultValues>
              <Attribute name="sunConfigurationTemplates" />
            </GetServiceDefaultValues>
          </SchemaRequests>
        </Requests>

    3. Ejecute el siguiente comando de asadmin:
    4. AccessManager-base/bin/amadmin -u amadminUser -w password
       -t ssoadapter-templates-get.xml > /tmp/ssoadapter-templates.xml

      La salida del comando se guarda en /tmp/ssoadapter-templates.xml.

      El archivo /tmp/ssoadapter-templates.xml presenta el siguiente formato:

      sunConfigurationTemplates=
      [<ssoadapter meta-template1>, <ssoadapter meta-template2>, ...]

      y cada metaplantilla <ssoadapter meta-template> presenta la siguiente sintaxis:

      default|imap:/?configName=SUN-UWC-MAIL
      &proxyAdminPassword=%5BPROXY-ADMIN_PASSWORD%5D&subType=sun-one
      &enableProxyAuth=false ...

  3. Modifique el archivo /tmp/ssoadapter-templates.xml para cambiar el nombre de las metaplantillas "ssoadapter" duplicadas.
    1. Busque cada una de las plantillas en el archivo /tmp/ssoadapter-templates.xml.
    2. Busque la cadena default|imap:/?configName= .

    3. Sustituya los nombres de las metaplantillas "ssoadapter" duplicadas por valores exclusivos.
    4. Por ejemplo, si hay dos metaplantillas "ssoadapter" SUN-UWC-MAIL, sustituya el valor de configName en una de ellas por SUN-UWC-MAIL2, lo que dará como resultado dos plantillas con nombres exclusivos:

      default|imap:/?configName=SUN-UWC-MAIL ...
      default|imap:/?configName=SUN-UWC-MAIL2 ...

  4. Cree un archivo de solicitud de amadmin que importará las metaplantillas "ssoadapter" modificadas, sobrescribiendo los datos originales.
    1. Copie /tmp/ssoadapter-templates.xml en /tmp/ssoadapter-new-templates.xml
    2. En /tmp/ssoadapter-new-templates.xml, sustituya la cadena:
    3. sunConfigurationTemplates=[

      por:

      <?xml version="1.0" encoding="ISO-8859-1"?>
      <!DOCTYPE Requests
        PUBLIC "-//iPlanet//iDSAME 5.0 Admin CLI DTD//EN"
        "jar://com/iplanet/am/admin/cli/amAdmin.dtd"
      >
      <Requests>
        <SchemaRequests serviceName="SunSSOAdapterService"   SchemaType="Global">
          <ModifyDefaultValues>
            <AttributeValuePair>
              <Attribute name="sunConfigurationTemplates" />

    4. Sustituya todos los signos "&" por "&amp;".
    5. Por ejemplo, la línea:

      default|imap:/?configName=SUN-UWC-MAIL
      &proxyAdminPassword=%5BPROXY-ADMIN_PASSWORD%5D
      &subType=sun-one&enableProxyAuth=false...

      será:

      default|imap:/?configName=SUN-UWC-MAIL
      &amp;proxyAdminPassword=%5BPROXY-ADMIN_PASSWORD%5D
      &amp;subType=sun-one&amp;enableProxyAuth=false ...

    6. Elimine las comas (",") al final de cada metaplantilla "ssoadapter".
    7. Incluya en cada metaplantilla "ssoadapter" una etiqueta <Value> inicial y una etiqueta </Value> final.
    8. Por ejemplo:

      <Value>default|imap:/?configName=SUN-UWC-MAIL
      &amp;proxyAdminPassword=%5BPROXY-ADMIN_PASSWORD%5D
      &amp;subType=sun-one&amp;enableProxyAuth=false ...</Value>

    9. Elimine el corchete final ("]") de la última metaplantilla "ssoadapter".
    10. Agregue las siguientes líneas al final del archivo:
    11.       </AttributeValuePair>
          </ModifyDefaultValues>
        </SchemaRequests>
      </Requests>

      El archivo ssoadapter-new-templates.xml resultante para la plantilla única utilizada en los pasos anteriores debería presentar el siguiente aspecto:

      <?xml version="1.0" encoding="ISO-8859-1"?>
      <!DOCTYPE Requests
        PUBLIC "-//iPlanet//iDSAME 5.0 Admin CLI DTD//EN"
        "jar://com/iplanet/am/admin/cli/amAdmin.dtd"
      >
      <Requests>
        <SchemaRequests serviceName="SunSSOAdapterService"   SchemaType="Global">
          <ModifyDefaultValues>
            <AttributeValuePair>
              <Attribute name="sunConfigurationTemplates" />
      <Value>default|imap:/?configName=SUN-UWC-MAIL
      &amp;proxyAdminPassword=%5BPROXY-ADMIN_PASSWORD%5D
      &amp;subType=sun-one&amp;enableProxyAuth=false ...</Value>
            </AttributeValuePair>
          </ModifyDefaultValues>
        </SchemaRequests>
      </Requests>

  5. Importe el nuevo archivo ssoadapter-new-templates.xml.
  6. AccessManager-base/bin/amadmin -u amadminUser -w password -v
    -t ssoadapter-new-templates.xml

Ahora ya puede acceder a la ficha "ssoadapter" de la consola de Portal Server para ver los adaptadores "ssoadapter" actualizados.

Habilite el canal URLScrapper

Al actualizar de la Versión 4 a la Versión 5, debe habilitar el canal URLScrapper. Consulte Habilite el canal URLScrapper.

Elimine la entrada del servicio de la puerta de enlace

La entrada del usuario amService-srapGateway debe eliminarse manualmente al actualizar Portal Server desde la Versión 2; de lo contrario, el componente de puerta de enlace de Portal Server Secure Remote Access no se iniciará una vez realizada la actualización. Lleve a cabo estos pasos:

  1. Inicie una sesión en la consola de Access Manager.
  2. Muestre todos los usuarios en el DN de organización.
  3. Elimine el usuario amService-srapGateway.

Actualización de varias instancias

No se admiten las actualizaciones por turnos de varias instancias (consulte Actualización de varias instancias) al actualizar los componentes de Portal Server de la Versión 2 a la Versión 5.


Actualización de Portal Server desde la Versión intermedia 7.0

En esta sección se incluye información sobre la actualización de Portal Server de la Versión intermedia (IFR) 7.0 2005Q4 a Java ES 5 (Versión 5).

En esta sección, se describen los siguientes temas:

Portal Server Introducción a la actualización de la versión IFR

Al actualizar Portal Server IFR 7.0 a la Versión 5 de Portal Server, tenga en cuenta los siguientes aspectos relacionados con el proceso de actualización:

Portal Server Actualización de IFR 7.0

En esta sección se describe cómo realizar una actualización de Portal Server de la Versión intermedia a Java ES Versión 5 en las plataformas Solaris y Linux. Cuando un tema haga referencia a procedimientos específicos para una plataforma, se indicará el sistema operativo al que se aplica. En esta sección, se describen los siguientes temas:

Tareas previas a la actualización de IFR 7

Las tareas previas a la actualización de la versión IFR son iguales a las de la actualización de la Versión 4 (consulte Tareas previas a la actualización de la Versión 4), con las siguientes excepciones.

Obtenga la información de configuración necesaria

La información necesaria para la secuencia de comandos psupgrade, como se describe en Obtenga las contraseñas y la información de configuración necesarias, no se aplica completamente para actualizar desde la IFR de Portal Server. Como Portal Server IFR no se admite en Application Server 7.x, no se puede aplicar el escenario de actualización del contenedor web 5 que aparece en la Tabla 15-6.

Configuración del contenedor de agentes común

El contenedor de agentes común es un componente compartido que proporciona servicios de contenedor para los agentes de supervisión y administración de Java ES. Las herramientas administrativas de Portal Server como, por ejemplo, la consola de Portal Server y la interfaz de línea de comandos psadmin utilizan un conjunto de agentes de supervisión y administración que reciben la denominación conjunta de servidor de administración de Portal Server y que se implementa en el contenedor de agentes común.

Si se han actualizado los componentes compartidos de Java ES a la Versión 5 antes de realizar la actualización de Portal Server IFR 7.0, es necesario que lleve a cabo los siguientes pasos adicionales para iniciar una sesión en la Versión 5 de la consola de Portal Server y utilizar la interfaz de línea de comandos psadmin. (Si los componentes compartidos de Java ES no se han actualizado a la Versión 5 antes de realizar la actualización de Portal Server IFR 7.0, omita los siguientes pasos adicionales.)

  1. Reconfigure el contenedor de agentes común.
  2. PortalServer7-base/bin/psconfig --config     PortalServer7-base/samples/example2.xml

    El archivo example2.xml proporciona la información de reconfiguración. Debe editar, en primer lugar, el archivo example2.xml para proporcionar las contraseñas necesarias antes de ejecutar el comando psconfig. Si utiliza ubicaciones de Portal Server que no son predeterminadas, debe proporcionar también los directorios correctos.

  3. Edite la ruta de clase del contenedor web para que haga referencia al contenedor de agentes común.
  4. La ruta de clase del contenedor web contendrá una referencia a la ubicación de la versión anterior del contenedor de agentes común: (rel4CAC-base-dir/lib/cacao_cacao.jar).

    Sustituya esta referencia por la ubicación de la Versión 5: (rel5CAC-admin-dir/lib/cacao_cacao.jar).

  5. Compruebe que se ha creado el archivo de propiedades pasconnect.properties en el directorio PortalServer7Config-base con la siguiente propiedad:
  6. pas.host=

    El valor de la propiedad puede ser nulo, localhost, o el nombre de host de Portal Server real.

  7. Reinicie el contenedor de agentes común.
  8. rel5CAC-admin-dir/bin/cacaoadm start

Actualización de Portal Server IFR 7.0 (Solaris)

En esta sección se abordan diversas consideraciones que afectan al proceso de actualización de Portal Server IFR, además de una descripción del propio procedimiento.

Consideraciones sobre la actualización de IFR 7 (Solaris)

Al actualizar Portal Server IFR a Java ES Versión 5, es preciso tener en cuenta las mismas consideraciones que al realizar la actualización de la Versión 4 (consulte Consideraciones sobre la actualización (Solaris)).

Además, consulte los problemas descritos en Portal Server Introducción a la actualización de la versión IFR.

Procedimiento de actualización de IFR 7 (Solaris)

El procedimiento que se describe a continuación hace referencia a Portal Server en el equipo en el que se vaya a realizar la actualización.

  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Detenga todas las instancias de Portal Server Secure Remote Access Gateway, Rewriter Proxy o Netlet Proxy que podrían estar en ejecución de forma local.
  4. PortalServer7-base/bin/psadmin stop-sra-instance -u amadminUser
       -f
    passwordFile -t gateway -N gatewayProfileName

    PortalServer7-base/bin/psadmin stop-sra-instance -u amadminUser
       -f
    passwordFile -t rwproxy -N gatewayProfileName

    PortalServer7-base/bin/psadmin stop-sra-instance -u amadminUser
       -f
    passwordFile -t nlproxy -N gatewayProfileName

    Compruebe que se hayan detenido los procesos:

    Puerta de enlace: netstat -an | grep 443
    Proxy Rewriter: netstat -an | grep 10443
    Proxy Netlet: netstat -an | grep 10555

  5. Asegúrese de que se esté ejecutando Access Manager si se ha implementado en un contenedor web distinto del contenedor en el que se haya implementado Portal Server.
  6. Si aún no se está ejecutando, inicie el contenedor web en el que se haya implementado Portal Server para iniciar esta aplicación.
  7. Web Server 6.x:
    WebServer-base
    /https-instanceName/start

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin start-domain --user admin_ID
         --password password domainName

  8. Obtenga los números de parche necesarios en la Tabla 15-8.
  9. Utilice siempre las revisiones más recientes disponibles, a menos que se le indique que utilice una revisión específica.

    Las revisiones pueden descargarse en /tmp desde: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  10. Aplique el parche adecuado de Portal Server y, si es necesario, el parche de traducción que aparece en la Tabla 15-8.
  11. patchadd /tmp/patch_ID

  12. Confirme que las actualizaciones de los parches se hayan realizado satisfactoriamente:
  13. showrev -p | grep patch_ID

    Como resultado, deberían devolverse las versiones de Id. de parche aplicadas en el Step 6.

  14. En los casos en los que los paquetes de traducción se hayan actualizado en el Step 6, establezca la configuración regional de JVM de la consola de Portal Server en UTF-8.
  15. export LC_ALL=ja_JP.UTF-8
    export LANG=ja_JP.UTF-8

  16. Establezca las dos variables de entorno (ANT_HOME y JAVA_HOME) necesarias para la secuencia de comandos psupgrade:
  17. export ANT_HOME=/usr/sfw
    export JAVA_HOME=/usr/jdk/entsys-j2se

  18. Asegúrese de que dispone del espacio de intercambio adecuado en el equipo.
  19. Normalmente, el espacio de intercambio suele establecerse en el doble de la cantidad de memoria RAM física.

  20. Ejecute la secuencia de comandos psupgrade.
  21. cd PortalServer7-base/bin
    ./psupgrade

    La secuencia de comandos psupgrade no se ejecuta desde la distribución de Java ES Versión 5 ni llama al programa de instalación de Java ES (ya se han aplicado las revisiones para los paquetes).

    La secuencia de comandos realiza una consulta en el sistema para detectar la ubicación, el número de puerto y otros datos acerca del contenedor web en el que se vayan a implementar las aplicaciones web de Portal Server. En función del escenario de actualización del contenedor web (consulte la Tabla 15-4), la secuencia de comandos le solicitará que introduzca la información adicional necesaria para implementar Portal Server en el contenedor web adecuado.

    La Tabla 15-6 muestra la información solicitada para los diferentes escenarios de actualización del contenedor web, incluidos en la Tabla 15-4.


    Nota

    Asegúrese de introducir los valores correctos para los parámetros de psupgrade, ya que no se puede retroceder para cambiarlos y, además, es muy difícil deshacer los cambios efectuados por la secuencia de comandos psupgrade.


  22. Detenga y reinicie el contenedor web.
  23. Aunque no sea necesario en determinadas situaciones, al reiniciar el contenedor web, se garantiza que Portal Server se inicie de forma limpia.

Actualización de la versión IFR 7 de Portal Server (Linux)

En esta sección se abordan diversas consideraciones que afectan al proceso de actualización de Portal Server, además de una descripción del propio procedimiento.

Consideraciones sobre la actualización de IFR 7 (Linux)

Al actualizar el software de Portal Server IFR a la Versión 5 en la plataforma Linux, es preciso tener en cuenta las mismas consideraciones que en la plataforma Solaris (consulte Consideraciones sobre la actualización de IFR 7 (Solaris)), excepto que, al instalar las revisiones de la Versión 5 en el sistema operativo Linux, se eliminan los RPM anteriores.

Procedimiento de actualización de IFR 7 (Linux)

El procedimiento que se describe a continuación hace referencia a Portal Server en el equipo en el que se vaya a realizar la actualización.


Precaución

En Linux, la actualización de Portal Server IFR a la Versión 5 no se puede anular. Asegúrese de realizar una copia de seguridad del sistema antes de llevar a cabo el siguiente procedimiento.


  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Detenga todas las instancias de Portal Server Secure Remote Access Gateway, Rewriter Proxy o Netlet Proxy que podrían estar en ejecución de forma local.
  4. PortalServer7-base/bin/psadmin stop-sra-instance -u amadminUser
       -f
    passwordFile -t gateway -N gatewayProfileName

    PortalServer7-base/bin/psadmin stop-sra-instance -u amadminUser
       -f
    passwordFile -t rwproxy -N gatewayProfileName

    PortalServer7-base/bin/psadmin stop-sra-instance -u amadminUser
       -f
    passwordFile -t nlproxy -N gatewayProfileName

    Compruebe que se hayan detenido los procesos:

    Puerta de enlace: netstat -an | grep 443
    Proxy Rewriter: netstat -an | grep 10443
    Proxy Netlet: netstat -an | grep 10555

  5. Asegúrese de que se esté ejecutando Access Manager si se ha implementado en un contenedor web distinto del contenedor en el que se haya implementado Portal Server.
  6. Si aún no se está ejecutando, inicie el contenedor web en el que se haya implementado Portal Server para iniciar esta aplicación.
  7. Web Server 6.x:
    WebServer-base
    /https-instanceName/start

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin start-domain --user admin_ID
         --password password domainName

  8. Obtenga el parche necesario utilizando los números de parche y los nombres de RPM que aparecen en la Tabla 15-8.
  9. Utilice siempre las revisiones más recientes disponibles, a menos que se le indique que utilice una revisión específica.

    Las revisiones pueden descargarse en /tmp desde: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/patch-access

  10. Aplique el parche de Portal Server y, si es necesario, los RPM de traducción para Portal Server que aparecen en la Tabla 15-8, en ese orden.
  11. Consulte el archivo Readme (Léame) del parche de Portal Server, que describe cómo utilizar una secuencia de comandos para aplicar los RPM del parche:

    cd /tmp

    donde /tmp es el directorio en el que se ha descargado la revisión.

    ./upgradeportalrpm

    Las secuencias de comandos de actualización instalan los RPM.

    Para la revisión de traducción, instale cada RPM con el siguiente comando:

    rpm -Fvh patchName-version.rpm

  12. Confirme que la actualización del parche se ha realizado con éxito:
  13. rpm -qa | grep sun-portal

    Se deberían mostrar los números de las revisiones de actualización de los RPM.

  14. En los casos en los que los paquetes de traducción se hayan actualizado en el Step 6, establezca la configuración regional de JVM de la consola de Portal Server en UTF-8.
  15. export LC_ALL=ja_JP.UTF-8
    export LANG=ja_JP.UTF-8

  16. Establezca las dos variables de entorno (ANT_HOME y JAVA_HOME) necesarias para la secuencia de comandos psupgrade:
  17. export ANT_HOME=/opt/sun
    export JAVA_HOME=/usr/jdk/entsys-j2se

  18. Asegúrese de que dispone del espacio de intercambio adecuado en el equipo.
  19. Normalmente, el espacio de intercambio suele establecerse en el doble de la cantidad de memoria RAM física.

  20. Ejecute la secuencia de comandos psupgrade.
  21. cd PortalServer7-base/bin
    ./psupgrade

    La secuencia de comandos psupgrade no se ejecuta desde la distribución de Java ES Versión 5 ni llama al programa de instalación de Java ES (ya se han aplicado las revisiones para los paquetes).

    La secuencia de comandos realiza una consulta en el sistema para detectar la ubicación, el número de puerto y otros datos acerca del contenedor web en el que se vayan a implementar las aplicaciones web de Portal Server. En función del escenario de actualización del contenedor web (consulte la Tabla 15-4), la secuencia de comandos le solicitará que introduzca la información adicional necesaria para implementar Portal Server en el contenedor web adecuado.

    La Tabla 15-6 muestra la información solicitada para los diferentes escenarios de actualización del contenedor web, incluidos en la Tabla 15-4.


    Nota

    Asegúrese de introducir los valores correctos para los parámetros de psupgrade, ya que no se puede retroceder para cambiarlos y, además, es muy difícil deshacer los cambios efectuados por la secuencia de comandos psupgrade.


  22. Detenga y reinicie el contenedor web.
  23. Aunque no sea necesario en determinadas situaciones, al reiniciar el contenedor web, se garantiza que Portal Server se inicie de forma limpia.

Verificación de la actualización

Puede verificar la aplicación de las revisiones para actualizar los paquetes de Portal Server a la Versión 5 mediante el siguiente comando:

Consulte la Tabla 15-5 para obtener los valores de salida.

Para verificar la actualización completa, asegúrese que aparezca Portal Desktop y que la utilidad de administración psadmin funcione como se describe en el documento.

También puede comprobar los siguientes archivos de registro de la actualización en /var/sadm/install/logs:

Tareas posteriores a la actualización de IFR 7

Al actualizar Portal Server de la versión IFR 7 a la Versión 5, debe realizar los procedimientos de actualización necesarios para abordar las siguientes situaciones:

Habilitación de Java ES Monitoring Framework

Al habilitar Java ES Monitoring Framework (componente compartido MFWK), las herramientas administrativas de Portal Server como, por ejemplo, la consola de Portal Server y la interfaz de línea de comandos psadmin pueden informar de las estadísticas como, por ejemplo, el número de visitantes y los portales a los que se accede frecuentemente. Para habilitar MFWK:

  1. Encuentre los siguientes dos archivos:
  2. MFWK-base/template/jesmf/desktopmfwk.properties
    MFWK-base/template/jesmf/com.sun.cmm.ps.xml

    donde MFWK-base es la siguiente ruta:

    /opt/SUNWmfwk    (Solaris)

    /opt/sun/mfwk    (Linux)

  3. Copie los dos archivos en el siguiente directorio:
  4. PortalServer7Data-base/portals/portal_ID/config/Portal_Instance/

  5. En el archivo desktopmfwk.properties, sustituya:
  6. com.sun.portal.ProductCollectionId=%PS_DIR%

    por:

    com.sun.portal.ProductCollectionId=Portal_Installed_Location

  7. Agregue los siguientes dos archivos jar:
  8. MFWK-base/lib/mfwk_instrum_tk.jar
    MFWK-base/lib/mfwk_agent.jar

    en la ruta de clase del contenedor web adecuada (el archivo server.xml para Web Server y el archivo domain.xml para Application Server)

  9. Reinicie el contenedor web correspondiente.
Actualización en el contenedor web Application Server

Si Portal Server se implementa en el contenedor web Application Server, debe realizar el siguiente procedimiento adicional para volver a implementar satisfactoriamente Portal Server:

  1. Encuentre la sección que define la configuración de psconsole en el archivo AppServer8Config-base/domains/domainName/config/server.policy :
  2. Agregue la siguiente línea al final de esa sección:
  3. permission java.lang.RuntimePermission “getProtectionDomain”

  4. Reinicie la instancia de Application Server.
  5. AppServer8-base/bin/asadmin start-domain --user admin_ID
         --password passworddomainName

    AppServer8-base/bin/asadmin start-node-agent --user admin_ID
         --password password nodeagentName

    donde nodeagentName presenta el formatohostName_domainName, , pero es sólo de forma predeterminada hostName.

Bloqueo de las conexiones en el contenedor web Application Server

Si la instancia actualizada de Portal Server se implementa en el contenedor web Application Server, las aplicaciones del portal se pueden bloquear mientras esperan la recepción de la conexiones de Java DB. Para solucionar este problema, lleve a cabo los siguientes pasos:

  1. Elimine la configuración en PortalServer7Data-base/derby/derby.properties para los siguientes dos parámetros:
  2. derby.drda.maxThreads
    derby.drda.timeslice

  3. Reinicie Java DB.
  4. ANT_HOME/bin/ant
        -DPS_CONFIG=
    PortalServer7Config-base/PSConfig.properties
        -buildfile
    PortalServer7-base/lib/derby.xml
        [stop-instance|start-instance]

    donde ANT_HOME es /usr/sfw (en Solaris) y /opt/sun (en Linux).

  5. Cambie los valores de configuración de Java DB para Application Server.
  6. Mediante la consola de Application Server, cambie los valores de atributos para los siguientes recursos del conjunto de conexiones: communitymcPool, FileSharingDBPool, PointBasePool, SurveyDBPool.

    Cambie los siguientes valores de atributos, como se indica a continuación:

    Idle Timeout en 300 o más
    Resource Type en javax.sql.ConnectionPoolDataSource
    Datasource classname
    en
        org.apache.derby.jdbc.ClientConnectionPoolDataSource

  7. Reinicie la instancia de Application Server en la que se ha implementado Portal Server.
Actualización en la Versión 5 del contenedor web Web Server (7.0)

Si ha actualizado Portal Server IFR en un Web Server que aún no se haya actualizado a la Versión 5 debido a que la secuencia de comandos psupgrade no admite la actualización de Portal Server IFR en la Versión 5 de Web Server (consulte Portal Server Introducción a la actualización de la versión IFR), debe realizar los siguientes pasos adicionales posteriores a la actualización:

  1. Actualice Web Server (y, si es necesario, Access Manager) a la Versión 5.
  2. Reconfigure los valores del contenedor Web Server necesarios para la consola de Portal Server y la interfaz de línea de comandos psadmin.
    1. Abra un navegador LDAP.
    2. Los valores de configuración se almacenan en Directory Server.

    3. En DN, busque:
      sunPortalAdminPortalDomainID=defaultDomain
      ->sunPortalAdminPortalDomainPortalID=portal1
      ->sunPortalAdminPortalDomainPortalServerInstanceIn=host-port
    4. Edite de la siguiente manera.
    5. Tenga en cuenta que todas las entradas son introducidas por la siguiente cadena: sunPortalAdminPortalDomainPortalServerInstance

      • Elimine la entrada para WebContainerInstanceDir.
      • Agregue una entrada para WebContainerDomainName y asígnele el valor de Web Container Config Name desde Tabla 15-6.
      • Edite las entradas como, por ejemplo InstallDir, WebContainerType, DocRoot y otros parámetros mostrados en la Tabla 15-6 para que se correspondan con los valores de la Versión 5 de Web Server (7.0).
  3. Cree la instancia de la Versión 5 de Portal Server.
  4. PortalServer7-base/bin/psadmin create-instance newInstance_ID

    Si ya existe el valor de newInstance_ID, se generará un error, por lo que es recomendable realizar este paso antes que el Step 4 indicado a continuación.

  5. Elimine la instancia de Portal Server IFR.
  6. PortalServer7-base/bin/psadmin delete-instance oldInstance_ID

Vuelva a implementar las aplicaciones de portlet personalizadas

Si ha creado e implementado aplicaciones de portlet personalizadas, estos portlets deben implementarse de nuevo manualmente una vez completada la actualización a la Versión 5 de Portal Server. Aunque existirán entradas del perfil de visualización y se mostrará el nombre del canal, no podrá ver el contenido hasta que vuelva a implementar los portlets personalizados.

Vuelva a implementar los portlets con el siguiente comando:

PortalServer7-base/bin/psadmin deploy-portlet

Puede confirmar la nueva implementación buscando el archivo .war y los archivos XML correspondientes en la siguiente ubicación:

PortalServer7Data-base/portals/Upgraded/war

Migre las aplicaciones de portlet personalizadas

Las aplicaciones de portlet personalizadas basadas en la infraestructura de interfaz de usuario proporcionada por Sun Java Web Console (SJWC) deben migrarse manualmente a la Versión 5 e implementarse de nuevo.

En concreto, este requisito se aplica a las cuatro aplicaciones web distribuidas con Portal Server como aplicaciones de portlet de ejemplo destinadas a personalizarse e instalarse en un portal: filesharing, surveys, wiki, rssportlet. Durante la actualización, las versiones de estas aplicaciones de portlet de ejemplo cuyos errores se han solucionado se ubican en el área de aplicaciones de portlet del disco. Si ha personalizado estas aplicaciones de portlet para su propio uso, deberá migrarlas manualmente a la Versión 5 e implementarlas de nuevo, ya que el proceso de actualización de Portal Server no las administra.

Algunas de estas aplicaciones de ejemplo (filesharing y surveys) se implementan de forma predeterminada y están disponibles para los usuarios al crearse una comunidad.

Puede actualizar, personalizar y volver a implementar las aplicaciones de portlet basadas en SJWC mediante el siguiente procedimiento. La aplicación de portlet filesharing se utiliza como ejemplo:

  1. Extraiga los archivos jar de la Versión 5 de SJWC.
    1. mkdir /tmp/lh
    2. cd /tmp/lh
    3. /usr/jdk/entsys-j2se/bin/jar xvf    PortalServer7-base/portlet/communityportlets.war
         WEB-INF/lib/commons-beanutils.jar
         WEB-INF/lib/commons-collections-3.1.jar
         WEB-INF/lib/commons-digester.jar
         WEB-INF/lib/commons-logging.jar
         WEB-INF/lib/dataprovider.jar WEB-INF/lib/jsf-api.jar
         WEB-INF/lib/jsf-impl.jar WEB-INF/lib/webui.jar
    4. Si PortalServer7-base/portlet/communityportlets.war
      no se encuentra, utilice PortalServer7-base/portlet/core/communityportlets.war.

    5. Cambie el nombre de uno de los archivos.
    6. mv WEB-INF/lib/commons-collections-3.1.jar
      WEB-INF/lib/commons-collections.jar

  2. Encuentre la aplicación de portlet filesharing.
  3. cd PortalServer7Config-base/portals/portal1/portletapps/filesharing

  4. Incluya las bibliotecas de SJWC actualizadas.
  5. jar uvf src/filesharing.war.tokenized -C /tmp/lh WEB-INF

  6. Personalice la aplicación de portlet filesharing.
  7. ant customize

  8. Vuelva a implementar la aplicación de portlet filesharing.
    1. PortalServer7-base/bin/psadmin undeploy-portlet -u amadmin
      -f passwordfile -p
      portal_id -i instance_id -g filesharing
    2. ant deploy
    3. Acceda al siguiente directorio (en función del contenedor web):
    4. Application Server 8.x:

      AppServer8Config-base/domains/domain1/applications/j2ee-modules/
      communityportlets/WEB-INF

      Web Server 6.x:

      WebServer6-base/https-instanceName/webapps/https-instanceName/
      communityportlets/WEB-INF

      Web Server 7.x:

      WebServer7Config-base/https-configName/web-app/https-configName/
      communityportlets/WEB-INF

    5. Abra el archivo sun-web.xml y agregue la siguiente línea justo antes de la última línea (es decir, delante de la etiqueta final sun-web-app):
    6. <class-loader delegate="false"/>

    7. Repita el Step c y el Step d para el archivo sun-web.xml ubicado en filesharing/WEB-INF.
  9. Repita del Step 2 al Step 5 para la aplicación surveys y las demás aplicaciones de portlet personalizadas basadas en la estructura de SJWC.
  10. Reinicie el contenedor web.
Corregir vínculos en marcador y canales de aplicación

Al actualizar la Versión 4 de Portal Server a la Versión 5, el marcador y los canales de aplicación tienen vínculos duplicados. Para solucionar estos vínculos, lleve a cabo el siguiente procedimiento.

  1. Inicie una sesión en PSConsole.
  2. En la ficha Tareas comunes, haga clic en Gestionar canales y contenedores.
  3. Seleccione DeveloperSample [Org] como DN y haga clic en Aceptar.
  4. Seleccione JSPTabContainer [predeterminado] como tipo de vista.
  5. En MyFrontPageTabPanelContainer, haga clic en Canal de aplicación.
  6. Aparecerán las propiedades del canal de aplicación en el lateral derecho.

    Para ver las propiedades de una configuración local específica, haga clic en Preferencias de tabla y proporcione el valor de la configuración local: de, fr, es, ja, ko, zh, zh_CN, zh_TW.

  7. Edite la propiedad userApps.
    1. En la propiedad userApps haga clic en el vínculo [Editar valores...]
    2. Aparecerá una ventana emergente con las aplicaciones existentes.

    3. Agregue a la lista la aplicación siguiente:
    4. NetFile

    5. Haga clic en Guardar y, a continuación, en Cerrar.
  8. Edite la propiedad de destino.
    1. En la propiedad de destino haga clic en el vínculo [Editar valores...]
    2. Aparecerá una ventana emergente con los destinos existentes.

    3. Agregue a la lista el destino siguiente:

      NetFile|/portal/NetFileApplet?Refer=java2

    1. Haga clic en Guardar y, a continuación, en Cerrar.
Migración manual de los portlets basados en Struts

Si tiene portlets personalizados que utilizan código basado en la estructura Struts, estos portlets deben actualizarse manualmente para que utilicen el archivo struts.jar incluido en la Versión 5 de Portal Server. Utilice el siguiente procedimiento:

  1. Anule la implementación de la aplicación de portlet basada en Struts.
  2. PortalServer7-base/bin psadmin undeploy-portlet

  3. Actualice el archivo .war con la versión correcta del archivo struts.jar.
  4. Copie PortalServer7-base/lib/struts.jar en strutsbasedPortlet/WEB-INF/lib/struts.jar

    donde strutsbasedPortlet es el directorio en el que residen los archivos del portlet basado en Struts.

  5. Cree un archivo .war del directorio strutsbasedPortlet.
  6. Vuelva a implementar la aplicación de portlet.
  7. PortalServer7-base/bin psadmin deploy-portlet

Anulación de la actualización (Solaris)

En esta sección, se describen diversas consideraciones que afectan al procedimiento que permite deshacer la actualización de Portal Server, además de una descripción del propio procedimiento.

Consideraciones sobre la anulación de la actualización (Solaris)

El procedimiento para anular la actualización a la Versión 5 consiste en restablecer la instalación de la versión IFR en PortalServer7-base y volver a implementar las aplicaciones web de la versión IFR.

Procedimiento de anulación de la actualización (Solaris)
  1. Inicie sesión como root o conviértase en superusuario.
  2. su -

  3. Restablezca Directory Server al estado que presentaba antes de la actualización.
  4. Utilice las utilidades de la GUI y la línea de comandos de copia de seguridad/restablecimiento de Directory Server. Consulte el capítulo sobre copia de seguridad y restablecimiento de Directory Server, incluido en la Sun Java System Directory Server Enterprise Edition 6.0 Administration Guide, http://docs.sun.com/doc/819-0995.

  5. Anule la implementación de las aplicaciones web de la Versión 5 de Portal Server que se volvieron a implementar durante la actualización a la Versión 5.
  6. Use las utilidades de administración del contenedor web (la línea de comandos o la consola) para anular la implementación de los siguientes paquetes:

    portal
    psconsole
    search1
    wsssoportlet
    guessnumber
    portletsamples

  7. Detenga Portal Server deteniendo su contenedor web.
  8. Web Server 6.x:
    WebServer-base
    /https-instanceName/stop

    Web Server 7.0:
    Admin Server--
    WebServer7Config-base/admin-server/bin/stopserv
    Instance Server--
    WebServer7Config-base/https-configName/bin/stopserv

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin stop-domain --user admin_ID
         --password password domainName

  9. Anule la aplicación del parche de Portal Server 7.1 que aparece en la Tabla 15-8.
  10. patchrm patch_ID

  11. Reinicie Portal Server reiniciando su contenedor web.
  12. Web Server 6.x:
    WebServer-base
    /https-instanceName/start

    Web Server 7.0:
    Admin Server--
    WebServer7Config-base/admin-server/bin/startserv
    Instance Server--
    WebServer7Config-base/https-configName/bin/startserv

    Application Server 8.x:
    AppServer8-base
    /bin/asadmin start-domain --user admin_ID
         --password password domainName

  13. Implemente las aplicaciones web de la Versión 5 de Portal Server cuya implementación se anuló durante Step 3.
  14. Use las utilidades de administración del contenedor web (la línea de comandos o la consola) para implementar los paquetes.

  15. Detenga y reinicie el contenedor web.
  16. Aunque no sea necesario en determinadas situaciones, al reiniciar el contenedor web, se garantiza que Portal Server se inicie de forma limpia.

Anulación de la actualización (Linux)

No se puede deshacer la actualización realizada en Linux.

Sin embargo, puede crear un sistema paralelo y probarlo antes de intentar realizar una actualización. Si necesita anular la actualización, puede restablecer este sistema paralelo.

Actualización de varias instancias

En algunas arquitecturas de implementación, Portal Server se implementa en varios sistemas informáticos para proporcionar escalabilidad y mejorar la disponibilidad. Por ejemplo, es posible que los componentes de Portal Server se ejecuten en varios equipos con un equilibrador que distribuya la carga.

Si utiliza instancias de Portal Server con equilibrado de carga, puede realizar una actualización por turnos en la que se actualicen las instancias de Portal Server secuencialmente sin necesidad de interrumpir el servicio. Puede actualizar cada instancia de Portal Server mientras las demás siguen ejecutándose. Para realizar una actualización por turnos de la versión IFR a la Versión 5, siga las instrucciones que aparecen en Actualización de varias instancias y sustituya toda referencia a la Versión 4 por la versión IFR.



Anterior      Contenido      Índice      Siguiente     


Número de referencia: 819-6553-11
junio de 2007.   Copyright 2007 Sun Microsystems, Inc. Todos los derechos reservados.