Removing a Db2 Data Gate instance

Important: IBM Cloud Pak® for Data Version 4.8 will reach end of support (EOS) on 31 July, 2025. For more information, see the Discontinuance of service announcement for IBM Cloud Pak for Data Version 4.X.

Upgrade to IBM Software Hub Version 5.1 before IBM Cloud Pak for Data Version 4.8 reaches end of support. For more information, see Upgrading from IBM Cloud Pak for Data Version 4.8 to IBM Software Hub Version 5.1.

Delete a Db2 Data Gate instance that you no longer need, or delete an instance to create a new instance with the same name.

About this task

A removal of an instance from the Cloud Pak for Data user interface sometimes does not delete all related objects of that instance. That is, you might be unable to pair a new instance with the same route host and port to the same Db2 for z/OS® subsystem or data sharing group without doing some clean-up work before.

Procedure

  1. Click Cloud Pak for Data main menu icon to open the Cloud Pak for Data main menu.
  2. Select Services > Instances.
    You see the Instances page. The Instances tab is in front. Your instances are listed in a table.
  3. Move your mouse pointer to the table row that represents the instance you want to work on. Move the mouse pointer to the very right of that row until a menu icon comes into view (Drop-down menu on instances table on My instances page.).
  4. From that drop-down menu (Drop-down menu on instances table on My instances page.), select Delete.
    A confirmation window is displayed:
    Figure 1. Instance-removal confirmation window
    Confirmation window that is displayed after you select the "Delete" option for an instance
  5. Click Delete.

Results

After completing the steps in the procedure, your instance should be removed entirely. However, in some situations, the removal function cannot remove all related objects. This will surface as a problem in the following situations:
  • You want to pair a new instance with the same route host and port to the same Db2 for z/OS subsystem or data sharing group. In this case, the removal function cannot remove all related objects from the Db2 for z/OS communications database.

    Therefore, you must clean up the communications database manually. Follow Instance not fully removed for instructions.

  • You want to pair a new instance with the same route host and port, and want to use the same storage as the removed instance (existing storage).

    In this case, remove the following folders and files manually from the storage entity:

    • appliance_etc
    • clone-api
    • dwa
    • dwa-apply-container-start.log
    • scratch
    • stunnel.conf
    • stunnel.pem
    • stunnel.pem.old