server_config update
You use the update subcommand to modify the following operating parameters:
Run-time license
Broker Server description
Base port number used by the
Broker ServerTip:
On Windows, the port number is part of the service name. If you change the port number, the program attempts to change the service name, an action that may not succeed. Another strategy to update a port number on Windows is to use the create subcommand to create a new Broker Server, copy the data files from the old data directory (not including the awbroker.cfg file), and delete the old Broker Server using the delete subcommand.
Syntax
server_config update datadir [-k license-file-path] [-d description]
[-p port] [-S]
You must stop the Broker Server before running the server_config utility. For the changes to take effect, you must restart the Broker Server.
Argument | Description |
datadir | The data directory for the Broker Server you are updating. Enclose the path name in quotes if any portion of it contains a space. |
-k license-file-path | The absolute path to the new license-key file. |
-d description | A new description of the Broker Server. This optional description appears on various pages in the Broker user interface. If the text includes spaces, enclose the entire description in quotation marks. |
-p port | The new base port to be used by the Broker. Stop the Broker before you attempt to change the port number. |
-S | Silent operation. No output is shown except for warnings and error messages. |
Example
The following example updates the configuration of a Broker to use a new run-time license and a new description.
server_config.exe update C:\SoftwareAG\Broker\data\awbrokersversion\server2
-k C:\SoftwareAG\Broker\config\license.xml
-desc "PRODUCTION--Broker Server for manufacturing"