Service Registry est un registre ebXML : un registre fédéré et un référentiel qui gère tous types de contenu électronique décrits par des métadonnées standard et évolutives. Il offre une gestion sûre et fédérée d'informations SOA (Service Oriented Architecture) et d'autre contenu et métadonnées. Il prend en charge ebXML Registry 3.0 et des protocoles de registre UDDI 3.0.
Cette rubrique présente les nouvelles fonctions et fonctionnalités ainsi que les nouveaux produits pris en charge par le logiciel Service Registry 3.1.
Le port d'accès par défaut de Service Registry a changé car la valeur de port précédente, 6060, entrait en conflit avec une valeur enregistrée auprès de l'IANA (Internet Assigned Numbers Authority) pour l'utilisation de X Window System (X11). La nouvelle valeur de port d'accès par défaut est 6480. Tous les ports par défaut de Service Registry sont désormais enregistrés auprès de l'IANA.
Tous les clients existants utilisant Java API for XML Registries (JAXR) doivent être modifiés pour utiliser la nouvelle valeur de port. Les propriétés javax.xml.registry.queryManagerURL et javax.xml.registry.lifeCycleManagerManagerURL spécifient cette valeur de port pour des clients JAXR. Une recompilation des clients est inutile si ces propriétés sont définies dans un fichier des propriétés.
Les packages Service Registry ont été renommés tel qu'indiqué dans le Tableau 1–1.
Tableau 1–1 Changements de nom de package Service Registry
Description du package |
Nom du package Java ES 4 |
Nom du package Java ES 5 |
---|---|---|
Package de développement sur Solaris |
SUNWsoar-server |
SUNWsrvc-registry-deploy |
Package de déploiement sur des systèmes Linux et HP-UX |
sun-soarserver |
sun-srvc-registry-deploy |
Package de développement sur Solaris |
SUNWsoar-sdk |
SUNWsrvc-registry-dev |
Package de développement sur des systèmes Linux et HP-UX |
sun-soarsdk |
sun-srvc-registry-dev |
Les noms de chemin d'accès d'installation de Service Registry ont également changé, tel qu'indiqué dans le Tableau 1–2.
Tableau 1–2 Changements de nom de chemin d'accès d'installation de Service Registry
Description |
Nom du chemin d'accès Java ES 4 |
Nom du chemin d'accès Java ES 5 |
---|---|---|
Répertoire d'installation de base sous Solaris |
/opt/SUNWsoar |
/opt/SUNWsrvc-registry |
Répertoire d'installation de base sous Linux et HP-UX |
/opt/sun/SUNWsoar |
/opt/sun/srvc-registry |
Répertoire d'installation de domaine et de données sous Solaris |
/var/opt/SUNWsoar |
/var/opt/SUNWsrvc-registry |
Répertoire d'installation de domaine et de données sous Linux et HP-UX |
/var/opt/sun/SUNWsoar |
/var/opt/sun/srvc-registry |
Dans la version précédente, le nom de la cible Ant utilisé pour configurer Service Registry était install. Dans la présente version, le nom cible est configure. La cible install est toujours prise en charge pour une compatibilité ascendante mais peut être supprimée dans une version ultérieure. Pour plus d'informations, reportez-vous au Chapitre 1, Configuring and Setting Up Service Registry du Service Registry 3.1 Administration Guide.
Pour obtenir la liste des fonctions d'accessibilité mises à disposition depuis la publication de ce média, consultez les évaluations de produit de la Section 508, disponibles sur demande auprès de Sun, afin de déterminer les versions les mieux adaptées au déploiement des solutions accessibles. Les mises à jour des applications sont disponibles à l'adresse http://sun.com/software/javaenterprisesystem/get.html. Pour obtenir plus d'informations sur l'engagement de Sun en matière d'accessibilité, visitez le site http://sun.com/access.
Service Registry comprend une implémentation de la version 1.0 de la spécification Java API for XML Registries (JAXR). JAXR 1.0 a été conçu de manière à prendre en charge les spécifications UDDI et ebXML Registry 2.0. L'implémentation de JAXR dans Service Registry inclut des extensions non standard de JAXR 1.0. Ces extensions d'API seront prises en compte dans une version future de la spécification JAXR afin d'être intégrées à la prochaine version standard de JAXR.
Ces extensions d'API pourront faire l'objet de modifications dans les prochaines versions de Service Registry. Sun s'efforcera de préserver la compatibilité amont avec ces API dans les versions ultérieures de Service Registry. Toutefois, la préservation de la compatibilité amont peut être impossible dans certains cas. Les clients choisissant d'utiliser ces extensions d'API sont invités à prendre conscience des modifications qui pourraient leur être apportées dans le fournisseur JAXR Service Registry dans les versions ultérieures.
Le tableau suivant indique les chemins d'accès et les noms de fichier par défaut utilisés dans ce manuel.
Tableau 1–3 Chemins d'accès et noms de fichier par défaut
Conventions |
Description |
Valeur par défaut |
---|---|---|
ServiceRegistry-base |
Représente le répertoire d'installation de base pour Service Registry. |
SE Solaris : /opt/SUNWsrvc-registry Systèmes Linux et HP-UX : /opt/sun/srvc-registry |
RegistryDomain-base |
Représente le répertoire dans lequel se trouvent le domaine Application Server pour Service Registry et la base de données de Service Registry. |
SE Solaris : /var/opt/SUNWsrvc-registry Systèmes Linux et HP-UX : /var/opt/sun/srvc-registry |
Ant-base |
Représente le répertoire dans lequel se trouvent la version de Java ES et l'outil Ant. |
SE Solaris : /usr/sfw/bin/ Systèmes Linux et HP-UX : /opt/sun/share/bin |
Cette rubrique indique la configuration minimale requise pour installer Service Registry 3.1.
La configuration minimale requise pour Service Registry est sensiblement identique à celle pour Sun Java System Application Server. L'espace disque minimum requis dans le Tableau 1–4 vient s'ajouter à l'espace disque minimum requis pour Application Server.
Tableau 1–4 Systèmes d'exploitation pris en charge
Système d'exploitation |
Mémoire minimum |
Mémoire recommandée |
Espace disque minimum |
Espace disque recommandé |
JVM |
---|---|---|---|---|---|
Sun Solaris 9, 10 (SPARC, x86) |
640 Mo |
1Go |
80 Mo disponibles |
120 Mo disponibles |
J2SE 1.4.2_10, J2SE 5_09 |
Redhat Enterprise Linux 3.0 U1, 4.0 |
640 Mo |
1Go |
65 Mo disponibles |
100 Mo disponibles |
J2SE 1.4.2_10, J2SE 5_09 |
HP-UX 11i (11.11) v1 |
640 Mo |
1Go |
65 Mo disponibles |
100 Mo disponibles |
J2SE 5_03 |
Pas de patchs en plus de ceux spécifiés pour Logiciel Java Enterprise System.
L'ensemble de documentation de Service Registry est disponible sur le site http://docs.sun.com/coll/1314.2. Pour en savoir plus sur Service Registry, reportez-vous aux manuels répertoriés dans le tableau ci-dessous.
Tableau 1–5 Documentation de Service Registry
Titre du document |
Contenu |
---|---|
Contient les informations les plus récentes concernant Service Registry, y compris les problèmes connus. |
|
Décrit comment configurer Service Registry après l'installation et comment utiliser l'outil d'administration fourni avec Registry. Explique également comment réaliser d'autres tâches d'administration. |
|
Décrit comment utiliser Service Registry Web Console pour rechercher Service Registry et y publier les données. |
|
Explique comment utiliser Java API for XML Registries (JAXR) pour effectuer des recherches dans Service Registry et publier des données dans ce dernier. |
Lorsque vous installez Service Registry, il est déployé sur Sun Java System Application Server. Pour plus d'informations sur l'administration d'Application Server, reportez-vous au Sun Java System Application Server Enterprise Edition 8.2 Administration Guide.
L'ensemble de documents relatifs à Java ES décrit la planification du déploiement et l'installation système. L'URL de la documentation système est http://docs.sun.com/coll/1286.2. Pour une présentation de Java ES, reportez-vous aux manuels dans l'ordre dans lequel ils apparaissent dans le tableau ci-dessous.
Tableau 1–6 Documentation de Logiciel Java Enterprise System
Titre du document |
Contenu |
---|---|
Sun Java Enterprise System 5 Release Notes for UNIX Sun Java Enterprise System 5 Release Notes for Microsoft Windows |
Contient les informations les plus récentes concernant Java ES, y compris les problèmes connus. En outre, les notes de version spécifiques à certains composants sont répertoriées dans la collection de notes de version (http://docs.sun.com/coll/1315.2). |
Décrit les principes techniques et conceptuels de Java ES. Décrit les composants, l'architecture, les processus et les fonctions. |
|
Présente les modalités de planification et de conception des solutions de déploiement d'entreprise basées sur Java ES. Fournit les principes et concepts fondamentaux de la planification et de la conception de déploiement, traite du cycle de vie d'une solution et fournit des exemples et des stratégies de haut niveau à utiliser lors de la planification de solutions basées sur Java ES. |
|
Vous aide à développer les spécifications d'implémentation du matériel, du système d'exploitation et des aspects réseau du déploiement de Java ES. Décrit les problèmes, comme les dépendances entre composants, à résoudre dans votre planification d'installation et de configuration. |
|
Sun Java Enterprise System 5 Installation Guide for UNIX Sun Java Enterprise System 5 Installation Guide for Microsoft Windows |
Vous guide à travers les étapes d'installation de Java ES. Il vous explique comment configurer les composants après leur installation et vous assurer de leur fonctionnement correct. |
Sun Java Enterprise System 5 Installation Reference for UNIX |
Fournit des informations supplémentaires sur les paramètres de configuration, inclut des feuilles de travail à utiliser dans votre planification de configuration, et répertorie le matériel de référence, tel que les répertoires par défaut et les numéros de port du système d'exploitation Solaris et de l'environnement d'exploitation Linux. |
Sun Java Enterprise System 5 Upgrade Guide for UNIX Sun Java Enterprise System 5 Upgrade Guide for Microsoft Windows |
Contient des instructions de mise à niveau vers Java ES 5 à partir de versions précédemment installées. |
Contient des instructions permettant de configurer la structure de contrôle pour chaque composant de produit, et d'utiliser la console de contrôle pour afficher les données en temps réel et créer des règles de contrôle. |
|
Définit les termes utilisés dans la documentation de Java ES. |
Toute la documentation concernant Java ES et ses composants se trouve à l'adresse http://docs.sun.com/prod/entsys.5.
Le tableau suivant indique les bogues rapportés pour Service Registry 3 et résolus ou clos dans Service Registry 3.1.
Tableau 1–7 Bogues résolus ou clos dans la présente version
Référence |
Description |
---|---|
6290339 |
Les objets EmailAddress ne peuvent être extraits pour les objets Organization |
6297023 |
L'affichage de ClassificationScheme persiste entre les opérations de publication |
6298088 |
Les noms de fichiers de plusieurs octets ne sont pas pris en charge pour les objets extrinsèques |
6298946 |
Une tentative de création de référence entre deux objets Organization provoque une erreur |
6301689 |
Commentaire de la version du contenu perdu lors de l'ajout d'un nouvel élément référentiel à un objet extrinsèque |
6303812 |
Des doublons de noms d'utilisateurs peuvent entraîner des messages d'erreur incohérents |
6305138 |
L'ensemble de ressources UDDI n'est pas localisé |
6305210 |
Registry ne peut pas utiliser l'environnement linguistique anglais si le domaine du serveur d'application utilise un environnement linguistique différent |
6307262 |
Les requêtes par nom extraient plusieurs copies de chaque ClassificationScheme canonique |
6312083 |
Certaines recherches renvoient des résultats inattendus |
6312094 |
L'Assistant Inscription ignore les valeurs obligatoires lors de la création d'un nom distinctif de certificat |
6312531 |
Échec des tentatives de configuration des URI pour les objets ExternalLink et ServiceBinding |
6313327 |
Échec de configuration de Service Registry après une réinstallation |
6313372 |
La traduction française d'une chaîne d'aide en ligne est incorrecte |
6313791 |
Échec de l'outil d'administration lorsque l'option -alias est utilisée |
6316300 |
Des objets créés dans un environnement linguistique non par défaut ne portent pas de nom |
6317212, 6317242, 6317489, 6317568, 6322668, 6325023 |
La console Web contient des chaînes non localisées dans des environnements linguistiques autres que l'anglais |
6318002 |
Des erreurs se produisent après la création d'un ExtrinsicObject ou d'un ExternalLink avec un concept non valide |
6323057 |
La suppression de AuditableEvent pour la création d'un objet provoque des exceptions |
6324423 |
Une tentative de consultation de l'élément référentiel avant d'avoir cliqué sur le bouton Appliquer entraîne une erreur |
6324437 |
Des objets fixés sont dupliqués lors de recherches ultérieures |
6325095 |
L'explorateur affiche des données incorrectes |
6325116 |
L'outil d'administration démarre de manière incorrecte avec l'option -locale |
6329272 |
La réinstallation de Service Registry supprime une base de données de référentiels existante |
6330540 |
Une connexion immédiatement après le redémarrage du serveur entraîne une exception |
6331538 |
Impossible d'ajouter un ClassificationNode à un nœud existant |
Les problèmes et bogues présentés ci-après concernent la version Service Registry 3.1.
Problème : Si le versionnage est activé et que vous modifiez un objet RegistryPackage afin de créer une nouvelle version de l'objet, l'intégralité du contenu du package disparaìt de la nouvelle version.
Solution : N'activez pas le versionnage. Pour de plus amples informations, reportez-vous à la rubrique Enabling Versioning of Registry Objects du Service Registry 3.1 Administration Guide.
Problème : Si le versionnage est activé et que vous ajoutez une classification à une version de l'objet, enregistrez alors l'objet. La classification existe maintenant dans l'ancienne et la nouvelle version.
Solution : N'activez pas le versionnage. Pour de plus amples informations, reportez-vous à la rubrique Enabling Versioning of Registry Objects du Service Registry 3.1 Administration Guide.
Problème : Si le versionnage est activé et que vous ajoutez un Slot, une Classification ou un ExternalIdentifier à un objet comportant un ExternalLink , le ExternalLink disparaît de la nouvelle version de l'objet.
Solution : N'activez pas le versionnage. Pour de plus amples informations, reportez-vous à la rubrique Enabling Versioning of Registry Objects du Service Registry 3.1 Administration Guide.
Problème : La spécification JAXR ne permet pas à un utilisateur de créer une association de/vers un objet désapprouvé. Le fournisseur JAXR de Service Registry permet cependant à un utilisateur de créer une telle association s'il est le propriétaire de l'objet désapprouvé.
Problème : Dans la console Web, la zone Détails d'un objet Person ne permet pas à l'utilisateur d'ajouter une PostalAddress, une EmailAddress ou un TelephoneNumber, bien qu'un objet Person contienne tous ces attributs.
Solution : Créez un objet User à la place d'un objet Person. Vous pouvez ajouter tous ces attributs à un objet User.
Problème : Une tentative d'exécution de la commande add association de l'outil d'administration pour créer une association que l'utilisateur n'est pas autorisé à exécuter entraîne un message d'erreur trompeur. Par exemple, si un utilisateur autre que l'administrateur tente de créer une association du type HasMember, le message d'erreur suivant s'affiche :
No Concept object exists for type: HasMember
Problème : Si vous utilisez la commande lcd de l'outil d'administration pour définir votre répertoire local actuel, la commande cp accepte les arguments de nom de chemin relatifs à ce répertoire. Cependant, la plupart des autres commandes n'acceptent pas ces arguments (add user, import et keystoreMover, par exemple). Pour ces commandes, vous devez spécifier un nom de chemin absolu.
Problème : Le service de catalogage WSDL conserve les fichiers XML et XSLT sur le serveur, dans le répertoire spécifié par la propriété java.io.tmpdir du fichier install.properties . De plus, le processus d'authentification de l'utilisateur conserve des fichiers commençant par .omar et portant le suffixe .jks dans ce même répertoire. Ces fichiers ne sont supprimés que lorsque le domaine Registry est arrêté.
Solution : Des fichiers portant un nom similaire au suivant peuvent être supprimés. Les caractères ????? représentent un numéro à 5 chiffres.
CanonicalXMLValidationService_OutputFile?????.xml InvocationControlFile_WSDLValidation?????.xslt
Problème : Lorsque vous utilisez le service de catalogage WSDL pour créer un service en publiant un fichier WSDL dans Registry, ce dernier crée un grand nombre d'objets faisant partie du service. Lorsque vous supprimez ou mettez à jour le service ou le fichier WSDL, ces objets ne sont pas supprimés ou mis à jour. Vous devez le faire séparément. Les objets catalogués doivent être supprimés ou mis à jour lorsque le service ou le fichier WSDL est supprimé ou mis à jour.
Problème : Lorsqu'un utilisateur sélectionne et exécute la requête FindAllMyObjects dans la console Web, les résultats obtenus incluent l'objet User de l'utilisateur à l'origine de la requête ainsi que tous les autres objets dont il est le propriétaire. Si l'utilisateur supprime cet objet par inadvertance, de graves problèmes en résultent : l'utilisateur ne peut plus intervenir sur les objets publiés comme étant cet utilisateur et il doit de nouveau s'enregistrer pour pouvoir publier des objets supplémentaires. La requête FindAllMyObjects ne doit pas afficher cet objet User. Seule la requête Obtenir l'utilisateur appelant doit l'afficher.
Solution : Veillez à ne pas supprimer votre propre objet User.
Problème : Lorsqu'un utilisateur crée un objet d'un type quelconque dans la console Web, le bouton Définition ou modification du statut n'est pas grisé. Cependant, il est impossible de définir ou de modifier l'état d'un objet si celui-ci n'a pas été préalablement créé. Si l'utilisateur clique sur ce bouton, un message d'erreur indiquant que l'objet est introuvable s'affiche.
Solution : Ne cliquez pas sur le bouton Définition ou modification du statut pour un objet que vous êtes en train de créer. Cliquez sur Appliquer pour terminer la création de l'objet, puis recherchez l'objet et modifiez son état.
Problème : Lorsque vous créez un objet, son état est Envoyé. Cependant, une fois l'objet modifié et enregistré, son état devient null. L'état de l'objet doit toujours être Envoyé à ce stade.
Dans la console Web, une fois que vous avez modifié l'objet, le texte Envoyé qui s'affiche dans le menu déroulant Statut est remplacé par le texte Sélection du statut (bogue 6501767).
Problème : Si vous cliquez sur le bouton Sélection du nœud de classification dans la zone de recherche de la console Web, le texte s'affichant à l'écran vous invite à cliquer sur OK après le choix d'un concept, alors que le nom du bouton est Fermer.
Problème : Dans la console Web, les formulaires Détails sur le nouvel utilisateur et Détails sur l'authentification de l'utilisateur contiennent des astérisques, mais n'expliquent pas qu'un astérisque désigne un champ obligatoire.
Solution : L'aide en ligne indique les champs obligatoires.
Problème : Sur les plates-formes Solaris, HP-UX et Windows, une tentative d'utilisation de l'outil de catalogage sur un fichier zippé échoue si la propriété JVM java.io.tmpdir est définie sur une valeur se terminant par une barre oblique (/). Ce problème est causé par une CatalogingException et un message indiquant que l'outil de catalogage n'a pas pu trouver l'un des fichiers dans la requête s'affiche.
Ce problème est étranger à Linux, où le paramètre par défaut de java.io.tmpdir ne se termine pas par une barre oblique.
Solution : Modifiez la valeur de la propriété java.io.tmpdir de manière qu'elle ne se termine pas par une barre oblique.
Effectuez les opérations suivantes :
Connectez-vous à la console d'administration d'Application Server, comme décrit dans la rubrique To Use the Application Server Admin Console du Service Registry 3.1 Administration Guide.
Développez le nœud Configurations.
Développez le nœud du serveur, server-config (Admin Config).
Cliquez sur Paramètres JVM.
Cliquez sur l'onglet Options JVM.
Cliquez sur Ajouter une option JVM.
Dans la zone de texte, saisissez ce qui suit (sur une seule ligne) :
Sous SE Solaris et HP-UX : -Djava.io.tmpdir=/var/tmp
Sous Windows : -Djava.io.tmpdir=c:\DOCUME~1\ADMINI~1\LOCALS~1\Temp
Cliquez sur Enregistrer.
Suivez les instructions de la rubrique To Stop and Restart the Application Server Domain for the Registry du Service Registry 3.1 Administration Guide.
Après avoir effectué ces opérations, vous devriez pouvoir publier un fichier zippé contenant plusieurs fichiers WSDL.
Problème :Si vous activez le versionnage et que vous utilisez le fournisseur JAXR pour créer un objet Organization auquel vous ajoutez un objet Service existant avant d'enregistrer l'objet Organization, le programme se referme et affiche un suivi de pile.
Problème : Si vous effectuez l'inscription de l'utilisateur dans la console Web sur un système HP-UX via Internet Explorer 6, vous ne parviendrez pas à accéder au certificat généré. Par exemple, si vous vous inscrivez, téléchargez le certificat généré, puis l'importez dans Internet Explorer 6, il est possible que vous puissiez vous connecter à Service Registry une fois, mais les tentatives de connexion ultérieures échoueront. Les échecs d'assertion sont consignés dans le fichier journal du serveur.
Solution : Utilisez un autre navigateur, tel que Firefox, pour accéder à la console Web sous HP-UX.
Cette rubrique décrit les problèmes suivants liés à la compatibilité :
Cette version de Service Registry met en œuvre son propre mécanisme d'authentification et de gestion des utilisateurs. Cela consiste à mettre à jour Registry dans une version ultérieure en un mécanisme SAML (tel que spécifié dans ebXML Registry standard dont ce composant est une implémentation).
Les bogues suivants dans Service Registry 3.1 sont liés à la compatibilité.
Problème : Si vous utilisez l'outil d'administration de Service Registry 3.1 avec Service Registry 3.0 déployé, des commandes telles que cp et rm entraînent une NullPointerException.
Solution : Utilisez l'outil d'administration de Service Registry 3.1 avec Service Registry 3.1 uniquement, et utilisez l'outil d'administration de Service Registry 3.0 avec Service Registry 3.0.
Problème : Si un programme client JAXR est exécuté dans un environnement JDK 1.6 ou si Service Registry est déployé sur un système exécutant JDK 1.6, des erreurs d'exécution surviennent lorsque le programme exécute un requête ou une opération de publication. Le problème sous-jacent est tel que JDK 1.6 utilise la version 1.3 de SOAP with Attachments API for Java (SAAJ) alors que Application Server utilise la version 1.2.
Solution : Il existe deux types de solutions requises : une pour le système client et une pour le serveur.
Si le client exécute JDK 1.6 et que le serveur exécute JDK 1.5, suivez les étapes de la rubrique Pour appliquer la solution du système client.
Si le client exécute JDK 1.5 et que le serveur exécute JDK 1.6, suivez les étapes de la rubrique Pour appliquer la solution du serveur.
Si le client et le serveur exécutent JDK 1.6, suivez les étapes des deux rubriques.
La solution du système client est requise si le système client exécute JDK 1.6. Cette solution implique les tâches suivantes :
Ajout des fichiers JAR SAAJ 1.3 au chemin de classe s'ils n'existent pas
Configuration de quatre propriétés système dans le fichier de version Ant du programme client
Veillez à ce que le chemin de classe comprenne les fichiers JAR suivants :
Sous SE Solaris :
/usr/share/lib/saaj-api.jar /usr/share/lib/saaj-impl.jar
Sous Linux et HP-UX :
/opt/sun/share/lib/saaj-api.jar /opt/sun/share/lib/saaj-impl.jar
Par exemple, le chemin de classe est correct si les cibles Ant d'un système Linux comprennent un paramètre similaire au suivant :
<path id="classpath"> <fileset dir="/opt/sun/share/lib"> <include name="*.jar"/> </fileset> ... </path>
Ajoutez les onglets <sysproperty> suivants aux cibles <java> des fichiers 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"/>
La solution du serveur implique les tâches suivantes :
Placement des fichiers JAR SAAJ 1.3 dans le répertoire lib d'Application Server
Ajout de deux options JVM pour définir des propriétés système
Arrêt et redémarrage d'Application Server
Accédez au répertoire lib d'Application Server.
Sous SE Solaris : cd /opt/SUNWappserver/appserver/lib
Sous Linux et HP-UX : cd /opt/sun/appserver/lib
Effectuez des copies de sauvegarde des deux fichiers JAR SAAJ dans le répertoire lib d'Application Server. Exemple :
cp saaj-api.jar saaj-api.jar.v1.2 cp saaj-impl.jar saaj-impl.jar.v1.2 |
Copiez les fichiers JAR SAAJ 1.3 dans le répertoire lib d'Application Server.
Sous SE Solaris :
cp /usr/share/lib/saaj-api.jar . cp /usr/share/lib/saaj-impl.jar . |
Sous Linux et HP-UX :
cp /opt/sun/share/lib/saaj-api.jar . cp /opt/sun/share/lib/saaj-impl.jar . |
Connectez-vous à la console d'administration d'Application Server tel que décrit dans la rubrique To Use the Application Server Admin Console du Service Registry 3.1 Administration Guide.
Développez le nœud Configurations.
Développez le nœud du serveur, server-config (Admin Config).
Cliquez sur Paramètres JVM.
Cliquez sur l'onglet Options JVM.
Cliquez sur Ajouter une option JVM.
Dans la zone de texte, saisissez comme suit :
-Djavax.xml.soap.MessageFactory=com.sun.xml.messaging.saaj.soap.ver1_1.SOAPMessageFactory1_1Impl |
Cliquez de nouveau sur Ajouter une option JVM.
Dans la zone de texte, saisissez comme suit :
-Djavax.xml.soap.MetaFactory=com.sun.xml.messaging.saaj.soap.SAAJMetaFactoryImpl |
Cliquez sur Enregistrer.
Suivez les instructions de la rubrique To Stop and Restart the Application Server Domain for the Registry du Service Registry 3.1 Administration Guide.
Problème : Si vous avez installé et utilisé la version précédente de Service Registry (à partir de Java ES 2005Q4) et que vous mettez maintenant votre système à niveau vers la version Java ES 5 d'Application Server sans passer à la version Java ES 5 de Service Registry, une erreur de connexion se produit lorsque vous essayez d'utiliser le certificat que vous avez précédemment créé dans la console Web.
Solution : Modifiez le fichier web.xml et le fichier de stratégies de sécurité de Service Registry.
Pour arrêter le domaine Application Server de Registry et modifier le fichier web.xml, suivez les étapes suivantes :
Accédez au répertoire d'installation de Service Registry :
Sous SE Solaris : cd /opt/SUNWsoar/install
Sous Linux et HP-UX : cd /opt/sun/SUNWsoar/install
Arrêtez le domaine Application Server de Registry :
Ant-base/ant -f build-install.xml appserver.domain.stop
Accédez au répertoire RegistryDomain-base /domains/registry/applications/j2ee-modules/soar/WEB-INF/ .
Ouvrez le fichier web.xml dans un éditeur de texte.
Dans l'onglet <security-constraint>, après l'onglet </web-resource-collection>, insérez comme suit :
<auth-constraint> <role-name>have.client.cert</role-name> </auth-constraint>
Après l'onglet </security-constraints>, insérez comme suit :
<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>
Enregistrez et fermez le fichier web.xml.
Pour modifier le fichier de stratégies de sécurité et redémarrer le domaine, suivez les étapes suivantes :
Accédez au répertoire suivant :
Solaris : cd /var/opt/SUNWsoar/domains/registry/config
Sous Linux et HP-UX : cd /var/opt/sun/SUNWsoar/domains/registry/config
Ouvrez le fichier server.policy dans un éditeur de texte.
Ajoutez les autorisations suivantes au fichier :
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"; };
Enregistrez et fermez le fichier server.policy.
Redémarrez le domaine Application Server de Registry :
Ant-base/ant -f build-install.xml appserver.domain.start
Ouvrez votre navigateur Web et accédez à l'URL http://localhost:6060/soar . Vous devez désormais pouvoir vous connecter et publier.
Problème : Si vous avez installé et utilisé la version précedente de Service Registry (à partir de Java ES 2005Q4) sur un système HP-UX et que vous mettez maintenant votre système à niveau vers la version Java ES 5 de Service Registry, l'installation échoue et un message d'erreur indiquant que le problème se situe au niveau de la base de données haute disponibilité (HADB) s'affiche. Le problème tient au fait que les packages HADB ont été installés dans ce que le programme d'installation de Java ES 5 considère comme un emplacement non configuré par défaut.
Ce problème se produit également si vous désinstallez la version Java ES 2005Q4 d'Application Server avant d'installer les versions Java ES 5 de Service Registry et d'Application Server.
Solution : Si vous avez désinstallé Application Server, vous devez supprimer les packages sun-hadb avant de procéder à la réinstallation.
Si vous effectuez directement une mise à niveau de la version Java ES 2005Q4 de Service Registry vers la version Java ES 5, les étapes sont plus compliquées :
Supprimez les packages sun-hadb.
Installez les versions Java ES 5 de Service Registry et d'Application Server.
Modifiez le fichier /opt/sun/appserver/config/asenv.conf comme suit :
Dans le répertoire /opt/sun/appserver/lib, créez un sous-répertoire nommé endorsed.
Copiez le fichier /opt/sun/javadb/lib/derby.jar dans le répertoire /opt/sun/appserver/lib/endorsed.
Les bogues suivants dans Service Registry 3.1 sont liés à la localisation.
Problème : Dans la console Web, lorsque vous modifiez l'environnement linguistique du navigateur et réinitialisez la langue, certaines étiquettes s'affichent toujours dans la langue précédente.
Solution : Cliquez sur le bouton Déconnexion ou Fin de session, puis rouvrez la session ou reconnectez-vous.
Problème : Si vous utilisez la console Web dans une langue non anglaise pour laquelle une aide en ligne existe, le lien Repères et aide associée de la page Résultats de la recherche renvoie à une page de l'aide anglaise au lieu de l'aide correspondant à votre langue.
Problème : Dans la console Web, si vous cliquez sur l'onglet Piste d'audit pour un objet dans la zone Détails, le texte figurant dans le champ Type d'événement (Créé, Mis à jour, etc.) s'affiche toujours en anglais.
Problème : Dans l'aide en ligne de la console Web, les deux dernières sections du dernier chapitre (Troubleshooting) ont été omises dans toutes les langues, excepté en anglais.
Solution : Les sections sont uniquement disponibles en anglais dans le manuel en ligne ; reportez-vous au Chapitre 4, Dépannage du Guide de l’utilisateur Service Registry 3.1.
Problème : Dans l'aide en ligne de la console Web, les références croisées à d'autres manuels (par exemple, au Service Registry 3.1 Administration Guide) ne sont pas traduites en japonais.
Problème : Dans l'Assistant Inscription de l'utilisateur de la console Web, l'ordre des champs de nom et d'adresse postale du formulaire Détails sur le nouvel utilisateur n'est pas traduit en japonais.
Problème : Dans la préface de l'aide en ligne japonaise relative à la console Web, si vous accédez à la section "Chemins et noms de fichier par défaut" et que vous cliquez sur le lien Suivant, l'erreur Page introuvable s'affiche. Le lien renvoie à une page inexistante.
Problème : Certains messages d'erreur n'ont pas été traduits dans d'autres langues que l'anglais. Par exemple, les messages d'erreur qui s'affichent lorsque vous essayez de créer un objet extrinsèque sans spécifier d'élément référentiel ou de modifier un objet ne vous appartenant pas, n'ont été que partiellement traduits.
Problème : Dans la zone Détails d'un objet de la console Web, le nom de l'objet figurant dans l'onglet Détails n'est pas traduit. Le nom de l'objet Java est utilisé à la place. L'ordre des mots est également incorrect dans la version française.
Problème : Dans la console Web, sur la page de redirection qui s'affiche lorsque vous vous connectez à Registry, la dernière ligne n'a pas été traduite en japonais.
Problème : Dans l'Assistant Inscription de l'utilisateur de la console Web, la zone de texte État ou Province du formulaire Détails sur le nouvel utilisateur a été omise dans les langues française, allemande et espagnole.
Les bogues suivants rencontrés dans Service Registry 3.1 sont liés à la documentation.
Problème : Une section ("Recherche de documentation sur les produits Sun") a été omise dans la préface de l'aide en ligne de la console Web (dans toutes les langues).
Solution : La préface complète est disponible en ligne (en anglais) dans le Guide de l’utilisateur Service Registry 3.1.
Problème : Dans la console Web, l'aide en ligne relative à l'onglet Explorer désigne incorrectement le répertoire racine de root. Le nom correct est registry.
Solution : La documentation appropriée est disponible dans la rubrique Utilisation de l’onglet Explorer du Guide de l’utilisateur Service Registry 3.1.