Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
 

アップグレード手順

以下は、コントロールセンターをアップグレードする手順です。これは通常従うべき手順です。別の手順については、次の章で説明します。

最新の Paragon Active Assuranceインストールガイドを必ず参照してください。

  • 「PostgreSQLデータベースのバックアップ」セクションから始まる、操作ガイドの製品データのバックアップの章に従ってバックアップを作成してください

    さらに、ファイルを /etc/netrounds/secret_key バックアップし、バックアップアーカイブと一緒に保管します。

    メモ:

    証明書と秘密キー ファイルのバックアップの作成は、リリース 4.1 以前のリリースからアップグレードする場合にのみ必要です。

  • コントロールセンターが使用するディスクまたはディスクパーティションのバックアップを作成します(またはVMスナップショットを作成します)。

  • および netrounds-callexecuter サービスを完全に無効にしますapache2

  • Paragon Active Assuranceサービスをすべて停止:

  • すべてのサービスが停止していることを確認します。

    一部のサービスが停止状態でない場合は、次のコマンドをもう一度実行します。

    問題が解決しない場合は、ジュニパーテクニカルサポートにお問い合わせください。

  • Ubuntu をバージョン18.04からバージョン22.04にアップグレードします。これは、以下にリンクされているページで説明されているように、2つのステップで実行できます。

  • 新しいコントロールセンターバージョンを含むtarballの整合性を検証します。

  • コントロールセンターのtarボールを解凍します。

  • 新しいコントロール・センター・パッケージをインストールします

    次の点に注意してください。

    • ファイル /etc/netrounds/netrounds.conf 内で、設定を PASSWORD_RESET_TIMEOUT_DAYS PASSWORD_RESET_TIMEOUT.前者はタイムアウトを日数で示し、後者は秒を単位として指定します。
    • このファイル /etc/netrounds/netrounds.conf では、 SPEEDTEST_ADDRESS オプションで設定を構成することもできます(Speedtestを使用する場合)。これは、解決されるのと同じIPアドレス SITE_URL を指すことも、独自のホスト名を持つこともできます。
    警告:

    既存の構成ファイルを上書きするかどうかを確認するメッセージが表示されます。続行する前に、以下の設定に関するすべての情報をお読みください。

    メモ:
    • 最初に「D」を選択して、古い設定と新しい設定の違いを調べることを強くお勧めします。ほとんどの場合、「N」を押して古い設定を保持する必要があります(上書きしないでください)。
    • 新しいオプション設定および更新された設定は、パッケージで提供されるサンプル構成ファイルで使用できる場合があります。これらを確認し、インストールに応じて新しいオプションを追加することをお勧めします。
    警告:

    Apacheの設定ファイルについては、

    「パッケージメンテナのバージョン」である「Y」を押す必要があります。

    デフォルトのsnakeoil証明書の代わりに適切なSSL証明書(推奨)をインストールしている場合は、Debianパッケージのインストールが完了した後、andSSLCertificateKeyFile設定のSSLCertificateFile正しいパスを指すようにファイルを再度変更する必要があります。インストールガイドのサービス設定の章の「SSL証明書の設定」セクションを参照してください。

  • データベースの移行を実行します。

    警告:

    データベースのパスワードをデフォルトから変更した場合は、 を実行する前にncc migrate、ファイルの設定/etc/netrounds/plugin.yamlでもdb-password変更してください。それ以外の場合、コマンドは失敗します。

    メモ:
    • これは機密性の高いコマンドであり、リモートマシンで実行する場合は注意が必要です。このようなシナリオでは、(通常、一般的なLinuxディストリビューションにデフォルトでインストールされます)またはtmux(インストールするために実行sudo apt-get install tmux)などのscreenプログラムを使用して、sshセッションが中断された場合でも移行コマンドの実行を継続することを強くお勧めします。
    • このコマンドの実行にはかなりの時間がかかります。
  • 所有者を/var/lib/netrounds/openvpn次のように変更します。netrounds

  • すべてのParagon Active Assuranceサービスを再起動します

  • 新しいテストエージェントリポジトリとプラグインをインストールします。

    プラグインは、テストエージェントアプリケーションによって使用されます。

  • 次のようにサービスを有効にします

    メモ:

    アップグレード後に TimescaleDB サービスと Metrics サービスが実行されることが予想される場合は、既定では有効になっていないため、これらも有効にする必要があります。

  • すべてのParagon Active Assuranceサービスを再起動します

    メモ:

    アップグレード後にサービスを再度稼働させるには、これを行う必要があります。

  • 新しい構成を有効にするには、以下も実行する必要があります。

  • コマンドを使用して、システムが稼働していることを確認します

  • 次のスクリプトを実行して、すべてのアカウントですべてのプラグインの最新バージョンを有効にします。

    スクリプトの実行後に次のエラーが発生した場合は、エラーのトラブルシューティングを行うために、スクリプト出力を添付してサポートケースを作成します。

    コントロールセンターのCLIを使用してプラグインを管理する方法の詳細については、「プラグイン」のアプリ内ヘルプを参照してください。

  • コントロールセンターのGUIにログインし、「 テストエージェント」 ビューに移動します。アップグレードが可能な各テストエージェントの横に、上矢印アイコンが表示されます。そのアイコンをクリックして、アップグレードを続行します。

Postgres のアップグレード

このセクションでは、Postgres 10 の代わりに Postgres 14 を使用するように および paa-plugins データベースをアップグレードnetroundsします。

次の手順を実行します。

  • Postgres 10 が現在使用されていることを確認します。

    期待される出力は次のとおりです。

    上記のコマンドで Postgres 14 が報告された場合は、それ以上のアクションを実行しないでください。

  • コントロールセンターのサービスを停止します。

  • 両方の Postgres クラスターを停止します。

  • 実際のアップグレードを行う前に、次のチェックを実行してください。

    このチェックで pg_upgrade 簡単に修正できないエラーが報告された場合は、ジュニパーテクニカルサポートにお問い合わせください。

    エラー pg_upgrade がなく、クラスターに互換性があることが報告された場合は、アップグレードを続行できます。

  • Postgresのアップグレード:

  • Postgres 10 がポート 5434 を使用し、Postgres 14 がポート 5432 を使用するようにポート割り当てを変更します。

    port in /etc/postgresql/14/main/postgresql.conf の値を 5432 に更新します。

    port in /etc/postgresql/10/main/postgresql.conf の値を 5434 に更新します。

  • postgresqlサービスを開始します。

  • ユーザーのパスワード netrounds を変更します。

  • 統計オプティマイザーを実行します。

  • コントロールセンターサービスを開始します。

  • Postgres 14 が現在データベースで使用されている netrounds ことを確認します。

    期待される出力:

    期待される出力:

  • コントロールセンターが機能していることを確認し、古いクラスタデータを削除します。

  • 必要に応じて、postgresql-10 および postgresql-12 クライアント/サーバー パッケージを削除します。

ConfDのアップグレード

ConfD サービスがコントロールセンターにインストールされている場合は、次の手順を実行します。

トラブルシューティング

ユーザーのパスワード認証に失敗しました

コマンドが失敗し、 ncc migrate エラーメッセージが表示された場合

上記の警告で説明されているように、/etc/netrounds/plugin.yamlファイル内の変数db-passwordを更新する必要があります。このファイルを編集してから、 を再実行しますncc migrate

ターゲットWSGIスクリプトが見つかりません

Apache構成ファイルに誤って「N」を選択し( 上記のこの手順を参照)、次のようなエラーメッセージが表示された場合

次のコマンドを実行して、軌道に戻ります。

これにより、古い設定が、更新されたパッケージ内の新しい設定で上書きされます。

繰り返しになりますが、デフォルトのsnakeoil証明書の代わりに適切なSSL証明書(推奨)をインストールしている場合は、Debianパッケージのインストールが完了した後、andSSLCertificateKeyFile設定のSSLCertificateFile正しいパスを指すようにファイルを再度変更する必要があります。インストールガイドのサービス設定の章の「SSL証明書の設定」セクションを参照してください。

同一生成元ポリシーでリモートリソースの読み取りが禁止されている

このエラーまたは同様のエラーは、 で /etc/netrounds/netrounds.confSPEEDTEST_ADDRESS を異なる値に設定SITE_URLした場合に発生する可能性があります。次に、ファイル内でrestol.confこれらの値の両方を許可するように変更ALLOWED_ORIGINS/etc/netrounds/restol.confする必要があります。これを実現する最も簡単な方法は、以前に ALLOWED_ORIGINSに割り当てられた値を削除することです。この設定は、 で見つかった/etc/netrounds/netrounds.confように および SPEEDTEST_ADDRESS を許可するSITE_URLデフォルト値を取得します。

openvpn@netroundsサービスがdh.pemファイルを見つけられません

これが発生した場合、以下のような出力が表示されます。

解決するには、次のコマンドを実行します。

openvpn@netrounds サービスが脆弱な CA キーを報告

この場合、出力は次のようになります。

あなたがする必要があるのは、 /etc/openvpn/netrounds.conf ファイルの最後に以下の行を追加してファイルを変更することです:

次に、openpvnサービスを再起動します。

コンテナ共通パッケージとの競合によりコントロールセンターのインストールが失敗する

Ubuntuシステムのアップグレード中に、非推奨のパッケージがすべて削除されるとは限らないため、コントロールセンターのインストールが失敗し、次のエラーメッセージが表示されることがあります。

この場合、コマンドを実行して、 apt-cache rdepends --installed containers-common どのパッケージがコンテナ共通パッケージを保持しているかを確認します。このコマンドが次の出力を返す場合は、パッケージを削除して containers-common 、コントロールセンターを再インストールできます。

パッケージを削除するには containers-common 、次のコマンドを実行します。