Déploiement du service de données REST sur Apache Tomcat

Cette rubrique explique comment configurer le service de données REST WebSphere eXtreme Scale sur Apache Tomcat Version 5.5 et les versions suivantes.

Pourquoi et quand exécuter cette tâche

Procédure

  1. Si vous utilisez un JRE ou un JDK Oracle, installez l'ORB IBM dans Tomcat :
    1. Tomcat version 5.5 :

      Copiez tous les fichiers JAR depuis :

      le répertoire base_wxs/lib/endorsed

      vers :

      le répertoire racine_tomcat/common/endorsed

    2. Tomcat version 6.0 :

      Créez un répertoire "endorsed" :

      [Unix][Linux] mkdir racine_tomcat/endorsed

      [Windows] md racine_tomcat/endorsed

      Copiez tous les fichiers JAR de :

      base_wxs/lib/endorsed

      vers :

      racine_tomcat/common/endorsed

  2. Configurez et démarrez une grille de données.
    1. Pour plus d'informations sur la configuration d'une grille de données pour l'utiliser avec le service de données REST, voir Configuration.
    2. Vérifiez qu'un client eXtreme Scale arrive à se connecter aux entités de la grille et à y accéder. Pour un exemple, voir Configuration des services de données REST.
  3. Générez le répertoire ou le fichier JAR de configuration du service REST d'eXtreme Scale. Pour les détails, voir dans Installation du service de données REST les explications sur le packaging et le déploiement.
  4. Déployez le module du service de données REST : wxsrestservice.war sur le serveur Tomcat.

    Copiez le fichier wxsrestservice.war depuis :

    rép_base_servicerest/lib

    vers :

    racine_tomcat/webapps

  5. Ajoutez le fichier JAR d'exécution du client ObjectGrid et le fichier JAR de l'application dans le chemin d'accès aux classes partagé, dans Tomcat :
    1. Editez le fichier racine_tomcat/conf/catalina.properties.
    2. Ajoutez les noms de chemin suivants à la fin de la propriété shared.loader, en les séparant par une virgule :
  6. Si vous utilisez la sécurité Java 2, ajoutez les droits de sécurité au fichier de règles tomcat :
    • Si vous utilisez Tomcat version 5.5 :

      Fusionnez le contenu de l'exemple de fichier de règles catalina 5.5 qui se trouve dans

      rép_base_servicerest/gettingstarted/tomcat/catalina-5_5.policy avec le fichier racine_tomcat/conf/catalina.policy.

    • Si vous utilisez Tomcat version 6.0 :

      Fusionnez le contenu de l'exemple de fichier de règles catalina 6.0 qui se trouve dans

      rép_base_servicerest/gettingstarted/tomcat/catalina-6_0.policy avec le fichier racine_tomcat/conf/catalina.policy.

  7. Démarrez le serveur Tomcat :
    • Si vous utilisez Tomcat 5.5 sous UNIX or Windows, ou la distribution ZIP de Tomcat 6.0 :

      1. cd racine_tomcat/bin
      2. Démarrez le serveur :
        • Sans la sécurité Java 2 activée :

          [Unix][Linux] ./catalina.sh run

          [Windows] catalina.bat run

        • Avec la sécurité Java 2 activée :

          [Unix][Linux] ./catalina.sh run -security

          [Windows] catalina.bat run -security

      3. Les journaux d'Apache Tomcat sont affichés sur la console. Lorsque le service de données REST a correctement démarré, le message suivant est affiché 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 à l'aide de la distribution du programme d'installation Windows :
      1. cd /bin
      2. Démarrez l'outil de configuration d'Apache Tomcat 6 :

        tomcat6w.exe

      3. Pour activer la sécurité Java 2 : (facultatif) :

        Ajoutez les entrées suivantes aux options Java dans la page Java de la fenêtre des propriétés d'Apache Tomcat 6 :

        -Djava.security.manager

        -Djava.security.policy=\conf\catalina.policy

      4. Cliquez sur le bouton Démarrer de la fenêtre de propriétés d'Apache Tomcat 6 pour démarrer le serveur Tomcat.
      5. Consultez les journaux suivants pour vérifier que le serveur Tomcat a été correctement démarré :
        • racine_tomcat/bin/catalina.log

          Affiche le statut du moteur du serveur Tomcat

        • racine_tomcat/bin/stdout.log

          Affiche le journal de la sortie système.

      6. Si le service de données REST est correctement démarré, le message suivant est affiché dans le journal de la sortie système :

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

  8. Vérifiez que le service de données REST fonctionne bien.
    Ouvrez un navigateur Web et accédez à l'adresse URL suivante :
    http://host:port/racine_contexte/restservice/nom_grille

    Le port par défaut pour Tomcat est 8080 et il est configuré dans le fichier racine_tomcat/conf/server.xml dans l'élément <Connector>.

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

Résultats

Le document de service AtomPub est affiché.