Cet exemple vous présente le paramétrage d'un ordinateur NUMA à quatre noeuds, chaque noeud logique étant associé à un noeud NUMA.

Sous Linux, après l'installation du serveur d'applications et avant son activation, vous devez configurer l'environnement Java de Linux. Voir le manuel Application Development Guide: Building and Running Applications pour plus de détails sur la configuration de l'environnement Java de Linux.

Pour activer le serveur d'applications pour DB2 UDB, procédez comme suit :

1. Connectez-vous au serveur DB2 en tant qu'utilisateur root sur les systèmes d'exploitation Linux ou UNIX ou en tant qu'utilisateur doté des droits Administrator sur les systèmes d'exploitation Windows.
2. Pour les systèmes d'exploitation basés sur Linux- et UNIX-, exécutez la commande suivante :

      . /chemin_instancedb2/sqllib/db2profile 

   chemin_instancedb2 étant l'emplacement où l'instance DB2 UDB a été créée.
3. Exécutez l'une des commandes suivantes :
   • Pour les systèmes d'exploitation Linux et UNIX :

        chemin_install_ServeurApp/bin/enable.sh 
              -db alias_bdd 
              -user utilisateur_bdd 
              -password mot_de_passe_bdd 
              -db2path chemin_sqllib 
              -instance nom_instance
              -easpath chemin_sai
              -fencedid id_utilisateur_isolé

   • Pour les systèmes d'exploitation Windows :

        chemin_install_serveurApp\bin\enable 
              -db alias_bdd 
              -user utilisateur_bdd 
              -password mot_de_passe_bdd 
              -db2path chemin_sqllib 
              -instance nom_instance
              -easpath chemin_sai
     

   où :
   • alias_bdd est l'alias de la base de données à activer,
   • utilisateur_bdd est l'ID utilisateur à employer lors de la connexion à la base de données,
   • mot_de_passe_bdd est le mot de passe à employer avec l'ID utilisateur lors de la connexion à la base de données,
   • chemin_sqllib est le chemin du répertoire SQLLIB de l'instance DB2 UDB. Ce chemin est utilisé pour la mise à jour de DB2EAS à l'aide des fichiers JAR requis,
   • nom_instance est le nom d'une instance DB2 UDB,
   • chemin_sai est le chemin du serveur d'applications intégré,
   • id_utilisateur_isolé est l'ID de l'utilisateur isolé.

Une fois le serveur d'applications pour DB2 activé, il démarre automatiquement.

Avant d'installer les outils Web DB2 sur WebSphere, vérifiez que vous disposez des éléments suivants :

• un serveur d'applications BEA WebLogic 7.0 ;
• IBM DB2 Administration Client version 8.
• Navigateur Web compatible avec HTML 4.0.
  Remarque :
  Les outils Web DB2 ont été testés sur Netscape 4.x, Netscape 6.x, Netscape 7.x, Mozilla 1.x, Internet Explorer 5.x, Opera 6.x, Konqueror 3.x (Linux) et EudoraWeb 2.x (SE Palm). L'utilisation de certains navigateurs Web n'ayant pas été testés peut nécessiter l'ajout d'une référence explicite à la configuration du servlet.

Les restrictions ci-après s'appliquent au déploiement des outils Web DB2 :

• Les conversions en langues et pages de codes multiples entre les serveurs de niveau intermédiaire et les serveurs DB2 ne sont pas prises en charge. Bien que la langue du serveur soit celle affichée, il se peut que certains caractères s'affichent incorrectement.
• Afin de visualiser les alertes du centre de santé pour les bases de données, les espaces table et les conteneurs d'espace table dans le Centre de santé Web, vous devez vous assurer que les bases de données sont cataloguées sur le serveur d'applications Web.
• Les boutons du navigateur Web (Arrêter, Précédente, Historique) ne peuvent pas être utilisés avec les outils Web DB2.
• Si vous utilisez Netscape Navigator 4 avec les outils Web DB2, il se peut que l'affichage de votre navigateur ne se régénère pas correctement. Si cela se produit, vous pouvez le régénérer en réduisant la fenêtre, puis en l'agrandissant. Vous pouvez également régénérer l'affichage en masquant la fenêtre du navigateur sous une autre fenêtre, puis en la ramenant ensuite à l'avant-plan.
• Pour affecter votre alias à un système, un noeud d'instance ou une base de données DB2 Universal Database (UDB), vous devez le cataloguer explicitement sur le serveur d'applications via l'Assistant de configuration DB2 ou le Centre de contrôle DB2.
• Le premier démarrage des outils Web DB2 sera beaucoup plus long que les démarrages suivants. Ceci est principalement dû au processus de catalogage automatique. Si vous ne voulez pas utiliser la fonctionnalité de catalogage automatique, vous pouvez raccourcir la délai d'attente en la désactivant via la configuration du servlet.
  Remarque :
  Les paramètres de configuration du servlet figurent dans le fichier descripteur de déploiement web.xml. Les noms de paramètres et les valeurs par défaut peuvent être modifiés à chaque édition. Certains serveurs d'applications peuvent autoriser des modifications de ces paramètres, via leur interface ou l'édition directe du fichier web.xml.
• La taille maximale absolue du tampon de sortie (résultats) est de 1 Mo dans le cas de l'utilisation d'un navigateur de station de travail ou de portable, même si sa configuration est supérieure. Dans le cas de navigateurs Web PDA, cette taille est de 1 ko.
• Sous Linux, UNIX, et Windows, les outils Web DB2 détectent et cataloguent automatiquement les systèmes figurant sur le même réseau TCP/IP que le serveur d'applications. L'adresse IP de ces systèmes commence par les mêmes trois chiffres. Les outils tentent de cataloguer les noeuds système DB2 via le nom d'hôte TCP/IP éloigné d'origine. En cas de nom en double, les outils affectent un nom aléatoire unique. Vous devez cataloguer explicitement les autres serveurs d'administration DB2 sur le serveur d'applications si vous voulez qu'ils soient accessibles. Il s'agit des serveurs utilisant TCP/IP ne se trouvant pas sur le même réseau TCP/IP que le serveur d'applications, ainsi que ceux qui ne font pas appel à TCP/IP.
• Sous Linux, UNIX, et Windows, les outils Web DB2 tentent de détecter et de cataloguer automatiquement les noeuds et bases de données d'instance DB2 UDB résidant sur les systèmes catalogués DB2 UDB. Il est possible de configurer une instance éloignée pour plusieurs protocoles de communication, par conséquent, le catalogue contiendra une entrée de noeud distincte pour chaque protocole pris en charge par une instance cataloguée automatiquement. En cas de nom en double, les outils affectent un nom aléatoire unique.

Pour installer les outils Web DB2 sur des serveurs d'applications WebLogic :

1. A partir de la console d'administration WebLogic, déployez les outils Web DB2 en procédant comme suit :
   1. Démarrez la console d'administration WebLogic.
   2. Cliquez sur domain -> deployments -> Web Applications dans la sous-fenêtre de gauche.
   3. Cliquez sur le lien Configure a new Web Application pour installer l'application Web DB2 Web Tools.
   4. Dans la liste du système de fichiers, localisez le fichier Sqllib\tools\web\db2wa.war.
   5. Cliquez sur select sous le nom de fichier db2wa.war.
   6. Dans la liste des serveurs disponibles, sélectionnez celui qui doit héberger DB2 Web Tools, puis cliquez sur la flèche pour le faire passer dans la liste des serveurs cibles.
      Remarque :
      Vous devez conserver le nom d'origine db2wa, car celui-ci est défini dans le code de l'application DB2 Web Tools.
   7. Cliquez sur Configure and Deploy.
   8. Patientez pendant que le serveur d'applications régénère l'état du processus de déploiement de l'application Web sur le serveur sélectionné. Si le déploiement aboutit, l'état suivant s'affiche : Deployed=true.
2. Appelez l'application Web DB2 Web Tools située à l'adresse :

   http://nom-serveur:numéro-port-serveur-app/db2wa

   Par exemple : http://nom-serveur:7001/db2wa.

Avant d'installer les outils Web DB2, vérifiez que vous disposez des éléments suivants :

• un serveur d'applications, par exemple :
  • Tomcat 4.0 Servlet/JSP Container (http://jakarta.apache.org/tomcat/)
  • Macromedia JRun 4.0 ;
• IBM DB2 Administration Client version 8.
• Navigateur Web compatible avec HTML 4.0.

Les restrictions ci-après s'appliquent au déploiement des outils Web DB2 :

• Les conversions en langues et pages de codes multiples entre les serveurs de niveau intermédiaire et les serveurs DB2 ne sont pas prises en charge. Bien que la langue du serveur soit celle affichée, il se peut que certains caractères s'affichent incorrectement.
• Afin de visualiser les alertes du centre de santé pour les bases de données, les espaces table et les conteneurs d'espace table dans le Centre de santé Web, vous devez vous assurer que les bases de données sont cataloguées sur le serveur d'applications Web.
• Les boutons du navigateur Web (Arrêter, Précédente, Historique) ne peuvent pas être utilisés avec les outils Web DB2.
• Si vous utilisez Netscape Navigator 4 avec les outils Web DB2, il se peut que l'affichage de votre navigateur ne se régénère pas correctement. Si cela se produit, vous pouvez le régénérer en réduisant la fenêtre, puis en l'agrandissant. Vous pouvez également régénérer l'affichage en masquant la fenêtre du navigateur sous une autre fenêtre, puis en la ramenant ensuite à l'avant-plan.
• Pour affecter votre alias à un système, un noeud d'instance ou une base de données DB2 UDB, vous devez le cataloguer explicitement sur le serveur d'applications via l'Assistant de configuration DB2 ou le Centre de contrôle DB2.
• Le premier démarrage des outils Web DB2 sera beaucoup plus long que les démarrages suivants. Ceci est principalement dû au processus de catalogage automatique. Si vous ne voulez pas utiliser la fonctionnalité de catalogage automatique, vous pouvez raccourcir la délai d'attente en la désactivant via la configuration du servlet.
  Remarque :
  Les paramètres de configuration du servlet figurent dans le fichier descripteur de déploiement web.xml. Les noms de paramètres et les valeurs par défaut peuvent être modifiés à chaque édition. Certains serveurs d'applications peuvent autoriser des modifications de ces paramètres, via leur interface ou l'édition directe du fichier web.xml.
• La taille maximale absolue du tampon de sortie (résultats) est de 1 Mo dans le cas de l'utilisation d'un navigateur de station de travail ou de portable, même si sa configuration est supérieure. Dans le cas de navigateurs Web PDA, cette taille est de 1 ko.
• Sous Linux, UNIX, et Windows, les outils Web DB2 détectent et cataloguent automatiquement les systèmes figurant sur le même réseau TCP/IP que le serveur d'applications. L'adresse IP de ces systèmes commence par les mêmes trois chiffres. Les outils tentent de cataloguer les noeuds système DB2 via le nom d'hôte TCP/IP éloigné d'origine. En cas de nom en double, les outils affectent un nom aléatoire unique. Vous devez cataloguer explicitement les autres serveurs d'administration DB2 sur le serveur d'applications si vous voulez qu'ils soient accessibles. Il s'agit des serveurs utilisant TCP/IP ne se trouvant pas sur le même réseau TCP/IP que le serveur d'applications, ainsi que ceux qui ne font pas appel à TCP/IP.
• Sous Linux, UNIX, et Windows, les outils Web DB2 tentent de détecter et de cataloguer automatiquement les noeuds et bases de données d'instance DB2 UDB résidant sur les systèmes catalogués DB2 UDB. Il est possible de configurer une instance éloignée pour plusieurs protocoles de communication, par conséquent, le catalogue contiendra une entrée de noeud distincte pour chaque protocole pris en charge par une instance cataloguée automatiquement. En cas de nom en double, les outils affectent un nom aléatoire unique.

Les procédures d'installation des outils Web DB2 sur des serveurs d'applications tels Tomcat 4.0 ou Macromedia JRun 4.0 sont les suivantes :

Tomcat 4.0

1. Préparez le fichier de configuration Tomcat 4.0 (CLASSPATH) en procédant comme suit :
   1. Créez la variable d'environnement/système CATALINA_HOME qui doit contenir le chemin d'accès à Tomcat 4.0 (répertoire principal). Par exemple, D:\jakarta-tomcat-4.0.3.
   2. Vérifiez que Tomcat Servlet/JSP Container est opérationnel :
      1. Démarrez Tomcat. Pour ce faire, exécutez startup.bat à partir du répertoire bin de Tomcat.
      2. Affichez la page Web principale http://hôtelocal:8080/ dans un navigateur Web.
2. Déployez les outils Web DB2 dans Tomcat Servlet/JSP Container. Pour ce faire, localisez le chemin d'installation des outils Web DB2 (Sqllib\tools\web\db2wa.war ) et copiez db2wa.war dans le répertoire de déploiement de Tomcat (répertoire webapps de Tomcat).
3. Appelez les outils Web DB2 sur Tomcat Servlet/JSP Container en procédant comme suit :
   1. Ouvrez une fenêtre de commande DB2 et indiquez le répertoire bin de Tomcat.
   2. Démarrez Tomcat à l'aide de startup.bat et vérifiez qu'un nouveau répertoire (db2wa) a été ajouté dans le répertoire webapps.
      Remarque :
      L'exécution de startup.bat à partir d'une fenêtre d'invite ne permet pas de définir DB2PATH. Pour ce faire, la ligne CLASSPATH doit être modifiée pour faire explicitement référence au chemin d'installation de DB2 UDB, et non à la variable d'environnement %DB2PATH%.
   3. L'application d'entreprise DB2 Web Tools se trouve à l'adresse http://localhost:8080/db2wa, elle est accessible à l'aide du navigateur Web compatible avec HTML 4.0.

JRun

1. Préparez un nouveau serveur d'applications pour les outils Web DB2 en procédant comme suit :
   Recommandation

   La création d'un serveur d'applications est recommandée, mais n'est pas obligatoire. Le serveur par défaut peut être utilisé à des fins de tests et, dans ce cas, seule la configuration du chemin de classe JVM et du répertoire de déploiement est obligatoire.

   1. Démarrez la console de gestion JRun (JRun Management Console) et connectez-vous sous l'ID administrateur du serveur d'applications.
   2. Créez un serveur d'applications à l'aide de l'option de création de serveur située dans la partie supérieure droite de la page principale. Ne modifiez pas le nom d'hôte affiché (hôtelocal).
   3. Indiquez le nouveau nom de serveur (DB2WebToolsServer) et cliquez sur le répertoire du serveur JRun. La valeur de paramètre est automatiquement remplie.
   4. Cliquez sur le bouton de création de serveur.
   5. Enregistrez les valeurs générées ou indiquez des nouvelles valeurs pour les paramètres suivants :
      • adresse URL du fournisseur JNDI ;
      • numéro de port du serveur Web. Il s'agit de la valeur à utiliser dans l'adresse URL des outils Web DB2 (http://localhost:numéro_port_serveur_Web/db2wa)
      • numéro de port du mandataire du connecteur Web.
   6. Cliquez si nécessaire sur l'option de mise à jour des numéros de port et fermez la fenêtre.
2. Déployez les outils Web DB2 sur le serveur d'applications JRun en procédant comme suit :
   1. Démarrez le serveur d'applications qui doit héberger l'application Web DB2 Web Tools (DB2WebToolsServer, par défaut, ou tout autre serveur à l'exception du serveur d'administration).
   2. Cliquez sur Applications Web, puis sur Ajout.
   3. Parcourez la section Fichier de déploiement pour sélectionner le fichier Sqllib\tools\web\db2wa.war dans le chemin d'installation de DB2 UDB.
   4. Cliquez sur Déployer et vérifiez que le chemin du contexte est /db2wa.
   5. Sélectionnez le serveur d'applications et vérifiez que l'application DB2 Web Tools apparaît dans la section Applications Web. Ne cliquez pas sur Validation sur cette page.
   6. Sélectionnez le lien Accueil situé sur le panneau supérieur gauche de la page principale.
   7. Redémarrez le serveur d'applications à partir de la vue Accueil qui contient les outils Web DB2 (DB2WebToolsServer).

L'application d'entreprise DB2 Web Tools se trouve à l'adresse http://localhost:numéro_port_serveur_web/db2wa, accessible à l'aide d'un navigateur Web compatible avec HTML 4.0.

Si vous voulez exploiter des accès disque directs, créez vos conteneurs d'unités DMS à l'aide d'E-S directes pour éviter tout problème de migration.

Pour arrêter et démarrer le démon du Centre de documentation :

1. Arrêtes le démon s'il est en cours d'exécution. Sur une ligne de commande, entrez :

   INIT_DIR/db2icd stop

   où INIT_DIR représente le répertoire d'installation du fichier db2icd.
2. Changez toutes les variables pour le démon en éditant le fichier db2ic.conf. Actuellement, vous pouvez modifier le numéro de port TCP où la documentation est disponible et l'emplacement de l'espace de travail temporaire utilisé par le démon en cours d'exécution.
3. Démarrez le démon. Sur une ligne de commande, entrez :

   INIT_DIR/db2icd start

   où INIT_DIR représente le répertoire d'installation du fichier db2icd.

Lorsque le démon démarre, il utilise les nouvelles variables d'environnement.

Il existe également une option pour arrêter et redémarrer le démon immédiatement. Sur une ligne de commande, entrez :

INIT_DIR/db2icd restart

où INIT_DIR représente le répertoire d'installation du fichier db2icd.

Vous pouvez vérifier l'état du démon à n'importe quel moment. Sur une ligne de commande, entrez :

INIT_DIR/db2icd status

où INIT_DIR représente le répertoire d'installation du fichier db2icd.Le démon renvoie l'état actuel et affiche l'ID de processus du démon s'il est actif.