Démarrage de services de données REST dans Apache Tomcat

Cette rubrique explique comment configurer et démarrer le service de données REST d'eXtreme Scale avec Apache Tomcat version 5.5 ou plus récente.

Avant de commencer

Vérifiez que l'exemple de grille de données eXtreme Scale est démarré. Voir Activation du service de données REST pour plus d'informations sur le démarrage de la grille.

Procédure

  1. Téléchargez et installez dans racine_tomcat Apache Tomcat version 5.5 ou ultérieure. Par exemple : /opt/tomcat
  2. Installez sur le serveur Tomcat le service de données REST d'eXtreme Scale et l'exemple fourni :
    1. Si vous utilisez un JRE ou un JDK Oracle, vous devez installer l'ORB IBM® dans Tomcat :
      • Pour Tomcat version 5.5

        Copiez tous les fichiers JAR de :

        base_wxs/lib/endorsed

        vers

        racine_tomcat/common/endorsed

      • Pour Tomcat version 6.0
        1. Créez un répertoire "validé".
          • [Unix][Linux] mkdir racine_tomcat/endorsed
          • [Windows] md racine_tomcat/endorsed
        2. Copiez tous les fichiers JAR de :

          base_wxs/lib/endorsed

          vers

          racine_tomcat/endorsed

    2. Déployez le module de service de données REST : wxsrestservice.war vers le serveur Tomcat.

      Copiez le fichier wxsrestservice.war depuis :

      base_servicerest/lib

      vers :

      racine_tomcat/webapps

    3. Ajoutez le fichier JAR d'exécution client ObjectGrid et le fichier JAR d'application au chemin d'accès aux classes dans Tomcat :
      1. Modifiez le fichier racine_tomcat/conf/catalina.properties.
      2. Ajoutez les noms de chemins suivants à la fin de la propriété shared.loader sous forme de liste séparée par des virgules :
        • base_wxs/lib/ogclient.jar
        • base_servicerest/gettingstarted/restclient/bin
        • base_servicerest/gettingstarted/common/bin
        Important : Le séparateur de chemin doit être une barre oblique.

  3. Si la grille de données eXtreme Scale a été démarrée avec la sécurité eXtreme Scale activée, définissez la propriété suivante dans le fichier restservice_home/gettingstarted/restclient/bin/wxsRestService.properties.
    ogClientPropertyFile=base_servicerest/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. Démarrez le serveur Tomcat avec le service de données REST :
    • Si vous utilisez Tomcat 5.5 sous UNIX ou Windows, ou Tomcat 6.0 sous UNIX :
      1. cd racine_tomcat/bin
      2. Démarrez le serveur :
        • [Unix][Linux] ./catalina.sh run
        • [Windows] catalina.bat run
      3. La console affiche ensuite les journaux d'Apache Tomcat. Au démarrage du service de données REST, le message suivant s'affiche dans la console d'administration :

        CWOBJ4000I : Le service de données REST de WebSphere eXtreme Scale a été démarré.

    • Si vous utilisez Tomcat 6.0 sous Windows :
      1. cd racine_tomcat/bin
      2. Démarrez l'outil de configuration Apache Tomcat 6 avec la commande suivante : tomcat6w.exe
      3. Dans la fenêtre des propriétés d'Apache Tomcat 6, cliquez sur le bouton Démarrer pour démarrer le serveur Tomcat.
      4. Révisez les journaux suivants pour vérifier que le serveur Tomcat a démarré correctement :
        • racine_tomcat/bin/catalina.log

          Affiche l'état du moteur du serveur Tomcat.

        • racine_tomcat/bin/stdout.log

          Affiche le journal de sortie système.

      5. Au démarrage du service de données REST, le message suivant s'affiche dans le journal de sortie système : CWOBJ4000I : Le service de données REST de WebSphere eXtreme Scale a été démarré.
  5. Vérifiez que le service de données REST fonctionne :
    1. Ouvrez un navigateur et accédez à :

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid

      Le document de service pour NorthwindGrid s'affiche.

    2. Accédez à :

      http://localhost:8080/wxsrestservice/restservice/NorthwindGrid/$metadata

      Le document Entity Model Data Extensions (EDMX) s'affiche.

  6. Pour arrêter les processus de grille de données, utilisez CTRL+C dans la fenêtre de commande correspondante.
  7. Pour arrêter Tomcat, utilisez CTRL +C dans la fenêtre depuis laquelle vous l'avez démarré.