Adding a new data disk to a Management appliance

IBM® API Connect uses the data disk on a Management appliance to store analytics data that is collected from the directory on which Elasticsearch, Informix®, and other processes are mounted. Over time, this disk begins to fill up. You allocate more data disk space by adding a new virtual data disk to the Management appliance, not by increasing the size of the existing data disk.

Before you begin

For information on determining how much disk space you need, see IBM API Connect topology.

You can determine the utilization of the data disk by running the stat show all CLI command on the Management appliance; the data disk corresponds to the /wip entry in the command output.

API Connect monitors the amount of disk space that is used by the analytics data. As the disk usage approaches 70 percent with data from the Elasticsearch, Informix, and other processes, a warning email is sent with recommendations for reducing the amount of information that you are saving to the disk. The email addresses that are specified for the following roles receive the email notifications when the disk space reaches 70% full, 80% full, and 90% full:

• cmc admin
• cmc owner
• topology administrator.

These notifications provide advanced notice when you are running out of disk space, so you can take steps to resolve the issue. The following list highlights some possible methods of managing your disk space:

• Set your log settings to retain less information in the logs. You can change these settings by selecting Settings > Analytics in the IBM API Connect Console.
• Add a virtual disk to your configuration. Complete the procedure later in this topic to add a virtual disk.
• Offload your analytics log information to another product. See Configuring destination targets for API Connect analytics data for information about how to offload your data.

1. Power off the virtual machine for your Management appliance.
2. In VMWare, allocate an additional virtual disk of the required size, and attach it to the Management appliance, by completing the following steps:
   1. Right-click your Management appliance name and select Edit settings.
   2. Select the Hardware tab and click Add.
   3. Choose Hard disk from the list of options, then click Next.
   4. Select the Create a new virtual disk radio button, then click Next.
   5. Under the Capacity heading, specify the required virtual disk size.
      Note: The maximum supported size for the new data disk is 2 TB.
   6. Under the Disk Provisioning heading, select the appropriate option for your organization.
      Select thick provisioning to prevent unexpected failures that can result when the host cannot allocate enough space when you use thin provisioning.
   7. Under the Location heading, select Store with the virtual machine, then click Next.
   8. Leave all content under the Virtual device node heading as default, then click Next.
   9. Review your settings, then click Finish.
3. Power on the virtual machine.
4. Run the following command to view the available disk space:

   stat show all

5. Optional: If the available disk space is not greater than it was before you added the disk, run a system reboot and repeat step 4.
6. If it did not increase following the restart, capture the logs and contact IBM support.