server_config add
The add subcommand has two uses:
To control which
Broker Server executable to use.
To add a
Broker Server by using or copying the configuration of an existing
Broker Server. By specifying an existing configuration file, you can propagate
Broker Server configurations among multiple platforms, add a previously configured
Broker Server to an active configuration, or quickly upgrade an existing
Broker Server deployment to a new release of
webMethods Broker.
Syntax
add datadir [-e exec] [-k license-file-path] [-p port] [-S]
Or:
add datadir [-m awbroker-cfg] [-k license-file-path] [-p port] [-S]
Argument | Description |
datadir | The path to the data directory for the Broker Server you are adding. Enclose the entire path in quotes if any portion of it contains a space. |
-e exec | The path to the awbroker executable file. This option allows you to run a Broker Server using an earlier release of webMethods Broker. The -k option (license file's absolute path) is required. Do not use in combination with the -m option. Enclose the entire path in quotes if any portion of it contains a space. |
-m awbroker-cfg | The path to the awbroker.cfg file to be used for the Broker Server to be added. A copy of the configuration file is placed in datadir. This option allows you to copy an existing Broker Server configuration. Do not use in combination with the -e option. |
-p port | The base port number to be used for the Broker Server to be added. This port number overrides any existing port number. This argument is needed if the default port 6849 is in use by another Broker Server. |
-k license-file-path | The Broker Server run-time license file. This license file overrides any existing license files. |
-S | Silent operation. No output is shown except for warnings and error messages. |
The following command-argument format adds a server, possibly overriding executable, license file path, and port number for the new server. The server is created if it does not exist. This requires specifying a license file path.
add datadir [-e exec] [-k license-file-path] [-p port] [-S]
The following command-argument format creates a new server using an existing the configuration file as a template. If the configuration file (using -m awbroker-cfg option) is not specified, awbroker.cfg from the specified data director is used. The license file path and port number may be overridden.
add datadir [-m awbroker-cfg] [-k license-file-path] [-p port] [-S]
Example 1
The following example adds a new Broker Server (placing a configuration file in the new server directory) by copying the existing configuration file in the server2 directory and specifying a new port number.
server_config.exe add "C:\Program
Files\webmethodsversion\Broker\data\awbrokersversion\myserver"
-m "C:\Program
Files\webmethodsversion\Broker\data\awbrokersversion\server2\awbroker.cfg"
-p 6830
Example 2
The following example adds an existing Broker Server to the active configuration. The configuration file already exists in the old server directory.
server_config.exe add "C:\Program
Files\webmethods\Broker\data\awbrokersversion\oldserver"