Creating a Broker Server with the Default Log and Storage Files
To create a new Broker Server, you use the server_config utility.
You can create a
Broker Server that uses separate storage sessions for metadata and run-time data. This is the recommended queue storage configuration. If you want to create a
Broker Server that uses a combined storage session, or use the server_config utility to create
Broker Servers, see
server_config create.
The following procedure creates a
Broker Server with the default log file and storage files sizes. If you want to specify the size and location of the log and storage files, see
Creating a
Broker Server that Specifies Size and Location of Files.
Note:
Unlike the installation process, which creates a default
Broker, the following procedure does not create any predefined
Brokers on the new
Broker Server. After the
Broker Server is created, you must define one or more
Brokers on the
Broker Server. For procedures, see
Creating a
Broker .
To create a
Broker Server with the default log and storage files
1. On the machine where Broker Server is installed, navigate to the following directory:
webMethods Broker_directory/bin
2. Run the following command.
server_config create dataDir -p port -k license-file-path
[-d description ] [-nostart] [-S]
Where... | Specifies... |
dataDir | The fully-qualified location of the data directory for the new Broker Server. Enclose the entire directory name in quotes if any portion of the name contains a space. The path that you specify must already exist although the data directory itself does not. For example, if you specify the data directory, C:\BrokerServers\data\BrokerServerEast01, the underlined portion of this structure must already exist. If the specified data directory exists when you run the server_config utility, be certain it is empty. |
port | The base port for this Broker Server. Be sure that this port and the two ports below it are available for this Broker Server to use. |
license-file-path | The absolute path to the license file for the Broker Server. The location must have the valid license file in XML format as provided by Software AG. |
description | An optional description for this Broker Server. This description appears when status information is displayed for the Broker Server and aids in identification of the server. Note: You do not have to provide a description when you create Broker Server. You can add it later using My webMethods. |
Include the -nostart parameter if you do not want
Broker Monitor to automatically start the
Broker Server after it is created.
Include the -s parameter to run the utility in "silent mode." In this mode, the utility suppresses informational messages and writes warnings and error messages to stdout:
Example in Windows:
server_config create
"c:\webMethods Broker_directory\Broker\data\awbrokersversion\My Broker"
-p 6800 -k c:\license_file_directory\new_license.xml -d "East Region Broker"
-nostart
Example in Unix:
server_config create /var/opt/webmethods/awbrokersversion/myBroker -p 6800
-k /tmp/licenses/new_license.xml -nostart -s