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

Nous allons expliquer comment configurer et démarrer le service de données REST d'eXtreme Scale avec WebSphere Application Server Community Edition.

Avant de commencer

Vérifiez que la grille d'exemple est bien démarrée. Voir Activation du service de données REST pour savoir comment démarrer la grille.

Procédure

  1. Téléchargez et installez WebSphere Application Server Community Edition version 2.1.1.3 ou plus récente dans le répertoire racine_wasce, par exemple le répertoire /opt/IBM/wasce.
  2. Démarrez le serveur WebSphere Application Server Community Edition en exécutant la commande suivante :
    • [Linux][Unix] racine_wasce/bin/startup.sh
    • [Windows] racine_wasce/bin/startup.bat

  3. Si la grille eXtreme Scale a été démarrée avec la sécurité d'eXtreme Scale activée, définissez les propriétés suivantes dans le fichier base_servicerest/gettingstarted/restclient/bin/wxsRestService.properties.
    ogClientPropertyFile=base_servicerest/gettingstarted/security/security.ogclient.properties
    loginType=none
  4. 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 du 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.
        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.
      2. Cliquez sur Référentiel 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. Archivage dans le référentiel
        Zone de texte Valeur
        Fichier base_wxs/lib/ogclient.jar
        Groupe com.ibm.websphere.xs
        Artefact ogclient
        Version 7.0
        Type jar
      4. Cliquez sur le bouton Installer.
        Conseil : Reportez-vous à la note technique suivante pour des explications détaillées sur les différentes méthodes de configuration des dépendances de classes et des bibliothèques : Specifying external dependencies to applications running on WebSphere Application Server Community Edition.
    2. Déployez vers le serveur WebSphere Application Server Community Edition le module du service de données REST, le fichier wxsrestservice.war.
      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.
        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 Déployer nouveau.
      4. Entrez les valeurs suivantes dans les zones de texte de la page Installer de nouvelles applications :
        Tableau 2. Valeurs d'installation
        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 que l'application est installée et a démarré.

      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é.

  5. Vérifiez que le service de données REST fonctionne :
    1. Ouvrez le lien suivant dans une fenêtre de navigateur : http://localhost:8080/wxsrestservice/restservice/NorthwindGrid. Le document de service de la grille NorthwindGrid s'affiche.
    2. Ouvrez le lien suivant dans une fenêtre de navigateur : http://localhost:8080/wxsrestservice/restservice/NorthwindGrid. Le document Entity Model Data Extensions (EDMX) s'affiche.
  6. Pour arrêter les processus de grille, utilisez CTRL+C dans les fenêtres de commande respectives.
  7. Pour arrêter WebSphere Application Server Community Edition, utilisez la commande suivante :
    • [Unix][Linux] racine_wasce/bin/shutdown.sh
    • [Windows] racine_wasce\bin\shutdown.bat
    Conseil : L'ID utilisateur par défaut est system et le mot de passe manager. Si vous utilisez un port personnalisé, utilisez l'option -port.