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
- Un JRE ou un JDK IBM® (recommandé) ou
Oracle version 5 ou ultérieure est installé et la variable d'environnement JAVA_HOME est définie.
- 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.
Pour plus d'informations sur version
2.1.1 ou (autres versions), lisez les
instructions d'installation.
Procédure
- Configurez et démarrez une grille de données.
- 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.
- 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.
- 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.
- Démarrez le serveur WebSphere Application Server
Community Edition :
- Pour démarrer le serveur sans la sécurité Java SE activée, exécutez la
commande suivante :
![[Unix]](./icons/ngunix.gif)
racine_wasce/bin/startup.sh
racine_wasce/bin/startup.bat
- Pour démarrer le serveur avec la sécurité Java SE activée, effectuez
les étapes suivantes :
![[Unix]](./icons/ngunix.gif)
- 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
- Modifiez le fichier racine_wasce/bin/setenv.sh.
- Après la ligne qui contient "WASCE_JAVA_HOME=", ajoutez la ligne suivante : export
JAVA_OPTS="-Djava.security.manager -Djava.security.policy=geronimo.policy".
- 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
- Modifiez le fichier racine_wasce/bin/setenv.bat.
- 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"
- Ajoutez le fichier JAR d'exécution de client ObjectGrid au référentiel WebSphere Application Server
Community Edition :
- 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.
- Cliquez sur le lien Référentiel situé dans la partie gauche de la fenêtre de la console,
dans le dossier Services.
- 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érentielZone de texte |
Valeur |
Fichier |
base_wxs/lib/ogclient.jar |
Groupe |
com.ibm.websphere.xs |
Artefact |
ogclient |
Version |
7.1 |
Type |
JAR |
- 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.
- 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.
- 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.
- 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.
- Cliquez sur le lien Déployer nouveau situé dans la partie gauche de la fenêtre de la console.
- Entrez les valeurs suivantes dans les zones de texte de la page Installer de nouvelles applications :
Tableau 2. Installer de nouvelles applicationsZone 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.
- Cliquez sur le bouton Installer. La page de la console indique alors que l'application a été installée et démarrée.
- 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é.
- Démarrez le serveur WebSphere Application Server
Community Edition en exécutant la commande suivante :
![[Unix]](./icons/ngunix.gif)
racine_wasce/bin/startup.sh
racine_wasce/bin/startup.bat
- Installez sur le serveur WebSphere Application Server
Community Edition le service de données REST d'eXtreme Scale et l'exemple fourni :
- Ajoutez le fichier JAR d'exécution de client ObjectGrid au référentiel WebSphere Application Server
Community Edition :
- 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.
- Cliquez sur le lien Référentiel à gauche de la fenêtre de la console,
dans le dossier Services.
- 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érentielZone de texte |
Valeur |
Fichier |
base_wxs/lib/ogclient.jar |
Groupe |
com.ibm.websphere.xs |
Artefact |
ogclient |
Version |
7.1 |
Type |
JAR |
- Cliquez sur le bouton Installer.
- Déployez le module de service de données REST, wxsrestservice.war, vers le serveur WebSphere Application Server
Community Edition.
- 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.
- Ouvrez et connectez-vous à la console d'administration de WebSphere Application Server
Community Edition.
- Cliquez sur le lien Déployer nouveau situé dans la partie gauche de la fenêtre de la console.
- Entrez les valeurs suivantes dans les zones de texte de la page Installer de nouvelles applications :
Tableau 4. Installer de nouvelles applicationsZone de texte |
Valeur |
Archive |
base_servicerest/lib/wxsrestservice.war |
Plan |
base_servicerest/gettingstarted/wasce/geronimo-web.xml |
- Cliquez sur le bouton Installer.
La page de la console indique alors que
l'application a été installée et démarrée.
- 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é.
- 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é.