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

Cette rubrique explique comment configurer le service de données REST WebSphere eXtreme Scale sur WebSphere Application Server ou WebSphere Application Server Network Deployment Version 6.1.0.25 et les versions suivantes. Ces instructions s'appliquent également aux déploiements où WebSphere eXtreme Scale est intégré avec le déploiement WebSphere Application Server.

Avant de commencer

Vous devez disposer de l'un des environnements suivants sur votre système pour configurer et déployer le service de données REST pour WebSphere eXtreme Scale.

Procédure

  1. Configurez et démarrez une grille de données.
    1. Pour plus de détails sur la configuration d'une grille de données pour l'utiliser avec le service de données REST, voir Démarrage d'une grille de données pour les services de données REST dans WebSphere Application Server.
    2. Vérifiez qu'un client peut se connecter et accéder aux entités dans la grille de données. 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. Reportez-vous dans Installation du service de données REST aux explications sur le packaging et le déploiement du service REST.
  3. Ajoutez le fichier JAR ou le répertoire de la configuration du service de données REST au chemin d'accès aux classes du serveur d'applications :
    1. Ouvrez la console d'administration de WebSphere Application Server.
    2. Accédez à Environnement > Bibliothèques partagées
    3. Cliquez sur Nouveau
    4. Ajoutez les entrées suivantes dans les zones appropriées :
      • Nom : extremescale_rest _configuration
      • Chemin de classes : <répertoire ou fichier JAR de configuration du service REST>
    5. Cliquez sur OK
    6. Sauvegardez les modifications apportées à la configuration principale
  4. Ajoutez le fichier JAR d'exécution client WebSphere eXtreme Scale, wsogclient.jar et le fichier JAR fichier JAR du service de données REST ou le répertoire d'accès au chemin d'accès aux classes du serveur. Cette étape n'est pas nécessaire si WebSphere eXtreme Scale est intégré à l'installation WebSphere Application Server.

    1. Ouvrez la console d'administration de WebSphere Application Server.
    2. Accédez à Environnement > Bibliothèques partagées.
    3. Cliquez sur Nouveau.
    4. Ajoutez les entrées suivantes dans les zones :
      • Nom : extremescale_client_v71
      • Chemin d'accès aux classes : base_wxs/lib/wsogclient.jar
      A faire : Ajoutez chaque chemin sur une ligne séparée.
    5. Cliquez sur OK.
    6. Sauvegardez les modifications apportées à la configuration principale.
  5. Installez le fichier EAR du service de données REST (wxsrestservice.ear) sur WebSphere Application Server à partir de la console d'administration :
    1. Ouvrez la console d'administration de WebSphere Application Server.
    2. Cliquez sur Applications > Nouvelle application.
    3. Accédez au fichier /lib/wxsrestservice.ear dans le système de fichiers, sélectionnez-le et cliquez sur Suivant.
      • Si vous utilisez WebSphere Application Server Version 7.0, cliquez sur suivant.
      • Si vous utilisez WebSphere Application Server Version 6.1, entrez un valeur de racine de contexte avec le nom /wxsrestservice et passez à l'étape suivante.
    4. Choisissez l'option d'installation détaillée et cliquez sur Suivant.
    5. Dans l'écran d'avertissements de sécurité de l'application, cliquez sur Continuer.
    6. Sélectionnez les options d'installation par défaut, puis cliquez sur Suivant.
    7. Choisissez un serveur pour y associer l'application et cliquez sur Suivant.
    8. Sur la page de rechargement JSP, utilisez les valeurs par défaut, puis cliquez sur Suivant.
    9. Dans la page des bibliothèques partagées, associez le module wxsrestservice.war aux bibliothèques partagées que vous avez définies :
      • extremescale_rest_configuration
      • extremescale_client_v71
      Conseil : Cette bibliothèque partagée est nécessaire uniquement si WebSphere eXtreme Scale n'est pas intégré à WebSphere Application Server.
    10. Sur la page de mappe des relations de bibliothèques partagées, utilisez les valeurs par défaut, puis cliquez sur Suivant.
    11. Sur la page de mappe des hôtes virtuels, utilisez les valeurs par défaut, puis cliquez sur Suivant.
    12. Dans la page des racines de contexte des mappes, spécifiez wxsrestservice comme racine de contexte.
    13. Sur l'écran récapitulatif, cliquez sur Fin pour terminer la installation.
    14. Sauvegardez les modifications apportées à la configuration principale.
  6. Démarrez l'application de service de données wxsrestservice REST :
    1. Accédez à l'application dans la console d'administration.
      • WebSphere Application Server Version 7.0 : Dans la console d'administration, cliquez sur Applications > Types d'application > Applications WebSphere.
      • WebSphere Application Server Version 6.1 : Dans la console d'administration, cliquez sur Applications > Applications d'entreprise.
    2. Cochez la case de l'application wxsrestservice et cliquez sur Démarrer.
    3. Vérifiez le fichier SystemOut.log du profil de serveur d'applications. Lorsque le service de données REST a démarré, le message suivant apparaît dans le journal SystemOut.log du profil du serveur :

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

  7. Vérifiez que le service de données REST fonctionne : Le numéro de port se trouve dans le fichier SystemOut.log dans le répertoire des journaux du profil du serveur d'applications et vous pouvez le trouver en recherchant le premier port affiché pour l'identificateur de message : SRVE0250I. Le port par défaut est 9080.

    Par exemple : http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/ Résultat : le document du service AtomPub s'affiche.

    Par exemple : http://localhost:9080/wxsrestservice/restservice/NorthwindGrid/$metadata. Le document Entity Model Data Extensions (EDMX) s'affiche.

  8. Pour arrêter les processus de grille de données, utilisez CTRL+C dans la fenêtre de commande correspondante.