Installing capabilities

IBM Concert platform capabilities are provided by separate products that you install and then attach to the platform. You install only the capability products that you intend to use.

Before you begin

Install the platform hub and the data access layer before you install and attach capability products.

About this task

IBM Concert platform capabilities are provided by separate products that you install and then attach to the platform hub:

Concert Observe, powered by IBM Instana
Concert Optimize, powered by IBM Turbonomic
Concert Protect, Concert Resilience, Workflows and Data Apps, provided by the Concert product

Each product has its own installation documentation. After you install a product, you attach it to the platform hub by using the manage-product.sh script. Attaching the product enables Concert home in the main navigation.

Step 1: Install the capabilities that you purchased

Install each capability by following the product-specific installation documentation.

Concert Optimize (powered by IBM Turbonomic): IBM Turbonomic powers Concert Optimize. For installation instructions, see Installing Concert Optimize.

Concert Observe (powered by IBM Instana)

IBM Instana powers Concert Observe. For installation instructions, see Installing Concert Core Observability.

Concert Protect and Concert Resilience (powered by the Concert product)

The Concert product powers both Concert Protect and Concert Resilience. You install and attach these capabilities together.

The Concert product also includes Concert Workflows and Data Apps. For installation information for those components, see the Concert product documentation. If you already installed the Concert product when you installed the platform hub, you don't need to install it again.

Install the Concert product by following the Concert product installation documentation.
Record the Concert instance URL. You need this value when you attach the product to the platform hub.

Step 2: Attach capability products to the platform hub

After you install a capability product, attach it to the platform hub by running the manage-product.sh script. The script supports single-product attachment and batch attachment from a JSON file.

Attach a single product

Go to the directory that contains the manage-product.sh.
```
cd $INSTALL_DIR/ibm-platform-hub/bin
```

Run the script with command-line parameters.

./manage-product.sh --action=add --deployment-type=k8s \
  --product-id={PRODUCT_ID} \
  --instance-url={INSTANCE_URL}\
  --namespace={K8s NAMESPACE} \
  --restart-hub=true

Specify the following values:

Parameter	Description
`action`	Specify `add` to attach a product.
`deployment-type`	Specify `k8s` for all Kubernetes and Red Hat OpenShift deployments.
`product-id`	Specify one of the following product IDs, depending on which capability you want to attach: Concert Observe: `instana` Concert Optimize: `turbonomic` Concert Protect and Concert Resilience: `concert` Workflows: `workflows` Data Apps: `dataapps`
`instance-url`	Specify the URL where the product instance is available.
`namespace`	For Kubernetes deployments, specify the namespace where you installed the platform hub. Specify `$HUB_NS` if you exported this variable during installation.
`restart-hub`	Specify `true` unless you plan to attach more capabilities. You need to restart the hub only once after all capabilities are attached. VM deployment: Restarts all platform containers (calls stop and start scripts). Kubernetes deployment: Restarts hub deployment pods.
`json-file`	Specify the location of a JSON file that defines multiple capabilities. For more information, see Attach multiple products by using a JSON file

Kubernetes deployment example

./manage-product.sh --action=add --deployment-type=k8s \
  --product-id=instana \
  --instance-url=https://instana.example.com \
  --namespace=$HUB_NS \
  --restart-hub=true

Attach multiple products by using a JSON file

Go to the directory that contains the manage-product.sh
```
cd $INSTALL_DIR/ibm-platform-hub/bin
```

To attach multiple products at one time, create a JSON file that contains either a single product object or an array of product objects, and then pass that file to the script.

Example products.json file.

[
  {
    "product-id": "concert",
    "instance-url": "https://concert.example.com"
  },
  {
    "product-id": "instana",
    "instance-url": "https://instana.example.com"
  },
  {
    "product-id": "turbonomic",
    "instance-url": "https://turbonomic.example.com"
  }
]

Example command for a Kubernetes deployment.

./manage-product.sh --action=add --deployment-type=k8s \
  --namespace=platform-hub \
  --json-file=products.json \
  --restart-hub=true

The script processes each product in the array sequentially.

Step 3: Access the user interface (UI)

The installation process might take 15 to 30 minutes depending on your system resources and network speed.

When the process is complete, follow the product-specific installation instructions from any capability that you installed to access the UI. The main navigation shows all attached capabilities and Concert home.

For more information, see the individual products documentation. Depending on your deployment method, the installation steps for each product include instructions to access the UI.

Next steps

After you install and attach your capability products, configure your watsonx.ai instance for the platform.