Déploiement du service de données REST sur WebSphere Application Server Community Edition

Vous pouvez configurer le service de données REST eXtreme Scale sur WebSphere Application Server Community Edition Version 2.1.1.3 et les versions suivantes.

Avant de commencer

Procédure

  1. Configurez et démarrez une grille de données.
    1. Pour plus d'informations sur la configuration d'une grille de données eXtreme Scale pour l'utiliser avec le service de données REST, voir Démarrage d'une grille de données autonome pour les services de données REST.
    2. Vérifiez qu'un client eXtreme Scale parvient à se connecter aux entités de la grille et à y accéder. Pour un exemple, voir Tutoriel : Démarrer avec WebSphere eXtreme Scale.
  2. 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.
  3. Démarrez le serveur WebSphere Application Server Community Edition :
    1. Pour démarrer le serveur sans la sécurité Java SE activée, exécutez la commande suivante :

      [Unix][Linux] racine_wasce/bin/startup.sh

      [Windows] racine_wasce/bin/startup.bat

    2. Pour démarrer le serveur avec la sécurité Java SE activée, effectuez les étapes suivantes : [Unix][Linux]
      1. Ouvrez une ligne de commande ou une fenêtre de terminal et exécutez la commande de copie suivante (ou copiez le contenu du fichier de règles spécifié dans votre règle existante) : cp base_servicerest/gettingstarted/wasce/geronimo.policy wasce_root/bin
      2. Modifiez le fichier racine_wasce/bin/setenv.sh.
      3. Après la ligne qui contient "WASCE_JAVA_HOME=", ajoutez la ligne suivante : export JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy".

      [Windows]
      1. Ouvrez une fenêtre de ligne de commande et exécutez la commande de copie suivante ou copiez le contenu du fichier de règles défini vers la stratégie existante :

        copy base_servicerest\gettingstarted\wasce\geronimo.policy\bin

      2. Modifiez le fichier racine_wasce/bin/setenv.bat.
      3. Après la ligne qui contient "set WASCE_JAVA_HOME=", ajoutez la ligne suivante :

        set JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy"

  4. Ajoutez le fichier JAR d'exécution de client ObjectGrid au référentiel WebSphere Application Server Community Edition :
    1. Ouvrez et connectez-vous à la console d'administration de WebSphere Application Server Community Edition. L'URL par défaut est http://localhost:8080/console, l'ID utilisateur par défaut est system et le mot de passe, manager.
    2. Cliquez sur le lien Référentiel situé dans la partie gauche de la fenêtre de la console, dans le dossier Services.
    3. Dans la section Ajouter une archive au référentiel, entrez les éléments suivants dans les zones de texte :
      Tableau 1. Ajout d'une archive au référentiel
      Zone de texte Valeur
      Fichier base_wxs/lib/ogclient.jar
      Groupe com.ibm.websphere.xs
      Artefact ogclient
      Version 7.1
      Type JAR
    4. Cliquez sur le bouton Installer

    Reportez-vous à la note technique suivante pour des détails sur les différentes manières dont les dépendances de classes et de bibliothèques peuvent être configurées : Specifying external dependencies to applications running on WebSphere Application Server Community Edition.

  5. Déployez vers le serveur WebSphere Application Server Community Edition le module du service de données REST, le fichier wxsrestservice.war, et démarrez-le.
    1. Copiez et éditez l'exemple de fichier XML de plan de déploiement : base_servicerest/gettingstarted/wasce/geronimo-web.xml, afin d'inclure les dépendances de chemin au répertoire ou au fichier JAR de configuration de votre service de données REST. Voir la section pour un exemple de définition du chemin d'accès aux classes afin d'y inclure votre fichier wxsRestService.properties ainsi que d'autres fichiers de configuration et classes de métadonnées.
    2. Ouvrez et connectez-vous à la console d'administration de WebSphere Application Server Community Edition.
      Conseil : L'URL par défaut est http://localhost:8080/console. L'ID utilisateur par défaut est system et le mot de passe, manager.
    3. Cliquez sur le lien Déployer nouveau situé dans la partie gauche de la fenêtre de la console.
    4. Entrez les valeurs suivantes dans les zones de texte de la page Installer de nouvelles applications :
      Tableau 2. Installer de nouvelles applications
      Zone de texte Valeur
      Archive base_servicerest/lib/wxsrestservice.war
      Plan base_servicerest/gettingstarted/wasce/geronimo-web.xml
      Conseil : Utilisez le chemin du fichier geronimo-web.xml que vous avez copié et édité au point 3.
    5. Cliquez sur le bouton Installer. La page de la console indique alors que l'application a été installée et démarrée.
    6. Examinez le journal de sortie du système WebSphere Application Server Community Edition ou la console pour déterminer si le service de données REST a démarré. Le message suivant doit apparaître :

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

  6. Démarrez le serveur WebSphere Application Server Community Edition en exécutant la commande suivante :
    • [Unix][Linux] racine_wasce/bin/startup.sh
    • [Windows] racine_wasce/bin/startup.bat
  7. Installez sur le serveur WebSphere Application Server Community Edition le service de données REST d'eXtreme Scale et l'exemple fourni :
    1. Ajoutez le fichier JAR d'exécution de client ObjectGrid au référentiel WebSphere Application Server Community Edition :
      1. Ouvrez et connectez-vous à la console d'administration de WebSphere Application Server Community Edition. L'URL par défaut est http://localhost:8080/console. L'ID utilisateur par défaut est system et le mot de passe, manager.
      2. Cliquez sur le lien Référentiel à gauche de la fenêtre de la console, dans le dossier Services.
      3. Dans la section Ajouter une archive au référentiel, entrez les éléments suivants dans les zones de texte :
        Tableau 3. Ajout d'une archive au référentiel
        Zone de texte Valeur
        Fichier base_wxs/lib/ogclient.jar
        Groupe com.ibm.websphere.xs
        Artefact ogclient
        Version 7.1
        Type JAR
      4. Cliquez sur le bouton Installer.
        Conseil : Reportez-vous à la note technique suivante pour des détails sur les différentes manières dont les dépendances de classes et de bibliothèques peuvent être configurées : Specifying external dependencies to applications running on WebSphere Application Server Community Edition.
    2. Déployez le module de service de données REST, wxsrestservice.war, vers le serveur WebSphere Application Server Community Edition.
      1. Editez l'exemple de fichier XML de déploiement base_servicerest/gettingstarted/wasce/geronimo-web.xml pour inclure les dépendances de chemin d'accès dans les répertoires du chemin d'accès aux classes de l'exemple Mise en route :
        • Modifiez le chemin "classesDirs" des deux GBeans du client Mise en route :
        Le chemin de "classesDirs" pour le bean géré GettingStarted_Client_SharedLib doit avoir la valeur base_servicerest/gettingstarted/restclient/bin.

        Le chemin de "classesDirs" pour le bean géré GettingStarted_Common_SharedLib doit avoir la valeur base_servicerest/gettingstarted/restclient/bin.

      2. Ouvrez et connectez-vous à la console d'administration de WebSphere Application Server Community Edition.
      3. Cliquez sur le lien Déployer nouveau situé dans la partie gauche de la fenêtre de la console.
      4. Entrez les valeurs suivantes dans les zones de texte de la page Installer de nouvelles applications :
        Tableau 4. Installer de nouvelles applications
        Zone de texte Valeur
        Archive base_servicerest/lib/wxsrestservice.war
        Plan base_servicerest/gettingstarted/wasce/geronimo-web.xml
      5. Cliquez sur le bouton Installer.

        La page de la console indique alors que l'application a été installée et démarrée.

      6. Recherchez le message ci-après sur la console ou dans le journal de sortie système de WebSphere Application Server Community Edition pour vérifier que le service de données REST a bien démarré :

        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 :

    Ouvrez un navigateur Web et accédez à l'URL http://<hôte>:<port>/<racine_contexte>/restservice/<nom_grille>

    Le port par défaut de WebSphere Application Server Community Edition est 8080 et il est défini à l'aide de la propriété HTTPPort dans le fichier /var/config/config-substitutions.properties.

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

Résultats

Le document de service AtomPub est affiché.