cle_clock
Home > wikikonf >  was/actions/by kikonf > session







Session

print

Action : was.session   (Category : was, Name : session, By : kikonf)
Complete Name : was.session.by.kikonf
Version : 5.0        License : Modified BSD License

Purpose of the was category :
Easy to customize. This category use in background the wsadmin command in jython mode (through AdminConfig, AdminControl and AdminTask), to drive WebSphere Application Server ® configuration.
You can use it to manage the whole WebSphere ® architecture.

Purpose of this session plugin : Tune a Session Manager

The following shows the Descriptor File for the Action : was.session

Toggle lines
<!-- Copyright (c) 2008, Patrick Germain Placidoux                          -->
<!-- All rights reserved.                                                   -->
<!--                                                                        -->
<!-- This file is part of Kikonf Public Software.                           -->
<!--                                                                        -->
<!-- Kikonf Public Software is released under the modified BSD License,     -->
<!-- which should accompany it or any part of it in the file "COPYING".     -->
<!-- If you do not have this file you can access the license                -->
<!-- through the WWW at http://www.kikonf.org/license/bsd/license.txt.      -->
<!--                                                                        -->
<!-- Home page: http://www.kikonf.org                                       -->
<!-- Contact: kikonf@gmx.com                                                -->
<!-- ====================================================================== -->
<!--                                                                        -->
<!--                                                                        -->
<!--                                                                        -->
<!-- DESCRIPTION : Was alias configuration.                                 -->
<!--                                                                        -->
<!-- ====================================================================== -->
<!-- UPDATE     |     DATE     |   CODE   |  REASON                         -->
<!-- ====================================================================== -->
<!--            |              |          |                                 -->
<!--                                                                        -->
<!--                                                                        -->
<!-- ====================================================================== -->



<session
    type = '{\
        *eq:action,\
        *required:True,\
        *display:False\
    }'
    bal = '{*display:False}'
    sub_type = '{\
        *value:configuration,\
        *eq:configuration,\
        *required:True,\
        *deny:True,\
        *display:False\
    }'
    softwares = "{
        '*type':'dict',
        '*dtype':
            {
                'was':
                {
                    '*ge':'6.1',
                    '*le':'7.9',
                    '*required':True
                }
            },
        '*deny':True, 
        '*display':False
    }"
    
    enable='{\
        *value:true,\
        *checkIn:(false,true),\
        *help:%lang/action.was.en/session.enable.help,\
    }'
    do_cookies= '{\
        *value:true,\
        *checkIn:(false,true),\
        *help:%lang/action.was.en/session.do_cookies.help\
    }'
    do_ssl_tracking= '{\
        *value:false,\
        *checkIn:(false,true),\
        *help:%lang/action.was.en/session.do_ssl_tracking.help\
    }'    
    do_url_rewriting= '{\
        *value:false,\
        *checkIn:(false,true),\
        *help:%lang/action.was.en/session.do_url_rewriting.help\
    }'    
    do_security= '{\
        *value:false,\
        *checkIn:(false,true),\
        *help:%lang/action.was.en/session.do_security.help,\
        *lhelp:%lang/action.was.en/session.do_security.lhelp\
    }'    
    max_wait= '{*type:int,*value:30}'
    __wk__='{\
        *help:%lang/action.was.en/session.help,\
        *lhelp:%lang/action.was.en/session.lhelp\
    }'
>

    <scope 
        node = ''
        server = ''
        application = ''
        war =''
        __wk__='{\
            *eq:1,\
            *help:%lang/action.was.en/scope.help,\
            *lhelp:%lang/action.was.en/scope.lhelp\
        }'
    />

    <tuning
        allow_overflow= '{\
            *value:false,\
            *checkIn:(false,true),\
            *lhelp:%lang/action.was.en/session.tuning.allow_overflow.lhelp\
        }'
        invalidation_timeout='{\
            *type:int,\
            *value:30,\
            *lhelp:%lang/action.was.en/session.tuning.invalidation_timeout.lhelp\
        }'
        max_in_memory='{\
            *type:int,\
            *value:1000,\
            *lhelp:%lang/action.was.en/session.tuning.max_in_memory.lhelp\
        }'
        schedule_invalidation= '{\
            *value:false,\
            *checkIn:(false,true),\
        }'
        __wk__='{\
            *eq:1,\
        }'
    />

    <cookie
        name='{*value:JSESSIONID,*type:str,*lhelp:%lang/action.was.en/session.cookie.name.lhelp}'
        path='{*value:/,*type:str,*lhelp:%lang/action.was.en/session.cookie.path.lhelp}'
        maximum_age='{*value:-1,*type:int,*lhelp:%lang/action.was.en/session.cookie.maximum_age.lhelp}'
        secure= '{\
            *value:false,\
            *checkIn:(false,true),\
            *type:str,\
            *lhelp:%lang/action.was.en/session.cookie.secure.lhelp\
        }'
        __wk__='{\
            *eq:1,\
            *help:%lang/action.was.en/session.cookie.help,\
            *lhelp:%lang/action.was.en/session.cookie.lhelp\
        }'
    />

</session>
							
(Source: <KIKONF_INSTALLATION_DIR>/plugins/actions/was/session/by/kikonf/ACT_INF/action.xml)


A descriptor file is a WYSISWYG xsd like schema, wich describes what are the supported Tags, Attributes and Attributes values for one Action.
The special Attributes : type, sub_type, bal, softwares, __wk__ are reserved by Kikonf.

The table below summarizes the informations provided by the was.session Descriptor File :

/session>   Tune a Session Manager
Name Default Type Required Denied Help
enable true (false, true)     Disable a Session Manager.
do_cookies true (false, true)     Enable Cookies Affinity
do_ssl_tracking false (false, true)     Enable Ssl Id Affinity
do_url_rewriting false (false, true)     Enable Url rewriting Affinity
do_security false (false, true)     Enable Security Integration
max_wait 30 int      

/session/scope>   A scope refers to a Name Space where to create the resource
Required:True
Name Default Type Required Denied Help
node   str      
server   str      
application   str      
war   str      

/session/tuning>  
Required:True
Name Default Type Required Denied Help
allow_overflow false (false, true)    
invalidation_timeout 30 int    
max_in_memory 1000 int    
schedule_invalidation false (false, true)      

/session/cookie>   Tune your cookie.
Required:True
Name Default Type Required Denied Help
name JSESSIONID str    
path / str    
maximum_age -1 int    
secure false (false, true)    



Trademarks :
  • "IBM", "WebSphere", "WebSphere Aplication Server", "WAS" are registred trademarks of International Business Machines Corporation.
  • "Java" and "JVM" are a registred trademarks of Oracle and/or its affiliates.
  • Other names may be trademarks of their respective owners.

Copyright © 2011 - Patrick Placidoux, Hélène Malamoud