Modifying file store configuration

After a file store has been created, you can, if required, modify file store attributes.

About this task

When you add a new bus member that uses a file store, you can choose either to accept the default settings for the file store or make changes to these settings, depending on your requirements.

After the file store has been created, you can, if required, subsequently modify the log size, permanent store size, or temporary store size settings directly through the administrative console. The new values take effect the next time the messaging engine is started.

The directory paths for the file store are fixed when the file store is created, and cannot subsequently be modified. You can create a new file store in a new location. To do this you remove the server or cluster as a bus member and then add it again choosing a new location for the file store. Any messages remaining in the original file store would be lost during this process.

Note: The default configuration for a file store is intended to be sufficient when used in typical messaging workloads. To improve the performance or resilience of the log file, the permanent store file, or the temporary store file, you can modify the file store attributes to control where these files are placed. For example, you can achieve better performance if you place these three file store files on a faster disk. Similarly, you can control the sizes of the log file, the permanent store file, and the temporary store file so that they can handle workloads with a large number of active transactions, large messages, or a large volume of message data resident in the messaging engine.

Procedure

  • To make changes to the log size, permanent store size or temporary store size, complete the following steps:
    1. Open the administrative console.
    2. Click Service integration -> Buses -> bus_name -> [Topology] Messaging engines -> engine_name -> [Additional Properties] Message store.
    3. Make the changes that you require to the existing log size, permanent store size, or temporary store settings, then click OK.
      For more information about configuring the properties, see the file store settings
    4. Save your changes to the master configuration.
  • To choose a new location for a file store, complete the following steps:
    1. To avoid losing messages on destinations that are localized on the file store, first ensure that no messages remain on the queues.
    2. Remove the server or cluster as a member of the bus.
    3. Add the server and cluster as a bus member again, choosing a new location for the file store.