Troubleshooting installation issues on Kubernetes

Use this information to troubleshoot installation issues with the IBM® App Connect Operator on Kubernetes.

If you encounter issues with your IBM App Connect Operator 11.5.1 or earlier installation, you can run the following commands to verify that the Operator was correctly installed:

1. Check that the IBM App Connect Operator is included in the list of Operators that are available for installation in the cluster:

   kubectl get packagemanifest ibm-appconnect

   The output should be similar to this:

   
   NAME                     CATALOG                                 AGE
   ibm-appconnect           IBM App Connect Operator Catalog k8S    10h

2. Check the contents of the subscription resource that you created for the Operator and verify that there are no warnings. In this command, subscriptionName represents the metadata.name value that was specified in the Subscription resource YAML file.

   kubectl get subscription -n namespaceName subscriptionName -o yaml

   For example:

   kubectl get subscription -n ace-fiona ibm-appconnect -o yaml

   The output should be similar to this:

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     annotations:
       kubectl.kubernetes.io/last-applied-configuration: |
         {"apiVersion":"operators.coreos.com/v1alpha1","kind":"Subscription","metadata":{"annotations":{},"name":"ibm-appconnect","namespace":"ace-fiona"},
   "spec":{"channel":"v1.4","installPlanApproval":"Manual","name":"ibm-appconnect","source":"ibm-appconnect-catalog","sourceNamespace":"olm"}}
     creationTimestamp: "2021-04-26T22:03:17Z"
     generation: 1
     labels:
       operators.coreos.com/ibm-appconnect.operators: ""
     managedFields:
     - apiVersion: operators.coreos.com/v1alpha1
       fieldsType: FieldsV1
       fieldsV1:
   ...
     name: ibm-appconnect
     namespace: ace-fiona
     resourceVersion: "22766120"
     selfLink: /apis/operators.coreos.com/v1alpha1/namespaces/ace-fiona/subscriptions/ibm-appconnect
     uid: 72b3e2ec-3133-420c-8d77-900fe0d31e80
   spec:
     channel: v1.4
     installPlanApproval: Automatic
     name: ibm-appconnect
     source: ibm-appconnect-catalog
     sourceNamespace: olm
     startingCSV: ibm-appconnect.v1.4.0
   status:
     catalogHealth:
     - catalogSourceRef:
         apiVersion: operators.coreos.com/v1alpha1
         kind: CatalogSource
         name: ibm-appconnect-catalog
         namespace: olm
         resourceVersion: "22650614"
         uid: c6c4d0c1-6a3b-4124-a2d9-e26868b03dbc
   ...
     conditions:
     - lastTransitionTime: 2021-04-30T17:08:24Z
       message: all available catalogsources are healthy
       reason: AllCatalogSourcesHealthy
       status: "False"
       type: CatalogSourcesUnhealthy
     currentCSV: ibm-appconnect.v1.4.0
     installPlanGeneration: 1
     installPlanRef:
       apiVersion: operators.coreos.com/v1alpha1
       kind: InstallPlan
       name: install-lhrj8
       namespace: ace-fiona
       resourceVersion: "22765136"
       uid: f9eba56d-a4fb-4e33-ac50-1291062992e0
     installedCSV: ibm-appconnect.v1.4.0
     installplan:
       apiVersion: operators.coreos.com/v1alpha1
       kind: InstallPlan
       name: install-lhrj8
       uuid: f9eba56d-a4fb-4e33-ac50-1291062992e0
     lastUpdated: 2021-04-30T17:08:57Z
     state: AtLatestKnown

3. Check the contents of the InstallPlan and verify that there are no errors. In this command, installPlanName represents the status.installplan.name value that is shown in the output from the previous command.

   kubectl get installPlan -n namespaceName installPlanName -o yaml

   For example:

   kubectl get installPlan -n ace-fiona install-lhrj8 -o yaml

   The output should be similar to this:

   apiVersion: operators.coreos.com/v1alpha1
   kind: InstallPlan
   metadata:
     creationTimestamp: 2021-04-30T17:08:21Z
     generateName: install-
     generation: 1
     labels:
       operators.coreos.com/ibm-appconnect.ace-fiona: ""
     managedFields:
     - apiVersion: operators.coreos.com/v1alpha1
       fieldsType: FieldsV1
       fieldsV1:
   ...
     name: install-lhrj8
     namespace: ace-fiona
     ownerReferences:
     - apiVersion: operators.coreos.com/v1alpha1
       blockOwnerDeletion: false
       controller: false
       kind: Subscription
       name: ibm-appconnect
       uid: 72b3e2ec-3133-420c-8d77-900fe0d31e80
     resourceVersion: "27531181"
     selfLink: /apis/operators.coreos.com/v1alpha1/namespaces/ace-fiona/installplans/install-lhrj8
     uid: f9eba56d-a4fb-4e33-ac50-1291062992e0
   spec:
     approval: Automatic
     approved: true
     clusterServiceVersionNames:
     - couchdb-operator.v1.4.3
     - ibm-appconnect.v1.4.0
     generation: 1
   status:
     bundleLookups:
     - catalogSourceRef:
         name: ibm-appconnect-catalog
         namespace: olm
       identifier: ibm-appconnect.v1.4.0
       path: ibmcom/appconnect-operator-bundle-k8s@sha256:0182ea715e390c9cac6dd666f72f2134c716af776018c344944b7618dede0344
       properties: '{"properties":[{"type":"olm.gvk","value":{"group":"appconnect.ibm.com","kind":"Configuration","version":"v1beta1"}},{"type":"olm.gvk","value":
   {"group":"appconnect.ibm.com","kind":"Dashboard","version":"v1beta1"}},{"type":"olm.gvk","value":{"group":"appconnect.ibm.com","kind":"DesignerAuthoring",
   "version":"v1beta1"}},{"type":"olm.gvk","value":{"group":"appconnect.ibm.com","kind":"IntegrationFlow","version":"v1beta1"}},{"type":"olm.gvk",
   "value":{"group":"appconnect.ibm.com","kind":"IntegrationServer","version":"v1beta1"}},{"type":"olm.gvk","value":{"group":"appconnect.ibm.com","kind":"SwitchServer",
   "version":"v1beta1"}},{"type":"olm.package","value":{"packageName":"ibm-appconnect","version":"1.4.0"}}]}'
       replaces: ibm-appconnect.v1.3.2
     - catalogSourceRef:
         name: operatorhubio-catalog
         namespace: olm
       identifier: couchdb-operator.v1.4.3
       path: quay.io/operatorhubio/couchdb-operator:v1.4.3
       properties: '{"properties":[{"type":"olm.gvk","value":{"group":"couchdb.databases.cloud.ibm.com","kind":"Backup","version":"v1"}},{"type":"olm.gvk",
   "value":{"group":"couchdb.databases.cloud.ibm.com","kind":"Bucket","version":"v1"}},{"type":"olm.gvk","value":{"group":"couchdb.databases.cloud.ibm.com",
   "kind":"CouchDBCluster","version":"v1"}},{"type":"olm.gvk","value":{"group":"couchdb.databases.cloud.ibm.com","kind":"Formation","version":"v1"}},
   {"type":"olm.gvk","value":{"group":"couchdb.databases.cloud.ibm.com","kind":"FormationLock","version":"v1"}},{"type":"olm.gvk","value":
   {"group":"couchdb.databases.cloud.ibm.com","kind":"Recipe","version":"v1"}},{"type":"olm.gvk","value":{"group":"couchdb.databases.cloud.ibm.com",
   "kind":"RecipeTemplate","version":"v1"}},{"type":"olm.package","value":{"packageName":"couchdb-operator","version":"1.4.3"}}]}'
       replaces: couchdb-operator.v1.4.2
   ...