Vous pouvez utiliser des fichiers de propriétés pour modifier des propriétés de gestionnaire de sessions
sous le conteneur web et des attributs tuningParams, sessionDatabasePersistence
et defaultCookieSettings associés sous un serveur.
Avant de commencer
Déterminez la nature des changements à apporter à votre configuration du
gestionnaire de sessions.
Démarrez l'outil de scriptage wsadmin. Pour démarrer wsadmin à l'aide du langage Jython, exécutez la commande wsadmin
-lang Jython à partir du répertoire bin
du profil de serveur.
Pourquoi et quand exécuter cette tâche
A l'aide d'un fichier de propriétés, vous pouvez créer, modifier ou supprimer
des propriétés de configuration d'un gestionnaire de sessions.
Exécutez des commandes d'administration
à l'aide de wsadmin pour modifier un fichier de propriétés pour un gestionnaire de sessions,
valider les propriétés et les appliquer à votre configuration.
Tableau 1. Actions associées aux fichiers de propriétés du gestionnaire de sessions. Vous pouvez créer, modifier et supprimer
des propriétés du gestionnaire de sessions.Action |
Procédure |
création |
Non applicable |
modify |
Editez des propriétés, puis exécutez la commande applyConfigProperties. |
suppression |
Non applicable |
création d'une propriété |
Définissez des propriétés, puis exécutez la commande applyConfigProperties. |
suppression d'une propriété |
Spécifiez les propriétés à supprimer du fichier de propriétés,
puis exécutez la commande deleteConfigProperties. |
Vous pouvez éventuellement utiliser le mode interactif avec les commandes :
AdminTask.nom_commande('-interactive')
Procédure
- Créez des propriétés du gestionnaire de sessions.
- Spécifiez des propriétés SessionManager sous le WebContainer
dans un fichier de propriétés.
Dans un éditeur, spécifiez des propriétés WebContainer
SessionManager et des attributs tuningParams, sessionDatabasePersistence
et defaultCookieSettings associés sous un serveur dans un fichier de
propriétés. Vous pouvez copier l'exemple de propriétés suivant
dans un éditeur et modifier les propriétés selon
votre situation.
#
# SubSection 1.0.7 # Session Manager
#
ResourceType=SessionManager
ImplementingResourceType=WebContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=
:WebContainer=:SessionManager=
AttributeInfo=services
#
#
#Properties
#
enableSecurityIntegration=false #boolean,default(false)
maxWaitTime=5 #integer,default(0)
context=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:WebContainer=
#ObjectName(WebContainer),readonly
allowSerializedSessionAccess=false #boolean,default(false)
enableProtocolSwitchRewriting=false #boolean,default(false)
enableUrlRewriting=false #boolean,default(false)
enable=true #boolean,default(false)
accessSessionOnTimeout=true #boolean,default(true)
enableSSLTracking=false #boolean,default(false)
sessionPersistenceMode=NONE #ENUM(DATABASE|DATA_REPLICATION|NONE),default(NONE)
enableCookies=true #boolean,default(true)
#
# SubSection 1.0.7.1 # Session Manager's Tuning Parameters
#
ResourceType=TuningParams
ImplementingResourceType=WebContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:WebContainer=
:SessionManager=:TuningParams=
AttributeInfo=tuningParams
#
#
#Properties
#
writeContents=ONLY_UPDATED_ATTRIBUTES #ENUM(ALL_SESSION_ATTRIBUTES|ONLY_UPDATED_ATTRIBUTES),
default(ONLY_UPDATED_ATTRIBUTES)usingMultiRowSchema=false #boolean,default(false)
allowOverflow=true #boolean,default(true)
writeFrequency=TIME_BASED_WRITE #ENUM(TIME_BASED_WRITE|END_OF_SERVLET_SERVICE|MANUAL_UPDATE),default(END_OF_SERVLET_SERVICE)
invalidationTimeout=30 #integer,default(30)
scheduleInvalidation=false #boolean,default(false)
writeInterval=10 #integer,default(120)
maxInMemorySessionCount=1000 #integer,default(1000)
#
# SubSection 1.0.7.1.1 # Session Manager's Tuning Parameters
#
ResourceType=InvalidationSchedule
ImplementingResourceType=WebContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:WebContainer=
:SessionManager=:TuningParams=:InvalidationSchedule=
AttributeInfo=invalidationSchedule
#
#
#Properties
#
secondHour=2 #default(0)
firstHour=14 #default(0)
#
# SubSection 1.0.7.3 # Session Manager's SessionDatabasePersistence
#
ResourceType=SessionDatabasePersistence
ImplementingResourceType=WebContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=
:WebContainer=:SessionManager=:SessionDatabasePersistence=
AttributeInfo=sessionDatabasePersistence
#
#
#Properties
#
password="{xor}Oz1tPjsyNjE="
userId=db2admin
tableSpaceName=
datasourceJNDIName="jdbc/Sessions" #required
db2RowSize=ROW_SIZE_4KB #ENUM(ROW_SIZE_4KB|ROW_SIZE_32KB|ROW_SIZE_16KB|ROW_SIZE_8KB),default(ROW_SIZE_4KB)
#
# SubSection 1.0.7.4 # Session Manager's Cookie
#
ResourceType=Cookie
ImplementingResourceType=WebContainer
ResourceId=Cell=!{cellName}:Node=!{nodeName}:Server=!{serverName}:ApplicationServer=:WebContainer=
:SessionManager=:Cookie=
AttributeInfo=defaultCookieSettings
#
#
#Properties
#
maximumAge=-1 #integer,default(-1)
name=JSESSIONID #default(JSESSIONID)
domain=
secure=false #boolean,default(false)
path=/ #default(/)
EnvironmentVariablesSection
#
#Environment Variables
cellName=WASCell06
serverName=myServer
nodeName=WASNode04
- Exécutez la commande applyConfigProperties pour créer une configuration WebContainer
SessionManager.
L'exécution de la commande applyConfigProperties
applique le fichier de propriétés à la configuration. Dans cet
exemple Jython, le paramètre facultatif -reportFileName
génère un rapport nommé report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName MonTypeObjet.props -reportFileName report.txt '])
- Modifiez des propriétés du gestionnaire de sessions existantes.
- Obtenez un fichier de propriétés pour le gestionnaire de sessions à
modifier.
Vous pouvez extraire un fichier de propriétés
pour un objet WebContainer SessionManager à l'aide de la commande extractConfigProperties.
- Ouvrez le fichier de propriétés dans un éditeur et modifiez les
propriétés souhaitées.
Vérifiez que les variables d'environnement
dans le fichier de propriétés correspondent à votre système.
- Exécutez la commande applyConfigProperties.
- Supprimez les propriétés du gestionnaire de sessions.
Pour
supprimer une ou plusieurs propriétés, spécifiez les propriétés à supprimer
du fichier de propriétés, puis exécutez la commande deleteConfigProperties.
AdminTask.deleteConfigProperties('[-propertiesFileName MonTypeObjet.props -reportFileName report.txt]')
Résultats
Vous pouvez utiliser le fichier de propriétés pour configurer et gérer
le gestionnaire de sessions.
Que faire ensuite
Sauvegardez les modifications de la configuration.