You can use properties files to create, modify, or delete
session manager objects of an application configuration.
Before you begin
Determine the changes that you want to make to a session
manager of an application configuration.
Start the wsadmin scripting
tool. To start wsadmin using the Jython language, run the wsadmin
-lang jython
command from the bin directory
of the server profile.
About this task
Using a properties file, you can create, modify, or delete
a session manager.
Run administrative commands using wsadmin
to create or change a properties file for a session manager, validate
the properties, and apply them to your configuration.
Table 1. Actions for application configuration
session manager properties files . You can create, modify,
and delete session manager properties.
Action |
Procedure |
create |
Set required properties and then run the applyConfigProperties command. |
modify |
Make required changes to properties and then
run the applyConfigProperties command. |
delete |
To delete the entire ApplicationConfig SessionManager
object, uncomment #DELETE=true and then run the deleteConfigProperties command. |
create Property |
Not applicable |
delete Property |
Not applicable |
Optionally, you can use interactive mode with the commands:
AdminTask.command_name('-interactive')
Procedure
- Create a properties file for an ApplicationConfig SessionManager
object.
- Set ApplicationConfig SessionManager properties as needed.
Open an editor on an ApplicationConfig SessionManager
properties file. Modify the Environment Variables section to match
your system and set any property value that needs to be changed. To
specify a custom property, edit the AttributeInfo
value
and properties values. An example ApplicationConfig SessionManager
properties file follows:
#
# Header (ApplicationConfig's Session Manager)
#
ResourceType=SessionManager
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=:ApplicationConfig=:SessionManager=
AttributeInfo=sessionManagement
#DELETE=true
#
#
#Properties
#
enableSecurityIntegration=false #boolean,default(false)
maxWaitTime=5 #integer,default(0)
context=null
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)
#
EnvironmentVariablesSection
#
#
#Environment Variables
cellName=myCell04
applicationName=myApp
- Run the applyConfigProperties command
to create or change a session manager.
Running the applyConfigProperties command
applies the properties file to the configuration. In this Jython example,
the optional -reportFileName
parameter produces a
report named report.txt:
AdminTask.applyConfigProperties(['-propertiesFileName myObjectType.props -reportFileName report.txt '])
- Modify an existing properties file.
- Obtain a properties file for the session manager that
you want to change.
You can extract a properties file
for an ApplicationConfig SessionManager object using the extractConfigProperties command.
- Open the properties file in an editor and change the
properties as needed.
Ensure that the environment variables
in the properties file match your system.
- Run the applyConfigProperties command.
- If you no longer need the session manager, you can delete
the entire session manager object.
To delete the entire
object, specify DELETE=true
in the header section
of the properties file and run the deleteConfigProperties command;
for example:
AdminTask.deleteConfigProperties('[-propertiesFileName myObjectType.props -reportFileName report.txt]')
Results
You can use the properties file to configure and manage
the session manager object and its properties.
What to do next
Save the changes to your configuration.