server_config relocate
The relocate subcommand configures the Broker Server to use the new data directory paths for the storage files. If you want to use a storage file that is outside the data directory, use the -qs_map_file option to map the storage file.
The relocate subcommand does not support relocation of storage files belonging to a different operating system. If you want to migrate data from a different operating system, use the command-line utilities or My webMethods to export and import webMethods Broker metadata.
Syntax
server_config relocate datadir [-k license-file-path] [-b basic-auth-cfg]
[-qs_map_file storage-file-old-path storage-file-new-path]*
Argument | Description |
datadir | The absolute path to the new data directory. |
-k license-file-path | Optional. The absolute path to the Broker Server run-time license file. The location must have a valid license file in XML format as provided by Software AG. Use this option only if the license file is located outside the new data directory. |
-b basic-auth-cfg | Optional. The absolute path to the new basic authentication configuration file (basicauth.cfg). Use this option only if the basic authentication configuration file (basicauth.cfg) is located outside the new data directory. |
-qs_map_file storage-file-old-path storage-file-new-path | Optional. The absolute paths to the old storage file and the new storage file. Provide separate mapping for each storage file outside the new data directory. Use this option only if you want to use a storage file that is outside the new data directory. |
Usage Notes
After you use the relocate subcommand, execute the server_config add command to add the new data directory to Broker Monitor's configuration file (awbrokermon.cfg).
Example
server_config relocate C:\SoftwareAG\Broker\data\awbrokers95\default
-k C:\SoftwareAG\Broker\config\license.xml
-b C:\SoftwareAG\Broker\config\basicauth.cfg-qs_map_file
D:\SoftwareAG\Broker90\Broker.qs.stor C:\SoftwareAG\Broker95\Broker.qs.stor