Chapter 5. Starting Up and Shutting Down

Table of Contents

5.1. Starting WebtoB
5.1.1. Before Starting WebtoB
5.1.2. wsboot
5.2. Shutting Down WebtoB
5.2.1. wsdown

This chapter describes how to start up and shut down WebtoB after it has been configured.

5.1. Starting WebtoB

5.1.1. Before Starting WebtoB

Check the following items before starting WebtoB.

  • Does a binary WebtoB environment file exist?

  • Do WebtoB executable programs (wsm, htl, hth, htmls, cgis, ssis, etc.) in the WebtoBDir path of the NODE section exist?

    After checking these items, WebtoB is ready to start.

5.1.2. wsboot

The wsboot program starts the WebtoB system.

  • Usage

    > wsboot [-f binary WebtoB environment file name][-T][-i][-configuration file name][-g server group name]
           [-A][-S server name][-s server name][-k number count][-w][-b]
           [-B boot in Block Listen mode][-o CLOPT string][-h]
  • Options

    • Options for starting WebtoB:

      OptionDescription
      [-f binary WebtoB environment file name]

      WebtoB operates according to its environment file. The –f option allows the user to specify the binary environment file.

      If the binary environment file is not specified the default file, wsconfig, is used.

      [-T]Runs WebtoB management processes (WSM, HTL, HTH). To provide external services, each server must be running.
      [-i]WebtoB is started after the successful execution of the command "wscfl -i http.m".
      [-c configuration file name]WebtoB is started after the successful execution of the command "wscfl -i configuration file name".
    • Options applied after wsboot (used for starting processes):

      OptionDescription
      [-g server group name]

      Starts all server processes in the target server group.

      The server group must be defined in the SRVGROUP section of the environment file.

      [-A]Starts all server processes in the SERVER section of the WebtoB environment file. This option must be used with the –T option so that management processes are running.
      [-S server name]Starts the MinProc number of server processes in the target server.
      [-s server name]

      Starts only the processes in the target server. The server name must be defined in the SERVER section of the WebtoB environment file.

      [-k number count]Use this option with the [-s] option. The [-k] option is used to specify the number of server processes to be started. The sum of this number and number of active server processes cannot be greater than the MaxProc value specified in the SERVER section. If [-k] is not specified, only a single server process is started.
      [-w]Starts WebtoB server processes individually instead of collectively.
      [-b]Starts Backup Server if it is configured.
      [-B Boot as Block Listen state]Starts WebtoB in the blocked state where client requests are ignored.
      [-o CLOPT string][-o] file name. Saves the standard output.
      [-h]Shows help.

Example

The following is an example of starting all WebtoB management processes and service server processes specified in the wsconfig environment file.

$ wsboot

The following is an example of starting WebtoB management processes WSM, HTL, and HTH specified in the wsconfig2 environment file.

$ wsboot –T –f wsconfig2

The following is an example of starting all service server processes specified in the wsconfig environment file.

$ wsboot -A

The following is an example of starting MinProc number of svr1 processes specified in the environment file.

$ wsboot –S svr1 

The following is an example of starting 5 svr1 processes specified in the wsconfig2 environment file.

$ wsboot -s svr1 –k 5 -f wsconfig2 

When WebtoB system is started, the binary WebtoB environment file content is loaded onto shared memory and each nodes starts WebtoB feature processes (WSM, HTL, HTH) from the WEBTOBDIR directory specified in its environment file. Defined service server processes are then started in order.

The following is the start-up order of WebtoB processes.

WSM → HTL → HTH → Server processes

5.2. Shutting Down WebtoB

Similar to wsboot, the WebtoB system shutdown process applies the settings in the binary WebtoB environment file. Shared memory is eliminated and active WebtoB processes (WSM, HTL, HTH) and application server processes are terminated.

5.2.1. wsdown

The wsdown command shuts down the WebtoB system. The shutdown options are similar to the wsboot options.

  • Usage

    wsdown [-f binary WebtoB environment file name][-A]
           [-S server name][-s server name][–k count]
           [-g server group name][-p server number]
           [-i][-w delay (within 5 seconds)][-k count][-h] 
    wsdown [-f binary WebtoB environment file name][-A]
           [-S server name][-s server name][–k count]
           [-g server group name][-p server number]
           [-i][-w delay (<= 5 seconds)][-k count][-h]
  • Options

    OptionDescription
    [-f binary WebtoB environment file name]

    Binary WebtoB environment file name must be specified.

    If the file name is not specified, wsconfig is used by default.

    [-A]Shuts down all service server processes.
    [-S server name]Shuts down the currently operating target service server processes.
    [-s server name ]

    Shuts down the target server processes.

    Shuts down the specified number of target server processes. (Similar to wsboot)

    If the [-k] option is not specified, only a single server process is terminated.

    [–k count]This option must be used with the [–s] option.
    [-g server group name]

    Terminates server processes in the target server group.

    The group name must be defined in the SVRGROUP section of the WebtoB environment file.

    [-p server number]

    Terminates target server process using process numbers.

    Unlike terminating with the [-s] option, this option can terminate specific processes by using process numbers (spr_no). Process numbers can be listed using the st –p command in wsadmin.

    [-i]

    Immediately executes the wsdown command.

    Normally, the wsdown command allows running processes to finish tasks before termination. However, the [-i] command immediately and forcibly terminates all processes.

    [-w delay (Within 5 seconds)]Executes the wsdown command after the specified time. The specified time must be less than 5 seconds.
    [-h]Shows wsdown help.