IBM データ・カタログ・ サービスのインストールとアップグレードに関する問題

このトラブルシューティング情報を使用して、 IBM Data Cataloging サービスに関連するインストールおよびアップグレードの問題を解決します。

リソースクォータが原因でインストールができない

問題ステートメント
IBM Fusionと IBM Data Catalogingのネームスペースにリソースクォータが設定されているため、 IBM Data Catalogingのインストールができません。 リソース・クォータが両方削除されるまで
解決策
IBM Data Catalogingのリソースクォータ値を以下のように設定する：
kind: ResourceQuota
apiVersion: v1
metadata:
  name: dcs-resource-quota
  namespace: ibm-data-cataloging
spec:
  hard:
    limits.cpu: '100'
    limits.memory: 180Gi
    pods: '120'
    requests.cpu: '20'
    requests.memory: 40Gi

データカタログのアップグレードが 1 時間以上停止しました

問題ステートメント
IBM データカタログのアップグレードが1時間以上止まっており、進捗率は15%です。
症状
IBM Data Catalogingのアップグレードが1時間以上実行され、15%で止まってしまう。 コンソール上では OpenShift® コンソールでは、インストールされたオペレータは IBM Data Cataloging オペレータのみを表示し、 ibm-data-cataloging ネームスペース下の IBM DB2 および Streams for Apache Kafka オペレータは表示されません。

また、 IBM Data Cataloging オペレータのサブスクリプションには、次のように表示されているInstallPlanPending, Reason "RequiresApproval.

解決策
  1. コンソールで OpenShift コンソールで、[ Operators ] > [ Installed Operators] タブに進みます。
  2. 選択するIBM Storage発見するオペレーター。
  3. へ移動サブスクリプションタブを選択し、InstallPlan。
  4. 承認するInstallPlan。
    代替方法としては、OpenShiftCLI は次のようになります。
    1. 次のコマンドを実行してInstallPlanそれは承認されません。
      oc get ip -n ibm-data-cataloging -o=jsonpath='{.items[?(@.spec.approved==false)].metadata.name}'
    2. 次のコマンドを実行してInstallPlan名前。
      oc patch installplan $(oc get ip -n ibm-data-cataloging -o=jsonpath='{.items[?(@.spec.approved==false)].metadata.name}') -n ibm-data-cataloging --type merge --patch '{"spec":{"approved":true}}'
  5. アップグレードプロセスが完了するまで待ちます。

データカタログインポートサービスポッドCrashLoopBackOff州

診断
  1. チェックCrashLoopBackOffインポート サービス ポッドで。
    oc -n ibm-data-cataloging get pod -l role=import-service
  2. ログが表示されていることを確認しますpermission deniedエラー:
    oc -n ibm-data-cataloging logs -l role=import-service
解決策
  1. インポート・サービス・ポッドをデバッグします。
    oc -n ibm-data-cataloging debug deployment/isd-import-service --as-user=0
  2. ディレクトリー権限を更新します。
    chmod 775 /uploads
mkdir -p /uploads/failed_requests
chmod 775 /uploads/failed_requests
exit

インストールまたはアップグレード中に IBM Data Cataloging データベース スキーマ ジョブが完了状態になっていません

注： この手順は、 IBM データ・カタログ・ サービスのデグレード状態に関連する、サービス・インストール後に利用不可モードになった DB2 を回復する場合に適用される。
症状
isd-db2whrest ポッドまたは isd-db-schema ポッドが作動不能状態またはエラー状態を報告します。

以下のコマンドを実行して、共通ログを表示します。

oc -n ibm-data-cataloging logs -l 'role in (db2whrest, db-schema)' --tail=200

ログを調べて、以下のエラーが存在するかどうかを確認します。

Waiting on c-isd-db2u-engn-svc port 50001...

db2whconn - ERROR - [FAILED]: [IBM][CLI Driver] SQL1224N The database manager is not able to accept new requests, has terminated all requests in progress, or has terminated the specified request because of an error or a forced interrupt. SQLSTATE=55032

Connection refused
解決策
  1. Db2: を再始動します。
    
oc -n ibm-data-cataloging rsh c-isd-db2u-0
sudo wvcli system disable -m "Disable HA before Db2 maintenance"
su - ${DB2INSTANCE}
db2stop
db2start
db2 activate db BLUDB
exit
sudo wvcli system enable -m "Enable HA after Db2 maintenance"
  2. Db2 HA モニターがアクティブであることを確認します。
    
sudo wvcli system status
exit
  3. インストール中またはアップグレード中に問題が発生したのか、インストール後の問題が発生したのかを確認してください。
  4. これがアップグレードまたはインストール中に発生した場合は、 isd-db-schema ジョブを再作成し、完了状態になるまでポッドをモニターします。
    SCHEMA_OLD="isd-db-schema-old.json"
SCHEMA_NEW="isd-db-schema-new.json"
oc -n ibm-data-cataloging get job isd-db-schema -o json > $SCHEMA_OLD
jq 'del(.spec.template.metadata.labels."controller-uid") | del(.spec.selector) | del (.status)' $SCHEMA_OLD > $SCHEMA_NEW
oc -n ibm-data-cataloging delete job isd-db-schema
oc -n ibm-data-cataloging apply -f $SCHEMA_NEW

    oc -n ibm-data-cataloging get pod | grep isd-db-schema
  5. これがインストール後の問題である場合は、 db2whrestを再始動します。
    oc -n ibm-data-cataloging delete pod -l role=db2whrest

IBM データ・カタログのインストールが1時間以上止まっている

注: この手順は、インストールの問題が発生した場合にのみ使用してください。アップグレードやそれ以降の問題には使用しないでください。
症状
IBM Data Catalogingのインストールを1時間以上行ったが、35%から80%（いずれも含む）の間で止まったままだった。
解決策
  1. 以下のコマンドを実行して、オペレーターをスケールダウンします。
    oc -n ibm-data-cataloging scale --replicas=0 deployment/spectrum-discover-operator
  2. 以下のコマンドを実行して、ワークロードをスケールダウンします。
    oc -n ibm-data-cataloging scale --replicas=0 deployment,statefulset -l component=discover
  3. DB スキーマ・ジョブが存在する場合は、以下のコマンドを実行して削除します。
    oc -n ibm-data-cataloging delete job isd-db-schema --ignore-not-found
  4. 以下のコマンドを実行して、 Db2 インスタンスとパスワード・シークレットを削除します。
    oc -n ibm-data-cataloging delete db2u isd
oc -n ibm-data-cataloging delete secret c-isd-ldapblueadminpassword --ignore-not-found
  5. Db2 ポッドと永続ボリューム要求が削除されるまで待ちます。
    oc -n ibm-data-cataloging get pod,pvc -o name | grep c-isd
  6. 以下のコマンドを実行して、オペレーターをスケールアップします。
    oc -n ibm-data-cataloging scale --replicas=1 deployment/spectrum-discover-operator

IBM Data Cataloging サービスが GPU ノードを備えた IBM Fusion HCI に正常にインストールされません

問題ステートメント
データ・カタログ・サービスは、何時間もインストール状態になっています。
解決策
この問題を解決するには、以下の手順を実行します。
  1. 新しいアフィニティーを使用して FSD にパッチを適用し、それらのノードで isd ワークロードをスケジュールしないようにします。
    oc -n <Fusion_namespace> patch fusionservicedefinitions.service.isf.ibm.com data-cataloging-service-definition  --patch "$(cat fsd_dcs_patch.yaml)"
    fsd_dcs_patch.yaml ファイル:
    
cat >> fsd_dcs_patch.yaml << EOF

apiVersion: service.isf.ibm.com/v1
kind: FusionServiceDefinition
metadata:
  name: data-cataloging-service-definition
  namespace: <Fusion_namespace>
spec:
  onboarding:
    parameters:
      - dataType: string
        defaultValue: ibm-data-cataloging
        descriptionCode: BMYSRV00003
        displayNameCode: BMYSRV00004
        name: namespace
        required: true
        userInterface: false
      - dataType: storageClass
        defaultValue: ''
        descriptionCode: BMYDC0300
        displayNameCode: BMYDC0301
        name: rwx_storage_class
        required: true
        userInterface: true
      - dataType: bool
        defaultValue: 'true'
        descriptionCode: descriptionCode
        displayNameCode: displayNameCode
        name: doInstall
        required: true
        userInterface: false
      - dataType: json
        defaultValue: '{"accept": true}'
        descriptionCode: descriptionCode
        displayNameCode: displayNameCode
        name: license
        required: true
        userInterface: false
      - dataType: json     
        defaultValue: '{"nodeAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":{"nodeSelectorTerms":[{"matchExpressions":[{"key":"nvidia.com/gpu","operator":"NotIn","values":["Exists"]}]}]}}}'
        descriptionCode: descriptionCode
        displayNameCode: displayNameCode
        name: affinity
        required: true
        userInterface: false
    
EOF
    出力にこのエラー・メッセージが表示される場合Error from server (UnsupportedediaType): the body of the request was in an unknown format - accepted media types include: application/json-patch+json, application/merge-patch+j son, application/apply-patch+yamlこの問題を解決するには、以下の手順を実行する必要があります。
    1. へ移動OpenShift Container PlatformWeb コンソール。
    2. Operators > Installed Operators タブの <Fusion_namespace> で、 IBM Fusion オペレータを選択します。
    3. IBM Fusion サービスインスタンス・タブを選択し、 data-cataloging-service-instance.
    4. 「YAML」タブを選択し、 data-cataloging-service-instanceの YAML ファイルを編集します。 spec.onboarding.parametersの下に、以下の行が追加されていることを確認します。
      - dataType: json
           defaultValue: '{"nodeAffinity":{"requiredDuringSchedulingIgnoredDuringExecution":{"nodeSelectorTerms":[{"matchExpressions":[{"key":"isf.ibm.com/nodeType","operator":"NotIn","values":["gpu"]}]}]}}}'
           descriptionCode: descriptionCode
           displayNameCode: displayNameCode
           name: affinity
           required: true
           userInterface: false
  2. パッチ FSD を表示します。
    
oc -n <Fusion_namespace> get fusionservicedefinitions.service.isf.ibm.com data-cataloging-service-definition -o yaml
  3. ユーザー・インターフェースからインストールします。

IBM データカタログデータベースのポッドが初期化フェーズでスタックする

症状
複数の Db2 ポッドがホスト・ポート 5002 を使用するため、ポッドが init フェーズにとどまる可能性があります。
解決策
  1. IBM Data Cataloging サービスをアンインストールします。 手順については、 IBM Data Catalogingのアンインストールを参照してください。
  2. IBM Data Cataloging FusionServiceDefinition パッチでファイルを作成する。
    cat >> fsd_dcs_patch.yaml << EOF
apiVersion: service.isf.ibm.com/v1
kind: FusionServiceDefinition
metadata:
  name: data-cataloging-service-definition
  namespace: ibm-spectrum-fusion-ns
spec:
  onboarding:
    parameters:
      - dataType: string
        defaultValue: ibm-data-cataloging
        descriptionCode: BMYSRV00003
        displayNameCode: BMYSRV00004
        name: namespace
        required: true
        userInterface: false
      - dataType: storageClass
        defaultValue: ''
        descriptionCode: BMYDC0300
        displayNameCode: BMYDC0301
        name: rwx_storage_class
        required: true
        userInterface: true
      - dataType: bool
        defaultValue: 'true'
        descriptionCode: descriptionCode
        displayNameCode: displayNameCode
        name: doInstall
        required: true
        userInterface: false
      - dataType: json
        defaultValue: '{"accept": true}'
        descriptionCode: descriptionCode
        displayNameCode: displayNameCode
        name: license
        required: true
        userInterface: false
      - dataType: json
        defaultValue: '{"size":1,"mln":2,"storage":{"activelogs":{"requests":"300Gi"},"data":{"requests":"600Gi"},"meta":{"requests":"100Gi"},"activelogs":{"tempts":"100Gi"}}}'
        descriptionCode: descriptionCode
        displayNameCode: displayNameCode
        name: dbwh
        required: true
        userInterface: false
EOF
  3. パッチを適用して、 Db2 クラスターのサイズを縮小します。
    oc -n ibm-spectrum-fusion-ns patch fusionservicedefinitions.service.isf.ibm.com data-cataloging-service-definition --type=merge --patch-file fsd_dcs_patch.yaml
  4. IBM Fusion ユーザーインターフェースから IBM Data Cataloging サービスをインストールします。 手順については、 IBM Data Catalogingのインストールを参照。