Uninstalling Concert, Concert Workflows, and Concert Data Apps on a VM

Edit online

You can uninstall Concert, Concert Workflows, and Concert Data Apps services to remove the containerized services with scripts and utilities that run on a Linux® x86 virtual machine (VM).

Before you begin

A cluster administrator must complete the appropriate tasks to uninstall the required products.
The uninstall action will permanently delete the installation directory, including all data and backup data, so move the backup data from the following path to a safe location before proceeding with the uninstallation:
```
$INSTALL_DIR/bin/../concert-hub/bin/../bin/../localstorage/volumes
```

Instructions

Refer to the following steps to uninstall Concert, Concert Workflows, and Concert Data Apps on a VM.

Set the $INSTALL_DIR variable:

export INSTALL_DIR=<install_directory>/ibm-concert

Navigate to the target installation directory:
```
cd $INSTALL_DIR
```
Uninstall the products using one of the following options based on your requirements:
1. To uninstall all products with interactive prompts, run the following command:
```
$INSTALL_DIR/bin/uninstall-products-on-vm
```
  You are prompted to confirm each product uninstallation. See step 3e for prompt details.
2. To uninstall all products without prompts, run the following command:
```
$INSTALL_DIR/bin/uninstall-products-on-vm --force
```
  This command uninstalls all products and removes images without prompts.
3. To uninstall a specific product with interactive prompts, run the following command:
```
$INSTALL_DIR/bin/uninstall-products-on-vm --product=<product-name>
```
  Replace <product-name> with concert, dataapps, workflows, or hub.
  
  You are prompted to confirm the product uninstallation. See step 3e for prompt details.
4. To uninstall a specific product without prompts, run the following command:
```
$INSTALL_DIR/bin/uninstall-products-on-vm --product=<product-name> --force
```
  Replace <product-name> with one of the following values: concert, dataapps, workflows, or hub.
  
  This command uninstalls the specified product and removes images without prompts.
5. If you choosed the uninstallation using prompts, respond to the prompts:
  1. When prompted to confirm the uninstallation of each product, enter one of the following responses:
```
Are you sure you want to uninstall Concert? (yes/no):
```
    - Enter yes to uninstall the product.
    - Enter no to skip the product and continue.
  2. If you are uninstalling Concert Workflows, provide the Concert Workflows namespace and FaaS namespace information when prompted.
    Note: If you did not specify custom namespaces during installation, use the default values: concert-workflows for Concert Workflows and faas for FaaS.
Remove the installation directory $INSTALL_DIR.
Note: When you run the command, this will remove the installation directory and all backup volumes.
```
rm -rf $INSTALL_DIR
```
To view help information about available command options, run the following command:
```
$INSTALL_DIR/bin/uninstall-products-on-vm --help
```

Results

The uninstall script removes product entries from the hub after each product is uninstalled. The hub is always uninstalled last.

If products remain in the hub, the hub is not uninstalled automatically.

Important: For Concert Workflows, the uninstall process deletes Kubernetes namespaces by using the WORKFLOWS_NS parameter (default: concert-workflows) and the WORKFLOWS_FAAS_NS parameter (default: faas) from the params.ini file.