Changing the location of the IBM App Connect Enterprise working directory

The IBM® App Connect Enterprise working directory is the location where components store 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 working directory does not have enough capacity, redirect the directory to another file system that has enough capacity.

About this task

The IBM App Connect Enterprise working directory1 is fixed at installation time so that IBM App Connect Enterprise 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 original working directory to a new location.

Note: When you create an integration node, you can specify a separate working directory for that integration node. For more information about this, see the -w workPath parameter of the mqsicreatebroker command.

Procedure

Changing the location of the working directory on Windows systems

About this task

When you change the location of the IBM App Connect Enterprise working directory, you mount a new partition at the location of the original working directory.

To change the location of the working directory on Windows, complete the following steps:

Procedure

  1. Shut down all IBM App Connect Enterprise services and processes.
  2. Create a new partition on the system.
    The new partition can be on the same drive as the original working directory, or on a different drive.
  3. In the IBM App Connect Enterprise Console, locate the working directory for your installation on the local system by running the following command: 
    echo %MQSI_WORKPATH%
  4. Copy the contents of the working directory to the new partition.
  5. Delete the contents of the original working 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 original working directory location.
  11. Click OK, then click OK again.

Results

Any files that IBM App Connect Enterprise creates in the working directory location are stored on the new partition.

Changing the location of the working directory on Linux

About this task

When you change the location of the IBM App Connect Enterprise working directory, you can either mount a new partition at the location of the original working directory, or you can replace the original working directory with a soft link that points to a new working directory.

To change the location of the working directory on Linux®, complete the following steps:

Procedure

  1. Shut down all IBM App Connect Enterprise services and processes.
  2. Create a new directory on a suitable file system.
  3. Locate the working directory for your installation on the local system by running the following command: 
    echo $MQSI_WORKPATH
  4. Copy the contents of the working directory to the new partition.
  5. Delete the contents of the original working directory.
  6. Perform one of the following tasks so that the IBM App Connect Enterprise installation uses the new working directory location:
    • Use the mount command to mount the new working directory at the location of the original working directory.
    • Delete the original working directory and replace it with a soft link. Give the soft link the same name as the original working directory and point the link to the new working directory.

Results

Any files that IBM App Connect Enterprise creates in the working directory location are stored in the new location.
1 This working directory is sometimes referred to as the IBM App Connect Enterprise work path directory.