Running the Broker Storage Utility in Fix Mode
Use the following procedure to run the Broker Storage Utility in fix mode. In this mode, the utility examines queue storage for inconsistencies and makes the changes necessary to resolve the inconsistencies.
Important:
This procedure will modify your queue storage file in an attempt to resolve inconsistencies. You should only run the utility in this mode on a copy of your queue storage system. For information about making a copy of queue storage, see
Files on which the Utility Operates.
By default, the utility automatically resolves inconsistencies that it detects in the storage system. However, you can optionally run the utility in "ask" mode, which instructs the utility to prompt you before it makes a change. For example, if the utility discovers that the storage system's log file is missing, it will ask whether you want to recreate the log file as shown here:
Phase 1: QS Log file for
"/var/opt/webmethods/awbrokersversion/default/Broker.qs"
named "/var/opt/webmethods/awbrokersversion/default/Broker.qs.log" was not
found.
Attempt to recreate (y/yes)? _
If you reject the solution that the utility suggests, the utility will exit. For example, if the utility reports that the log file is missing, you might want to decline the utility's proposed solution (which is to recreate the file) and check whether the file has simply been moved to another directory or whether its location had been incorrectly specified in the Broker Server configuration file.
If the utility cannot reconcile inconsistencies in the storage system, make sure you have a copy of the original, unmodified storage files and contact Software AG Global Support for assistance.
To run the
Broker Storage Utility in fix mode
1. Stop the Broker Server and navigate to the following directory:
webMethods Broker_directory /bin
2. Run the following command to start the utility:
server_qsck fix copyDir [-a] [-p phaseN um] [-v]
where copyDir is the path to the directory that contains a copy of the queue storage files.
Include... | If you want to... |
-a | Instruct the utility to prompt you before it attempts to resolve inconsistencies. Omit the -a flag if you want the utility to automatically reconcile inconsistencies that it encounters. |
-p | Specify the phase through which you want the utility to execute. For example, if you want the utility to reconcile inconsistencies uncovered during phases one and two, set this flag to 2. If omitted, all phases are performed. |
-v | Enable verbose mode, which displays informational messages and identifies the object on which the utility is operating. If omitted, only error messages and inconsistencies are displayed. |
For example:
server_qsck fix /var/opt/webMethods/awbrokersversion/myBrokerCopy -a -v
For additional information about the syntax for the
server_qsck command, see
server_qsck Command Reference.
3. After you have corrected all the files, run the utility in check mode one last time to verify that there are no residual errors. Make corrections as necessary.
4. Copy the queue storage files back to their original locations.