Working with application configuration session manager properties files

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.
    1. 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
    2. 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.
    1. 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.

    2. 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.

    3. 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.