Create a Broker Server and Use the Old Storage
1. Back up the old data directory.
2. Go to the old_Software AG_directory/Broker/bin directory and back up the old awbrokermon.cfg file.
3. Open the awbrokermon.cfg file and note the location of the old data directory as specified on the dataDir parameter.
4. Stop the old Broker Server, go to the old_Software AG_directory/Broker/bin directory, and run this command:
server_config remove full_path_to_old_data_directory
When asked whether to remove the Broker Server from the Broker Monitor configuration, enter Y.
5. If you need to copy the data directory to a new location (for example, because the old and new Broker installations are on different machines), do the following:
a. Copy the old data directory to the new location.
You might have old storage files (for example, .stor and .data files) that were located outside the old data directory. You can copy these files to the new data directory, or you can copy these files to a location outside the new data directory.
b. On the machine that hosts the new Broker, open a command window or shell, go to the new_Software AG_directory/Broker/bin directory, and run the command below. The command configures the Broker Server to use the new data directory paths for the old storage files.
If you copied old storage files to a location outside the new data directory, use the -qs_map_file option for each old storage file to map the file’s location on the old machine to the file’s location on the new machine.
server_config relocate full_path_to_new_data_directory
[-qs_map_file full_path_to_old_storage_file_in_old_location
full_path_to_copy_of_storage_file_in_new_location]
6. If you are migrating from and to multi-home machines (that is, machines that have multiple network interfaces and IP addresses), open the awbroker.cfg file and update the broker-ipaddress configuration to point to the new machine. If you do not, you might experience a port binding error when you create the Broker Server.
7. Create the Broker Server. On the machine that hosts the new Broker, open a command window or shell, go to the new_Software AG_directory/Broker/bin directory, and run the appropriate command below. Specify the same port for the new Broker Server that you used for the old Broker Server.
Location of Old Data Directory | Command |
Old location | server_config add full_path_to_old_data_directory
-k 9.6_license_file -p old_port
|
New location | server_config add full_path_to_new_data_directory
-k 10.5_license_file -p old_port
|
Broker Server details are automatically added to the Broker Monitor startup configuration.
8. If you installed the new Broker on a different machine than the old Broker but you could not use the same host name for the new machine, update the host name in the awbroker.cfg file.
9. Make sure the new Broker Server is running, as follows:
System | Steps |
Windows | a. Open the Windows Services window and make sure the status of the Software AG Broker Server 10.5(port) service is Started. b. Right-click the service and click Properties. Make sure the Path to Executable field points to the awbroker file for 10.5. |
UNIX | a. Run the command ps -ef | grep awbroker, which prints all running Broker processes including the path to the executable. Make sure the output text shows a line like this: full_path_to_new_Software AG_directory/Broker/bin/awbroker -d full_path_to_new_data_directory b. Make sure the awbroker process is running and that it is running from the 10.5 awbroker file. |