Notes de version de Solaris 9 12/03

Chapitre 5 Problèmes liés à la documentation

Ce chapitre décrit des problèmes connus concernant la documentation. Pour prendre connaissance des problèmes de documentation identifiés après la publication de ces notes de version, reportez-vous au document Notes de version de Solaris 9 12/03 à l'adresse http://docs.sun.com/db/doc/817-2706.

Depuis la publication de ce document sur le Solaris 9 12/03 Documentation CD et dans le kiosque d'installation sur le Solaris 9 12/03 Installation CD, les problèmes de documentation suivants ont été ajoutés à ce chapitre :

Erreurs contenues dans la documentation

Document concerné : Guide d'installation Solaris 9 12/03

L'exemple 41-8, « Installation à partir d’un CD local » indique à tort que vous pouvez spécifier une URL HTTP sécurisée comme emplacement du programme wanboot-cgi. La valeur de la variable du serveur d'initialisation doit être une URL HTTP au format : http:/addresse_ip/ chemin/wanboot-cgi.

Document concerné : “Administering DHCP (Task)” in System Administration Guide: IP Services

La rubrique, « Creating DHCP Options and Macros for Solaris Installation Parameters », devrait contenir l'information suivante concernant les limites de taille des options du vendeur DHCP :

Retenez que la somme totale des valeurs assignées à toutes les options d'une macro ne doit pas excéder 255 octets, en incluant les codes des options et les informations de longueur. Cette limite est dictée par le protocole DHCP.

En règle générale, vous devez fournir le minimum d'informations nécessaires concernant le vendeur. Pour les options requérant des chemins d'accès, vous devez utiliser des noms courts. Si vous créez des liens symboliques vers des chemins d'accès longs, vous pouvez passer les noms de liens les plus courts.

Document concerné : Sun WBEM SDK Developers Guide

Dans le schéma CIM de Solaris, les classes et propriétés suivantes sont marquées du qualificatif Deprecated (désapprouvé) :

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 Client Applications” in Sun WBEM SDK Developers Guide

Le chapitre “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 tourne le logiciel Solaris 8, vous devez inclure le fichier /usr/sadm/lib/wbem/cimapi.jar au CLASSPATH du client. Le fichier cimapi.jar comporte les classes com.sun.wbem requises pour communiquer avec un serveur sur lequel tourne le logiciel 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 schéma de numérotation d'un nom de répertoire d'application déployée a été mise en oeuvre en tant que mécanisme d'indexation. Ce mécanisme, qui permet aux développeurs de modifier un fichier JAR ou un fichier de classe associé à l'application déployée, est important pour la plate-forme Windows, car toute tentative d'écrasement de fichier partagé entraîne une erreur de violation de partage et Windows verrouille le fichier chargé. Le fichier est chargé dans l'instance de serveur ou l'IDE lors du démarrage de la session. En cas d'erreur de violation de partage, vous avez le choix entre les deux possibilités suivantes :


Remarque :

le redéploiement de l'application sur la plate-forme Solaris n'est pas nécessaire, car il n'existe aucune contrainte de verrouillage de fichier.


Lorsqu'une application déjà déployée sur la plate-forme Windows fait l'objet de changements en vue d'une configuration IDE, d'une copie de fichier ANT, d'une compilation ou de toute autre opération, tenez compte du fait qu'un nouveau répertoire avec un numéro d'index incrémenté est créé pour pallier la contrainte de verrouillage du fichier. Exemple : sur la plate-forme Solaris, l'application J2EE Helloworld est déployée sur le serveur d'applications Sun ONE. Son arborescence de répertoires se présente de la manière suivante :

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

Il est nécessaire de modifier le servlet faisant partie de cette application déployée (ex. : 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 approprié, il existe un fichier de rechargement pour cette application. L'indicateur de rechargement du fichier server.xml est défini sur True et, si l'instance du serveur tourne, les modifications prennent effet sans qu'il soit nécessaire de réassembler l'application, ni de la redéployer.

Sur la plate-forme Windows, il est impossible de modifier ou de mettre à jour le fichier JAR ou le fichier de classe en raison du verrouillage du fichier. Vous disposez de deux solutions pour résoudre ce problème sous Windows :

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. Après un deuxième déploiement, l'arborescence des répertoires de Helloworld se présente comme suit :

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

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

Le deuxième déploiement de Helloworld s'effectue alors sous helloworld_2.