Manually creating a CustomResourceDefinition in a Kubernetes environment

Describes the steps for manually creating the CustomResourceDefinitions which are required for the management subsystem. If the create-crd command is set to false during installation, the CRDs must be manually created by the Kubernetes administrator.

Before you begin

Note: This article refers to third-party software that IBM does not control. As such, the software may change and this information may become outdated.

These instructions assume you have a working Kubernetes environment and understand how to manage Kubernetes.

Kubernetes is a platform for automated deployment, scaling, and operation of application containers across clusters of hosts, providing container-centric infrastructure. For more information, see https://kubernetes.io.

About this task

If the apicup subsys set mgmt create-crd command is set to false in the Install Assist script (perhaps to disallow cluster-level access during installation), then the CRDs must be created manually prior to deploying API Connect in a Kubernetes environment.

Procedure

  1. Ensure you have not already installed the CRDs by executing the following command: kubectl get crd
  2. Download the cassandra-crds_lts_v2018.4.1.20.yaml CRD from IBM Fix Central at the following link: http://www.ibm.com/support/fixcentral/quickorder?product=ibm%2FWebSphere%2FIBM+API+Connect&fixids=cassandra-crds_lts_v2018.4.1.20.yaml&source=SAR
  3. Execute kubectl create -f <CustomResourceDefinition.yaml> (use the same file name as the one created to define the CRDs). This installs the two required CRDs, cassandraclusters.apic.ibm.com and cassandraclusterbackups.apic.ibm.com.
  4. Verify the installation by entering kubectl get crd. You should receive results similar to the following: 
    NAME                                   AGE
cassandraclusterbackups.apic.ibm.com   79d
cassandraclusters.apic.ibm.com         79d
  5. After installing the CRDs manually, install the management subsystem following the instructions at Installing the Management subsystem into a Kubernetes environment. Set the apicup subsys set mgmt create-crd command to false.