health service-functionality list

Print the list of available service-functionality checks that are available on the current cluster.

Important: You cannot run any service-functionality commands as part of the runcommand command.

Prerequisites

Create a profile to use the cpd-cli management commands.

Pulling the required image from a private container registry

The ibm-service-functionality image is automatically mirrored when you mirror the IBM Software Hub images to your private container registry.

Before you run the cpd-cli health service-functionality command, you must authorize the client runtime environment on your workstation to pull the ibm-service-functionality image from the private container registry:

  1. Ensure that Docker or Podman is running on the client workstation.
  2. Source your installation environment variables script.
  3. Authenticate to your private container registry:
    • Docker
      docker login ${PRIVATE_REGISTRY_LOCATION} \
-u ${PRIVATE_REGISTRY_PULL_USER} \
-p ${PRIVATE_REGISTRY_PULL_PASSWORD}
    • Podman
      podman login ${PRIVATE_REGISTRY_LOCATION} \
-u ${PRIVATE_REGISTRY_PULL_USER} \
-p ${PRIVATE_REGISTRY_PULL_PASSWORD}

To use the ibm-service-functionality image from your private container registry, you must specify the following options when you run the cpd-cli health service-functionality command:

  • --image-prefix
  • --image-tag

For example:

cpd-cli health service-functionality \
--control_plane_ns=${PROJECT_CPD_INST_OPERANDS} \
--profile=${CPD_PROFILE_NAME} \
--image-prefix=${PRIVATE_REGISTRY_LOCATION} \
--image-tag=${VERSION}.${IMAGE_ARCH}

Syntax

cpd-cli health service-functionality list \
--control_plane_ns=<project-cpd-inst-operands> \
--profile=<cpd-profile-name> \
[--image-prefix=<image-registry-prefix>] \
[--image-tag=<image-tag> \
[--log-level=debug|trace] \
[--save] \
[--verbose]

Arguments

The command has no arguments.

Options

Table 1: Command options
Option Description
--control_plane_ns

-c

 The project where the IBM Software Hub control plane is installed.
Status
Required.
Syntax
--control_plane_ns=<project-cpd-inst-operands>
Default value
No default.
Valid values
The project where the IBM Software Hub control plane is installed.
--image-prefix Specify the registry that the image should be pulled from.
Status
Required if your cluster pulls images from a private container registry.
Syntax
--image-prefix=<image-registry-prefix>
Default value
icr.io/cpopen/cpd

If you omit this option, the default value is used.

Valid values
IBM Entitled Registry
icr.io/cpopen/cpd
Private container registry
${PRIVATE_REGISTRY_LOCATION}
--image-tag Specify the tag that identifies the image in the repository.

The tag must exist on the ibm-service-functionality image in the repository that you specified for the --image-prefix option.

Status
Required if your cluster pulls images from a private container registry.
Syntax
--image-tag=<image-tag>
Default value
No default.
Valid values
The value depends on which image you want to pull.
Tip: If you mirrored the images to a private container registry using the --arch flag, use the single-arch image.
Multi-arch image
${VERSION}
Single-arch image
${VERSION}.IMAGE_ARCH
--profile The name of the profile that you created to store information about an instance of Cloud Pak for Data and your credentials for the instance.
Status
Required.
Syntax
--profile=<cpd-profile-name>
Default value
No default.
Valid values

The name of the profile that you created.
Table 2: Global options
Option Description

--help

-h

 Display command help.
Status
Optional.
Syntax
--help
Default value
No default.
Valid values
Not applicable.
--log-level The command log level.
Status
Optional.
Syntax
--log-level=debug|trace
Default value
No default.
Valid values
debug
Debug messages are written to the log.
trace
Trace messages are written to the log.
--save Save output, resource YAML files, and pod container logs to the local file system.
Status
Optional.
Syntax
--save
Default value
false
Valid values
true|false
--verbose Display detailed information about resources in table format.
Status
Optional.
Syntax
--verbose
Default value
false
Valid values
true|false

Examples

Note: The following examples use the recommended installation environment variables.

It is strongly recommended that you use a script to create environment variables with the correct values for your environment. For more information, see Setting up installation environment variables.

Get the list of available service health checks based on the services that are installed
cpd-cli health service-functionality list \
--control_plane_ns=${PROJECT_CPD_INST_OPERANDS} \
--profile=${CPD_PROFILE_NAME}

Sample output:

############################################################################

                 AVAILABLE SERVICE FUNCTIONALITY CHECK IDS

############################################################################

CLUSTER: https://<

SERVICE ID	NAME
ccs       	Common Core Services
datastage 	DataStage
wkc       	IBM Knowledge Catalog
ws        	Watson Studio