Configuring the file system monitor

You can configure the file system monitor to specify different usage thresholds for individual file systems.

About this task

By default, the file system monitor checks all system and queue manager file systems every 60 minutes, it generates a warning when file systems are 75% full, and it generates a critical usage notification when file systems are 90% full. You can change these default settings to select which file systems are monitored and to configure specific usage thresholds for individual system or queue manager file systems. To monitor only specific file systems, you can disable monitoring for all file systems and specify usage thresholds for the file systems that you would like to monitor.

You can use the IBM® MQ Appliance web UI, the CLI, or the rest interface to make these changes.

• To configure the file system monitor by using the IBM MQ Appliance web UI.
  1. Start the IBM MQ Appliance web UI and click the Object icon .
  2. Select Monitoring > File System Usage Monitor.
  3. On the Main page, you can change the polling interval for all monitored file systems by altering the value in the Polling interval field. The minimum interval is 15 minutes.
  4. On the System page, you can change the warning and critical thresholds for all system file systems. You can also click Add to select particular system file systems, and specify warning and critical thresholds that apply to only that file system. For example, you can specify that the monitor generates a critical warning for the Temporary file system when it is 85% full. You can select any of the following system file systems:
     • system – System storage (Flash device)
     • temporary – Temporary storage (temporary:)
     • mqroot – IBM MQ root
     • mqbackup – IBM MQ queue manager backups (mqbackup:///QMgrs)
     • mqdiag – IBM MQ diagnostics (mqdiag:)
     • mqerr – IBM MQ errors (mqerr:)
     • mqtrace – IBM MQ trace (mqtrace:)
  5. On the Queue managers page, you can change the warning and critical thresholds for all queue manager file systems. You can also click Add to enter the name of a specific queue manager and specify warning and critical thresholds that apply to that queue manager alone. For high availability and disaster recovery configurations, queue managers in the secondary role are not monitored.
  6. When you have made the required changes, click Apply.
• To configure the file system monitor by using the CLI:
  1. Connect to the IBM MQ Appliance as described in Command line access. Log in as an administrative user.
  2. Type config to enter global configuration mode.
  3. Type fs-usage-monitor to enter file system usage monitor configuration mode.
  4. To configure the polling interval for all monitored file systems, use the poll command.
  5. To configure the default monitoring of all system file systems, use the following commands:
     • all-system
     • all-system-critical
     • all-system-warning
  6. To configure the default monitoring of all queue manager file systems, use the following commands:
     • all-qm
     • all-qm-critical
     • all-qm-warning
  7. To configure the monitoring of individual system file systems, use the system command.
  8. To configure the monitoring of individual queue manager file systems, use the qm command.
• For guidance on using the REST interface to configure the appliance, see REST management interface.