Notes de version de Solaris 9 12/02

Chapitre 5 Problèmes liés à la documentation

Ce chapitre décrit des problèmes connus concernant la documentation.

Les problèmes de documentation suivants ont été ajoutés à ce chapitre depuis la dernière publication de ce document sur le CD de la documentation de Solaris 9 et dans le kiosque d'installation sur le CD d'installation de Solaris 9 12/02.

Erreurs contenues dans la documentation

Document concerné : Solaris 9 Package List

Le module LDAP SUNWlldap n'est pas inclus dans la "Solaris 9 12/02 Operating Environment Package List" in Solaris 9 12/02 Package List. Le module SUNWlldap est inclus dans l'environnement d'exploitation Solaris 9 , ainsi que dans les métaclusters Core, End User, Developer, Entire et Entire+OEM.

Document concerné : la page du manuel `sysidcfg` et le Guide d'installation Solaris Solaris 9 12/02

La page du manuel portant sur sysidcfg(4) et la collection de manuels d'installation et de mise à jour Solaris 9 12/02 expliquent comment n'utiliser qu'une adresse IPv4 comme valeur de mot-clé default_route dans le fichier sysidcfg. Vous pouvez toutefois utiliser la valeur NONE au niveau du mot-clé default_route.

Document concerné : Solaris WBEM SDK Developer's Guide

Dans le schéma CIM de Solaris, les classes et propriétés suivantes sont marquées du qualificatif Deprecated.

Classe Solaris_LogRecord
Classe Solaris_LogService
Classe Solaris_LogServiceSetting
Classe Solaris_LogServiceSetting
Propriété OptionsEnabled dans la classe Solaris_IPProtocolEndpoint

Utilisez les alternatives appropriées de ces classes et propriétés désapprouvées. Reportez-vous aux qualificatifs de description de la classe pour déterminer les alternatives de classe et de propriété correctes.

Document concerné : "Writing a Client Program" in Solaris WBEM SDK Developer's Guide

Le document “Writing a Client Program” fournit des informations sur la création de clients WBEM qui utilisent le protocole RMI avec l'API javax.com.sun.client. Si vous souhaitez vous connecter à un serveur sur lequel s'exécute l'environnement d'exploitation Solaris 8, vous devez inclure le fichier /usr/sadm/lib/wbem/cimapi.jar dans le chemin CLASSPATH du client. Le fichier cimapi.jar inclut les classes com.sun.wbem requises pour communiquer avec un serveur sur lequel tourne l'environnement d'exploitation Solaris 8.

Document concerné : Sun ONE Application Server 7 Developer's Guide

Remarque :

cette documentation est liée à l'utilisation de répertoires de déploiement indexés.

La partie plan de numérotage d’un nom de répertoire d’une application déployée a été mise en oeuvre tel un mécanisme d’indexation permettant à un développeur de modifier un fichier JAR ou fichier de classe associé à l'application déployée. Ceci constitue une amélioration appréciable pour la plate-forme Windows, étant donné qu'a lieu une erreur de violation de partage lors de tentatives d'écrasement d'un fichier chargé. En effet, Windows place un verrouillage de fichier sur le fichier chargé. Le fichier est chargé dans l'instance de serveur ou dans l'environnement de développement intégré (IDE) au démarrage de la session. Lorsqu'a lieu une erreur de violation de partage, deux possibilités s'offrent à vous :

Compilez le fichier de classe mis à jour (qui faisait à l'origine partie de ce fichier JAR) puis placez-le en premier dans le chemin CLASSPATH, afin qu'il soit chargé avant les classes plus anciennes, et enfin autorisez Sun ONE Application Server à recharger cette application (à condition que le rechargement soit actif).
Procédez à la mise à jour du fichier JAR, créez un nouveau fichier EAR et redéployez l'application.

Remarque :

le redéploiement de l'application sur la plate-forme Solaris n’est pas nécessaire étant donné qu'il n’y a aucune contrainte de verrouillage du fichier.

Lorsque que des changements sont effectués dans une application déjà déployée sur la plate-forme Windows en vue d'une configuration IDE, d'une copie de fichier ANT, d'une compilation ou de toute autre opération, notez qu’un nouveau répertoire avec un numéro d'index incrémenté est créé pour pallier la contrainte de verrouillage du fichier. Par exemple, sur la plate-forme Solaris, l'application J2EE, Helloworld, est déployée vers le serveur d'applications Sun ONE. L'arborescence de ses répertoires est la suivante :

appserv/domains/domain1/server1/applications/j2ee-apps/helloworld_1

Vous devez alors effectuer une modification du servlet faisant partie de cette application déployée (par exemple, HelloServlet.java). L'environnement de développement intégré de Sun ONE Studio est lancé et le fichier source de ce servlet est modifié puis compilé à l'aide de la cible javac attribuée au répertoire mentionné ci-dessus. Si la source a été compilée à l’emplacement correct, un fichier de rechargement existe pour cette application, l’indicateur de rechargement du fichier server.xml est défini sur True et, si l'instance de serveur est exécutée, les modifications prennent effet sans qu'il ne soit nécessaire de réassembler l'application ni de la redéployer.

Sur la plate-forme Windows, il est impossible de modifier le fichier JAR ou le fichier de classe ou de le mettre à jour en raison d'un problème de verrouillage du fichier. Deux solutions sont donc possibles pour résoudre ce problème sous Windows :

Compilez le fichier source modifié puis ajoutez le fichier de classe ou le fichier JAR au début du chemin d'accès de la classe, de manière à ce que les modifications de la source soient effectives.
Effectuez les modifications dans la source de l'applet Helloworld, assemblez-le, puis redéployez-le sans en annuler le déploiement précédent.

La deuxième option est préférable, car elle débouche sur l'utilisation du numéro d'index incrémenté ajouté au nom de répertoire de l'application déployée. Voici l'apparence qu'adopte l'arborescence des répertoires de Helloworld après un deuxième déploiement :