Datastage server Maintenance mode
Maintenance
mode
To
prevent users from authenticating to IBM®
InfoSphere® Information Server during
maintenance, you can place it into maintenance mode with the
SessionAdmin command. Use the same command to take InfoSphere
Information Server out
of maintenance mode and to determine the current maintenance mode.
Placing InfoSphere
Information Server in
maintenance mode is useful when you do routine maintenance such as
applying a fix pack or backing up the system. When in maintenance
mode, only users with the suite administrator role and system users
can authenticate. Note also that in the Web admin console, Maximum
Sessions is
not editable while InfoSphere
Information Server is
in maintenance mode.
Usage
Use
the SessionAdmin command to set the maintenance mode for InfoSphere
Information Server.
You must have suite administrator authority to run this command. The
command is in the following locations:
- Linux
IS_install_dir/ASBServer/bin/SessionAdmin.sh
IS_install_dir/ASBNode/bin/SessionAdmin.sh
IS_install_dir/ASBNode/bin/SessionAdmin.sh
- Windows
IS_install_dir\ASBServer\bin\SessionAdmin.bat
IS_install_dir\ASBNode\bin\SessionAdmin.bat
IS_install_dir\ASBNode\bin\SessionAdmin.bat
Tip: In
the following usage examples, you can choose to use the -authfile
option instead of -user and -password.
Placing InfoSphere
Information Server in maintenance mode
SessionAdmin
-user username
-password plaintext_password
-kill-user-sessions
SessionAdmin
-user username
-password plaintext_password
-set-maint-mode ON
Taking InfoSphere
Information Server out of maintenance mode
SessionAdmin
-user username
-password plaintext_password
-set-maint-mode OFF
Determining
the current maintenance mode
SessionAdmin
-user username
-password plaintext_password
-get-maint-mode
Syntax
SessionAdmin
[-{verbose
| v}]
[-{results
| res} value
]
[-{log
| l} value
]
[-{logerror
| error} value
]
[-{loginfo
| info} value
]
[-{loglevel
| level} value
]
[-{help
| ?} ]
[-{host
| h} value
]
[-{port
| p} value
]
[-{user
| ur} value
]
[-{password
| pw} value
]
[-{authfile
| af} value
]
[-{kill-user-sessions
| kus} ]
[-{get-maint-mode
| gmm}]
[-{set-maint-mode
| smm} value
]
Parameters
[-{verbose
| v}]
Display
detailed runtime output, except for the runtime logging messages.
[-{results
| res} value ]
Print
all the enabled runtime output to the specified file.
[-{log
| l} value ]
Print
the runtime logging messages to the specified file. This option is
used with loglevel.
[-{logerror
| error} value ]
Print
all ERROR and FATAL runtime logging messages to the specified file.
[-{loginfo
| info} value ]
print
all INFO, WARN, DEBUG, and TRACE runtime logging messages to the
specified file.
[-{loglevel
| level} value]
The
level at which runtime logging messages are enabled.
[-{help
| ?} ]
Displays
the usage message.
[-{host
| h} value]
Host
machine name. The default value is localhost.
[-{port
| p} value]
Host
machine HTTP port. The default value is 9080.
[-{user
| ur} value ]
The
administrator user ID to run this command. If not specified and if
the -authfile parameter is not specified, you are prompted for a user
ID.
[-{password
| pw} value ]
The
password of the administrator user ID specified in the -user
parameter. This parameter cannot be specified without the -user
parameter. If the -user parameter is specified without the -password
parameter, you are prompted for a password.
[-{authfile
| af} value ]
The
path for the credentials file that contains the administrator user ID
and password to run this command. If the -user parameter is also
specified, the credentials file is ignored and you are prompted for a
password.
[-{kill-user-sessions
| kus} ]
Stop
all user sessions.
[-{get-maint-mode
| gmm}]
Display
the current maintenance mode setting.
[-{set-maint-mode
| smm} value ]
Set
the maintenance mode. Acceptable values are ON or OFF.