IBM Integration Bus, Version 9.0.0.8 Operating Systems: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

See information about the latest product version

Changing the location of the work path

The work path directory is the location where a component 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 IBM® Integration Bus 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 systems

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 IBM Integration Bus 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. In the IBM Integration Console, locate the work path directory for your installation on the local system by running the following command:
    echo %MQSI_WORKPATH%
  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 pane of the Computer Management dialog, click Disk Management. The new partition that you added, and any existing partitions, are listed in the right 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 IBM Integration Bus creates in the work path location are stored on the new partition.

Changing the location of the work path on Linux and UNIX systems

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:

  1. Shut down all IBM Integration Bus services and processes.
  2. Create a new directory on a suitable file system.
  3. Locate the work path directory for your installation on the local system by running the following command:
    echo $MQSI_WORKPATH
  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 IBM Integration Bus 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 IBM Integration Bus creates in the work path location are stored in the new location.

an19000_.htm | Last updated Friday, 21 July 2017