You can use properties files to create, modify, or delete
session manager objects of an Enterprise JavaBeans (EJB) module configuration. An
EJB module must conform to Java Platform,
Enterprise Edition (Java EE) specifications.
Before you begin
Determine the changes that you want to make to a session
manager of an EJB module 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 EJB module 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 EJBModuleConfig 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 EJBModuleConfig SessionManager
object.
- Set EJBModuleConfig SessionManager properties as needed.
Open an editor on an EJBModuleConfig 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 EJBModuleConfig SessionManager properties
file follows:
#
# Header (EJBModuleConfig Session Manager)
#
ResourceType=SessionManager
ImplementingResourceType=Application
ResourceId=Cell=!{cellName}:Deployment=!{applicationName}:ApplicationDeployment=:ApplicationConfig=:EJBModuleConfig=myEJBModule: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 EJBModuleConfig 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.