トラブルシューティング
変更を提案
PDF
Astra Trident のインストール中および使用中に発生する可能性のある問題のトラブルシューティングには、ここに記載されているポインタを使用してください。
全般的なトラブルシューティング
-
Tridentポッドが正常に起動しないと（Tridentポッドがで停止した場合など）
ContainerCreating準備が完了したコンテナが2つ未満のフェーズ）を実行中であることkubectl -n trident describe deployment tridentおよびkubectl -n trident describe pod trident--**詳細な分析情報を提供できます。kubeletログの取得（例：Viajournalctl -xeu kubelet)また有用である場合もある。 -
Tridentのログに十分な情報がない場合は、にアクセスしてTridentのデバッグモードを有効にすることができます
-dインストールオプションに基づいてインストールパラメータにフラグを設定します。次に、を使用してデバッグが設定されていることを
./tridentctl logs -n tridentを検索していますlevel=debug msgログに記録されます。- オペレータとともにインストールされます
-
kubectl patch torc trident -n <namespace> --type=merge -p '{"spec":{"debug":true}}'すべての Trident ポッドが再起動されます。これには数秒かかることがあります。これを確認するには、の出力の「経過時間」列を確認します
kubectl get pod -n trident。Astra Trident 20.07および20.10では
tprovの代わりにtorc。 - Helm とともにインストールされます
-
helm upgrade <name> trident-operator-21.07.1-custom.tgz --set tridentDebug=true`
- tridentctl を使用してインストールされます
-
./tridentctl uninstall -n trident ./tridentctl install -d -n trident
-
を含めて、各バックエンドのデバッグログを取得することもできます
debugTraceFlagsバックエンドの定義に含まれています。たとえば、と指定しますdebugTraceFlags: {“api”:true, “method”:true,}TridentログでAPI呼び出しとメソッドの逆数を取得する。既存のバックエンドにはを追加できますdebugTraceFlagsを使用して設定しますtridentctl backend update。 -
Red Hat CoreOSを使用する場合は、次の点を確認してください
iscsidはワーカーノードで有効になり、デフォルトで開始されます。この設定には、 OpenShift MachineConfig を使用するか、イグニッションテンプレートを変更します。 -
Trident をで使用する際によく発生する問題です "Azure NetApp Files の特長" テナントとクライアントのシークレットが、必要な権限がないアプリケーションの登録から取得された場合です。Trident の要件の詳細については、を参照してください "Azure NetApp Files の特長" 設定
-
PVをコンテナにマウントする際に問題が発生する場合は、を確認してください
rpcbindをインストールして実行しておきます。ホストOSに必要なパッケージマネージャを使用して、かどうかを確認しますrpcbindを実行しています。のステータスを確認できますrpcbindを実行してサービスを提供しますsystemctl status rpcbindまたはそれと同等のものです。 -
Tridentバックエンドがにあると報告した場合
failed以前は対処したことがあるにもかかわらず、状況はバックエンドに関連付けられたSVM /管理者クレデンシャルの変更が原因であると考えられます。を使用したバックエンド情報の更新tridentctl update backendTridentポッドをバウンスすると、この問題 が修正されます。 -
TridentをDockerでコンテナランタイムとしてインストールする際に権限の問題が発生した場合は、Tridentのインストールをで試してください
--in cluster=falseフラグ。これはインストーラポッドを使用せず、に起因する許可の問題を回避するtrident-installerユーザ： -
を使用します
uninstall parameter <Uninstalling Trident>実行に失敗したあとにクリーンアップに使用します。デフォルトでは、スクリプトは Trident によって作成された CRD を削除しないため、実行中の導入環境でも安全にアンインストールしてインストールできます。 -
以前のバージョンのTridentにダウングレードする場合は、
tridentctl uninstallTridentを削除するコマンド。必要なをダウンロードします "Trident のバージョン" を使用してをインストールしますtridentctl installコマンドを実行します -
インストールが成功した後、PVCがにスタックしている場合
Pending実行中のフェーズkubectl describe pvcTridentがこのPVCのPVのプロビジョニングに失敗した理由について追加情報 に説明できる。
オペレータを使用したTridentの導入に失敗
オペレータを使用してTridentを導入している場合は、ステータスがになります TridentOrchestrator からの変更 Installing 終了： Installed。を確認した場合は Failed ステータスが表示され、オペレータが単独でリカバリできない場合は、次のコマンドを実行してオペレータのログを確認する必要があります。
tridentctl logs -l trident-operator
trident-operator コンテナのログの末尾には、問題のある場所を示すことができます。たとえば、このような問題の 1 つは、エアーギャップ環境のアップストリームレジストリから必要なコンテナイメージをプルできないことです。
Tridentのインストールが失敗した理由を理解するには、
次の項目を参照してください： TridentOrchestrator ステータス。
kubectl describe torc trident-2
Name: trident-2
Namespace:
Labels: <none>
Annotations: <none>
API Version: trident.netapp.io/v1
Kind: TridentOrchestrator
...
Status:
Current Installation Params:
IPv6:
Autosupport Hostname:
Autosupport Image:
Autosupport Proxy:
Autosupport Serial Number:
Debug:
Image Pull Secrets: <nil>
Image Registry:
k8sTimeout:
Kubelet Dir:
Log Format:
Silence Autosupport:
Trident Image:
Message: Trident is bound to another CR 'trident'
Namespace: trident-2
Status: Error
Version:
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Warning Error 16s (x2 over 16s) trident-operator.netapp.io Trident is bound to another CR 'trident'
このエラーは、がすでに存在することを示します TridentOrchestrator
これはTridentのインストールに使用された機能です。各Kubernetesクラスタで実行できるのは
Tridentのインスタンスを1つ使用することで、
アクティブな状態が1つだけ存在する時間 TridentOrchestrator それができること
を作成します。
また、 Trident ポッドのステータスを確認することで、適切でないものがあるかどうかを確認できます。
kubectl get pods -n trident NAME READY STATUS RESTARTS AGE trident-csi-4p5kq 1/2 ImagePullBackOff 0 5m18s trident-csi-6f45bfd8b6-vfrkw 4/5 ImagePullBackOff 0 5m19s trident-csi-9q5xc 1/2 ImagePullBackOff 0 5m18s trident-csi-9v95z 1/2 ImagePullBackOff 0 5m18s trident-operator-766f7b8658-ldzsv 1/1 Running 0 8m17s
ポッドを完全に初期化できないことがわかります。
1つ以上のコンテナイメージが取得されなかったためです。
問題に対処するには、を編集する必要があります TridentOrchestrator CR。
または、を削除することもできます `TridentOrchestrator`をクリックし、新しい
修正された正確な定義を持つもの。
Tridentの導入に失敗しました tridentctl
何が問題になったかを確認するには、を使用してインストーラを再実行します -d 引数。デバッグモードをオンにして、問題の内容を理解するのに役立ちます。
./tridentctl install -n trident -d
問題に対処したら、次のようにインストールをクリーンアップし、を実行します tridentctl install コマンドの再実行：
./tridentctl uninstall -n trident INFO Deleted Trident deployment. INFO Deleted cluster role binding. INFO Deleted cluster role. INFO Deleted service account. INFO Removed Trident user from security context constraint. INFO Trident uninstallation succeeded.
Astra TridentとCRDを完全に削除
Astra Tridentと作成されたCRDと関連するカスタムリソースをすべて完全に削除できます。
|
この操作は元に戻せません。Astra Tridentを完全に新規にインストールする場合を除き、この作業は行わないでください。CRDを削除せずにAstra Tridentをアンインストールする方法については、を参照してください。 "Astra Trident をアンインストール"。 |
Astra Tridentをアンインストールし、Tridentオペレータを使用してCRDを完全に削除するには、次の手順を実行します。
kubectl patch torc <trident-orchestrator-name> --type=merge -p '{"spec":{"wipeout":["crds"],"uninstall":true}}'
Astra Tridentをアンインストールし、Helmを使用してCRDを完全に削除する手順は次のとおりです。
kubectl patch torc trident --type=merge -p '{"spec":{"wipeout":["crds"],"uninstall":true}}'
Astra Tridentのアンインストール後にCRDを完全に削除するには tridentctl
tridentctl obliviate crd
RWX rawブロックネームスペースo Kubernetes 1.26でNVMeノードのステージング解除が失敗する
Kubernetes 1.26を実行している場合、RWX rawブロックネームスペースでNVMe/TCPを使用すると、ノードのステージング解除が失敗することがあります。次のシナリオは、障害に対する回避策を提供します。または、Kubernetesを1.27にアップグレードすることもできます。
ネームスペースとポッドが削除されました
Astra Tridentで管理されるネームスペース（NVMeの永続的ボリューム）をポッドに接続したシナリオを考えてみましょう。ネームスペースをONTAPバックエンドから直接削除すると、ポッドを削除しようとすると、ステージング解除プロセスが停止します。このシナリオは、Kubernetesクラスタやその他の機能には影響しません。
該当するノードから永続的ボリューム（そのネームスペースに対応するボリューム）をアンマウントして削除します。
ブロックされたデータLIF
If you block (or bring down) all the dataLIFs of the NVMe Astra Trident backend, the unstaging process gets stuck when you attempt to delete the pod. In this scenario, you cannot run any NVMe CLI commands on the Kubernetes node. .回避策 すべての機能を復元するには、dataLIFSを起動します。
ネームスペースマッピングが削除され
If you remove the `hostNQN` of the worker node from the corresponding subsystem, the unstaging process gets stuck when you attempt to delete the pod. In this scenario, you cannot run any NVMe CLI commands on the Kubernetes node. .回避策 を追加します `hostNQN` サブシステムに戻ります。