Content Server Manual / 3.13.2.15 Runlevel

Advanced Search

Content Server Manual / Version 2110

Table Of Contents

3.13.2.15 Runlevel

With the runlevel tool you control the mode of operation of the content server. See Section 2.4, “Server Run Levels” for details about runlevels. You should always use runlevel to shut down the server.

usage: cm runlevel -u <user> [other options] -r <runlevel> 
              [-g <grace>] [-w <timeout>]
          runlevel -u <user> [other options] -a
          runlevel -u <user> [other options] -a
available options:
 -g,--grace <grace>          grace period in seconds 
                             (default=120),
                             use jointly with the option -r
 -w,--wait <wait>            wait time in seconds (default is
                             not to wait for runlevel change),
                             use jointly with the option -r
 -a,--abort                  abort pending runlevel switch
 -d,--domain <domain name>   domain for login (default=<builtin>)
 -p,--password <password>    password for login
 -r,--runlevel <runlevel>    desired runlevel (one of offline,
                             maintenance, administration, online)
 -u,--user <user name>       user for login (required)
 -url <ior url>              url to connect to
 -v,--verbose                enables verbose output

The options have the following meaning:

Parameter	Description
`-g`	Delays the runlevel switch for the specified number of seconds. This gives users the chance to save their changes and logout. During the grace period the runlevel switch can be aborted with the `-a` option.
`-w`	If used with `-r`, the utility will not exit before the target runlevel has been reached (exit code 0) or the specified number of seconds have passed (exit code 1). The utility will not fail, if a runlevel change has already been scheduled (it will not reschedule another change, but just wait for the specified runlevel to be reached). If the server is not available when the utility is run, it will not fail but keep trying to connect or time out after the specified number of seconds. If time out is met, `runlevel` will exit with exit code 1.
`-a`	Abort a pending runlevel switch triggered by a recent invocation of `runlevel`.
`-r`	Specify the new runlevel. The legal values are described in the Operations Basics

Table 3.35. Options of runlevel

Note that you cannot switch the runlevel from offline mode. You have to restart the server instead.

Search Results

Table Of Contents