Citrix ADC

インストール、アップグレード、ダウングレードプロセスに関連する問題のトラブルシューティング

インストール、アップグレード、またはダウングレード処理の完了後にアプライアンスが期待どおりに動作しない場合は、まず問題の最も一般的な原因をチェックします。

トラブルシューティングのリソース

最適な結果を得るには、Citrix ADC インストール、アップグレード、ダウングレードに関連する問題のトラブルシューティングを行うために、次のリソースを使用します。

  • アプライアンスからの設定ファイル。高可用性ペアの場合、両方のアプライアンスからの構成ファイル。
  • アプライアンスの次のファイル:
    • 関連する newnslog ファイル。
    • ns.log ファイル。
    • メッセージファイル。
  • ネットワークトポロジダイアグラム。

問題と解決策

次に、インストール、アップグレード、ダウングレードに関する最も一般的な問題、およびそれらを解決するためのヒントを示します。

  1. 問題

    ハードウェアとソフトウェアの非互換性が原因で、Citrix ADC MPXアプライアンスのアップグレードが失敗します。

    解像度

    Citrix ADC MPXハードウェアとソフトウェアの互換性マトリクスを参照し 、ソフトウェアリリースがCitrix ADC MPXハードウェアでサポートされているかどうかを確認します。

  2. 問題

    Citrix ADC VPXアプライアンスとハイパーバイザーの非互換性が原因で、Citrix ADC VPXアプライアンスのアップグレードが失敗します。

    解像度

    Citrix ADC VPXアプライアンスおよびハイパーバイザーの互換性マトリクスを参照し 、Citrix ADC VPXアプライアンスモデルがハイパーバイザーでサポートされているかどうかを確認します。

  3. 問題

    ハードウェアとソフトウェアの非互換性が原因で、Citrix ADC MPXアプライアンスのアップグレードが失敗します。

    解像度

    Citrix ADCアプライアンスの整合性を検証します。Citrix ADCハードウェアアプライアンスをお持ちの場合は、fsckを実行してディスクチェックを実行し、Citrix ADCハードディスクの整合性を検証することをお勧めします。

    詳細については、「 Citrix ADCアプライアンスのファイルシステムの整合性を検証する方法」を参照してください。

  4. 問題

    GUIストールを使用したCitrix ADCアプライアンスのアップグレード。

    解像度

    ブラウザを更新して、アップグレードが進行中であるかどうかを確認します。

  5. 問題

    /var ディレクトリのスペースが不足しているため、Citrix ADCアプライアンスのアップグレードが失敗する

    解像度

    /var ディレクトリ上のスペースを解放します。詳細については、「 /var ディレクトリの空き領域を増やす方法」 を参照してください。

  6. 問題

    ソフトウェアのダウングレード後、Citrix ADCにアクセスできない

    原因

    ソフトウェアのダウングレード処理中に、既存のリリースとビルドの設定ファイルが以前のリリースおよびビルドの設定ファイルと一致しない場合、アプライアンスは設定をロードできず、デフォルトの IP アドレスがアプライアンスに割り当てられます。

    解像度

    • コンソールからアプライアンスにアクセスできることを確認します。
    • アプライアンスの NSIP アドレスとルートを確認します。
      • IP アドレスがデフォルトの 192.168.100.1 IP アドレスに変更されている場合は、必要に応じて IP アドレスを変更します。
      • アプライアンスがアクセス可能であることを確認します。
  7. 問題

    アップグレード中に、同期用のコマンドを実行すると、次のメッセージが表示されます。

    コマンドはセカンダリノードで失敗しましたが、プライマリノードで成功しました。

    解像度

    高可用性 (HA) 同期の実行中は、依存コマンド (set /unset /bind /unbind) を実行しないでください。

  8. 問題

    アップグレードプロセス中に、force failover コマンドを実行しても、トラフィックは新しいプライマリノードを通過しません。

    解像度

    • ネットワークトポロジとスイッチの設定に関する問題をチェックします。
    • set L2param-garpreply ENABLED コマンドを実行して、GARP 応答を有効にします。
    • まだ使用されていない場合は、仮想 MAC を使用してみてください。
    • プライマリノードから sendarp —a コマンドを実行します。
  9. 問題

    Citrix ADCアプライアンスをアップグレードまたはダウングレードした後、SSHを介したアプライアンスへの接続が失敗します。

    解像度

    Citrix ADCアプライアンスで次の操作を実行します。

    • /nsconfig/ssh/ssh_host_*で古いまたは安全でないホストキーを削除します。
    • /nsconfig/sshd_config でカスタムSSHD構成を確認し、それがまだ関連性と互換性があるかどうかを確認します。Google NMT それに応じて、カスタムSSHD構成の名前を変更するか削除します。
    • Citrix ADCアプライアンスをコールドリブートします
  10. 問題

    HA ペアでは、force HA フェールオーバーコマンドを実行した後も、デバイスはリブートを続けます。アップグレード後にセカンダリデバイスが起動しない。

    解像度

    /var ディレクトリがいっぱいかどうかを確認します。その場合は、古いインストールファイルを削除します。df —h コマンドを実行して、使用可能なディスク領域を表示します。

  11. 問題

    HA ペアをアップグレードすると、ノードの 1 つが UNKNOWN 状態として表示されます。

    解像度

    • 両方のノードが同じビルドを実行しているかどうかを確認します。ビルドが同じではなく、HA ノードにバージョンが一致しない場合、show ha node コマンドを実行すると、一部のフィールドが UNKNOWN と表示されます。
    • セカンダリアプライアンスが到達可能かどうかを確認します。
  12. 問題

    Citrix ADCをアップグレードすると、負荷分散仮想サーバーとサービスのほとんどがダウンしていることがインターフェイスに表示されます。

    解像度

    セカンダリアプライアンスで SNIP アドレスがアクティブであることを確認します。また、show service コマンドを入力して、サービスが実行されているかどうかを確認します。

  13. 問題

    アップグレードを実行すると、セカンダリアプライアンス上のすべての仮想サーバがダウンします。

    解像度

    次のコマンドを実行して、HA 状態と HA 同期を有効にします。

    • ノードのハーステートの有効化を設定する
    • ノードの非同期有効化を設定する

    HA を無効にすることは推奨されません。

  14. 問題

    ダウングレードを実行した後、Citrix ADCが正常に起動しません。

    解像度

    正しいライセンスがインストールされているかどうかを確認します。

  15. 問題

    HA ペアでは、アップグレードの実行後に一部の機能が同期化されません。

    解像度

    sync ha file misc コマンドを実行して、プライマリノードからセカンダリノードに設定ファイルを同期します。

  16. 問題

    再起動中に、次のエラーメッセージが表示されます。

    ns.conf の 1 つ以上のコマンドが失敗したどうしたらいいですか?

    解像度

    ns.conf ファイルのコマンドが 255 バイトの制限を超えていないことを確認します。25 バイト制限に対して長すぎるポリシーを作成するコマンドでは、パターンセットを使用してポリシーを短縮できます。

    例:

    add cs policy p11 -rule 'HTTP.REQ.URL.ENDSWITH_ANY("ctx_file_extensions")'
    Done
    <!--NeedCopy-->
    

    ctx_file_extensions は、多数の拡張子をカバーするデフォルトのパッチセットです。デフォルトのパターンセットに加えて、ユーザー定義のパターンセットを作成できます。次のコマンドを実行して、パッチセットを追加します。

    add patset <name>
    <!--NeedCopy-->
    

    注意:パッチセットは、リリース9.3以降でのみサポートされます。

  17. 問題

    Citrix ADC VPXアプライアンスをアップグレードする場合、/varの空き容量を増やすように指示されます。どのファイルを削除すればよいですか?

    解像度

    /var/tmp/ ディレクトリから古いインストールファイルを削除します。また、/flashから不要なファイルを削除します。

  18. 問題

    セカンダリアプライアンスで force HA フェールオーバーコマンドを実行しても、グラフィカルユーザーインターフェイス(GUI)に接続できません。

    解像度

    コマンドラインインターフェイスを使用してセカンダリアプライアンスにログオンし、set ns ip <IP>-gui enabled コマンドを実行して GUI へのアクセスを有効にします。

  19. 問題

    アップグレードの実行後、Java アプレット (アップグレードウィザードまたはライセンスウィザード) をロードする GUI 上のリンクをクリックすると、次のエラーメッセージが表示されます。GUI のバージョンがカーネルのバージョンと一致しません。このインスタンスを閉じて、Java プラグインのキャッシュをクリアして再度開いてください

    解像度

    • GUIを使用してCitrix ADCにログオンします。
    • [Citrix ADC Gateway]>[グローバル設定]に移動します。
    • [設定] の [グローバル設定の変更] をクリックします。
    • 詳細ペインの [クライアントエクスペリエンス] で、[UI テーマ] リストから [既定] を選択します。
    • [OK] をクリックします。
  20. 問題

    何らかの理由でCitrix ADCアプライアンスのアップグレードが失敗した場合、バックアップファイルを使用してアプライアンスを復元する方法は?

    解像度

    アップグレードが失敗した場合は、バックアップされたファイルを使用して、アプライアンスを以前のバージョンのCitrix ADCアプライアンスに復元します。詳細については、「 Citrix ADCアプライアンスのバックアップと復元」を参照してください。

    Citrix ADCクラスターセットアップのバックアップと復元の詳細については、「 クラスター設定のバックアップと復元」を参照してください。

  21. 問題

    Citrix ADCアプライアンスのアップグレードに失敗した後にライセンスが失われた場合、どのように問題を解決するのですか?

    解像度

    ライセンスが不足している場合、またはライセンスを再割り当てする場合は、次のトピックの「 ライセンスの概要」を参照してください。

これらのトラブルシューティング手順は、複数のリリース間でソフトウェアをダウングレードするときの設定が失われる問題にも適用されます。

その他の問題については、リリースノート、ナレッジセンターの記事、FAQ を参照してください。

インストール、アップグレード、ダウングレードプロセスに関連する問題のトラブルシューティング