Pour configurer votre application WebSphere
Application Server afin qu'elle utilise le dispositif
pour la gestion des sessions, vous pouvez soit sélectionner le dispositif lorsque vous installez une nouvelle application, soit actualiser votre application existante
ou les paramètres du serveur pour qu'ils utilisent le dispositif.
Avant de commencer
Pour pouvoir changer la configuration dans
WebSphere
Application Server, vous devez avoir :
- Un accès à la cellule WebSphere
Application Server à configurer.
- L'adresse IP ou le nom d'hôte qualifié complet du dispositif.
- Un ID utilisateur et un mot de passe que vous utilisez pour vous connecter au dispositif interface utilisateur.
Pour pouvoir créer une grille de données, vous devez disposer des droits de création d'une mémoire cache de données.
- installé WebSphere eXtreme
Scale Client dans la configuration WebSphere
Application Server. Pour plus d'informations, voir Installation de WebSphere eXtreme Scale Client.
- activé la sécurité globale dans la console d'administration WebSphere
Application Server si la sécurité de la couche de transport du dispositif est activée ou que vous voulez que les clients utilisent la sécurité de la couche de transport. Pour plus d'informations, voir Configuration de TLS (Transport Layer Security).
- Seules les sessions utilisant des cookies comme mécanisme de suivi de session peuvent être enregistrées dans la grille de données. Vous ne pouvez pas rendre persistantes des sessions utilisant la réécriture d'URL comme mécanisme de suivi de session.
Procédure
- Pour configurer la gestion de session lors de l'installation de l'application, effectuez la procédure suivante :
- Dans la console d'administration de WebSphere
Application Server, cliquez sur . Sélectionnez le chemin Détaillé pour la création de l'application, puis effectuez les premières étapes de l'assistant.
- A l'étape Paramètres de gestion des sessions eXtreme Scale session de l'assistant,
configurez la grille de données que vous voulez utiliser. Pour la zone
Gérer la persistance des sessions par , choisissez WebSphere DataPower XC10 Appliance. Entrez les informations concernant le dispositif et la grille de données
sur le dispositif que vous voulez utiliser. Vous pouvez créer une grille de données ou utiliser une grille de données existante déjà configurée sur le dispositif.
Si vous souhaitez sauvegarder vos sessions sur une grille de données existante du dispositif, vous devez connaître le nom de la grille de données à utiliser.
Toutefois, vous pouvez également créer une grille de données sur le dispositif lors de la configuration de l'application. Pour créer une grille de données de session avant de configurer l'application dans la console d'administration de WebSphere
Application Server, cliquez sur . Cliquez sur l'icône Ajouter (
) et indiquez le nom de la grille de données de session à créer. Ce nom ne peut contenir les caractères suivants : ^ . \\ / , # $ @ : ; \ * ? <
> | = + & % [ ] " ".
- Terminez l'installation de l'application en effectuant la procédure de l'assistant.
Vous pouvez également installer l'application à l'aide d'un script wsadmin. Dans l'exemple suivant, le paramètre-SessionManagement crée une configuration identique à celle que vous pouvez créer dans la console d'administration :
AdminApp.install('C:/A.ear', '[ -nopreCompileJSPs -distributeApp
-nouseMetaDataFromBinary -nodeployejb -appname A -edition 8.0
-createMBeansForResources -noreloadEnabled -nodeployws -validateinstall
off -noprocessEmbeddedConfig -filepermission .*\.dll=755#.*\.so=755#.*\.a=755#.*\.sl=755
-buildVersion Unknown -noallowDispatchRemoteInclude -noallowServiceRemoteInclude
-asyncRequestDispatchType DISABLED -nouseAutoLink -SessionManagement [[true
XC10SessionManagement myXC10.ibm.com:!:username:!:password:!:AGrid80]]
-MapWebModToVH [[MicroWebApp microwebapp.war,WEB-INF/web.xml default_host] [MicroSipApp
microsipapp.war,WEB-INF/web.xml default_host] [MicroDG1App microdg1app.war,WEB-INF/web.xml
default_host] [MicroDG2App microdg2app.war,WEB-INF/web.xml default_host] [MicroSip2App
microsip2app.war,WEB-INF/web.xml default_host]]]')
- Pour configurer la gestion de session sur une application existante dans la console d'administration
de WebSphere
Application Server :
- Dans la console d'administration WebSphere
Application Server, cliquez sur .
- Actualisez les champs pour activer la persistance des sessions vers une grille de données.
Vous pouvez également mettre à jour l'application à l'aide d'un script wsadmin. Dans l'exemple suivant, le paramètre-SessionManagement crée une configuration identique à celle que vous pouvez créer dans la console d'administration :
AdminApp.edit('A-edition9.0', '[ -SessionManagement [[true
XC10SessionManagement myXC10.ibm.com:!:username:!:password:!:AGrid80]]]')
Les caractères
:!: envoyés sont utilisés comme délimiteurs. Les valeurs envoyées sont les suivantes :
applicationIdentifier:!:username:!:password:!:
gridName
Lorsque vous enregistrez les modifications,
l'application utilise la grille de données configurée pour la persistance des sessions sur le dispositif.
- Pour configurer la gestion de session sur un serveur existant :
- Dans la console d'administration WebSphere
Application Server, cliquez sur .
- Actualisez les champs pour activer la persistance des sessions.
Les commandes wsadmin suivantes vous permettent de configurer également la gestion des sessions sur un serveur existant :
AdminTask.configureServerSessionManagement('[-nodeName my_node
-serverName server1 -enableSessionManagement true -sessionManagementType
XC10SessionManagement -XC10SessionManagement [-applianceIdentifier myserver.ibm.com
-userName -password ******** -gridName myTestGrid]]')
Lorsque vous enregistrez les modifications, le serveur utilise la grille de données configurée pour la persistance de sessions avec toutes les applications qu'il exécute.
Résultats
Vous avez configuré le gestionnaire de sessions HTTP pour que les sessions soient conservées
vers une
grille de données. Les entrées sont supprimées de la grille de données lorsque les sessions expirent. Voir
Paramètres de gestion des sessions pour plus d'informations sur la mise à jour la valeur de temporisation des sessions dans la console d'administration
WebSphere
Application Server.
Si l'ensemble de la grille de données qui héberge les données de sessions d'application est inaccessible à partir du client du conteneur Web, le client utilise le conteneur Web de base dans la gestion de sessions
WebSphere
Application Server.
La grille de données peut être inaccessible dans les scénarios suivants :
- Problème de réseau entre le conteneur Web et le dispositif.
- Arrêt des processus serveur dans le dispositif.
Les sessions les moins utilisées sont invalidés à partir du cache de session du conteneur Web. Si la grille de données dans le dispositif devient disponible, les sessions ayant été invalidées à partir du cache du conteneur Web peuvent extraire les données de la grille de données distante et charger les données dans une nouvelle session. Si l'ensemble de la grille de données dans le dispositif n'est pas disponible et que la session est invalidée dans le cache de session, les données de session utilisateur sont perdues. Compte tenu de ce problème, n'arrêtez pas l'ensemble de la grille de données de production lorsque le système est chargé.
ATTENTION :
Lorsque vous configurez ce scénario, les données d'identification de sécurité pour IBM WebSphere DataPower XC10 Appliance sont automatiquement stockées dans la configuration de WebSphere
Application Server.
Si vous êtes amené à modifier les données d'identification pour la grille de données après cette première configuration,
WebSphere
Application Server ne disposera plus des données d'identification correctes. Vous pourrez les réinitialiser
en appliquant à nouveau les paramètres de gestion des sessions eXtreme Scale.
Que faire ensuite
- Configurez la sécurité avant de commencer à envoyer des données à la grille de données.
Pour plus d'informations, voir Sécuriser les grilles de données.
- Configurez des répliques. Les répliques permettent de s'assurer que les données de vos grilles de données sont disponibles si la copie principale échoue. Pour configurer des répliques, cliquez sur . Les répliques sont créées seulement si le dispositif est dans une collectivité. Si le nombre de dispositifs dans la collectivité est n, le nombre maximal de répliques est n-1. Ainsi, si vous configurez trois répliques mais que vous n'avez que deux dispositifs dans la collectivité, une seule réplique est créée. Des répliques supplémentaires sont créées si vous ajoutez des dispositifs à la collectivité. Définissez le nombre de réplique au nombre idéal de répliques souhaitées : ainsi, lorsque des dispositifs rejoignent la collectivité, de nouvelles répliques sont créées. Le contenu de la grille de données est effacé lorsque vous modifiez le nombre de répliques.
- Configurez une limite de capacité pour la grille de données.
En configurant des limites de capacité sur la grille de données, vous pouvez vous assurer que la capacité de stockage pour la collectivité est utilisée de façon prévisible.
Pour plus d'informations, voir Configuration de la capacité maximale d'une grille de données.
- Vous pouvez surveiller votre grille de données de session dans l'interface utilisateur de DataPower XC10
Appliance. Pour plus d'informations, voir Surveillance des grilles de données dans l'interface utilisateur.