Resolución de problemas

Consulte la tabla siguiente para ver algunos problemas comunes y sus soluciones.

Otros recursos para la solución de problemas

Consulte el archivo readme de las herramientas de Rational. Está disponible en el menú Inicio (en Windows) o en el launchpad de instalación de Rational Software Development Platform.

Resolución de problemas

Problemas Soluciones
No se puede iniciar el entorno de prueba de WebSphere Portal v5.x
  • Asegúrese de haber instalado el entorno de prueba de WebSphere Portal v5.x. Compruebe el archivo de anotaciones cronológicas de instalación para verificar que la instalación sea correcta. El archivo de anotaciones cronológicas de instalación para el entorno de prueba de WebSphere Portal v5.0 es installdir_área de trabajo\runtimes\portal_v50\log\wpsinstalllog.txt.
  • Cambie la configuración de servidor: esta solución sólo se aplica cuando el entorno de prueba de WebSphere Portal v5.x no puede iniciarse en la modalidad de depuración. En la configuración de servidor, asegúrese de que el recuadro de selección Habilitar sustitución de método dinámico en modalidad de depuración de la página Servidor esté seleccionado. Para ello, realice los pasos siguientes:
    1. En la vista Servidores, realice una doble pulsación en el entorno de prueba de WebSphere Portal v5.x que no se pueda iniciar en la modalidad de depuración para poder abrir su configuración de servidor.
    2. Seleccione la página Visión general.
    3. Seleccione el recuadro de selección Habilitar sustitución de método dinámico en modalidad de depuración.
    4. Pulse Ctrl+S para guardar la configuración de servidor actualizada.
  • Sólo para Linux: cambie el permiso de acceso para la base de datos de WebSphere Portal. Debido a una limitación de WebSphere Portal, el entorno de prueba de WebSphere Portal v5.x sólo está disponible para que lo utilice un usuario. Puede permitir que otros usuarios utilicen el servidor activando el permiso de lectura, grabación y ejecución de la base de datos de WebSphere Portal. Para cambiar el permiso de acceso, introduzca estos mandatos:
    1. cd /opt/PortalUTE/PortalServer/cloudscape/
    2. chmod -R 777 wps50
    De forma alternativa, puede cambiar el usuario que utiliza el servidor si desinstala y vuelve a instalar el entorno de prueba de WebSphere Portal v5.x.
  • Sólo para Windows: verifique que el usuario de Windows sea un Administrador. Si no es así, inicie sesión en Windows como Administrador y ejecute el entorno de prueba de WebSphere Portal v5.x.
  • Para ejecutar o depurar portlets Struts, debe habilitar la transcodificación (consulte Habilitar transcodificación) si los portlets tienen contenido estático (distinto a JSP) o XML.
  • Para ejecutar o depurar proyectos de portlet que hacen referencia a otros proyectos Java o EJB, consulte Referencia a otros proyectos.
  • Para ejecutar o depurar proyectos de portlet que utilizan archivos de biblioteca de aplicaciones, consulte el apartado relativo a bibliotecas compartidas en Definición de servidores locales para probar portlets.
  • Compruebe el archivo de anotaciones cronológicas de WebSphere Portal para determinar el problema. Consulte el archivo de anotaciones cronológicas o habilite el registro cronológico de la consola como se describe en Definición de servidores locales para probar portlets.
No se puede crear un servidor para el entorno de prueba de WebSphere Portal v5.x.
  • Asegúrese de que el entorno de prueba de WebSphere Portal v5.x que desea utilizar esté instalado. Un servidor de entorno de prueba de WebSphere Portal v5.x sólo puede crearse si se ha instalado el entorno de prueba.
  • (Sólo para WebSphere Portal v5.1): asegúrese de que ha configurado las preferencias como se describe en Configuración del entorno de prueba de WebSphere Portal 5.1.
Al realizar una prueba en el entorno de prueba de WebSphere Portal 5.1.0.0, se produce el error siguiente: com.ibm.websphere.wmm.exception.InvalidMemberDNException: La sintaxis del DN de miembro <admin_user_id> no es válida. Compruebe si los caracteres especiales están protegidos. El ID de usuario de administrador definido para el servidor destino debe ser igual que el utilizado para la instalación de entorno de prueba de Portal.
Los errores de compilación JSP o Java se producen para un portal importado, exportado o desplegado. Los archivos JSP o las clases Java que dependen de archivos JAR externos para algunas clases pueden no compilarse si se produce una estas condiciones:
  • Los archivos JSP o las clases Java se han importado de un servidor de portal remoto y utilizan archivos JAR externos ubicados en los directorios directorio_instalación_WebSphere/lib o directorio_instalación_servidor_Portal/shared/app del servidor remoto.
  • Los archivos JSP o las clases Java se han exportado desde un proyecto de herramientas de Rational que tiene acceso a los archivos JAR y está instalado en un servidor de portal remoto que no tiene acceso a los archivos JAR.
  • Los archivos JSP o las clases Java se han desplegado desde un proyecto de herramientas de Rational que tiene acceso a los archivos JAR y el servidor de portal de destino no tiene acceso a los archivos JAR.

Esto puede ocurrir porque las operaciones de importación, exportación y despliegue no afectan a los archivos JAR a los que se ha hecho referencia.

Para resolver este problema, si su proyecto de portal utiliza archivos JAR externos, los archivos JAR deben ponerse a disposición del servidor.
  • Para hacer que los archivos JAR estén disponibles en un proyecto de portal, copie los archivos JAR en la máquina de desarrollo y añádalos a la Vía de acceso de construcción Java del proyecto de portal. Para establecer la Vía de acceso de construcción Java, siga estos pasos:
    1. Desde la vista Explorador de proyectos, resalte el proyecto y seleccione Propiedades.
    2. En el panel izquierdo, seleccione Vía de acceso de construcción Java.
    3. En el panel derecho, seleccione la pestaña Bibliotecas.
    4. Añada los JAR a los que se ha hecho referencia.
    5. Pulse Aceptar para guardar la configuración.
  • Para hacer que los archivos JAR estén disponibles en el entorno de prueba de WebSphere Portal, copie los archivos JAR en la máquina de desarrollo y añádalos al directorio directorio_instalación_área de trabajo/runtimes/portal_v5X/shared/app del servidor de entorno de prueba.
  • Para hacer que los archivos JAR estén disponibles en un servidor de portal remoto, copie manualmente los archivos JAR necesarios en el sistema de servidor de portal remoto tras exportar o desplegar el proyecto de portal.
java.lang.NoClassDefFoundError en el entorno de prueba de WebSphere Portal v5.x. Cuando compruebe o depure una aplicación de portlet utilizando la depuración local y la aplicación de portlet tenga que utilizar archivos de biblioteca o hacer referencia a otros proyectos, tendrá que ponerlos a disposición del servidor. Consulte el apartado relativo a las bibliotecas compartidas en Definición de servidores locales para probar portlets o Referencia a otros proyectos.
La función de transcodificación no funciona correctamente cuando ejecuta o depura portlets en un servidor de entorno de prueba de WebSphere Portal v5.0. La función de transcodificación está inhabilitada por omisión en el entorno de prueba de WebSphere Portal v5.0. Tiene que habilitarla. Consulte Habilitar transcodificación.
No se puede lanzar el emulador de dispositivos WML utilizando el entorno de prueba de WebSphere Portal v5.0. Para ejecutar o depurar portlets en un emulador de dispositivos WML utilizando el entorno de prueba de WebSphere Portal v5.0, debe habilitar la transcodificación. Consulte Habilitar transcodificación. También debe definir el programa emulador de dispositivos utilizando las instrucciones de Definición de navegadores Web y emuladores de dispositivos.
No se pueden ejecutar proyectos de portlet personalizados en el entorno de prueba de WebSphere Portal v5.x. Para ejecutar o depurar proyectos de portlet personalizados, debe utilizar el servidor de conexión de WebSphere Portal Server y WebSphere Portal debe ejecutarse en un servidor remoto.
Los portlets Faces que contienen los archivos *.jar de utilidades utilizados por el soporte de fragmentos de código EJB no funcionan en tiempo de ejecución en un servidor de portal WebSphere remoto. Esto sucede al desplegar estos portlets como parte de un proyecto de portal nuevo en un servidor de Portal.

Para obtener más información, consulte Probar y desplegar portlets que hacen referencia a módulos J2EE.

Al Ejecutar en servidor en un portlet que se está utilizando en un proyecto de portal genera un archivo EAR inesperado en el diálogo Selección de servidor. En lugar de seleccionar el proyecto de portlet, seleccione el proyecto EAR del portlet y pulse con el botón derecho del ratón para llevar a cabo la función Ejecutar en servidor.
Para buscar el archivo EAR del proyecto de portlet
  1. En el Explorador de proyectos, expanda el nodo Aplicaciones de empresa.
  2. Pulse con el botón derecho del ratón sobre el nodo EAR del proyecto de portlet. En el menú, seleccione Ejecutar > Ejecutar en servidor.
Se ha producido el error No se ha podido restaurar el entorno de trabajo al iniciar Rational Software Development Platform. Reinicie las herramientas de Rational y especifique un directorio nuevo como espacio de trabajo. Si ha seleccionado antes la opción Utilizar este espacio de trabajo como valor predeterminado y no mostrar este recuadro de diálogo otra vez y el diálogo que permite especificar el directorio de espacio de trabajo no aparece, inicie el área de trabajo con el parámetro -data. En la línea de mandatos:


Para Windows

cd installdir_área de trabajo
rationalsdp.exe -data directorio_espacio de trabajo


Para Linux

cd installdir_área de trabajo
rationalsdp.sh -data directorio_espacio de trabajo

donde installdir_área de trabajo es el directorio donde ha instalado Rational Software Development Platform y directorio_espacio de trabajo es el nuevo directorio de espacio de trabajo que desea utilizar.

Los portlets desarrollados para WebSphere Portal 4.2 no funcionan correctamente en WebSphere Portal 5.x. Esta solución sólo funciona cuando los portlets se han desarrollado mediante Portal Toolkit 5.0.2 o anterior.
Para solucionar esto, realice una de estas acciones:
  • Suprima el archivo /WEB-INF/tld/portlet.tld del proyecto de portlet.
  • Cambie el nivel API de portlet del proyecto de portlet siguiendo estos pasos:
    1. Resalte el proyecto de portlet en la vista Explorador de proyectos.
    2. Pulse con el botón derecho del ratón y seleccione Propiedades > API de portlet.
    3. Seleccione un nivel API de portlet utilizando la lista desplegable.
    4. Seleccione Aceptar para guardar el cambio.

La mayoría de los portlets escritos para WebSphere Portal Versión 4.2 se ejecutarán sin que se realicen cambios en ellos en WebSphere Portal Versión 5.x. Algunas de las API de portlet 4.2.x están ahora marcadas como obsoletas, pero todavía están disponibles en WebSphere Portal Versión 5.x. No obstante, el archivo portlet.tld es distinto en las versiones de WebSphere Portal. Este archivo se ha incluido en proyectos de portlet de Portal Toolkit 5.0.2 o anterior.

La ejecución (comprobación) o depuración de un portlet en el entorno de prueba ha fallado. Tras iniciar la tarea Ejecutar en servidor o Depurar en servidor, el entorno de prueba estaba en estado de iniciación, pero se ha completado. El portlet no tiene errores de validación en los archivos JSP o en el código Java, y el descriptor de despliegue es correcto. Asegúrese de que la opción Crear automáticamente esté seleccionada en Preferencias del área de trabajo. Para comprobar el valor, seleccione Windows > Preferencias > Área de trabajo.
El despliegue o la comprobación de portlet en un sistema remoto ha fallado. La anomalía puede producirse con cualquiera de estas tareas:
  • Despliegue de un portlet utilizando el asistente Desplegar
  • Ejecución o depuración de un proyecto de portlet utilizando un servidor de conexión de servidor
  • Despliegue de un proyecto de portal que utiliza un proyecto de portlet
  • Ejecución o depuración de un proyecto de portal que utiliza un proyecto de portlet
Asegúrese de que el servidor esté configurado correctamente. Consulte Consideraciones de red.
El contenido de la vista Consola se trunca cuando se ejecuta o depura un proyecto en un servidor de entorno de prueba de WebSphere Portal v5.x. Asegúrese de que la opción Limitar salida de consola no esté seleccionada en Preferencias del área de trabajo. Para comprobar el valor, seleccione Window > Preferencias > Ejecutar/Depurar > Consola.
El entorno de prueba de WebSphere Portal v5.1 no se inicia cuando tiene asociados dos o más proyectos de portlet JSR 168. El entorno de prueba de WebSphere Portal v5.1 no puede iniciarse cuando dos o más proyectos de portlet JSR 168 están asociados al servidor y no tienen el atributo ID en el elemento <portlet-app> del descriptor de despliegue de portlet. Puede ocurrir el mismo problema si el atributo ID no es exclusivo. Para solucionar este problema, edite el descriptor de despliegue de portlet (portlet.xml) y añada un atributo ID con valor exclusivo al elemento <portlet-app>. Realice el cambio utilizando la página Origen al editar el descriptor de despliegue de portlet.
El despliegue de un proyecto de portlet JSR 168 en un servidor WebSphere Portal v5.0 sólo funciona una vez. Mediante las páginas administrativas de WebSphere Portal en el servidor WebSphere Portal, elimine (desinstale) los portlets JSR 168 que desee desplegar, aplique el arreglo PQ92087 al servidor de portal y, a continuación, despliegue otra vez los portlets utilizando Rational Software Development Platform.
Al importar un archivo WAR de portlet, no parecen servidores WebSphere Portal en la lista de servidores de destino. Compruebe la entrada DOCTYPE del descriptor de despliegue Web (web.xml) en el directorio WEB-INF del archivo WAR. La sintaxis correcta es:
<!DOCTYPE web-app 
PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.2//EN" 
"http://java.sun.com/j2ee/dtds/web-app_2_2.dtd">
donde la serie web-app_2_2.dtd define el nivel Web del archivo WAR. La serie web-app_2_2.dtd es para el nivel Web 2.2 ( nivel 1.2 de especificación J2EE). La serie web-app_2_3.dtd es para el nivel Web 2.3 (nivel 1.3 de especificación J2EE).

Un error común es tener un punto "." en lugar de un carácter de guión bajo "_" en el número de versión. Por ejemplo, web-app_2.2.dtd en lugar de web-app_2_2.dtd.

Si no ha importado el archivo WAR, siga estos pasos para corregir el problema:
  1. Corrija la sintaxis de la entrada DOCTYPE en el archivo web.xml.
  2. Vuelva a empaquetar el archivo WAR.
  3. Importe el archivo WAR.
Si ya ha importado el archivo WAR, siga estos pasos para corregir el problema:
  1. Arregle la entrada DOCTYPE en el descriptor de despliegue Web siguiendo estos pasos:
    1. En la vista Explorador de proyectos, realice una doble pulsación en el descriptor de despliegue Web para el proyecto de portlet. Se abre el editor de descriptor de despliegue Web.
    2. En la pestaña Origen, corrija la sintaxis de la entrada DOCTYPE.
    3. Pulse Ctrl + s para guardar el cambio.
  2. Cambie el Servidor de destino del proyecto de portlet y el proyecto EAR siguiendo estos pasos:
    1. En la vista Explorador de proyectos, resalte el proyecto de portlet. Pulse el botón derecho del ratón y seleccione Propiedades. Se abre el recuadro de diálogo Propiedades.
    2. En el panel izquierdo, resalte Servidor.
    3. En el panel derecho, cambie el destino Tiempo de ejecución de destino de un servidor WebSphere Portal. Pulse Aceptar.
    4. Repita los pasos anteriores para el proyecto EAR asociado.
Los portlets que contienen dependencias J2EE (es decir, conexiones de base de datos, proyectos EJB y JAR de utilidades dependientes) no se despliegan en un servidor de Portal remoto con proyectos de portlet o de portal.

Para obtener más información, consulte los apartados Probar y desplegar portlets que hacen referencia a módulos J2EE y Referencia a otros proyectos

Duplique el ID de objeto.

El despliegue o exportación de un proyecto de portal ha fallado. Parte del mensaje de error indica una DuplicateKeyException para la restricción de la clave primaria definida en PAGE_INST(OID).

Cuando se suprime un objeto de un servidor WebSphere Portal v5.1, el objeto se marca como suprimido pero no se elimina inmediatamente. Si después se exporta o despliega el objeto en el servidor de conexión de servidor de portal remoto, puede producirse un error de ID de objeto duplicado.

Este problema puede producirse en los escenarios siguientes:
  • Escenario 1:
    1. Importe el proyecto de portal.
    2. Suprima páginas del proyecto de portal.
    3. Despliegue o exporte el proyecto de portal.
    4. Cree páginas con nombres exclusivos idénticos en el proyecto de portal.
    5. Despliegue o exporte el proyecto de portal.
  • Escenario 2:
    1. Importe el proyecto de portal.
    2. Suprima páginas del servidor WebSphere Portal.
    3. Vuelva a desplegar o exportar el proyecto de portal al servidor WebSphere Portal.
  • Escenario 3:
    1. Importe el proyecto de portal.
    2. Suprima páginas del servidor WebSphere Portal.
    3. Vuelva a importar el proyecto de portal sin seleccionar la opción Suprimir proyecto al sobrescribir.
    4. Vuelva a desplegar o exportar el proyecto de portal al servidor WebSphere Portal.

Para resolver este problema, puede configurar WebSphere Portal para eliminar objetos inmediatamente o ejecutar una tarea de borrado individual utilizando la interfaz de configuración XML. Para obtener instrucciones, consulte el apartado Administración > Borrado retardado de páginas de portal suprimidas en la documentación del producto WebSphere Portal.

Colocación en antememoria de etiquetas y páginas

Cuando se ejecuta un proyecto de portal WebSphere Portal v5.1 en un servidor de conexión de servidor remoto, los cambios realizados en la estructura de etiquetas y páginas no aparecen inmediatamente.

Los servidores WebSphere Portal v5.1 ponen en antememoria el contenido de las páginas. Cuando ejecute un proyecto de portal en un servidor remoto, es posible que no vea cambios en el contenido de las páginas hasta después de 10 minutos, que es el valor predeterminado del tiempo de vida de la antememoria.

Para cambiar el tiempo de vida de la antememoria, cambie el valor del parámetro cacheinstance.com.ibm.wps.model.content.impl.ResourceCache.lifetime en el archivo directorio_instalación_Portal/shared/app/config/services/CacheManagerService.properties del servidor de portal remoto.

El valor es el número de segundos que el contenido permanece en antememoria. Los valores 0 o -1 indican que no hay tiempo de espera excedido.

Si cambia la estructura de las etiquetas y las páginas y los cambios no aparecen en el navegador Web, salga de la sesión de WebSphere Portal explícitamente utilizando el navegador Web y vuelva a iniciar sesión. Una vez iniciada la sesión, se mostrarán los cambios. Tenga en cuenta que es posible que no pueda cerrarse la ventana del navegador Web. Los pasos para salir de la sesión e iniciarla deben realizarse cada vez que se publica un proyecto de portal actualizado.

En algunas configuraciones que utilizan WebSphere Portal v5.0, los cambios efectuados en un proyecto de portal o de portlet no se muestran automáticamente en el navegador Web al ejecutar o depurar el proyecto utilizando un servidor de conexión de servidor remoto.
Hay dos maneras de solucionar este problema:
  • Salga de la sesión de WebSphere Portal explícitamente utilizando el navegador Web y vuelva a iniciar sesión. Una vez iniciada la sesión, se mostrarán los cambios. Tenga en cuenta que no funcionará con solo cerrar la ventana del navegador Web. Debe salir de la sesión y volver a iniciarla cada vez que se publique un proyecto de portal actualizado.
  • De forma alternativa, configure las herramientas Rational para que utilice un navegador Web externo. Para ello, seleccione Ventana > Preferencias. Amplíe la entrada Internet de la izquierda y seleccione Navegador Web. En la sección principal, seleccione cualquier navegador Web excepto el navegador Web interno. A continuación, antes de seleccionar Ejecutar en servidor o Depurar en servidor, debe cerrar el navegador Web externo antes de realizar la operación.
Anomalía de conexión de servidor al depurar en un entorno de prueba o un servidor remoto.

Si no puede conectar con un entorno de prueba o un servidor de portal remoto para depurar, y está seguro de que el servidor está configurado correctamente, el problema puede deberse a que el tiempo de espera se haya excedido al conectar con el proceso JVM en la máquina remota. Esto puede ocurrir si la máquina remota está ocupada o si la red es lenta.

Puede aumentar el valor de tiempo de espera predeterminado de tres (3) para depurar seleccionando Ventana > Preferencias > Java > Depurar, y aumentando el valor del campo Tiempo de espera del depurador.

Los portlets de cooperación no se crean mediante el navegador incorporado (Konqueror) de SuSE Linux Enterprise Server versión 9.

Para obtener más información, incluida una lista de navegadores Web que soportan los menús de los portlets de cooperación, consulte el tema Desarrollo de portlets > Portlets de cooperación > Problemas y restricciones conocidos en los portlets de cooperación en Information Center de WebSphere Portal.

Para obtener instrucciones sobre cómo definir un navegador Web alternativo, consulte Definición de navegadores Web y emuladores de dispositivos.

Los proyectos de portal con conexiones entre portlets de API de portlet IBM no se pueden desplegar ni exportar en WebSphere Portal 5.1.0.0.

Consulte las instrucciones de despliegue como requisito previo en Conexión de portlets de cooperación.

Las conexiones suprimidas de un servidor WebSphere Portal importado todavía no están disponibles en el servidor de portal remoto después del despliegue.

Solo puede eliminar conexiones de un servidor WebSphere Portal que se haya actualizado con iFix PK00815.

Si ha actualizado su servidor de portal de 5.0.2 a 5.0.2.1 y a 5.0.2.2, y utiliza DB2 V7.2 con Fixpack 7 o Fixpack 8, puede aparecer el mensaje de error La referencia de carácter "#26" es un carácter XML no válido cuando importe un proyecto de portal desde el servidor de portal. Esto se debe a un problema al actualizar el servidor de portal de 5.0.2 a 5.0.2.1 y provoca que los caracteres de doble byte se corrompan en la base de datos de portal y no sean válidos en XMLAccess.
Para solucionar este problema, deberá ejecutar manualmente dos scripts XMLAccess contra el servidor. Siga estos pasos:
  1. Exporte la configuración completa desde el servidor de portal utilizando XMLAccess:
    xmlaccess -in Export.xml -user wpsadmin -pwd wpsadmin -out serverconfig.xml -url http://hostname/wps/config
    Export.xml puede hallarse en el directorio <wps_home>/doc/xml-samples.
  2. Edite el archivo serverconfig.xml que se crea como resultado del paso anterior. Busque y sustituya todas las instancias de &#26; con un carácter ANSI, como ~. La utilización de más de un carácter puede provocar errores con el script XMLAccess, ya que pueden sobrepasarse las longitudes de serie permitidas en la base de datos de portal. Guarde este archivo.
  3. Utilice XMLAccess para reconfigurar el servidor utilizando el archivo serverconfig.xml modificado:
    xmlaccess -in serverconfig.xml -user wpsadmin -pwd wpsadmin -url http://hostname/wps/config
  4. Los proyectos de portal pueden ahora importarse desde el servidor de portal.
  5. Si lo desea, utilice RAD para corregir las traducciones de idioma nacional para las series corrompidas.

(C) Copyright IBM Corporation 2002, 2005. Reservados todos los derechos.