| Important |
|---|
|
Avant d'utiliser le présent document et le produit associé, prenez connaissance des informations générales figurant à la section Remarques. |
LE PRESENT DOCUMENT EST LIVRE "EN L'ETAT". IBM DECLINE TOUTE RESPONSABILITE, EXPRESSE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE QUALITE MARCHANDE OU D'ADAPTATION A VOS BESOINS. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne vous sera pas applicable.
Ce document est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. Les informations qui y sont fournies sont susceptibles d'être modifiées avant que les produits décrits ne deviennent eux-mêmes disponibles. En outre, il peut contenir des informations ou des références concernant certains produits, logiciels ou services non annoncés dans ce pays. Cela ne signifie cependant pas qu'ils y seront annoncés.
Pour plus de détails, pour toute demande d'ordre technique, ou pour obtenir des exemplaires de documents IBM, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial.
Vous pouvez également consulter les serveurs Internet suivants :
Compagnie IBM France
(C) Copyright IBM France 2003. Tous droits réservés.
© Copyright International Business Machines Corporation 2000, 2003. All rights reserved.
Note to U.S. Government Users -- Documentation related to restricted rights -- Use, duplication or disclosure is subject to restrictions set forth in GSA ADP Schedule contract with IBM Corp.
Chapitre 1. Conditions d'installation requises pour IBM WebSphere Application Server - Express
Chapitre 2. Installation de WebSphere Application Server - Express sur un système Windows
Chapitre 3. Installation de WebSphere Application Server - Express sur un système Linux
Chapitre 4. Installation de WebSphere Application Server - Express sous AIX
Chapitre 5. Installation de WebSphere Application Server - Express sous Solaris
Chapitre 6. Installation de WebSphere Application Server - Express sous HP-UX
Chapitre 7. Plug-ins de sécurité du serveur Web HTTP
Chapitre 8. Installation de plug-ins de sécurité du serveur Web HTTP
La présente édition (sixième édition - novembre 2003) du Guide d'installation contient les informations suivantes concernant WebSphere Application Server - Express version 5.1 :
Consultez le site relatif au support du produit à l'adresse www.ibm.com/software/webservers/appserv/express/support.html pour obtenir les informations suivantes concernant les correctifs et le support :
Par exemple, pour effectuer une mise à niveau de 5.0, 5.0.1 ou 5.0.2 vers 5.1.
Notez les points suivants concernant WebSphere Application Server - Express V5.1 :
Ce guide est disponible aux formats HTML et Acrobat PDF, dans le répertoire racine du CD d'installation et dans le répertoire d'installation du produit. Les deux versions contiennent les mêmes informations. Vous pouvez ouvrir install.html dans n'importe quel navigateur Web. Pour ouvrir install.pdf, vous devez avoir installé le logiciel Acrobat Reader, que vous pouvez télécharger à partir de www.adobe.com/products/acrobat/readstep2.html.
Les éléments matériels suivants doivent être installés avant d'installer WebSphere Application Server - Express:
Affichage 800 x 600 minimum (1024 x 768 recommandé)
Affichage 1024 x 768 minimum minimum
Prise en charge d'une carte de communication.
Prise en charge de TCP/IP et d'une carte de communication.
Les éléments logiciels suivants doivent être installés avant d'installer WebSphere Application Server - Express :
L'un des systèmes d'exploitation suivants :
Windows 2000 Server ou Advanced Server avec Service Pack 4 ou
version ultérieure, composant de serveur éloigné uniquement
Windows 2003 Server Standard Edition, composant du serveur éloigné
uniquement
Windows 2000 Professionnel avec Service Pack 4 ou version
ultérieure, outils WebSphere Studio et composants du serveur
Windows XP SP1a Professionnel pour les outils WebSphere Studio et les
composants du serveur
Red Hat, version 7.2 pour le composant Outils WebSphere Studio,
comprenant l'environnement de test d'unité uniquement
Red Hat, version 8.0 pour le composant Outils WebSphere Studio,
comprenant l'environnement de test d'unité uniquement.
Red Hat, version AS (ou EL) 2.1 pour le composant du serveur éloigné
uniquement
SuSE, version 7.2 pour le composant Outils WebSphere Studio comprenant
l'environnement de test d'unité uniquement.
SuSE, version 8.1 pour le composant Outils Studio comprenant
l'environnement de test d'unité uniquement.
United Linux V 1.0 (Suse SLES 8), composant du serveur éloigné
uniquement
AIX 5.2 (niveau de maintenance 5200-01), composant du serveur
éloigné uniquement, avec déploiement à distance à partir de n'importe
quelle plateforme d'outils Studio prise en charge
Solaris 9 (avec le groupe de correctifs recommandé d'avril 2003),
composant serveur éloigné uniquement
HP 11iv1 (niveau de correctif, décembre 2002), composant du serveur éloigné
uniquement
Tableau 1. Langues prises en charge par les systèmes d'exploitation Red Hat et SuSE.
|
| Anglais uniquement | Anglais et une langue nationale | Jeu de caractères mono-octet (SBCS) | Jeu de caractères à double octets (DBCS) (Voir Remarque 1) |
|---|---|---|---|---|
| Red Hat 7.2 | OUI |
|
|
|
| Red Hat 8.0 |
| OUI | OUI | OUI (1) |
| SuSE 7.2 | OUI |
|
|
|
| SuSE 8.1 |
| OUI | OUI |
|
(1) Si vous souhaitez utiliser un jeu de caractères à double octets sur Red Hat 8.0, vous devez mettre à jour GTK 2.0 à l'aide de la version 2.2 ou d'une version ultérieure. Voir (Facultatif) Mise à jour de GTK à l'aide de la version 2.2.2 ou d'une version ultérieure.
Avertissements :
Si WebSphere Application Server - Express est installé et que vous installez des plug-ins de fournisseur tiers, vous devez vous procurer les plug-ins correspondants pour la version 5.1.1 et les réinstaller.
Ce module contient deux jeux de CD :
Scénarios d'installation
IMPORTANT : Vous pouvez utiliser DB2 Universal Database Express Edition sur un poste pour montrer, tester et développer des programmes d'application. Vous ne pouvez pas installer un des programmes sur un serveur de production. Consultez la licence fournie pour plus de détails.
La présente section comporte les informations relatives à l'installation de WebSphere Application Server - Express sous Windows. Les principaux composants de WebSphere Application Server - Express sont Application Server, Remote Agent Controller et WebSphere Studio Site Developer (WSSD). Vous avez la possibilité d'installer tout ou partie de ces composants. Vous devez installer Remote Agent Controller avec Application Server pour être en mesure d'administrer ce dernier à l'aide de WSSD.Vous pouvez installer WebSphere Application Server - Express à partir du CD-ROM ou des images électroniques téléchargées.
Remarque concernant l'installation :
Vous pouvez exécuter le programme d'installation en mode console interactif au lieu d'utiliser les écrans d'interface graphique de l'assistant. Le mode console peut être plus adapté aux personnes ayant des exigences en matière d'accessibilité. Le mode "-accessibility" fournit des informations vocales complémentaires aux utilisateurs finals malvoyants. Pour utiliser le mode console, exécutez cette commande à partir du répertoire setup du CD d'installation de WebSphere Application Server - Express :
Suivez les instructions pour effectuer l'installation. Remarque : L'option "-is:javaconsole" est essentielle. Si vous ne la spécifiez pas, le programme d'installation sera suspendu. "-log @NONE" désactive la journalisation afin d'éliminer les renseignements de journal destinés à la console. En cas d'incident pendant l'installation, vous devrez peut-être supprimer cette option afin de collecter des renseignements de journal.
Important : N'installez pas cette version sur une version antérieure. Vous pouvez installer cette version dans un autre répertoire, afin que les deux versions coexistent, ou désinstaller au préalable la version antérieure. Si le programme d'installation détecte une version précédente du serveur d'applications, vous pouvez effectuer la migration de la configuration du serveur vers le serveur 5.1. Pour plus de détails, reportez-vous au Guide de migration.
Important : Si vous tentez d'ouvrir un espace de travail de la version 4.0.x à partir de l'environnement IDE Studio Site Developer version 5.1.1, l'espace de travail sera converti en un espace de travail de la version 5.1.1. Les noms de projet, les fichiers source de projet et les chemins de compilation Java de projet (chemin d'accès aux classes) sont conservés. Toutefois, les paramètres de l'interface utilisateur, de débogage et la plupart des préférences sont perdus. Pour connaître la procédure à suivre pour la migration en toute sécurité des projets existants vers la version 5.1.1, voir le Guide de migration.
Par mesure de précaution, il est recommandé d'effectuer une copie de sauvegarde des espaces de travail de la version 5.x avant d'effectuer la migration vers la version 5.1.1.
Avant d'installer le produit, vérifiez les points suivants :
Pour installer WebSphere Application Server - Express à partir du premier CD d'installation du produit, procédez comme suit :
Conseils :
Important : N'installez pas l'application dans un répertoire dont le nom contient des caractères double octet ou des caractères spéciaux, tel que le dollar. Une telle opération risque de produire des effets indésirables, tels que des erreurs dans le chemin d'accès aux classes dans l'environnement de test WebSphere.
WebSphere Application Server - Express se compose de plusieurs modules téléchargeables. Chaque module correspond à une archive auto-extractible. Tous les modules sont nécessaires.
Avant d'installer le produit, vérifiez les points ci-après :
Pour installer l'image électronique de WebSphere Application Server - Express, procédez comme suit :
A l'issue de l'installation de WebSphere Application Server - Express, vous devez obtenir la structure de répertoires suivante dans le<chemin d'installation d'Express> :
Si l'un de ces répertoires contient un nombre sensiblement différent de fichiers, un incident lié à l'installation s'est probablement produit. Consultez le fichier expressInstallLog.txt dans le répertoire<ChemininstallExpress>\logs pour identifier l'incident.
Si l'installation a abouti, lancez Site Developer en sélectionnant Démarrer >Programmes > IBM WebSphere Application Server - Express 5.1 >Studio Site Developer. Une fois que Site Developer est lancé, suivez les liens de la page de bienvenue pour charger et exécuter l'un des exemples Express.
IBM Agent Controller est toujours installé sous forme de service Windows et est lancé automatiquement. IBM Agent Controller fournit le canal de communication entre Site Developer et Application Server. Sélectionnez Panneau de configuration > Outils d'administration > Services pour vérifier que le composant IBM Agent Controller est répertorié et actif. Si vous pensez qu'un incident s'est produit, examinez le fichier servicelog.log dans le répertoire <chemin d'installation d'Express>\RAC\config.
Si l'installation n'a pas abouti, consultez le fichier racInstallLog.txt dans le répertoire <ChemininstallExpress>\logs. Si le fichier racInstallLog.txt n'existe pas, cela signifie peut-être qu'une autre version du composant IBM Agent Controller est déjà installée sur le système. Désinstallez l'autre version et relancez l'installation.
Vous pouvez vérifier le fonctionnement de base de l'installation d'Application Server en exécutant la vérification de l'installation du serveur à partir de l'application First Steps. First Steps est lancée à la fin de l'installation ou vous pouvez lancer ce programme en sélectionnant Démarrer > Programmes > IBM WebSphere Application Server - Express 5.1 > First Steps.
Vous pouvez également vérifier le fonctionnement d'Application Server en exécutant le fichier <ChemininstallExpress>\Express\bin\testServer.bat. Le fichier lance et arrête le logiciel à l'aide de la configuration par défaut. Ce fichier est uniquement utilisé pour tester l'installation du serveur.
L'exécution du fichier setupwin32.exe démarre le programme d'installation Java puis retourne à l'invite de commandes. L'installation continue de s'exécuter en arrière-plan. Il existe plusieurs méthodes simples pour vérifier qu'une installation en mode silencieux a abouti :
Vous pouvez également exécuter l'installation en émettant la commande permettant d'exécuter directement le programme d'installation Java. Plusieurs paramètres de ligne de commande doivent être transmis au programme d'installation pour qu'il fonctionne correctement. Dans le répertoire util du premier CD, il existe un fichier de commandes exemple appelé syncInstall.bat qui peut permettre d'exécuter l'installation de manière synchronisée. L'invite de commandes ne s'affiche plus tant que l'installation n'est pas terminée. Vous pouvez transmettre des paramètres à la commande syncInstall.bat de la même manière qu'avec le fichier setupwin32.exe. Cette commande batch est particulièrement utile pour les scénarios d'installation en mode silencieux.
Le programme d'installation WebSphere Application Server - Express peut s'exécuter en mode silencieux. Pour installer WebSphere Application Server - Express en mode silencieux, vous devez utiliser l'option de ligne de commande -silent. Dans le cas d'une installation en mode silencieux, aucun panneau d'assistant ne s'affiche après l'exécution de la commande d'installation.
Pour exécuter l'installation en mode silencieux en appliquant les valeurs par défaut, utilisez la commande suivante :
setupwin32.exe -silent
Si vous souhaitez modifier l'emplacement par défaut de l'installation Express (IBM/WebSphere/Express), entrez :
setupwin32.exe -silent -P waseBean.installLocation=c:\<votrerépertoire>
Vous pouvez également utiliser un fichier réponse afin de définir d'autres options pour l'installation en mode silencieux. Reportez-vous à l'exemple de fichier réponse disponible sur le CD-ROM d'installation. Pour exécuter l'installation en mode silencieux à l'aide d'un fichier de réponses, entrez la commande :
setupwin32.exe -silent -options <chemin complet>\fichierréponses
Remarque : WebSphere Application Server - Express ne prend pas en charge une installation en mode silencieux à partir d'un CD lorsque vous sélectionnez la fonction WebSphere Studio Site Developer. Cette situation est due au fait que le deuxième CD est requis pour cette fonction et que le programme d'invitation ne vous invite pas à insérer le deuxième CD lors de l'exécution en mode silencieux. Pour installer la fonction WebSphere Studio Site Developer en mode silencieux, vous pouvez copier le deuxième CD sur le disque dur ou monter le CD dans une deuxième unité de CD puis utiliser l'option '-media 2=<path to second CD>' pour indiquer au programme d'installation l'emplacement de la deuxième image du CD.
Un fichier de réponses exemple est inclus avec Express dans : \util\responsefile.txt. Vous pouvez utiliser ce fichier en tant que fichier de réponses modèle.
Pour désinstaller WebSphere Application Server - Express :
Pour supprimer complètement WebSphere Application Server - Express, supprimez manuellement les répertoires restants.
Lors de la désinstallation de WebSphere Application Server - Express, le panneau qui apparaît à l'écran contient des options supplémentaires qui ne s'affichent pas lors de l'installation. Ces options supplémentaires sont des sous-fonctions de Studio Site Developer. Si vous souhaitez sélectionner ou désélectionner la fonction Studio Site Developer, vérifiez que toutes ses sous-fonctions sont sélectionnées ou désélectionnées.
Le composant IBM Agent Controller fournit le mécanisme de communication entre Studio Site Developer et Application Server. Le composant Agent Controller est installé sous forme de service Windows et est configuré pour s'exécuter avec le compte du système local. Vous pouvez utiliser le panneau de gestionnaire des services Windows pour modifier cette configuration et exécuter IBM Agent Controller avec un autre compte. Comme Agent Controller est utilisé pour lancer Application Server, le compte avec lequel Agent Controller s'exécute correspond à celui utilisé pour l'exécution du logiciel Application Server.
Vous disposez de plusieurs options pour sécuriser le lien entre Studio Site Developer et Agent Controller. La procédure d'installation configure le lien pour permettre à n'importe quel utilisateur Studio Site Developer d'établir une connexion avec Agent Controller. Vous serez amené à modifier ce paramètre de sécurité par défaut si vous utilisez Agent Controller dans un environnement de serveur de production.
Vous pouvez utiliser les fichiers <chemin_installation_Express>\RAC\bin\RACSecurityOn.bat et RACSecurityOff.bat pour activer et désactiver la sécurité de base de la connexion. Lorsque la sécurité est activée, l'utilisateur de Studio Site Developer doit indiquer un ID utilisateur et un mot de passe valides pour le système d'exploitation lors de la connexion à Agent Controller. Agent Controller transmet l'ID utilisateur et le mot de passe au système d'exploitation pour authentification. Sous Windows, les mots de passe des noms de domaine ne sont pas authentifiés. Vous devez indiquer l'ID utilisateur et le mot de passe local.
Pour que l'utilitaire SetConfig d'IBM Agent Controller puisse être exécuté, java doit être défini dans le chemin d'exécution.
Si vous installez WebSphere Application Server - Express 5.1 sur une machine sur laquelle se trouve déjà une copie de WebSphere Application Server - Express 5.0, IBM Agent Controller est mis à jour en fonction de la version 5.1.1 et configuré pour désigner le serveur Express version 5.1. Si vous souhaitez ultérieurement supprimer WebSphere Application Server - Express 5.1 et restaurer l'environnement 5.0, vous devrez réinstaller la version 5.0 de WebSphere Application Server ou du composant Studio Site Developer afin de restaurer la version 5.0 d'IBM Agent Controller. L'une ou l'autre de ces fonctions 5.0 installe IBM Agent Controller pour 5.0.
La présente section décrit les incidents et restrictions connus relatifs à l'installation et à la désinstallation de WebSphere Application Server - Express sous Windows. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, reportez-vous au fichier readme.
Si vous effectuez le mappage vers une unité réseau sans spécifier de nom d'unité (par exemple, \\computername\sharename), le message d'erreur suivant peut s'afficher lorsque vous essayez d'installer WebSphere Application Server - Express : "The wizard cannot continue because of the following error: could not load wizard specified in /wizard.inf(104)". Pour éviter cette erreur, effectuez un mappage local vers l'unité réseau en spécifiant un nom d'unité (par exemple, x:\sharename.exe).
N'installez pas le produit sur une unité Novell NetWare, car la procédure d'installation échouerait.
Vous devez vous connecter en tant qu'administrateur avant de commencer l'installation de WebSphere Application Server - Express.
L'échec d'une procédure d'installation peut parfois entraîner la copie partielle des fichiers de désinstallation dans le répertoire _uninst. Dans ce cas, le programme affiche un message indiquant que la machine virtuelle Java est introuvable lors de l'exécution de la désinstallation. Lancez alors la désinstallation manuellement en procédant comme suit :
En cas d'échec de votre installation, vous devez supprimer tous les fichiers de WebSphere Application Server - Express qui ont été installés. Si le répertoire que vous destiniez à l'installation de WebSphere Application Server - Express est vide, cela signifie que le processus d'installation a déjà supprimé les fichiers qui ont été installés et que vous pouvez supprimer le répertoire vide.
En cas d'échec de l'installation, procédez comme suit :
La présente section comporte les informations relatives à l'installation de WebSphere Application Server- Express sous Linux. Les principaux composants de WebSphere Application Server - Express sont Application Server, Remote Agent Controller et WebSphere Studio Site Developer (WSSD). Vous avez la possibilité d'installer tout ou partie de ces composants. Vous devez installer Remote Agent Controller avec Application Server pour être en mesure d'administrer ce dernier à l'aide de WSSD.
Vous pouvez installer WebSphere Application Server - Express à partir du CD-ROM ou à partir des images électroniques téléchargées.
Remarque concernant l'installation :
Vous pouvez exécuter le programme d'installation en mode console interactif au lieu d'utiliser les écrans d'interface graphique de l'assistant. Le mode console peut être plus adapté aux personnes ayant des exigences en matière d'accessibilité. Le mode "-accessibility" fournit des informations vocales complémentaires aux utilisateurs finals malvoyants. Pour utiliser le mode console, exécutez cette commande à partir du répertoire setup du CD d'installation de WebSphere Application Server - Express :
Suivez les instructions pour effectuer l'installation. Remarque : L'option "-is:javaconsole" est essentielle. Si vous ne la spécifiez pas, le programme d'installation sera suspendu. "-log @NONE" désactive la journalisation afin d'éliminer les renseignements de journal destinés à la console. En cas d'incident pendant l'installation, vous devrez peut-être supprimer cette option afin de collecter des renseignements de journal.
N'installez pas cette version sur une version antérieure. Vous pouvez installer cette version dans un autre répertoire, afin que les deux versions coexistent, ou désinstaller au préalable la version antérieure. Si le programme d'installation détecte une version précédente du serveur d'applications, vous pouvez effectuer la migration de la configuration du serveur vers le serveur 5.1. Pour plus de détails, reportez-vous au Guide de migration.
Vous trouverez les instructions nécessaires à la migration en toute sécurité des projets existants provenant d'une version antérieure de Studio Site Developer vers la version 5.1.1 dans le Guide de Migration.
Par mesure de précaution, il est recommandé d'effectuer une copie de sauvegarde des espaces de travail de la version 4.0.x et de la version 5.0 avant d'effectuer la migration vers la version 5.1.1.
Pour installer WebSphere Application Server - Express à partir du CD-ROM du produit, procédez comme suit :
Exécution de 'setupLinux' à partir d'une fenêtre de commande :Si le répertoire de travail en cours dans la fenêtre de commande est /mnt/cdrom et que vous effectuez l'installation à partir du CD, vous ne pourrez pas éjecter le premier CD de l'unité lorsque le programme vous demandera d'insérer le deuxième CD d'installation. Cela est dû au fait que le répertoire de travail de la fenêtre de commande désigne le CD, lequel semble être en cours d'utilisation. Pour que cet incident ne se produise pas, la fenêtre de commande ne doit pas contenir /mnt/cdrom comme répertoire de travail. Au lieu d'utiliser la commande ./setupLinux pour lancer l'installation, il convient donc d'utiliser le chemin d'accès complet au CD : /mnt/cdrom/setupLinux.
Exécution de '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' à partir d'une fenêtre de commande :
Vous risquez d'obtenir des erreurs de type 'mqver introuvable' et 'wempsservice introuvable'. Vous pouvez ignorer ces messages d'erreur.
Exécution de Cloudscape sur un système Linux
Pour utiliser Cloudscape sur un système Linux, utilisez le script shell EXPcview.sh fourni dans le répertoire /opt/IBM/WebSphere/Express51/Express/bin.
Avant d'installer le produit, vérifiez les points ci-après :
L'image de WebSphere Application Server - Express sur le CD-ROM Linux a été divisée en plusieurs modules pour réduire la taille des fichiers à télécharger. Chaque module correspond à une archive auto-extractible. Tous les modules sont nécessaires.
Pour installer les images électroniques de WebSphere Application Server - Express, procédez comme suit :
A l'issue de l'installation de WebSphere Application Server - Express, vous devez avoir la structure de répertoires ci-dessus dans le répertoire /opt/IBM/WebSphere/Express51 :
Si l'un de ces répertoires contient un nombre sensiblement différent de fichiers, un incident lié à l'installation s'est probablement produit. Examinez le fichier /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt afin de diagnostiquer l'incident.
Commencez par examiner le fichier /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt. Faites-le défiler vers le bas et vérifiez l'état d'avancement de l'installation. Si l'installation a abouti, lancez Site Developer en exécutant wasexpress51 ou /opt/IBM/WebSphere/Express51/SiteDeveloper/wasexpress51. Une fois que Site Developer est lancé, suivez les liens de la page de bienvenue pour charger et exécuter l'un des exemples Express.
Si l'installation n'a pas abouti, consultez le fichier expressInstallLog.txt afin de déterminer la raison de l'échec.
Si l'installation a abouti, lancez IBM Agent Controller en exécutant /opt/IBMRAC/bin/RAStart.sh. Si vous pensez qu'un incident s'est produit, examinez le fichier /opt/IBMRAC/config/servicelog.log.
Si l'installation n'a pas abouti, consultez le fichier racInstallLog.txt pour déterminer la cause de l'incident.
Vous pouvez vérifier le fonctionnement de base de l'installation d'Application Server en exécutant la vérification de l'installation du serveur à partir de l'application First Steps. First Steps est lancé à la fin de l'installation ou vous pouvez lancer ce programme à partir du menu Démarrer.
Vous pouvez également vérifier le fonctionnement d'Application Server en exécutant le script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Ce script lance et arrête le logiciel Application Server à l'aide de la configuration par défaut. Ce script est uniquement utilisé pour tester l'installation du serveur.
Le programme d'installation WebSphere Application Server - Express peut s'exécuter en mode silencieux. Pour installer WebSphere Application Server - Express en mode silencieux, vous devez utiliser l'option de ligne de commande -silent. Dans le cas d'une installation en mode silencieux, aucun panneau d'assistant ne s'affiche après l'exécution de la commande d'installation.
Pour exécuter l'installation en mode silencieux en appliquant les valeurs par défaut, utilisez la commande suivante :
./setupLinux -silent
Vous pouvez également utiliser un fichier réponse afin de définir d'autres options pour l'installation en mode silencieux. Reportez-vous à l'exemple de fichier réponse disponible sur le CD-ROM d'installation. Pour exécuter l'installation en mode silencieux à l'aide d'un fichier de réponses, entrez la commande :
./setupLinux -silent -options <chemin complet>/fichierréponses
Remarque : WebSphere Application Server - Express ne prend pas en charge une installation en mode silencieux à partir d'un CD lorsque vous sélectionnez la fonction WebSphere Studio Site Developer. Cette situation est due au fait que le deuxième CD est requis pour cette fonction et que le programme d'invitation ne vous invite pas à insérer le deuxième CD lors de l'exécution en mode silencieux. Pour installer la fonction WebSphere Studio Site Developer en mode silencieux, vous pouvez copier le deuxième CD sur le disque dur ou montez le CD dans une deuxième unité de CD puis utiliser l'option "-media 2=<path to second CD>" pour indiquer au programme d'installation l'emplacement de la deuxième image du CD.
Un fichier de réponses exemple est inclus avec Express dans : /util/responsefile.txt. Vous pouvez utiliser ce fichier en tant que fichier de réponses modèle.
Le composant IBM Agent Controller fournit le mécanisme de communication entre Studio Site Developer et Application Server.
Vous disposez de plusieurs options pour sécuriser le lien entre Studio Site Developer et Agent Controller. La procédure d'installation configure le lien pour permettre à n'importe quel utilisateur Studio Site Developer d'établir une connexion avec Agent Controller. Vous pouvez modifier ce paramètre de sécurité par défaut lorsque vous utilisez Agent Controller dans un environnement de serveur de production.
Vous pouvez utiliser les scripts /opt/IBMRAC/bin/RACSecurityOn.sh et RACSecurityOff.sh pour activer et désactiver la sécurité de base de la connexion. Lorsque la sécurité est activée, l'utilisateur de Studio Site Developer doit indiquer un ID utilisateur et un mot de passe valides pour le système d'exploitation lors de la connexion à Agent Controller. Agent Controller transmet l'ID utilisateur et le mot de passe au système d'exploitation pour authentification.
Si vous installez WebSphere Application Server - Express 5.1 sur une machine sur laquelle se trouve déjà une copie de WebSphere Application Server - Express 5.0, IBM Agent Controller est mis à jour en fonction de la version 5.1.1 et configuré pour désigner le serveur Express version 5.1. Si vous souhaitez ultérieurement supprimer WebSphere Application Server - Express 5.1 et restaurer l'environnement 5.0, vous devrez réinstaller la version 5.0 de WebSphere Application Server ou du composant Studio Site Developer afin de restaurer la version 5.0 d'IBM Agent Controller. L'une ou l'autre de ces fonctions 5.0 installe IBM Agent Controller pour version 5.0.
Avertissements :
Si vous souhaitez utiliser un jeu de caractères à double octets (DBCS) sur Red Hat 8.0, vous devez suivre la procédure ci-dessous pour mettre à jour GTK à l'aide de la version 2.2.2 ou d'une version ultérieure. Les instructions suivantes concernent GTK 2.2.2.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH
rpm -q libtiff-devel
Si ce n'est pas le cas, installez-le à partir du CD d'installation de Red Hat.
/usr/local/lib
./configure make make install /sbin/ldconfig
L'installation de GTK 2.0.6 a lieu par défaut. Pour être sûr que votre application utilise à chaque fois GTK 2.2.2, exécutez les exemples de commandes suivants à partir de la ligne de commande avant de lancer l'application.
export LD_LIBRARY_PATH=/usr/local/lib/:$LD_LIBRARY_PATH export PATH=/usr/local/bin/:$PATH /opt/IBM/WebSphereExpress/SiteDeveloper/wasexpress51
Pour en savoir plus sur l'utilisation de GTK, consultez le site Web à l'adresse developer.gnome.org/doc/API/2.2/gtk/gtk-building.html.
Pour désinstaller WebSphere Application Server - Express sous Linux, procédez comme suit :
./uninstaller
Pour supprimer complètement WebSphere Application Server - Express, supprimez manuellement les répertoires restants.
La présente section décrit les incidents et restrictions connus relatifs à l'installation et à la désinstallation de WebSphere Application Server - Express sous Linux. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, reportez-vous au fichier readme.
En cas d'échec de l'installation, procédez comme suit :
L'échec d'une procédure d'installation peut parfois entraîner la copie partielle des fichiers de désinstallation dans le répertoire _uninst. Dans ce cas, le programme affiche un message indiquant que la machine virtuelle Java est introuvable lors de l'exécution de la désinstallation. Lancez alors la désinstallation manuellement en procédant comme suit :
La présente section contient des informations sur l'installation de WebSphere Application Server - Express sous AIX. Les principaux composants de WebSphere Application Server - Express installables sous AIX sont Application Server et Remote Agent Controller. Vous avez la possibilité d'installer tout ou partie de ces composants. Vous devez installer Remote Agent Controller avec Application Server pour être en mesure d'administrer ce dernier sous AIX à l'aide de Studio Site Developer sous Windows ou Linux. Vous pouvez aussi utiliser la console d'administration basée sur le navigateur pour administrer Application Server.
Vous pouvez installer WebSphere Application Server - Express à partir du CD-ROM ou à partir des images électroniques téléchargées.
Si vous possédez une version antérieure de WebSphere Application Server - Express sur votre système, vous devez la désinstaller avant de continuer.
Il n'existe qu'un seul CD pour l'installation du produit. Pour installer WebSphere Application Server - Express à partir du CD-ROM du produit, procédez comme suit :
Avant d'installer le produit, vérifiez les points ci-après :
L'image de WebSphere Application Server - Express sur le CD-ROM AIX a été divisée en plusieurs modules pour réduire la taille des fichiers à télécharger.
Chaque module correspond à une archive auto-extractible. Tous les modules sont nécessaires. Pour installer les images électroniques de WebSphere Application Server - Express, procédez comme suit :
A l'issue de l'installation de WebSphere Application Server - Express, vous devez avoir la structure de répertoires ci-dessus dans le répertoire /opt/IBM/WebSphere/Express51 :
Si l'un de ces répertoires contient un nombre sensiblement différent de fichiers, un incident lié à l'installation s'est probablement produit. Examinez le fichier /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Commencez par examiner le fichier /opt/IBM/WebSphere/Express51/logs/expressracInstallLog.txt. Faites-le défiler vers le bas et vérifiez l'état d'avancement de l'installation. Si l'installation a abouti, lancez IBM Agent Controller en exécutant /opt/IBMRAC/bin/RAStart.sh. Si vous pensez qu'un incident s'est produit, examinez le fichier /opt/IBMRAC/config/servicelog.log.
Si l'installation n'a pas abouti, consultez le fichier racInstallLog.txt pour déterminer la cause de l'incident.
Vous pouvez vérifier le fonctionnement de base de l'installation d'Application Server en exécutant la vérification de l'installation du serveur à partir de l'application First Steps. First Steps est lancé à la fin de l'installation ou vous pouvez lancer ce programme en exécutant le script /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
Vous pouvez également vérifier le fonctionnement d'Application Server en exécutant le script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Ce script lance et arrête le logiciel Application Server à l'aide de la configuration par défaut. Ce script est uniquement utilisé pour tester l'installation du serveur.
Le programme d'installation de WebSphere Application Server - Express peut s'exécuter en mode silencieux. Pour installer WebSphere Application Serve - Express en mode silencieux, vous devez utiliser l'option de ligne de commande -silent. Dans le cas d'une installation en mode silencieux, aucun panneau d'assistant ne s'affiche après l'exécution de la commande d'installation.
Pour exécuter l'installation en mode silencieux, en appliquant toutes les valeurs par défaut, utilisez la commande suivante :
./aix/setupAIX -silent
Vous pouvez également utiliser un fichier réponse afin de définir d'autres options pour l'installation en mode silencieux. Reportez-vous à l'exemple de fichier réponse disponible sur le CD-ROM d'installation. Pour exécuter une installation en mode silencieux à l'aide d'un fichier de réponses, entrez la commande :
./aix/setupAIX -silent -options <chemin complet>/fichierréponses
Un fichier de réponses exemple est inclus avec Express dans : /util/responsefile.text Vous pouvez utiliser ce fichier en tant que fichier de réponses modèle.
Le composant IBM Agent Controller fournit le mécanisme de communication entre Studio Site Developer et Application Server.
Vous disposez de plusieurs options pour sécuriser le lien entre Studio Site Developer et Agent Controller. La procédure d'installation configure le lien pour permettre à n'importe quel utilisateur Studio Site Developer d'établir une connexion avec Agent Controller. Vous pouvez modifier ce paramètre de sécurité par défaut lorsque vous utilisez Agent Controller dans un environnement de serveur de production.
Vous pouvez utiliser les scripts /opt/IBMRAC/bin/RACSecurityOn.sh et RACSecurityOff.sh pour activer et désactiver la sécurité de base de la connexion. Lorsque la sécurité est activée, l'utilisateur de Studio Site Developer doit indiquer un ID utilisateur et un mot de passe valides pour le système d'exploitation lors de la connexion à Agent Controller. Agent Controller transmet l'ID utilisateur et le mot de passe au système d'exploitation pour authentification.
Pour désinstaller WebSphere Application Server - Express sous AIX, procédez comme suit :
./uninstaller
La présente section décrit les incidents et restrictions connus liés à l'installation et à la désinstallation de WebSphere Application Server - Express pour AIX. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, reportez-vous au fichier readme.
En cas d'échec de l'installation, procédez comme suit :
L'échec d'une procédure d'installation peut parfois entraîner la copie partielle des fichiers de désinstallation dans le répertoire _uninst. Dans ce cas, le programme affiche un message indiquant que la machine virtuelle Java est introuvable lors de l'exécution de la désinstallation. Lancez alors la désinstallation manuellement en procédant comme suit :
Si vous possédez une version antérieure de WebSphere Application Server - Express sur votre système, vous devez la désinstaller avant de continuer.
Pour installer WebSphere Application Server - Express à partir du CD-ROM du produit, procédez comme suit :
Remarque concernant l'installation :
Si vous lancez la commande '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' à partir d'une fenêtre de commande, des erreurs de type 'mqver introuvable' et 'wempsservice introuvable' peuvent être générées. Vous pouvez ignorer ces messages d'erreur.
Avant d'installer le produit, vérifiez les points ci-après :
L'image de WebSphere Application Server - Express sur le CD-ROM Solaris a été divisée en plusieurs modules pour réduire la taille des fichiers à télécharger. Chaque module correspond à une archive auto-extractible. Tous les modules sont nécessaires.
Pour installer les images électroniques de WebSphere Application Server - Express, procédez comme suit :
A l'issue de l'installation de WebSphere Application Server - Express, vous devez avoir la structure de répertoires ci-dessus dans le répertoire /opt/IBM/WebSphere/Express51 :
Si l'un de ces répertoires contient un nombre sensiblement différent de fichiers, un incident lié à l'installation s'est probablement produit. Examinez le fichier /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Le programme d'installation WebSphere Application Server - Express peut s'exécuter en mode silencieux. Pour installer WebSphere Application Server - Express en mode silencieux, vous devez utiliser l'option de ligne de commande -silent. Dans le cas d'une installation en mode silencieux, aucun panneau d'assistant ne s'affiche après l'exécution de la commande d'installation.
Pour exécuter l'installation en mode silencieux en appliquant les valeurs par défaut, utilisez la commande suivante :
./solaris/setupSolaris -silent
Vous pouvez également utiliser un fichier réponse afin de définir d'autres options pour l'installation en mode silencieux. Reportez-vous à l'exemple de fichier réponse disponible sur le CD-ROM d'installation. Pour exécuter une installation en mode silencieux à l'aide d'un fichier de réponses, entrez la commande :
./solaris/setupSolaris -silent -options <chemin complet>/fichierréponses
Pour désinstaller WebSphere Application Server - Express sous Solaris, procédez comme suit :
./uninstaller
La présente section décrit les incidents et restrictions connus liés à l'installation et à la désinstallation de WebSphere Application Server - Express pour Solaris. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, reportez-vous au fichier readme.
En cas d'échec de l'installation, procédez comme suit :
L'échec d'une procédure d'installation peut parfois entraîner la copie partielle des fichiers de désinstallation dans le répertoire _uninst. Dans ce cas, le programme affiche un message indiquant que la machine virtuelle Java est introuvable lors de l'exécution de la désinstallation. Lancez alors la désinstallation manuellement en procédant comme suit :
La présente section comporte les informations relatives à l'installation de WebSphere Application Server- Express sous HP-UX. Vous ne pouvez installer que le composant Application Server de WebSphere Application Server - Express sous HP-UX. Utilisez la console d'administration basée sur le navigateur pour administrer Application Server sous HP-UX.
Vous pouvez installer WebSphere Application Server - Express à partir du CD-ROM ou à partir des images électroniques téléchargées.
Si vous possédez une version antérieure de WebSphere Application Server - Express sur votre système, vous devez la désinstaller avant de continuer.
Pour installer WebSphere Application Server - Express à partir du CD-ROM du produit, procédez comme suit :
Remarque concernant l'installation :
Si vous lancez la commande '/opt/IBM/WebSphere/Express/AppServer/bin/collector.sh -Summary' à partir d'une fenêtre de commande, des erreurs de type 'mqver introuvable' et 'wempsservice introuvable' peuvent être générées. Vous pouvez ignorer ces messages d'erreur.
Avant d'installer le produit, vérifiez les points ci-après :
L'image de WebSphere Application Server - Express sur le CD-ROM HP/UX a été divisée en plusieurs modules pour réduire la taille des fichiers à télécharger. Chaque module correspond à une archive auto-extractible. Tous les modules sont nécessaires.
Pour installer les images électroniques de WebSphere Application Server - Express, procédez comme suit :
A l'issue de l'installation de WebSphere Application Server - Express, vous devez avoir la structure de répertoires ci-dessus dans le répertoire /opt/IBM/WebSphere/Express51 :
Si l'un de ces répertoires contient un nombre sensiblement différent de fichiers, un incident lié à l'installation s'est probablement produit. Examinez le fichier /opt/IBM/WebSphere/Express51/logs/expressInstallLog.txt.
Vous pouvez vérifier le fonctionnement de base de l'installation d'Application Server en exécutant la vérification de l'installation du serveur à partir de l'application First Steps. First Steps est lancé à la fin de l'installation ou vous pouvez lancer ce programme en exécutant le script /opt/IBM/WebSphere/Express51/Express/bin/launchFirstSteps.sh.
Vous pouvez également vérifier le fonctionnement d'Application Server en exécutant le script /opt/IBM/WebSphere/Express51/Express/bin/testServer.sh. Ce script lance et arrête le logiciel Application Server à l'aide de la configuration par défaut. Ce script est uniquement utilisé pour tester l'installation du serveur.
Le programme d'installation WebSphere Application Server - Express peut s'exécuter en mode silencieux. Pour installer WebSphere Application Server - Express en mode silencieux, vous devez utiliser l'option de ligne de commande -silent. Dans le cas d'une installation en mode silencieux, aucun panneau d'assistant ne s'affiche après l'exécution de la commande d'installation.
Pour exécuter l'installation en mode silencieux en appliquant les valeurs par défaut, utilisez la commande suivante :
./hpux/setupHPUX -silent
Vous pouvez également utiliser un fichier réponse afin de définir d'autres options pour l'installation en mode silencieux. Reportez-vous à l'exemple de fichier réponse disponible sur le CD-ROM d'installation. Pour exécuter l'installation en mode silencieux à l'aide d'un fichier de réponses, entrez la commande :
./hpux/setupHPUX -silent -options <chemin complet/fichierréponses
Pour désinstaller WebSphere Application Server - Express sous HP-UX, procédez comme suit :
./uninstaller
La présente section décrit les incidents et restrictions connus liés à l'installation et à la désinstallation de WebSphere Application Server - Express pour HP-UX. Pour obtenir plus d'informations sur les incidents et les restrictions affectant l'utilisation effective du produit, reportez-vous au fichier readme.
En cas d'échec de l'installation, procédez comme suit :
L'échec d'une procédure d'installation peut parfois entraîner la copie partielle des fichiers de désinstallation dans le répertoire _uninst. Dans ce cas, le programme affiche un message indiquant que la machine virtuelle Java est introuvable lors de l'exécution de la désinstallation. Lancez alors la désinstallation manuellement en procédant comme suit :
Bienvenue dans la fonction de plug-in de serveur Web pour WebSphere Application Server - Express.
Le plug-in de serveur Web permet aux utilisateurs de séparer la machine du serveur Web et la machine du serveur Express Application pour assurer un niveau supérieur de sécurité et de performances. Cette séparation confère généralement une plus grande souplesse à l'architecture du site Web.
Ces plug-in communiquent avec WebSphere Application Server - Express sur HTTP(S).
L'installation des plug-ins de serveur Web inclut tous les composants nécessaires à la configuration automatique des serveurs Web suivants sur les plateformes pour lesquelles ils sont pris en charge.
| Serveur Web Apache |
|
| IBM HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
Remarque #1
|
Remarques :
| Serveur Web Apache |
|
| IBM HTTP Web Server |
|
| Microsoft Internet Information System (IIS) |
|
| iPlanet (Sun ONE) Web Server |
|
| Lotus Domino Web Server |
|
| WebSphere Application Server - Express |
Voir Remarque #1 ci-dessous
|
Remarques :
Emplacement d'installation des bibliothèques et des fichiers de plug-ins. Si WebSphere Application Server - Express est installé sur le poste, l'emplacement par défaut est <répertoire_installation_Express>/Plugins.
Remarque : Le répertoire d'installation correspond au répertoire d'installation des fichiers de licence, du produit, de la JVM et de la désinstallation. Les fichiers du plug-in de serveur Web nécessaires lors de l'installation sont installés dans <RépInstall>/../AppServer.
Structure de répertoires exemple :
C:\
- Program Files
-IBM
-WebSphere
- Plugins
- AppServer
Dans un environnement à un seul niveau où le serveur Web est installé sur la même machine que le serveur Express Application, les plug-ins du serveur Web se trouvent dans le répertoire WebSphere Application Server - Express : <RépInstallExpress>/AppServer. Ainsi, vous obtenez une intégration transparente du plug-in de serveur Web avec le serveur Express Application. La conséquence est que le répertoire par défaut du fichier plugin-cfg.xml régénéré est le même répertoire que celui pour lequel le serveur Web est configuré. Il n'est donc pas nécessaire de copier ou de déplacer manuellement le fichier plugin-cfg.xml régénéré après sa régénération.
Nom d'hôte de la machine sur laquelle WebSphere Application Server - Express est exécuté. Ces informations sont collectées pour permettre l'insertion de valeurs appropriées dans le fichier de configuration du plug-in (plugin-cfg.xml). La valeur par défaut est le nom d'hôte de l'hôte local. Si WebSphere Application Server - Express est en cours d'exécution sur une machine différente, entrez le nom d'hôte de ce serveur distant.
Pour chaque plug-in de serveur Web que vous choisissez d'installer, vous devez indiquer l'emplacement de son fichier de configuration. Ce fichier doit exister pour pouvoir poursuivre l'installation.
Pour plus d'informations, reportez-vous à la section 4.0 "Modifications apportées à la configuration de mon serveur Web".
Pour plus d'informations, reportez-vous à la section 4.0 "Modifications apportées à la configuration de mon serveur Web".
Cette section décrit les modifications apportées à vos fichiers de configuration de serveur Web au cours de l'installation comme des tâches pouvant être effectuées manuellement. Ces étapes sont exécutées automatiquement par le processus d'installation et elles sont répertoriées ici pour information.
Ces modifications sont notamment l'ajout d'une référence à la bibliothèque de plug-in de serveur Web appropriée et une référence à l'emplacement du fichier de configuration du plug-in de serveur Web (plugin-cfg.xml).
Etapes de l'exécution de ces tâches
Utilisez les entrées suivantes en tant que modèle pour la configuration de votre fichier.REMARQUE : <RacineInstallplugins> correspond au répertoire racine d'installation des plug-ins WebSphere Application Server - Express.
LoadModule ibm_app_server_http_module/opt/IBM/WebSphere/ Express51/Plugins/bin/ mod_ibm_app_server_http.so WebSpherePluginConfig /opt/IBM/WebSphere/ Express51/Plugins/config/cells/plugin-cfg.xml
Remarque : La racine d'installation peut varier en fonction de la plateforme du système d'exploitation. Par exemple, la racine d'installation AIX est /opt/IBM/WebSphere/Express51/Plugins/ pour la version 5.
LoadModule ibm_app_server_http_module <RacineInstallplugins>\bin\ mod_ibm_app_server_http.dll WebSpherePluginConfig <RacineInstallplugins> \config\cells\plugin-cfg.xml
Utilisez les entrées suivantes comme modèle pour la configuration de votre fichier.
LoadModule was_ap20_module/opt/IBM/WebSphere/Express51/Plugins/bin/ mod_was_ap20_http.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/plugins/ config/cells/plugin-cfg.xml
Remarque : La racine d'installation peut varier en fonction de la plateforme du système d'exploitation. Par exemple, la racine d'installation AIX est /opt/IBM/WebSphere/Express51/Plugins/ pour la version 5.
LoadModule was_ap20_module <RacineInstallplugins>\bin\mod_was_ap20_http.dll WebSpherePluginConfig <RacineInstallplugins>\config\cells\plugin-cfg.xml
Remarque : Si la directive IBM HTTP Server 1.3.26, LoadModule ibm_app_server_http_module, est présente dans un fichier IBM HTTP Server 2.0 httpd.conf, IBM HTTP Server ne peut pas démarrer. Vous devez mettre en commentaire ou supprimer la directive pour démarrer le serveur version 2.
Utilisez les entrées suivantes comme modèle pour la configuration de votre fichier.
LoadModule app_server_http_module/opt/IBM/WebSphere/ Express51/Plugins/bin/mod_app_server_http.so WebSpherePluginConfig / opt/IBM/WebSphere/Express51/ Plugins/config/cells/plugin-cfg.xml
La plupart des serveurs Web Apache ne sont pas compilés avec le support API (EAPI) étendu. Si vous obtenez un message similaire à ce qui suit lorsque vous démarrez le serveur Web avec le plug-in mod_app_server_http.so, utilisez la version EAPI du module.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO /opt/IBM/WebSphere/AppServer/ bin/mod_app_server_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -D EAPI)
Pour utiliser le module EAPI, configurez le fichier httpd.conf de façon à ce qu'il pointe vers mod_app_server_http_eapi.so et non vers mod_app_server_http.so :
LoadModule app_server_http_module/opt/IBM/WebSphere/Express51/ Plugins/bin/mod_app_server_http_eapi.so WebSpherePluginConfig /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml
Remarque : La racine d'installation peut varier en fonction de la plateforme du système d'exploitation. Par exemple, la racine d'installation AIX est /opt/IBM/WebSphere/Express51/Plugins/ pour la version 5.
LoadModule app_server_http_module <RacineInstallplugins>\bin\mod_app_server_http.dll WebSpherePluginConfig <RacineInstallplugins>\config\cells\plugin-cfg.xml
La plupart des serveurs Web Apache ne sont pas compilés avec le support API (EAPI) étendu. Si vous obtenez un message similaire à ce qui suit lorsque vous démarrez le serveur Web avec le plug-in mod_app_server_http.dll, utilisez la version EAPI du module.
[Tue Jul 2 13:20:14 2002] [warn] Loaded DSO C:\WebSphere\AppServer\bin\ mod_app_server_http.so uses plain Apache 1.3 API, this module might crash under EAPI! (please recompile it with -D EAPI)
Pour utiliser le module EAPI, configurez le fichier httpd.conf de façon à ce qu'il pointe vers mod_app_server_http_eapi.dll et non vers mod_app_server_http.dll :
LoadModule app_server_http_module <RacineInstallplugins>\bin\mod_app_server_http_eapi.dll WebSpherePluginConfig <RacineInstallplugins>\config\cells\plugin-cfg.xml
Suivez cette procédure pour permettre au plug-in de transport HTTP de fonctionner avec Domino version 5.05 ou 5.06. L'assistant d'installation n'effectue pas cette modification. Vous devez exécuter cette procédure manuellement.
Remarque : Si des fichiers de filtre DSAPI (Domino Web Server Application Programming Interface) sont déjà spécifiés, utilisez un espace pour délimiter le fichier de plug-in de WebSphere Application Server.
Définissez la variable d'environnement WAS_HOME de façon à ce qu'elle pointe vers le répertoire racine d'installation de WebSphere Application Server.
Ajoutez la variable Plugin Config au registre sous le chemin HKEY_LOCAL_MACHINE > SOFTWARE > IBM > WebSphere Application Server > 5.1.0.0. Affectez comme valeur à cette variable l'emplacement du fichier plugin-cfg.xml, c'est-à-dire <RacineInstallplugins>\config\cells\plugin-cfg.xml.
<RacineInstallplugins> correspond au répertoire racine d'installation des plug-ins WebSphere Application Server - Express.
02/12/2001 03:05:09 PM JVM: Java virtual machine initialized WebSphere Application Server DSAPI filter loaded 02/12/2001 03:05:10 PM HTTP Web Server started
Utilisez les entrées suivantes comme modèle pour la configuration de votre fichier.
Incluez ces directives dans le fichier obj.conf :
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties=" /opt/IBM/WebSphere/Express51/Plugins/config/cells/plugin-cfg.xml" Service fn="as_handler"
Remarque : La racine d'installation peut varier en fonction de la plateforme du système d'exploitation. Par exemple, la racine d'installation AIX est /opt/IBM/WebSphere/Express51/Plugins/ pour la version 5.
Ajoutez une directive au fichier obj.conf après "<Object name=default>" :
Service fn="as_handler"
Ajoutez deux directives à la fin du fichier magnus.conf :
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="/opt/IBM/WebSphere/Express51/Plugins/bin/libns41_http.so" Init fn="as_init" bootstrap.properties="/opt/IBM/WebSphere/Express51/Plugins/ config/cells/plugin-cfg.xml"
Remarque : La racine d'installation peut varier en fonction de la plateforme du système d'exploitation. Par exemple, la racine d'installation AIX est /opt/IBM/WebSphere/Express51/Plugins/ pour la version 5.
Incluez ces directives dans le fichier obj.conf :
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<RacineInstallplugins>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <RacineInstallplugins>\config\cells\plugin-cfg.xml" Service fn="as_handler"
Ajoutez une directive au fichier obj.conf après "<Object name=default>" :
Service fn="as_handler"
Ajoutez deux directives à la fin du fichier magnus.conf :
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="<RacineInstallplugins>\bin\libns41_http.dll" Init fn="as_init" bootstrap.properties=" <RacineInstallplugins>:\config\cells\plugin-cfg.xml"
Suivez cette procédure pour reproduire manuellement la façon dont l'assistant d'installation configure le serveur du Gestionnaire des services Internet (IIS) :
<RacineInstallplugins> correspond au répertoire racine d'installation des plug-ins WebSphere Application Server - Express.
La régénération du fichier de configuration des plug-ins de serveur Web, plugin-cfg.xml, est requise après le déploiement d'applications vers WebSphere Application Server - Express.
Avec WebSphere Application Server - Express version 5.1.0, utilisez le script genPluginCfg pour regénérer le fichier plugin-cfg.xml en fonction de la configuration en cours de votre serveur WebSphere Express Application Server.
<RépInstallExpress> correspond au répertoire racine d'installation de WebSphere Application Server - Express
<RacineInstallPlugin> correspond au répertoire racine d'installation des plug-ins WebSphere Application Server - Express.
Les situations suivantes nécessitent l'édition manuelle du fichier plugin-cfg.xml :
<?xml version="1.0" encoding="ISO-8859-1" ?> <Config> <Log LogLevel="Error" Name="C:\Program Files\IBM\WebSphere\Express51\Plugins\logs\http_plugin.log" /> <VirtualHostGroup Name="default_host"> <VirtualHost Name="*:7080" /> <VirtualHost Name="*:80" /> <VirtualHost Name="*:7443" /> </VirtualHostGroup> <ServerCluster Name="server1_DefaultNode_Cluster"> <Server Name="DefaultNode_server1"> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7080" Protocol="http" /> <Transport Hostname="myHostname.raleigh.ibm.com" Port="7443" Protocol="https"> <Property name="keyring" value=" C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.kdb" /> <Property name="stashfile" value=" C:\Program Files\IBM\WebSphere\Express51\Plugins\etc\plugin-key.sth" /> </Transport> </Server> <PrimaryServers> <Server Name="DefaultNode_server1" /> </PrimaryServers> </ServerCluster> <UriGroup Name="default_host_server1_DefaultNode_Cluster_URIs"> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/UTC/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomHomePageExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/YourCoExpressExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/CustomerServiceExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/DocumentMgmtExample/*" /> <Uri AffinityCookie="JSESSIONID" AffinityURLIdentifier="jsessionid" Name="/SurveyExample/*" /> </UriGroup> <Route ServerCluster="server1_DefaultNode_Cluster" UriGroup="default_host_server1_DefaultNode_Cluster_URIs" VirtualHostGroup="default_host" /> </Config>
Lorsque votre serveur Web est installé sur une autre machine que WebSphere Application Server - Express, le fichier plugin-cfg.xml généré doit être déplacé vers le répertoire <RacineInstallPlugins>/config/cells situé sur la machine de votre serveur Web. En conséquence, les chemins d'accès référencés dans le fichier plugin-cfg.xml peuvent avoir besoin d'être modifiés manuellement. Les utilisations ultérieures du script genPluginCfg fusionneront les mises à jour et conserveront vos mises à jour manuelles des entrées de chemin d'accès.
Exemple : export SHLIB_PATH=/usr/lib:/lib
Le CD-ROM du produit est au format ISO-9660 avec l'extension Rockridge. Il est possible que vous ayez à monter le CD-ROM manuellement. Le montage ou le démontage du CD_ROM nécessite que l'utilisateur dispose de privilèges root.
Suivez ces instructions pour le montage du CD_ROM sous HP-UX
/usr/sbin/pfs_mountd &
/usr/sbin/pfsd &
<device_file> <mount_point> <filesystem_type> <translation_method>
Exemple : /dev/dsk/c0t0d0 /cdrom pfs-rrip ro,suid 0 0
/usr/sbin/pfs_mount /cdrom
/usr/sbin/pfs_umount /cdrom
Exemple : export WAS_HOME=/opt/IBM/WebSphere/Express51/Plugins
WebSphere Application Server - Express, version 5.1 inclut une application pré-installée nommée Snoop permettant de vérifier si le plug-in de serveur Web est installé correctement. Le fichier de configuration du plug-in de serveur Web, plugin-cfg.xml, installé lors de l'installation des plug-ins du serveur Web est pré-configuré pour tester l'application Snoop. Toutefois, vous pouvez également regénérer le plug-in de serveur Web en suivant les instructions de cette documentation.
CONSEIL : N'oubliez pas de redémarrer le serveur Web une fois la regénération du fichier de configuration du plug-in effectuée.
Procédure de test du plug-in de serveur Web
http://NomHôte:7080
CONSEIL : Si le démarrage du serveur Web n'aboutit pas, reportez-vous à la section "Conseils pour la résolution des incidents" de ce document pour savoir comment résoudre l'incident.
REMARQUE : N'indiquez par le transport interne, 7080, de WebSphere Express Application Server. Le plug-in de serveur Web se comporte comme un proxy du serveur utilisant le transport interne 7080. L'URL suivante suppose que que votre serveur écoute sur le port HTTP par défaut 80.
http://nomHôte
Si le plug-in de serveur Web est installé et configuré correctement, la page Web de l'application par défaut de WebSphere Application Server sera affichée dans votre navigateur.
Pour commencer : Généralement, le serveur Web ne démarre pas après la configuration du plug-in du serveur Web car le fichier plugin-cfg.xml contient des informations non valides ou incorrectes et ne peuvent être analysées par le serveur Web. Ce problème est, la plupart du temps, généré par une des situations suivantes :
Si vous rencontrez des difficultés avec le composant de plug-in HTTP, c'est-à-dire le composant qui envoie les requêtes depuis votre serveur HTTP, tel qu'IBM HTTP Server, Apache ou IIS, à Websphere Application Server - Express, essayez la procédure suivante :
Si ces fichiers ne révèlent pas l'origine de l'incident, exécutez la procédure supplémentaire suivante :
Procédure d'identification des incidents relatifs aux plug-ins
Le plug-in fournit une fonction de trace très lisible qui peut favoriser l'identification de l'incident. Définissez l'attribut LogLevel du fichier config/plugin-cfg.xml sur la valeur Trace pour suivre le traitement de la requête et voir ce qui ne va pas. A un niveau supérieur :
Vous pouvez voir cette séquence très clairement lorsque vous lisez l'ensemble de la trace correspondant à une requête simple :
[Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: --------------------System Information-------------------- [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Bld date: Jul 3 2002, 15:35:09 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Webserver: IIS [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: Hostname = SWEETTJ05 [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: OS version 4.0, build 1381, 'Service Pack 6' [Thu Jul 11 10:59:15 2002] 0000009e 000000b1 - PLUGIN: ---------------------------------------------------------------
ws_common: websphereGetStream: Failed to connect to app server, OS err=%d
où %d est un code d'erreur spécifique au système d'exploitation se rapportant à la raison de l'échec de l'appel connect(). Cela peut se produire pour différentes raisons.
La regénération du fichier plugin-cfg.xml peut être effectuée à l'aide de la console d'administration utilisant le navigateur ou à l'aide du script se trouvant dans le répertoire <RépInstallExpress>/AppServer/bin.
Syntaxe : GenPluginCfg [[-option.name optionValue]...]
Options correctes :
-config.root configroot_dir
(la valeur par défaut est la variable d'environnement CONFIG_ROOT)
-cell.name cell
(la valeur par défaut est la variable d'environnement WAS_CELL)
-node.name node
(la valeur par défaut est la variable d'environnement WAS_NODE)
-server.name server
(obligatoire pour génération d'un seul plug-in de serveur)
-output.file.name file_name
(la valeur par défaut est configroot_dir/plugin-cfg.xml)
-destination.root root
(la racine d'installation de la configuration de la machine sera utilisée)
-destination.operating.system windows/unix
(le système d'exploitation de la configuration de la machine sera utilisée)
-debug yes/no
(la valeur par défaut est no)
Exemples :
IBM HTTP server
Articles techniques et exemple de code
Mises à jour de la documentation
Pour compléter les informations fournies dans le système d'aide en ligne, vous pourrez consulter les dernières informations concernant WebSphere Application Server - Express sur les sites Web suivants :
La présente section explique comment configurer la fonction de plug-in de sécurité du serveur Web pour WebSphere Application Server - Express. La fonction de plug-in de sécurité du serveur Web doit être installée à partir du CD du plug-in de serveur Web fourni avec WebSphere Application Server - Express version 5.1.1.
Les plug-ins de sécurité du serveur Web permettent aux utilisateurs de séparer le poste du serveur Web du poste du serveur Express Application à des fins de sécurité et de performances. Cette séparation confère généralement une plus grande souplesse à l'architecture du site Web.
Ces plug-in de sécurité communiquent avec WebSphere Application Server - Express sur HTTP(S).
L'installation du plug-in de serveur Web inclut tous les composants nécessaires à la configuration automatique des serveurs Web suivants sur les plateformes pour lesquelles ils sont pris en charge.
Le plug-in de sécurité du serveur Web doit être installé sur le même poste que votre serveur Web HTTP. Vous devez donc vous assurer que votre serveur Web HTTP est déjà installé sur le poste avant d'installer son plug-in.
Reportez-vous au fichier Readme sur le CD du plug-in de serveur Web pour obtenir des détails concernant les rubriques suivantes :
Pour installer les plug-ins de sécurité du serveur Web HTTP à partir du CD, procédez comme suit :
Emplacement dans lequel les fichiers de plug-in et les bibliothèques du serveur Web seront installés. Si WebSphere Application Server - Express est installé sur le poste, l'emplacement par défaut est <répertoire_installation_Express>/Plugins.
Remarque : le répertoire d'installation correspond au répertoire d'installation des fichiers de licence, du produit, de la JVM et de la désintallation. Les fichiers du plug-in de serveur Web nécessaires lors de l'installation sont installés dans <RépInstall>/../AppServer.
Structure de répertoires exemple :
C:\ Program File\IBM\WebSphere\Plugins
C:\ Program File\IBM\WebSphere\Appserver
Dans un environnement à un seul niveau où le serveur Web est installé sur la même machine que le serveur Express Application, les plug-ins du serveur Web se trouvent dans le répertoire WebSphere Application Server - Express : <RépInstallExpress>/AppServer. Ainsi, vous obtenez une intégration transparente du plug-in de serveur Web avec le serveur Express Application. La conséquence est que le répertoire par défaut du fichier plugin-cfg.xml régénéré est le même répertoire que celui pour lequel le serveur Web est configuré. Il n'est donc pas nécessaire de copier ou de déplacer manuellement le fichier plugin-cfg.xml régénéré après sa régénération.
Nom d'hôte du poste sur lequel WebSphere Application Server - Express est exécuté. Ces informations sont collectées pour permettre l'insertion de valeurs appropriées dans le fichier de configuration du plug-in (plugin-cfg.xml). La valeur par défaut est le nom de l'hôte local. Si WebSphere Application Server - Express est exécuté sur un autre poste, entrez le nom d'hôte de ce serveur éloigné.
Vous serez invité à indiquer l'emplacement du fichier de configuration de chaque plug-in de serveur Web que vous choisissez d'installer. Ce fichier doit exister pour pouvoir poursuivre l'installation.
Le programme d'installation des plug-in de WebSphere Application Server - Express peut s'exécuter en mode silencieux. Pour installer les plug-ins de WebSphere Application Server - Express en mode silencieux, vous devez utiliser l'option de ligne de commande -silent. Dans le cas d'une installation en mode silencieux, aucun panneau d'assistant ne s'affiche après l'exécution de la commande d'installation.
Vous devez utiliser un fichier de réponses afin de définir les options appropriées pour une installation en mode silencieux. Reportez-vous à l'exemple de fichier réponse disponible sur le CD-ROM d'installation. Pour exécuter l'installation en mode silencieux à l'aide d'un fichier de réponses, entrez la commande :
Pour Windows :
install.exe -silent -options <chemin complet>/fichierréponses
Pour Linux et Unix :
linux/setupLinux -silent -options <chemin complet>/fichierréponses
Exemples de plateformes Unix :
WebSphere Application Server - Express, version 5.1 inclut une application pré-installée nommée Snoop permettant de vérifier si le plug-in de serveur Web est installé correctement. Le fichier de configuration du plug-in de serveur Web, plugin-cfg.xml, installé lors de l'installation des plug-ins du serveur Web est pré-configuré pour tester l'application Snoop. Toutefois, vous pouvez également regénérer le plug-in de serveur Web en suivant les instructions de cette documentation.
CONSEIL : N'oubliez pas de redémarrer le serveur Web une fois la regénération du fichier de configuration du plug-in effectuée.
Procédure de test du plug-in de serveur Web
http://NomHôte:7080
CONSEIL : Si le démarrage du serveur Web n'aboutit pas, reportez-vous à la section "Conseils pour la résolution des incidents" de ce document pour savoir comment résoudre l'incident.
REMARQUE : N'indiquez par le transport interne, 7080, de WebSphere Express Application Server. Le plug-in de serveur Web se comporte comme un proxy du serveur utilisant le transport interne 7080. L'URL suivante suppose que que votre serveur écoute sur le port HTTP par défaut 80.
http://nomHôte
Si le plug-in de serveur Web est installé et configuré correctement, la page Web de l'application par défaut de WebSphere Application Server sera affichée dans votre navigateur.
Pour désinstaller les plug-ins de sécurité du serveur Web HTTP pour WebSphere Application Server - Express, procédez comme suit :
Pour désinstaller les plug-ins de serveur Web HTTP pour WebSphere Application Server - Express sur des plateformes Linux et Unix, procédez comme suit :
./uninstaller
Par défaut, les plug-ins Concurrent Versions System (CVS) sont installés automatiquement avec WebSphere Application Server - Express. La version la plus récente du serveur CVS est disponible sur le site www.cvshome.org. Pour utiliser CVS, il n'est pas nécessaire d'installer un client CVS, un serveur CVS suffit. Pour plus d'informations sur l'installation et l'utilisation de CVS, affichez l'aide en ligne de l'équipe CVS. Le site www.ibm.com/websphere/developer/library/ techarticles/0108_karasiuk/0108_karasiuk.html comprend aussi un article sur le support de l'équipe CVS dans WebSphere Application Server - Express.
Outre CVS, vous pouvez utiliser Rational ClearCase comme système de gestion de la configuration logicielle (SCM). Pour obtenir plus d'informations sur Rational ClearCase, consultez le sitewww.ibm.com/software/awdtools/clearcase/
Ni le serveur CVS, ni Rational ClearCase client ou serveur ne sont installés automatiquement. Vous devez les installer indépendamment de WebSphere Studio.
Plusieurs référentiels SCM peuvent être intégrés avec WebSphere Application Server - Express par le biais de composants SCM Team Adapter (ou Team Provider dans Eclipse). Pour rechercher la liste des produits SCM et des adaptateurs fournis par les partenaires commerciaux IBM, consultez le site www-3.ibm.com/software/awdtools/studioappdev/about/ et sélectionnez SCM Adaptor Vendors dans la section Further reading. Cette liste permet d'accéder aux sites Web du fournisseur des produits SCM pour télécharger les cartes SCM de votre choix. IBM n'est pas responsable de ces cartes et ne les garantit pas. Pour obtenir des services d'assistance ou des informations supplémentaires, adressez-vous directement au fournisseur du produit SCM.
Le présent document peut contenir des informations ou des références concernant certains produits, logiciels ou services IBM non annoncés dans ce pays. Pour plus de détails, référez-vous aux documents d'annonce disponibles dans votre pays, ou adressez-vous à votre partenaire commercial IBM. Toute référence à un produit, logiciel ou service IBM n'implique pas que seul ce produit, logiciel ou service puisse être utilisé. Tout autre élément fonctionnellement équivalent peut être utilisé, s'il n'enfreint aucun droit d'IBM. Il est de la responsabilité de l'utilisateur d'évaluer et de vérifier lui-même les installations et applications réalisées avec des produits, logiciels ou services non expressément référencés par IBM.
IBM peut détenir des brevets ou des demandes de brevet couvrant les produits décrits dans le présent document. La remise de ce document ne vous donne aucun droit de licence sur ces brevets ou demandes de brevet. Si vous désirez recevoir des informations concernant l'acquisition de licences, veuillez en faire la demande par écrit à l'adresse suivante :
IBM EMEA Director of Licensing
Les informations sur les licences concernant les produits utilisant un jeu de caractères double octet peuvent être obtenues par écrit à l'adresse suivante :
IBM World Trade Asia Corporation
Licensing
2-31 Roppongi 3-chome, Minato-ku
Tokyo 106, Japan
IBM pourra utiliser ou diffuser, de toute manière qu'elle jugera appropriée et sans aucune obligation de sa part, tout ou partie des informations qui lui seront fournies.
Le paragraphe suivant ne s'applique ni au Royaume-Uni, ni dans aucun pays dans lequel il serait contraire aux lois locales : LE PRESENT DOCUMENT EST LIVRE "EN L'ETAT". IBM DECLINE TOUTE RESPONSABILITE, EXPLICITE OU IMPLICITE, RELATIVE AUX INFORMATIONS QUI Y SONT CONTENUES, Y COMPRIS EN CE QUI CONCERNE LES GARANTIES DE VALEUR MARCHANDE OU D'ADAPTATION A VOS BESOINS. Certaines juridictions n'autorisent pas l'exclusion des garanties implicites, auquel cas l'exclusion ci-dessus ne vous sera pas applicable.
Le présent document peut contenir des inexactitudes ou des coquilles. Il est mis à jour périodiquement. Chaque nouvelle édition inclut les mises à jour. IBM peut modifier sans préavis les produits et logiciels décrits dans ce document.
Les licenciés souhaitant obtenir des informations permettant : (i) l'échange des données entre des logiciels créés de façon indépendante et d'autres logiciels (dont celui-ci), et (ii) l'utilisation mutuelle des données ainsi échangées, doivent adresser leur demande à :
Lab Director
IBM Canada Ltd. Laboratory
8200 Warden Avenue
Markham, Ontario, Canada L6G 1C7
Ces informations peuvent être soumises à des conditions particulières, prévoyant notamment le paiement d'une redevance.
Le logiciel sous licence décrit dans ce document et tous les éléments sous licence disponibles s'y rapportant sont fournis par IBM conformément aux dispositions de l'ICA, des Conditions internationales d'utilisation des logiciels IBM ou de tout autre accord équivalent.
Les informations concernant des produits non IBM ont été obtenues auprès des fournisseurs de ces produits, par l'intermédiaire d'annonces publiques ou via d'autres sources disponibles. IBM n'a pas testé ces produits et ne peut confirmer l'exactitude de leurs performances ni leur compatibilité. Elle ne peut recevoir aucune réclamation concernant des produits non IBM. Toute question concernant les performances de produits non IBM doit être adressée aux fournisseurs de ces produits.
Les références à des sites Web non IBM sont fournies à titre d'information uniquement et n'impliquent en aucun cas une adhésion aux données qu'ils contiennent. Les éléments figurant sur ces sites Web ne font pas partie des éléments du présent produit IBM et l'utilisation de ces sites relève de votre seule responsabilité.
Le présent document peut contenir des exemples de données et de rapports utilisés couramment dans l'environnement professionnel. Ces exemples mentionnent des noms fictifs de personnes, de sociétés, de marques ou de produits à des fins illustratives ou explicatives uniquement. Toute ressemblance avec des noms de personnes, de sociétés ou des données réelles serait purement fortuite.
LICENCE DE COPYRIGHT :
Le présent logiciel contient des exemples de programmes d'application en langage source destinés à illustrer les techniques de programmation sur différentes plateformes d'exploitation. Vous avez le droit de copier, de modifier et de distribuer ces exemples de programmes sous quelque forme que ce soit et sans paiement d'aucune redevance à IBM, à des fins de développement, d'utilisation, de vente ou de distribution de programmes d'application conformes aux interfaces de programmation des plateformes pour lesquels ils ont été écrits ou aux interfaces de programmation IBM. Ces exemples de programmes n'ont pas été rigoureusement testés dans toutes les conditions. Par conséquent, IBM ne peut garantir expressément ou implicitement la fiabilité, la maintenabilité ou le fonctionnement de ces programmes. Vous avez le droit de copier, de modifier et de distribuer ces exemples de programmes sous quelque forme que ce soit et sans paiement d'aucune redevance à IBM, à des fins de développement, d'utilisation, de vente ou de distribution de programmes d'application conformes aux interfaces de programmation IBM.
Toute copie totale ou partielle de ces programmes exemples et des oeuvres qui en sont dérivées doit comprendre une notice de copyright, libellée comme suit :
(C) (nom de votre société) (année). Des segments de code sont dérivés des Programmes exemples d'IBM Corp. (C) Copyright IBM Corp. 2000, 2003. All rights reserved.
Les informations sur l'interface de programmation vous aident à créer des logiciels à l'aide de ce programme.
Les interfaces de programmation génériques permettent d'écrire des applications qui obtiennent les services des outils de ce programme.
Cependant ces informations peuvent également contenir des informations sur les diagnostics, les modifications et la configuration. Ces informations doivent vous permettre de déboguer vos applications.
Avertissement : N'utilisez pas ces informations comme interface de programmation car elles sont sujettes à modification.
Les termes qui suivent sont des marques d'International Business Machines Corporation aux Etats-Unis et/ou dans certains autres pays :
Java et toutes les marques et logos incluant Java sont des marques de Sun Microsystems, Inc. aux Etats-Unis et/ou dans certains autres pays.
ActiveX, Microsoft, Windows, Windows NT et le logo Windows sont des marques de Microsoft Corporation aux Etats-Unis et/ou dans certains autres pays.
UNIX est une marque enregistrée de The Open Group aux Etats-Unis et/ou dans certains autres pays.
D'autres sociétés sont propriétaires des autres marques, noms de produits ou logos qui pourraient apparaître dans ce document.