Startup and Shutdown

This chapter describes the commands and various options for starting and stopping WebtoB.

To start and stop the WebtoB system, use the webtob binary located in the ${WEBTOB_HOME}/bin directory.

  • Usage

    > webtob [-a <target action>][-c <configuration file name>][-p <configuration file path>][-t <forced shutdown time>][-i][-v][-V][-L][-h]
    Option Description

    [-a <target action>]

    Specifies the target action. (Default: start)

    • start

    • start-engine

    • start-manager

    • stop

    • stop-engine

    • stop-manager

    • restart

    [-c <configuration file name>]

    Specifies the configuration file name. (Default: webtob-config.json)

    [-p <configuration file path>]

    Specifies the configuration file path. (Default: ${WEBTOB_HOME}/config)

    [-t <Forced shutdown time>]

    Specifies the timeout before a forced shutdown. (Unit: seconds, default: 60)

    [-i]

    Performs an immediate forced shutdown. By default, it completes ongoing tasks before shutdown, but using this option does not guarantee task completion.

    [-v]

    Displays the current WebtoB version information.

    [-V]

    Starts WebtoB in verbose mode. Since logs are printed to the console and WebtoB runs as a foreground process, the shell cannot be used until the process stops.

    [-L]

    Identical to [-V] option, but log level is fixed at DEBUG regardless of configuration.

    [-h]

    Prints help information.

Starting WebtoB

To start WebtoB, run the webtob or webtob -a start command.

The following is an example of executing the webtob command to start WebtoB.

$ webtob
Environment variables for WebtoB:
        WEBTOB_HOME = /home/webtob/

Welcome to WebtoB Demo system.
Enterprise edition License in used.
Success to load config files : webtob-config.json
******* Configuration initialized successfully *******
Current WebtoB Configuration:
        Number of client handlers (HTH) = 1
        Number of worker threads per handler (HTH) = 8
        Number of connection pool size per handler (HTH) = 8192

Today is 2025-06-12
License expires on 2099-12-31 (27230 days remaining)

Booting WebtoB on node (webtob)
Current maximum open files per node 1024
Limit of open files is increased from 1024 to 1048576
Version: WebtoB 6 Fix #1 Linux B0 epoll 2025.06.05
Starting Server(pid:93736) at Thu Jun 12 16:49:14 2025
WebtoB manager starts managing WebtoB process (PID: 1446773)

Stopping WebtoB

To stop WebtoB, run the webtob -a stop command. Before stopping WebtoB, check the .webtob.pid file to see if WebtoB is currently running. Then, go to the ${WEBTOB_HOME}/bin directory and run the webtob -a stop command.

The following is an example of executing the webtob -a stop command to stop WebtoB.

$ webtob -a stop
Environment variables for WebtoB:
        WEBTOB_HOME = /home/webtob/
Shutting down WebtoB
WebtoB process (PID: 93736) is terminated normally. Stop managing process.
WebtoB(pid: 93736) is stopped.
Shutting down WebtoB Manager
WebtoB Manager (PID: 1446773) is stopped.