Consulte la tabla siguiente para ver algunos problemas comunes y sus soluciones.
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.
Problemas | Soluciones |
---|---|
No se puede iniciar el entorno de prueba de WebSphere Portal v5.x |
|
No se puede crear un servidor para el entorno de prueba de WebSphere Portal v5.x. |
|
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:
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.
|
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
|
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:cd installdir_área de trabajo rationalsdp.exe -data directorio_espacio de trabajo 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:
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 | .
El despliegue o la comprobación de portlet en un sistema remoto ha fallado.
La anomalía puede producirse con cualquiera de estas tareas:
|
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 | .
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:
Si ya ha importado el archivo WAR, siga estos pasos para corregir el problema:
|
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 |
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:
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 WebSphere Portal. en la documentación del producto |
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:
|
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 , 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 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:
|