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.
- WebSphere
Application Server avec le client autonome WebSphere eXtreme Scale :
- WebSphere eXtreme Scale Trial Version
7.1 avec le service de données REST est téléchargé et extrait ou WebSphere eXtreme Scale Version 7.1.0.0 avec le groupe de correctif 2 est installé dans un répertoire autonome.
- WebSphere
Application Server Version 6.1.0.25, 7.0.0.5 ou version suivante est installé et actif.
- WebSphere
Application Server intégré à WebSphere eXtreme Scale:
WebSphere eXtreme Scale Version 7.1.0.0 avec le groupe de correctifs 2 ou suivant installé sur WebSphere
Application Server Version 6.1.0.25, 7.0 ou version suivante.
Conseil : Le service de données REST d'WebSphere eXtreme Scale
requiert uniquement que le client WebSphere eXtreme Scale soit installé. Il n'est pas nécessaire d'étendre le profil.
Découvrez comment activer la sécurité Java 2 dans le centre de documentation WebSphere
Application Server.
Procédure
- Configurez et démarrez une grille de données.
- 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.
- 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.
- 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.
- 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 :
- Ouvrez la console d'administration de WebSphere
Application Server.
- Accédez à
- Cliquez sur Nouveau
- 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>
- Cliquez sur OK
- Sauvegardez les modifications apportées à la configuration principale
- 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.
- Ouvrez la console d'administration de WebSphere
Application Server.
- Accédez à .
- Cliquez sur Nouveau.
- 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.
- Cliquez sur OK.
- Sauvegardez les modifications apportées à la configuration
principale.
- Installez le fichier EAR du service de données REST (wxsrestservice.ear)
sur WebSphere
Application Server
à partir de la console d'administration :
- Ouvrez la console d'administration de WebSphere
Application Server.
- Cliquez sur .
- 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.
- Choisissez l'option d'installation détaillée et cliquez sur Suivant.
- Dans l'écran d'avertissements de sécurité de l'application, cliquez sur Continuer.
- Sélectionnez les options d'installation par défaut, puis cliquez sur Suivant.
- Choisissez un serveur pour y associer l'application et cliquez sur Suivant.
- Sur la page de rechargement JSP, utilisez les valeurs par défaut, puis cliquez sur Suivant.
- 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.
- Sur la page de mappe des relations de bibliothèques partagées, utilisez les valeurs par défaut, puis cliquez sur Suivant.
- Sur la page de mappe des hôtes virtuels, utilisez les valeurs par défaut, puis cliquez sur Suivant.
- Dans la page des racines de contexte des mappes, spécifiez wxsrestservice
comme racine de contexte.
- Sur l'écran récapitulatif, cliquez sur Fin pour terminer la installation.
- Sauvegardez les modifications apportées à la configuration
principale.
- Démarrez l'application de service de données wxsrestservice REST :
- Accédez à l'application dans la console d'administration.
- WebSphere
Application Server Version 7.0 :
Dans la console d'administration, cliquez sur .
- WebSphere
Application Server Version 6.1 :
Dans la console d'administration, cliquez sur .
- Cochez la case de l'application wxsrestservice et cliquez sur Démarrer.
- 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é.
- 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.
- Pour arrêter les processus de grille de données, utilisez CTRL+C dans la fenêtre de commande correspondante.