WebSphere Message Brokers
File: an19000_
Writer: Laura Cowen

Task topic

This build: July 31, 2007 21:33:45

Changing the location of the work path for WebSphere Message Broker

The work path directory is the location in which WebSphere Message Broker stores internal data, such as installation logs, component details, and trace output. The shared-classes directory is also located in the work path directory and is used for deployed Java code. If the work path directory does not have enough capacity, redirect the directory to another file system that has enough capacity.

The work path is fixed at installation time so that WebSphere Message Broker can always find the information that it needs, and always knows where to store new information.

If you need to change the location (for example, if you do not have enough capacity on the automatically-designated file system), do not change the path to the directory; instead, redirect the old work path directory to a new location.

Changing the location of the work path on Windows

When you change the location of the work path, you mount the new partition at the location of the old work path directory.

To change the location of the work path on Windows:

  1. Shut down all WebSphere Message Broker services and processes.
  2. Create a new partition on the system. The new partition can be on the same drive as the old work path, or on a different drive.
  3. Locate the work path directory for your installation by running the following command:
    mqservice component_name
    where component_name is the name of one of the components (for example, a broker) in the WebSphere Message Broker installation.
  4. Copy the contents of the work path directory to the new partition.
  5. Delete the contents of the old work path directory.
  6. Open the Computer Management dialog: click Start > Settings > Control Panel > Administrative Tools > Computer Management The Computer Management dialog opens.
  7. In the left-hand pane of the Computer Management dialog, click Disk Management. The new partition that you added and any existing partitions are listed in the right-hand pane.
  8. Right-click the new partition, then click Change Drive Letter and Paths.... The Change Drive Letter and Paths dialog opens.
  9. Click Add.... The Add Drive Letter or Path dialog opens.
  10. Ensure that Mount in the following empty NTFS folder is selected, then browse to the old work path location.
  11. Click OK, then click OK again.
Any files that WebSphere Message Broker creates in the work path location are stored on the new partition.

Changing the location of the work path on UNIX and Linux

When you change the location of the work path, you can either mount the new partition at the location of the old work path directory, or you can replace the old work path directory with a soft link that points to the new work path directory.

To change the location of the work path on UNIX and Linux (x86 platform):

  1. Shut down all WebSphere Message Broker services and processes.
  2. Create a new directory on a suitable file system.
  3. Locate the work path directory for your installation by running the following command:
    mqservice component_name
    where component_name is the name of one of the components (for example, a broker) in the WebSphere Message Broker installation.
  4. Copy the contents of the work path directory to the new partition.
  5. Delete the contents of the old work path directory.
  6. Perform one of the following tasks so that the WebSphere Message Broker installation uses the new work path location:
    • Use the mount command to mount the new work path directory at the location of the old work path directory.
    • Delete the old work path directory and replace it with a soft link. Give the soft link the same name as the old work path directory and point the link to the new work path directory.
Any files that WebSphere Message Broker creates in the work path location are stored in the new location.
Related reference
mqsicreatebroker command
Notices | Trademarks | Downloads | Library | Support | Feedback

Copyright IBM Corporation 1999, 2007Copyright IBM Corporation 1999, 2007. All Rights Reserved.
This build: July 31, 2007 21:33:45

an19000_ This topic's URL is: