Notas de la versión de Service Registry 3.1

Previous: Índice

Capítulo 1 Notas de la versión de Service Registry 3.1

Service Registry es una implementación de ebXML Registry: un registro federado y un repositorio que administra todos los tipos de contenido electrónico descritos por los metadatos estándar y extensibles. Proporciona administración de información federada y segura de la Arquitectura orientada a servicios (SOA), y otros metadatos y contenido. Admite los protocolos de registro ebXML Registry 3.0 y UDDI 3.0.

Novedades de Service Registry 3.1

Este apartado proporciona información relacionada con las nuevas características, la funcionalidad y los productos admitidos en el software Service Registry 3.1.

Nuevo puerto de acceso de Service Registry

Ha cambiado el puerto de acceso predeterminado de Service Registry, ya que el valor de puerto anterior, 6060, entraba en conflicto con el valor registrado con la Agencia de asignación de números de Internet (IANA) para el uso del sistema X Window (X11). El nuevo valor de puerto de acceso predeterminado es 6480. Todos los puertos predeterminados de Service Registry se registran ahora con IANA.

Deben modificarse todos los clientes existentes que utilicen Java API for XML Registries (JAXR) para que utilicen el nuevo valor de puerto. Las propiedades javax.xml.registry.queryManagerURL y javax.xml.registry.lifeCycleManagerManagerURL especifican este valor de puerto para los clientes JARX. Si se definen estas propiedades en el archivo de propiedades, no es necesario volver a compilar los clientes.

Nuevos nombres de paquetes y de rutas de instalación de Service Registry

Se han cambiado los nombres de los paquetes de Service Registry, como se muestra en la Tabla 1–1.

Tabla 1–1 Cambios en los nombres de paquetes de Service Registry


Descripción del paquete	Nombre del paquete de Java ES 4	Nombre del paquete de Java ES 5
Paquete de implementación en el SO Solaris	`SUNWsoar-server`	`SUNWsrvc-registry-deploy`
Paquete de implementación en los sistemas Linux y HP-UX	`sun-soarserver`	`sun-srvc-registry-deploy`
Paquete de desarrollo en el SO Solaris	`SUNWsoar-sdk`	`SUNWsrvc-registry-dev`
Paquete de desarrollo en los sistemas Linux y HP-UX	`sun-soarsdk`	`sun-srvc-registry-dev`

También se han cambiado los nombres de rutas de instalación de Service Registry, como se muestra en la Tabla 1–2.

Tabla 1–2 Cambios en los nombres de rutas de instalación de Service Registry


Descripción	Nombre de ruta de Java ES 4	Nombre de ruta de Java ES5
Directorio base de instalación en el SO Solaris	`/opt/SUNWsoar`	`/opt/SUNWsrvc-registry`
Directorio base de instalación en los sistemas Linux y HP-UX	`/opt/sun/SUNWsoar`	`/opt/sun/srvc-registry`
Directorio de instalación de datos y dominios en el SO Solaris	`/var/opt/SUNWsoar`	`/var/opt/SUNWsrvc-registry`
Directorio de instalación de datos y dominios en los sistemas Linux y HP-UX	`/var/opt/sun/SUNWsoar`	`/var/opt/sun/srvc-registry`

Nuevo nombre de destino de la configuración

En la versión anterior, el nombre del destino Ant utilizado para configurar Service Registry era install. En esta versión, el nombre de destino es configure. El destino install aún se admite para proporcionar compatibilidad con versiones anteriores, pero es posible que se elimine en una próxima versión. Consulte el Capítulo 1, Configuring and Setting Up Service Registry de Service Registry 3.1 Administration Guide para obtener más información.

Funciones de accesibilidad para usuarios con discapacidades

Si desea disfrutar de las funciones de accesibilidad que se han comercializado tras la publicación de este soporte, consulte la Sección 508 de las evaluaciones de productos, que se pueden obtener de Sun previa solicitud, para determinar las versiones más adecuadas para implementar soluciones accesibles. Puede encontrar versiones modernizadas de las aplicaciones en http://sun.com/software/javaenterprisesystem/get.html. Para obtener información sobre el compromiso de Sun con respecto a la accesibilidad, visite http://sun.com/access.

Implementación de una API específica

Service Registry incluye una implementación de la versión 1.0 de la especificación Java API for XML Registries (JAXR). JAXR 1.0 se escribió de acuerdo con las especificaciones UDDI y ebXML Registry 2.0. La implementación de JAXR en Service Registry incluye extensiones no estándar de JAXR 1.0. Estas extensiones API se incluirán en una futura versión de la especificación JAXR, por lo que se consideran adiciones al futuro estándar JAXR.

Estas extensiones API están sujetas a cambios en las futuras versiones de Service Registry. Sun hará los esfuerzos necesarios para conservar la compatibilidad con versiones anteriores de estas API en las próximas versiones de Service Registry. Aunque en algunos casos, la compatibilidad con versiones anteriores no es posible. Los clientes que decidan usar estas extensiones API deben ser conscientes de los posibles cambios que pueden sufrir las extensiones en el proveedor JAXR de Service Registry en las próximas versiones.

Nombres de archivo y rutas predeterminadas

En la siguiente tabla se describen las rutas y los nombres de archivos predeterminados que se utilizan en este manual.

Tabla 1–3 Nombres de archivo y rutas predeterminadas


Convenciones de	Descripción	Valor predeterminado
`ServiceRegistry-base`	Representa el directorio base de instalación de Service Registry.	SO Solaris: `/opt/SUNWsrvc-registry` Sistemas Linux y HP-UX: `/opt/sun/srvc-registry`
`RegistryDomain-base`	Representa el directorio en el que se encuentra el dominio de Application Server para Service Registry, así como la ubicación de la base de datos de Service Registry.	SO Solaris: `/var/opt/SUNWsrvc-registry` Sistemas Linux y HP-UX: `/var/opt/sun/srvc-registry`
`Ant-base`	Representa el directorio en el que reside la versión de Java ES de la herramienta Ant.	SO Solaris: `/usr/sfw/bin/` Sistemas Linux y HP-UX: `/opt/sun/share/bin`

Requisitos de hardware y software

En este apartado, se muestran los requisitos que deben cumplirse antes de instalar Service Registry 3.1.

Los requisitos de Service Registry son, en su mayoría, iguales a los de Sun Java System Application Server. Deben cumplirse los requisitos de espacio en disco de la Tabla 1–4, además de los requisitos de espacio en disco de Application Server.

Tabla 1–4 Sistemas operativos admitidos


Sistema operativo	Memoria mínima	Memoria recomendada	Espacio en disco mínimo	Espacio en disco recomendado	JVM
Sun Solaris 9, 10 (SPARC, x86)	640 MB	1 GB	80 MB de espacio libre	120 MB de espacio libre	J2SE 1.4.2_10, J2SE 5_09
Redhat Enterprise Linux 3.0 U1, 4.0	640 MB	1 GB	65 MB de espacio libre	100 MB de espacio libre	J2SE 1.4.2_10, J2SE 5_09
HP-UX 11i (11.11) v1	640 MB	1 GB	65 MB de espacio libre	100 MB de espacio libre	J2SE 5_03

Revisiones y niveles de firmware requeridos

No se necesita ninguna revisión adicional más allá de las que aparecen documentadas para Java Enterprise System.

Documentación de Service Registry 3.1

El conjunto de documentación de Service Registry está disponible en http://docs.sun.com/coll/1314.2. Para obtener más información acerca de Service Registry, consulte los manuales que se indican en la tabla siguiente.

Tabla 1–5 Documentación de Service Registry


Título del documento	Contenido
Notas de la versión de Service Registry 3.1	Contiene la información más actualizada acerca de Service Registry, incluidos los problemas conocidos.
Service Registry 3.1 Administration Guide	Describe cómo se configura Service Registry después de instalarlo y cómo se usa la herramienta de administración que se incluye con Registry. También se indica cómo realizar otras tareas administrativas.
Guía del usuario de Service Registry 3.1	Describe cómo se usa la utilidad Web Console de Service Registry para realizar búsquedas y publicar datos en Service Registry.
Service Registry 3.1 Developer’s Guide	Describe cómo se usa Java API for XML Registries (JAXR) para realizar búsquedas y publicar datos en Service Registry.

Manuales relacionados

Cuando instale Service Registry, éste se implementará en Sun Java System Application Server. Para obtener información acerca de la administración de Application Server, consulte Sun Java System Application Server Enterprise Edition 8.2 Administration Guide.

La colección de documentos de Java ES describe cómo se planifica la implementación y la instalación del sistema. La dirección URL de la documentación del sistema es http://docs.sun.com/coll/1286.2. Si desea obtener una introducción a Java ES, consulte los manuales en el orden en que figuran en la tabla siguiente.

Tabla 1–6 Documentación de Java Enterprise System


Título del documento	Contenido
Sun Java Enterprise System 5 Release Notes for UNIX Sun Java Enterprise System 5 Release Notes for Microsoft Windows	Contiene la información más actualizada acerca de Java ES, incluidos los problemas conocidos. Además, los componentes tienen sus propias notas de la versión enumeradas en la Colección de notas de la versión (`http://docs.sun.com/coll/1315.2`).
Sun Java Enterprise System 5 Technical Overview	Presenta los fundamentos técnicos y conceptuales de Java ES. Describe los componentes, la arquitectura, los procesos y las funciones.
Sun Java Enterprise System Deployment Planning Guide	Proporciona una introducción a la planificación y el diseño de soluciones de implementación empresarial basadas en Java ES. Presenta conceptos básicos y principios relacionados con el diseño y la planificación de implementaciones, muestra el ciclo de vida de la solución, y ofrece ejemplos y estrategias de alto nivel que pueden utilizarse a la hora de planificar soluciones basadas en Java ES.
Sun Java Enterprise System 5 Installation Planning Guide	Le ayuda a desarrollar las especificaciones de implementación para el hardware, el sistema operativo y la red de la implementación de Java ES. Describe problemas a los que deberá enfrentarse al planificar la configuración y la instalación como, por ejemplo, las dependencias existentes entre los componentes.
Sun Java Enterprise System 5 Installation Guide for UNIX Sun Java Enterprise System 5 Installation Guide for Microsoft Windows	Le guía a través del proceso de instalación de Java ES. También muestra cómo se configuran los componentes después de instalarlos y cómo se comprueba si funcionan correctamente.
Sun Java Enterprise System 5 Installation Reference for UNIX	Ofrece información adicional sobre parámetros de configuración, proporciona hojas de trabajo para utilizar en la planificación de configuración e incluye una lista del material de referencia como directorios y números de puerto predeterminados en el sistema operativo Solaris y el entorno operativo Linux.
Sun Java Enterprise System 5 Upgrade Guide for UNIX Sun Java Enterprise System 5 Upgrade Guide for Microsoft Windows	Proporciona instrucciones para la actualización a Java ES 5 a partir de versiones instaladas previamente.
Sun Java Enterprise System 5 Monitoring Guide	Proporciona instrucciones para configurar Monitoring Framework para cada componente de producto, y para usar Monitoring Console con el fin de ver los datos en tiempo real y crear reglas de supervisión.
Sun Java Enterprise System Glossary	Define los términos utilizados en la documentación de Java ES.

La dirección URL para toda la documentación acerca de Java ES y sus componentes es http://docs.sun.com/prod/entsys.5.

Errores solucionados en esta versión

La siguiente tabla describe los errores detectados en Service Registry 3 y los errores solucionados o cerrados en Service Registry 3.1.

Tabla 1–7 Errores solucionados o cerrados en esta versión


Número de error	Descripción
6290339	Los objetos de `EmailAddress` no se pueden recuperar para los objetos de `Organization`.
6297023	Se sigue mostrando el `ClassificationScheme` entre las operaciones de publicación.
6298088	Los nombres de archivos multibyte no se admiten para objetos extrínsecos.
6298946	Si intenta crear una referencia entre objetos de `Organization`, se produce un error.
6301689	La información sobre la versión del contenido se pierde cuando se agrega un nuevo elemento de depósito al objeto extrínseco.
6303812	Un nombre de usuario duplicado genera un mensaje de error ambiguo.
6305138	No se ha adaptado a entorno nacional el paquete de recursos UDDI.
6305210	Registry no puede usar la configuración regional inglesa si el dominio de Application Server usa una configuración regional distinta de la inglesa.
6307262	Las consultas por nombre recuperan varias copias de cada `ClassificationScheme` canónico.
6312083	Algunas búsquedas devuelven resultados inesperados.
6312094	El Asistente de registro omite los valores requeridos cuando crea un nombre distinguido (DN) de certificado.
6312531	Al intentar definir un URI para los objetos `ExternalLink` y `ServiceBinding` , se producen errores.
6313327	La configuración de Service Registry presenta errores después de la reinstalación.
6313372	La cadena de ayuda en línea presenta una traducción al francés incorrecta.
6313791	La herramienta de administración falla cuando se utiliza la opción `-alias`.
6316300	Los objetos creados con una configuración regional no predeterminada no presentan ningún nombre.
6317212, 6317242, 6317489, 6317568, 6322668, 6325023	Web Console contiene cadenas no traducidas en las configuraciones regionales diferentes del inglés.
6318002	Se produce un error tras crear un `ExtrinsicObject` o un `ExternalLink` con un concepto no válido.
6323057	La eliminación de un `AuditableEvent` para la creación de objetos provoca excepciones.
6324423	Al intentar ver el elemento de depósito antes de hacer clic en el botón Aplicar, se produce un error.
6324437	Los objetos clavados se duplican en las búsquedas siguientes.
6325095	El explorador muestra datos incorrectos.
6325116	La herramienta de administración se inicia incorrectamente con la opción `-locale`.
6329272	La reinstalación de Service Registry elimina una base de datos de depósitos existente.
6330540	Al iniciar una sesión inmediatamente después de que se reinicie el servidor, se genera una excepción.
6331538	No se puede agregar el `ClassificationNode` al nodo existente.

Problemas y errores conocidos

Los siguientes problemas conocidos afectan al funcionamiento de la versión Service Registry 3.1.

6248218: al cambiar la versión del objeto `RegistryPackage`, se pierde su contenido

Resumen del problema: si está activado el control de versiones y se cambia un objeto RegistryPackage para crear una nueva versión de él, todo el contenido del paquete desaparece de la nueva versión.

Solución: no active el control de versiones. Consulte la sección Enabling Versioning of Registry Objects de Service Registry 3.1 Administration Guide para obtener más información.

6248293: el objeto `Classification` se añade a las versiones antigua y nueva del objeto

Resumen del problema: si con el control de versiones activado se añade una clasificación a una versión del objeto y, a continuación, se guarda dicho objeto, la clasificación existirá tanto en la versión antigua como en la nueva.

Solución: no active el control de versiones. Consulte la sección Enabling Versioning of Registry Objects de Service Registry 3.1 Administration Guide para obtener más información.

6248418: la adición de `Classification`, `ExternalIdentifier` o `Slot` tiene como efecto colateral la eliminación de `ExternalLink`

Resumen del problema: si está activado el control de versiones y se añade un objeto Slot, Classification o ExternalIdentifier a un objeto que tiene un objeto ExternalLink , el ExternalLink desaparece de la nueva versión del objeto.

Solución: no active el control de versiones. Consulte la sección Enabling Versioning of Registry Objects de Service Registry 3.1 Administration Guide para obtener más información.

6359188: el intento de crear una asociación a (o a partir de) un objeto obsoleto perteneciente al usuario no genera una excepción `IllegalStateException`.

Resumen del problema: la especificación JAXR no permite a un usuario crear una asociación a (o a partir de) un objeto que se ha dejado de utilizar. Sin embargo, el proveedor JAXR de Service Registry permite crear esta asociación si el objeto que se ha dejado de utilizar pertenece al usuario.

6374079: la información de `Person` y `User` no es idéntica.

Resumen del problema: en Web Console, el área Detalles de un objeto Person no permite al usuario agregar un objeto PostalAddress, EmailAddress o TelephoneNumber, aunque este objeto Person contenga todos estos atributos.

Solución: cree un objeto User en lugar de un objeto Person. Puede agregar todos estos atributos a un objeto User.

6407168: el comando `add association` de la herramienta de administración genera errores confusos.

Resumen del problema: al intentar emitir el comando add association de la herramienta de administración para crear una asociación para la que el usuario no tiene autorización, es posible que se muestre un mensaje de error confuso. Por ejemplo, si un usuario que no es administrador intenta crear una asociación del tipo HasMember, aparece el siguiente mensaje de error:

No Concept object exists for type: HasMember

6407195: la mayoría de los comandos de la herramienta de administración ignoran el valor `lcd`

Resumen del problema: si utiliza el comando lcd de la herramienta de administración para definir el directorio local actual, el comando cp acepta los argumentos de nombre de ruta relativos a este directorio. No obstante, no ocurre lo mismo con la mayoría del resto de comandos (add user, import y keystoreMover, por ejemplo). Para estos comandos, es preciso especificar un nombre de ruta absoluto.

6407974: una gran cantidad de archivos permanece en el directorio temporal.

Resumen del problema: el servicio de catalogación de WSDL deja archivos XML y XSLT en el servidor, en concreto, en el directorio especificado por la propiedad java.io.tmpdir del archivo install.properties . Además, el proceso de autenticación del usuario deja archivos que comienzan por .omar y con el sufijo .jks en el mismo directorio. Estos archivos no se eliminan hasta que se detiene el dominio de Registry.

Solución: los archivos con nombres similares a los siguientes pueden eliminarse. Los caracteres ????? representan un número de 5 dígitos.

CanonicalXMLValidationService_OutputFile?????.xml
InvocationControlFile_WSDLValidation?????.xslt

6436598: el catalogador de WSDL no elimina ni moderniza los objetos catalogados cuando se ha eliminado o modernizado un objeto de origen.

Resumen del problema: al utilizar el servicio de catalogación de WSDL para crear un servicio mediante la publicación de un archivo WSDL en Registry, esta aplicación crea un gran número de objetos que forman parte del servicio. Al eliminar o modernizar el servicio o el archivo WSDL, estos objetos no se eliminan ni modernizan; en su lugar, deben eliminarse o modernizarse individualmente. Los objetos catalogados deben eliminarse o modernizarse al eliminar o modernizar el servicio o el archivo WSDL.

6479361: la consulta FindAllMyObjects no debería incluir el usuario del llamador.

Resumen del problema: cuando un usuario selecciona y ejecuta una consulta FindAllMyObjects en Web Console, los resultados mostrados incluyen el objeto de User que ejecutó la consulta, junto con todos los demás objetos que pertenecen al usuario. Si el usuario elimina este objeto de forma involuntaria, se producirán graves problemas: el usuario no podrá realizar ninguna acción en los objetos publicados como ese usuario y deberá realizar de nuevo el registro de usuario para publicar más objetos. La consulta FindAllMyObjects no debería mostrar este objeto de User. Sólo la consulta GetCallersUser debería mostrar este objeto.

Solución: asegúrese de no eliminar su propio objeto de User.

6487653: el botón Establecer o cambiar estado no funciona al crear objetos

Resumen del problema: mientras un usuario está creando un objeto de cualquier tipo en Web Console, el botón Establecer o cambiar estado no aparece atenuado. Sin embargo, no es posible establecer o cambiar el estado de un objeto que aún no se ha creado. Si el usuario hace clic en este botón, aparece un mensaje de error que indica que no se encuentra el objeto.

Solución: no haga clic en el botón Establecer o cambiar estado para un objeto que esté creando. Haga clic en Aplicar para completar la creación del objeto, busque el objeto y cambie su estado.

6499274, 6501767: el estado de los objetos modificados es Nulo

Resumen del problema: si crea un objeto, éste tendrá el estado Enviado. Sin embargo, una vez modificado y guardado, su estado cambia a nulo. El objeto debería seguir teniendo el estado Enviado.

En Web Console, tras modificar el objeto, el texto del menú desplegable Estado cambia de Enviado a Seleccionar estado (error 6501767).

6500654: la descripción y el botón de la ventana Seleccionar un nodo de clasificación no coinciden

Resumen del problema: si hace clic en el botón Seleccionar un nodo de clasificación en el área Buscar de Web Console, el texto indica que se haga clic en Aceptar después de elegir un concepto, pero el nombre del botón es Cerrar.

6500668: el asistente para el registro de usuarios no explica el significado del asterisco

Resumen del problema: en Web Console, los formularios Datos del nuevo usuario y Datos de autenticación del usuario contienen asteriscos, pero los formularios no explican que el asterisco indica un campo obligatorio.

Solución: la ayuda en línea establece qué campos son obligatorios.

6502100: el catalogador de WSDL no gestiona `java.io.tmpdir` con barra diagonal inversa al final

Resumen del problema: en las plataformas Solaris, HP-UX y Windows, al intentar utilizar el catalogador de WSDL en un archivo zip se produce un error si la propiedad de JVM java.io.tmpdir está definida en un valor que termina con una barra diagonal inversa (/). El aviso de fallo consiste en una CatalogingException con un mensaje que indica que el catalogador no ha encontrado uno de los archivos de la petición.

Este problema no ocurre en Linux, donde el valor predeterminado de java.io.tmpdir no termina en una barra diagonal inversa.

Solución: cambie el valor de java.io.tmpdir de modo que no termine en una barra diagonal inversa.

Realice los siguientes pasos:

Inicie una sesión en la consola de administración de Application Server tal como se describe en la sección To Use the Application Server Admin Console de Service Registry 3.1 Administration Guide.
Expanda el nodo de configuraciones.
Expanda el nodo del servidor, server-config (Admin Config).
Haga clic en Configuración de JVM.
Haga clic en la ficha Opciones de JVM.
Haga clic en Agregar opción de JVM.
En el campo de texto, escriba lo siguiente (todo en la misma línea):

En Solaris OS y HP-UX: -Djava.io.tmpdir=/var/tmp

En Windows: -Djava.io.tmpdir=c:\DOCUME~1\ADMINI~1\LOCALS~1\Temp
Haga clic en Guardar.
Siga las instrucciones que aparecen en To Stop and Restart the Application Server Domain for the Registry de Service Registry 3.1 Administration Guide.

Una vez realizados estos pasos, podrá publicar un archivo zip que contenga varios archivos WSDL.

6507387: si está activado el control de versiones, al intentar añadir un objeto `Service` existente a un objeto `Organization`, se produce un error

Resumen del problema:si activa el control de versiones y utiliza un proveedor de JAXR para crear un objeto Organization al cual se añade un objeto Service existente antes de guardar el objeto Organization, se produce un error en el programa con un seguimiento de pila.

6513883: en los sistemas HP-UX, se produce un error en el registro de usuarios con Internet Explorer 6

Resumen del problema: si realiza un registro de usuario en Web Console en un sistema HP-UX mediante Internet Explorer 6, tendrá problemas al acceder al certificado generado. Concretamente, si registra y descarga el certificado generado y, a continuación, lo importa en Internet Explorer 6, podrá iniciar una sesión en Service Registry una vez, pero los siguientes intentos de conexión producirán un error. Los fallos de aserción aparecen en el archivo de registro del servidor.

Solución: utilice un navegador distinto, como Firefox, para acceder a Web Console en sistemas HP-UX.

Problemas de compatibilidad

En este apartado, se describen los siguientes problemas relacionados con la compatibilidad:

Funciones en extinción

Mecanismo de registro de usuarios

Esta versión de Service Registry incluye su propio mecanismo de autenticación y administración de usuarios. Está previsto modernizar Registry a un mecanismo basado en SAML en una próxima versión (como se especifica en el estándar ebXML Registry, del que este componente es una implementación).

Errores relacionados con la compatibilidad

Los siguientes errores de Service Registry 3.1 están relacionados con la compatibilidad.

6422192: se produce una excepción `NullPointerException` al utilizar la herramienta de administración de Service Registry 3.1 con Service Registry 3.0.

Resumen del problema: si utiliza la herramienta de administración de Service Registry 3.1 con una instancia implementada de Service Registry 3.0, los comandos como cp y rm generarán una excepción NullPointerException.

Solución: utilice la herramienta de administración de Service Registry 3.1 sólo con Service Registry 3.1 y la herramienta de administración de Service Registry 3.0 con Service Registry 3.0.

6463868: el programa cliente o el servidor que utiliza JDK 1.6 presenta errores.

Resumen del problema: si un programa cliente JAXR se ejecuta en un entorno de JDK 1.6 o si Service Registry se implementa en un sistema que esté ejecutando JDK 1.6, se producen errores de tiempo de ejecución cuando el programa realiza una operación de consulta o publicación. El problema subyacente consiste en que JDK 1.6 utiliza la versión 1.3 de SOAP with Attachments API for Java (SAAJ), mientras que Application Server utiliza la versión 1.2.

Solución: existen dos tipos de soluciones necesarias, una para el sistema cliente y otra para el servidor.

Si el cliente está ejecutando JDK 1.6 y el servidor está ejecutando JDK 1.5, siga los pasos incluidos en Para realizar la solución del sistema cliente.
Si el cliente está ejecutando JDK 1.5 y el servidor está ejecutando JDK 1.6, siga los pasos incluidos en Para realizar la solución del sistema del servidor.
Si el cliente y el servidor están ejecutando JDK 1.6, siga los pasos incluidos en ambas soluciones.

Para realizar la solución del sistema cliente

Es necesario llevar a cabo la solución del sistema cliente si éste ejecuta JDK 1.6. Esta solución conlleva las siguientes tareas:

Adición de los archivos JAR de SAAJ 1.3 a la ruta de clase si aún no están presentes
Definición de las cuatro propiedades del sistema en el archivo de creación de Ant para el programa cliente

Asegúrese de que la ruta de clase incluya los siguientes archivos JAR:

En SO Solaris:
```
/usr/share/lib/saaj-api.jar
/usr/share/lib/saaj-impl.jar
```
En los sistemas Linux y HP-UX:
```
/opt/sun/share/lib/saaj-api.jar
/opt/sun/share/lib/saaj-impl.jar
```
Por ejemplo, si los destinos Ant para el sistema Linux incluyen una configuración como la siguiente, la ruta de clase es correcta:
```
<path id="classpath">
  <fileset dir="/opt/sun/share/lib">
    <include name="*.jar"/>
  </fileset>
  ...
</path>
```

Agregue las siguientes etiquetas <sysproperty> a los destinos <java> en los archivos build.xml:

<sysproperty key="javax.xml.soap.MessageFactory" 
   value="com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl"/>
<sysproperty key="javax.xml.soap.MetaFactory" 
   value="com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl"/>
<sysproperty key="javax.xml.soap.SOAPConnectionFactory" 
   value="com.sun.xml.messaging.saaj.client.p2p.HttpSOAPConnectionFactory"/>
<sysproperty key="javax.xml.soap.SOAPFactory" 
   value="com.sun.xml.messaging.saaj.soap.ver1_1.SOAPFactory1_1Impl"/>

Para realizar la solución del sistema del servidor

La solución del sistema del servidor conlleva las siguientes tareas:

Ubicación de los archivos JAR de SAAJ 1.3 en el directorio lib de Application Server
Adición de dos opciones de JVM para definir las propiedades del sistema
Parada y reinicio de Application Server

Acceda al directorio lib de Application Server.

En SO Solaris: cd /opt/SUNWappserver/appserver/lib

En los sistemas Linux y HP-UX: cd /opt/sun/appserver/lib

Realice copias de seguridad de los dos archivos JAR de SAAJ en el directorio lib de Application Server. Por ejemplo:
cp saaj-api.jar saaj-api.jar.v1.2 cp saaj-impl.jar saaj-impl.jar.v1.2

Copie los archivos JAR de SAAJ 1.3 en el directorio lib de Application Server.

En SO Solaris:

cp /usr/share/lib/saaj-api.jar .
cp /usr/share/lib/saaj-impl.jar .

En los sistemas Linux y HP-UX:

cp /opt/sun/share/lib/saaj-api.jar .
cp /opt/sun/share/lib/saaj-impl.jar .

Inicie sesión en la consola de administración de Application Server, como se describe en To Use the Application Server Admin Console de Service Registry 3.1 Administration Guide.

Expanda el nodo de configuraciones.

Expanda el nodo del servidor, server-config (Admin Config).

Haga clic en Configuración de JVM.

Haga clic en la ficha Opciones de JVM.

Haga clic en Agregar opción de JVM.

Escriba lo siguiente en el campo de texto:

-Djavax.xml.soap.MessageFactory=com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl

Haga clic de nuevo en Agregar opción de JVM.

Escriba lo siguiente en el campo de texto:

-Djavax.xml.soap.MetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl

Haga clic en Guardar.

Siga las instrucciones que aparecen en To Stop and Restart the Application Server Domain for the Registry de Service Registry 3.1 Administration Guide.

6475651: el inicio de sesión de Java ES 2005Q4 Service Registry presenta errores después de modernizar Application Server.

Resumen del problema: Si ha instalado y utilizado la versión anterior de Service Registry (de Java ES 2005Q4), y actualiza a la versión Java ES 5 de Application Server pero no actualiza a la versión Java ES 5 de Service Registry, se produce un error de inicio de sesión al intentar utilizar el mismo certificado creado anteriormente con Web Console.

Solución: edite el archivo web.xml y el archivo de directivas de seguridad para Service Registry.

Para detener el dominio de Application Server de Registry y editar el archivo web.xml , siga estos pasos:

Acceda al directorio de instalación de Service Registry:

En SO Solaris: cd /opt/SUNWsoar/install

En los sistemas Linux y HP-UX: cd /opt/sun/SUNWsoar/install
Detenga el dominio de Application Server de Registry:

Ant-base/ant -f build-install.xml appserver.domain.stop
Acceda al directorio RegistryDomain-base /domains/registry/applications/j2ee-modules/soar/WEB-INF/ .
Abra el archivo web.xml en un editor de textos.
En la etiqueta <security-constraint>, inserte lo siguiente detrás de la etiqueta </web-resource-collection>:
```
<auth-constraint>
  <role-name>have.client.cert</role-name>
</auth-constraint>
```

Inserte lo siguiente detrás de la etiqueta </security-constraints>:

<error-page>
  <error-code>400</error-code>
  <location>/registry/thin/AuthenticateError.jsp</location>
</error-page>
<security-role>
  <description>all subjects who have client certificates</description>
  <role-name>have.client.cert</role-name>
</security-role>

Guarde y cierre el archivo web.xml.

Para editar el archivo de directivas de seguridad y reiniciar el dominio, siga estos pasos:

Cambie al directorio siguiente:

En SO Solaris: cd /var/opt/SUNWsoar/domains/registry/config

En los sistemas Linux y HP-UX: cd /var/opt/sun/SUNWsoar/domains/registry/config
Abra el archivo server.policy en un editor de textos.

Agregue las siguientes concesiones a este archivo:

grant codeBase "file:${com.sun.aas.instanceRoot}/applications/j2ee-modules/soar/WEB-INF/lib/-"{
       permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
};

grant codeBase "file:${com.sun.aas.instanceRoot}/generated/jsp/j2ee-modules/soar/-" {
      permission java.lang.reflect.ReflectPermission "suppressAccessChecks";
};

Guarde y cierre el archivo server.policy.
Reinicie el dominio de Application Server de Registry:

Ant-base/ant -f build-install.xml appserver.domain.start
Abra la URL http://localhost:6060/soar en el navegador web. Debería poder iniciar una sesión y realizar operaciones de publicación.

6491246: no es posible realizar actualizaciones en la plataforma HP-UX

Resumen del problema: si ha instalado y utilizado la versión anterior de Service Registry (de Java ES 2005Q4) en un sistema HP-UX, y actualiza a la versión Java ES 5 de Service Registry, la instalación producirá un mensaje de error que indica que el problema se debe a HADB (High Availability Database o Base de datos de alta disponibilidad). El problema consiste en que los paquetes de HADB se instalaron en la que el programa de instalación de Java ES 5 considera como una ubicación no predeterminada.

El problema también ocurre si se desinstala la versión Java ES 2005Q4 de Application Server y, a continuación, se instalan las versiones Java ES 5 de Service Registry y Application Server.

Solución: si ha desinstalado Application Server, debe eliminar los paquetes de sun-hadb antes de volver a instalar.

Si va a realizar una actualización directamente de la versión Java ES 2005Q4 de Service Registry a la versión Java ES 5, los pasos a seguir son más complicados:

Elimine los paquetes de sun-hadb.
Instale las versiones Java ES 5 de Service Registry y Application Server.

Edite el archivo /opt/sun/appserver/config/asenv.conf del modo siguiente:

Cambie la línea

AS_ANT="/opt/sun/share/lib/ant/bin"

por

AS_ANT="/opt/sun/bin"

Cambie la línea

AS_ANT_LIB="/opt/sun/share/lib/ant/lib"

por

AS_ANT_LIB="/opt/sun/share/lib"

Agregue las dos líneas siguientes:

AS_DERBY_INSTALL="/opt/sun/javadb"
AS_MFWK_HOME=/opt/sun/mfwk/share

En el directorio /opt/sun/appserver/lib, cree un subdirectorio con el nombre endorsed.
Copie el archivo /opt/sun/javadb/lib/derby.jar en el directorio /opt/sun/appserver/lib/endorsed.

Problemas relacionados con la traducción

Los siguientes errores de Service Registry 3.1 están relacionados con la traducción.

6276676: faltan cadenas traducidas en Web Console.

Resumen del problema: en Web Console, cuando se cambia la configuración regional del navegador y se restablece el idioma, algunas etiquetas permanecen en el idioma anterior.

Solución: haga clic en Cerrar sesión o Finalizar sesión, y reinicie la sesión o vuelva a iniciar una.

6493416: el vínculo de la ayuda en línea lleva a la página en inglés

Resumen del problema: si se utiliza Web Console en una configuración regional distinta a la inglesa para la que exista ayuda en línea disponible, el vínculo Marcador y ayuda relacionada de la página Resultados de búsqueda lleva a una página de la ayuda en inglés en lugar de hacerlo a la ayuda en la configuración regional correspondiente.

6496070: los nombres de tipo de evento no están traducidos para ninguna configuración regional

Resumen del problema: en Web Console, si hace clic en la ficha Ubicador de auditoría para un objeto en el área Detalles, el texto del campo Tipo de evento (Created, Updated, etc.) siempre aparece en inglés.

6499672: faltan dos páginas de la ayuda en línea en todas las configuraciones regionales excepto en la inglesa

Resumen del problema: en la ayuda en línea de Web Console, faltan las dos últimas secciones del último capítulo (Troubleshooting o Solución de problemas) en todas las configuraciones regionales excepto en la inglesa.

Solución: estas secciones se encuentran en el manual en línea, pero sólo en inglés; consulte el Capítulo 4, Solución de problemas de Guía del usuario de Service Registry 3.1.

6500664: existen cadenas sin traducir en la ayuda en línea correspondiente a la configuración regional japonesa

Resumen del problema: en la ayuda en línea de Web Console, las referencias cruzadas a otros manuales (por ejemplo, Service Registry 3.1 Administration Guide) no están traducidas en japonés.

6500673: el orden del nombre y las direcciones postales es incorrecto en la configuración regional japonesa

Resumen del problema: en el Asistente para el registro de usuarios de Web Console, el orden de los campos correspondientes al nombre y la dirección postal del formulario Datos del nuevo usuario no están traducidos en la configuración regional japonesa.

6500677: vínculo erróneo en la ayuda en línea para la configuración regional japonesa

Resumen del problema: en el prefacio de la ayuda en línea de Web Console correspondiente a la configuración regional japonesa, al situarse en la sección "Rutas y nombres de archivo predeterminados" y hacer clic en el vínculo Siguiente, aparece un error que indica que no se encuentra la página. El vínculo hace referencia a una página inexistente.

6509544: algunos mensajes de error no están traducidos

Resumen del problema: algunos mensajes de error no se han traducido a otras configuraciones regionales distintas de la inglesa. Por ejemplo, los mensajes de error que aparecen si intenta crear un objeto extrínseco sin especificar un elemento de depósito o si intenta modificar un objeto que no le pertenece, sólo se han traducido en parte.

6510165: los nombres de objeto de las fichas Detalles no están traducidos

Resumen del problema: en Web Console, en el área Detalles correspondiente a un objeto, el nombre del objeto que aparece en la ficha Detalles no está traducido sino que se utiliza el nombre de objeto de Java. Además, en la configuración regional francesa, el orden de las palabras no es correcto.

6510540: una línea de la página de redirección no está traducida al japonés

Resumen del problema: en Web Console, en la página de redirección que aparece al iniciar una sesión en Registry, la última línea no se ha traducido al japonés.

6515105: falta un campo de texto de registro de usuarios en algunas configuraciones regionales

Resumen del problema: en el Asistente para el registro de usuarios de Web Console, el campo de texto Estado o provincia del formulario Datos del nuevo usuario falta en las configuraciones regionales francesa, alemana y española.

Cuestiones sobre la documentación

Los siguientes errores de Service Registry 3.1 están relacionados con la documentación.

6500315: falta una página de la ayuda en línea

Resumen del problema: en la ayuda en línea de Web Console, falta una sección del prefacio (?Searching Sun Product Documentation? o Búsqueda de documentación de productos Sun) en todas las configuraciones regionales.

Solución: el prefacio completo se encuentra en línea (en inglés) en la Guía del usuario de Service Registry 3.1.

6501734: en la ayuda en línea se utiliza un nombre equivocado para el directorio de la ficha Examinar

Resumen del problema: en Web Console, la ayuda en línea sobre la ficha Examinar se refiere de forma incorrecta al nombre del directorio raíz como root. El nombre correcto sería registry.

Solución: la documentación correcta se encuentra en la sección Utilización de la ficha Examinar de Guía del usuario de Service Registry 3.1.

Previous: Índice

Capítulo 1 Notas de la versión de Service Registry 3.1

Novedades de Service Registry 3.1

Nuevo puerto de acceso de Service Registry

Nuevos nombres de paquetes y de rutas de instalación de Service Registry

Nuevo nombre de destino de la configuración

Funciones de accesibilidad para usuarios con discapacidades

Implementación de una API específica

Nombres de archivo y rutas predeterminadas

Requisitos de hardware y software

Revisiones y niveles de firmware requeridos

Documentación de Service Registry 3.1

Manuales relacionados

Errores solucionados en esta versión

Problemas y errores conocidos

6248218: al cambiar la versión del objeto RegistryPackage, se pierde su contenido

6248293: el objeto Classification se añade a las versiones antigua y nueva del objeto

6248418: la adición de Classification, ExternalIdentifier o Slot tiene como efecto colateral la eliminación de ExternalLink

6359188: el intento de crear una asociación a (o a partir de) un objeto obsoleto perteneciente al usuario no genera una excepción IllegalStateException.

6374079: la información de Person y User no es idéntica.

6407168: el comando add association de la herramienta de administración genera errores confusos.

6407195: la mayoría de los comandos de la herramienta de administración ignoran el valor lcd

6407974: una gran cantidad de archivos permanece en el directorio temporal.

6436598: el catalogador de WSDL no elimina ni moderniza los objetos catalogados cuando se ha eliminado o modernizado un objeto de origen.

6479361: la consulta FindAllMyObjects no debería incluir el usuario del llamador.

6487653: el botón Establecer o cambiar estado no funciona al crear objetos

6499274, 6501767: el estado de los objetos modificados es Nulo

6500654: la descripción y el botón de la ventana Seleccionar un nodo de clasificación no coinciden

6500668: el asistente para el registro de usuarios no explica el significado del asterisco

6502100: el catalogador de WSDL no gestiona java.io.tmpdir con barra diagonal inversa al final

6507387: si está activado el control de versiones, al intentar añadir un objeto Service existente a un objeto Organization, se produce un error

6513883: en los sistemas HP-UX, se produce un error en el registro de usuarios con Internet Explorer 6

Problemas de compatibilidad

Funciones en extinción

Mecanismo de registro de usuarios

Errores relacionados con la compatibilidad

6422192: se produce una excepción NullPointerException al utilizar la herramienta de administración de Service Registry 3.1 con Service Registry 3.0.

6463868: el programa cliente o el servidor que utiliza JDK 1.6 presenta errores.

Para realizar la solución del sistema cliente

Para realizar la solución del sistema del servidor

6475651: el inicio de sesión de Java ES 2005Q4 Service Registry presenta errores después de modernizar Application Server.

6491246: no es posible realizar actualizaciones en la plataforma HP-UX

Problemas relacionados con la traducción

6276676: faltan cadenas traducidas en Web Console.

6493416: el vínculo de la ayuda en línea lleva a la página en inglés

6496070: los nombres de tipo de evento no están traducidos para ninguna configuración regional

6499672: faltan dos páginas de la ayuda en línea en todas las configuraciones regionales excepto en la inglesa

6500664: existen cadenas sin traducir en la ayuda en línea correspondiente a la configuración regional japonesa

6500673: el orden del nombre y las direcciones postales es incorrecto en la configuración regional japonesa

6500677: vínculo erróneo en la ayuda en línea para la configuración regional japonesa

6509544: algunos mensajes de error no están traducidos

6510165: los nombres de objeto de las fichas Detalles no están traducidos

6510540: una línea de la página de redirección no está traducida al japonés

6515105: falta un campo de texto de registro de usuarios en algunas configuraciones regionales

Cuestiones sobre la documentación

6500315: falta una página de la ayuda en línea

6501734: en la ayuda en línea se utiliza un nombre equivocado para el directorio de la ficha Examinar

6248218: al cambiar la versión del objeto `RegistryPackage`, se pierde su contenido

6248293: el objeto `Classification` se añade a las versiones antigua y nueva del objeto

6248418: la adición de `Classification`, `ExternalIdentifier` o `Slot` tiene como efecto colateral la eliminación de `ExternalLink`

6359188: el intento de crear una asociación a (o a partir de) un objeto obsoleto perteneciente al usuario no genera una excepción `IllegalStateException`.

6374079: la información de `Person` y `User` no es idéntica.

6407168: el comando `add association` de la herramienta de administración genera errores confusos.

6407195: la mayoría de los comandos de la herramienta de administración ignoran el valor `lcd`

6502100: el catalogador de WSDL no gestiona `java.io.tmpdir` con barra diagonal inversa al final

6507387: si está activado el control de versiones, al intentar añadir un objeto `Service` existente a un objeto `Organization`, se produce un error

6422192: se produce una excepción `NullPointerException` al utilizar la herramienta de administración de Service Registry 3.1 con Service Registry 3.0.