クラシックポリシーを使用する構成のアップグレードに関する考慮事項

January 9, 2024

寄稿者:

クラシックポリシーは、NetScalerリリース12.0ビルド56.20から廃止されました。リリース13.1以降、クラシックポリシーサポートは一部の機能から削除されました。リリース13.1以降でサポートされていない機能またはコマンドの完全なリストについては、「 NetScaler Classicポリシーベースの機能に関するステータス変更のお知らせ」 の表2を参照してください。

リリース 13.1 以降にアップグレードするための前提条件として、従来のポリシーを NSPEPI ツールでサポートされている機能の高度なポリシーに変換することをお勧めします。NSPEPI ツールでサポートされている機能については、「nspepi 変換ツールで処理されるコマンドまたは機能」を参照してください。アップグレード前に高度なポリシーに変換しないと、構成が無効なため、アップグレードは失敗します。

重要:

リリース13.1以降にアップグレードする前に、事前構成チェックツールを実行することをお勧めします。このツールにより、廃止または削除された機能に関連するコマンドが構成に含まれていないことが保証されます。廃止または削除された機能に関連するコマンドがある場合、ツールはエラーを返し、構成が失われる可能性があります。事前設定チェックツールの最新バージョンは、公開されている GitHub リンク-からダウンロードすることをお勧めします。 https://github.com/citrix/ADC-scripts/tree/master/nspepi

詳細については、アップグレード前の事前構成チェックツールを参照してください。

事前構成チェックの一環としてエラーが発生した場合は、 nspepi ツールを使用して無効な構成を有効な構成に変換することをお勧めします。公開されている GitHub リンク- https://github.com/citrix/ADC-scripts/tree/master/nspepiからnspepiツールの最新バージョンをダウンロードしてください。 nspepiツールを使用したポリシー表現の変換の詳細については、「 NSPEPI ツールを使用したポリシー表現の変換」を参照してください。

アップグレード前にクラシックポリシーを変換できなかった場合は、アップグレード中に高度なポリシーに変換することを選択できます。アップグレードの一環として、 ./installns コマンドの実行中に次の表に記載されているオプションのいずれかを選択できます。

オプション	説明
オプションなし	事前設定チェックでエラーが発生した場合、インストールは停止します。アップグレードプロセスを進めるには、クラシックポリシーを高度なポリシーに変換する必要があります。
-M	NSPEPI ツールはインストールの一部として実行され、従来のポリシーを高度なポリシーに変換します。
-Y	このオプションはお勧めしません。このオプションでは、事前構成チェックがスキップされるため、有効な構成が失われる可能性があります。

オプション

説明

オプションなし

事前設定チェックでエラーが発生した場合、インストールは停止します。アップグレードプロセスを進めるには、クラシックポリシーを高度なポリシーに変換する必要があります。

-M

NSPEPI ツールはインストールの一部として実行され、従来のポリシーを高度なポリシーに変換します。

-Y

このオプションはお勧めしません。このオプションでは、事前構成チェックがスキップされるため、有効な構成が失われる可能性があります。

アップグレード中にクラシックポリシーを高度なポリシーに変換するには、 -M オプションを選択します。-Mオプションは NSPEPI ツールを起動し、変更された構成で既存のns.confファイルを更新します。古い設定は、後で参照できるように/nsconfig/ns.conf_oldに用意しています。

./installns -M`
<!--NeedCopy-->

高度なポリシー変換中にエラーが見つかった場合は、NetScalerサポートにお問い合わせください。

nspepiツールは、一部のコマンドまたは機能の変換を処理しません。完全なリストについては、「 nspepi 変換ツールで処理されないコマンドまたは機能」を参照してください。

変換する必要がある各構成について、次の手順を実行します。

Citrix ADCリリース12.1または13.0でnspepiツールを実行してns.confファイルを変換します。NSPEPI ツールは、プレフィックスがnew_とwarn_の 2 つのファイルを生成します。 new_プレフィックスの付いたファイルには変換された構成が含まれ、warn_プレフィックスの付いたファイルには警告とエラーが含まれます。

warn_プレフィックスの付いたファイルを確認し、エラーがあれば修正します。

変換した構成をテストします。以下のオプションのいずれかを使用して、変換した設定を適用します。

clear config -f basic コマンドを実行し、 source /nsconfig/new_ns.conf コマンドを実行して変換された構成を取得します。
クラシックコマンドを手動で（ポリシーのバインドを解除して削除して）削除し、 source /nsconfig/new_ns.conf コマンドを実行して変換された構成を取得します。

注:

clear config -f basicコマンドを使用してクリアされない構成では、「リソースはすでに存在します」というエラーが表示される場合があります。これらのエラーは無視できます。

構成を保存します。

無効な構成を有効な構成に正常に変換したら、他の前提条件があるかどうかを確認し、アップグレードに進みます。詳しくは、「 NetScalerアプライアンスのアップグレードとダウングレード」を参照してください。

この記事の概要

この情報は役に立ちましたか?