オペレータ コンソールのアップグレード

uim203
この記事では、UMP/OC をオペレータ コンソールにアップグレードする方法について説明します。アップグレードの準備を行い、アップグレードを実行し、アップグレード後のタスクを完了します。
2
  • OC の以前のバージョンから OC 20.3.3 にアップグレードするには、UIM 20.3.3 リリースの一部として利用できる OC 20.3.3 アップグレード インストーラを使用します。UIM 20.3.3 リリースの詳細については、「UIM 20.3.3」 の記事を参照してください。
  • UIM 20.3.3 では、ネイティブ OC 画面(ホーム ページ、グループ ビュー ページ、デバイス表示ページ、モニタリング テクノロジ(プローブ)ビュー ページ)を表示する CA Business Intelligence (CABI)の依存関係が削除されました。カスタムおよび標準装備のダッシュボードとレポートは、引き続き CABI を使用して表示されます。つまり、CABI と依存関係があります。ただし、ネイティブ OC 画面は CABI (Jaspersoft)に依存しなくなったので、HTML5 を使用して表示されます。HTML5 を使用したネイティブ OC 画面の詳細については、UIM 20.3.3 記事の「モニタリング データの設定および表示」の記事または「CABI 依存関係の削除(ネイティブ オペレータ コンソール)」を参照してください。
  • OC の以前のバージョンから OC 20.3.2 にアップグレードするには、OC 20.3.2 パッチ リリースの一部として利用できる OC 20.3.2 アップグレード インストーラを使用します。OC 20.3.2 パッチの詳細については、「OC 20.3.2 パッチ」を参照してください。
  • OC 20.3.0 から OC 20.3.1 にアップグレードするには、UIM 20.3.1 パッチに含まれるオペレータ コンソールのアップグレード インストーラを使用します。UIM 20.3.1 は、UIM 20.3.0 のパッチ リリースです。UIM 20.3.1 パッチには、UIM Server 用のアップグレード インストーラは含まれていません。このパッチには、OC アップグレード インストーラと、それぞれのコンポーネントを 20.3.1 にアップグレードするために使用できる個別のスタンドアロン アーティファクトが含まれています。UIM 20.3.1 パッチ リリースの一部として利用可能なアーティファクトの詳細については、「UIM 20.3.1」を参照してください。
  • UIM 20.3.0 では、UMP は UIM 20.3.0 では使用できなくなったため、UMP をアップグレードするには OC インストーラを使用します。OC インストーラは、廃止されたコンポーネントをアンインストールし、有効なコンポーネントをアップグレードします。
  • オペレータ コンソールのアップグレード」と「複数 OC 設定のアップグレード」は 2 つの個別の手順です。セットアップに基づいて、適切な手順を実行できます。
  • ネットワーク通信を管理するために、OC と共に wasp プローブがコア プローブとしてインストールされます。OC インストーラを実行せずに wasp プローブを再展開することにより、UMP/OC をアップグレードまたはダウングレードすることを試みないでください。
  • 20.3.0 へのアップグレード中に、OC インストーラが UMP サーバではなくプライマリ ハブに OC をインストールしようとする場合は、「オペレータ コンソールのトラブルシューティング」の情報に従ってください。
アップグレードの準備
以下の表のすべてのタスクを実行して、UMP/OC を OC にアップグレードする準備が整っていることを確認します。これらのすべてのタスクが完了するまでは、アップグレードを続行しないでください。
タスク
説明および手順
アップグレード パスの確認
サポートされているアップグレード パスに従っていることを確認します。
互換性マトリクスの「サポートされているアップグレード パス」セクションを確認します。
システムのバックアップを実行します。
アップグレード後は、バックアップのリストアによってのみ以前のシステムに戻すことができます。
アップグレード中にエラーのためにインストールをキャンセルした場合、現在のシステムが動作しなくなる可能性があります。その場合、バックアップのリストアが唯一の対処方法になります。
ROOT Webapp ディレクトリ内のカスタマイズされたファイルのバックアップ
<UMP/OC_installation>/Nimsoft/probes/service/wasp/webapps/ROOT/
ディレクトリはアップグレード中に上書きされます。このディレクトリにあるファイルのいずれかをカスタマイズしている場合は、アップグレードする前にバックアップします。よくカスタマイズされるファイルを以下のリストに示します。
  • portal-ext.properties
  • web.xml
これらのファイルは両方とも、マルチ UMP または HTTPs の設定の一部として変更されます。
UIM 20.3.0 では、portal-ext.properties ファイルは config.properties に置き換えられます。アップグレードが完了したら、config.properties の内容を
<
UMP/OC_installation>
/Nimsoft/probes/service/wasp/config/ フォルダ内の portal-ext.properties の内容に置き換えることができます。
アップグレードが完了したら、使用している web.xml ファイルの変更点を
<
UMP/OC_installation>
/Nimsoft/probes/service/wasp/webapps/ROOT/ フォルダ内の web.xml に追加できます。
(Oracle の場合のみ) Oracle ごみ箱の無効化
UIM を初めてインストールする場合や、旧バージョンからアップグレードする場合は、UIM および OC をインストールまたはアップグレードする前に、ごみ箱を無効にしておく必要があります。
以下の手順に従います。
  1. SQL Developer などのツールを使用して Oracle データベースに接続します。
  2. 以下のコマンドを入力します。
    ALTER SYSTEM SET recyclebin = OFF DEFERRED;
    ALTER SESSION SET recyclebin = off;
  3. 次のコマンドを使用して、ごみ箱が無効になっていることを確認します。
    show parameter recyclebin;
(SAML SSO 設定の場合のみ) SAML 設定のバックアップ
SAML シングル サインオンを使用している場合は、記事「SAML シングル サインオンを使用するための UMP の設定」の手順に従って、SAML 設定をバックアップします。
UMP/OC を OC にアップグレードすると、SAML 設定ファイルは失われます。
robot.cfg の設定
UIM Server インストーラによって、
<Nimsoft>\security
フォルダに .pem ファイル(certificate.pem)が作成されます。.pem ファイルは必要なロボットと共有する対称キーであり、data_engine プローブとの通信に使用されます。この .pem ファイルをリモートの UMP/OC、および CABI ロボットにコピーし、このファイルの場所を robot.cfg ファイル内に指定します(
cryptkey = <.pem ファイルの場所>
)。また、data_engine が存在しているのと同じコンピュータに影響を受けるプローブがない場合は、生成された .pem ファイルをロボット コンピュータ(data_engine は使用できない)にコピーし、そのコンピュータの .pem ファイルの場所を使用して robot.cfg ファイルを更新します。robot.cfg ファイル設定の詳細については、「robot.cfg ファイルの設定」を参照してください。
セキュア セットアップでのアップグレード
アップグレード シナリオでは、セキュア セットアップで UMP を OC にアップグレードする場合、適切な証明書を展開して UMP/OC ロボットをセキュア状態にしてから、ロボットのバージョンをセキュアなものに更新することを確認します。その後、UMP/OC をアップグレードします。セキュア セットアップと証明書を展開する方法の詳細については、「セキュア ハブおよびロボット」を参照してください。
UIM Server に mon_config_service_ws があり、別のロボットに UMP がある場合の考慮事項
UIM Server に mon_config_service_ws がインストールされ、別のロボットに UMP がインストールされている場合、アップグレードの実行中に以下の点を確認してください。
シナリオ 1:
既存の UIM Server を 20.3.0 にアップグレードする前
  1. 既存の UIM Server で利用可能な wasp フォルダのバックアップを取得します。
  2. 既存の UIM Server から wasp プローブを削除します。
  3. 既存の UIM Server を 20.3.0 (UIM Server)にアップグレードするプロセスを開始します。
    UIM Server のアップグレードが完了すると、9.0.2/9.2.0 UMP を 20.3.0 OC にアップグレードできるようになります。これらの手順を実行しないで UMP を 20.3.0 OC にアップグレードしようとした場合、問題が発生します。
シナリオ 2:
UIM Server を 20.3.0 にアップグレードする前に wasp プローブを削除しない場合
  1. アップグレード済みの UIM Server で利用可能な wasp フォルダのバックアップを取得します。
  2. アップグレード済みの UIM Server から wasp プローブを削除します。
  3. 既存の UMP を 20.3.0 OC にアップグレードします。
  4. アップグレード済みの UIM Server に 20.3.0 で利用可能な wasp を展開します。
  5. 20.3.0 で利用可能なアドミン コンソール、mps、およびテレメトリ パッケージを展開します。
    これらの手順を実行しないで UMP を 20.3.0 OC にアップグレードしようとした場合、問題が発生します。
UIM での OpenJDK
UIM 9.2.0 では Open JDK (JRE)が導入され、Oracle JDK が置き換えられました。そのため、UMP を OC にアップグレードすると、アップグレード プロセスによって OpenJDK が OC コンピュータに配置されます。ただし、OC ロボットを再起動しない限り、新しい OpenJDK は選択されません。これは、UMP を OC にアップグレードした後に実行する必要がある追加の手順です。UIM での OpenJDK の使用の詳細については、「OpenJDK の導入」を参照してください。
アップグレードの実行
OC の新規インスタンスのインストールと同じプロセスに従って、UMP/OC を OC にアップグレードします。「サポートされているアップグレード パス」に記載されている、サポートされているアップグレード パスに従います。インストーラの
[Select Robot (ロボットの選択)]
パネルには、[OC <x.x.x.x.> にアップグレードする]オプションが用意されています。インストーラは、デフォルトから変更された設定(ポート番号など)のすべてを保持します。
20.3.3 では、新しいオプションの
[IP の指定]
[ロボットの選択]
ダイアログ ボックスで利用することもできます。このオプションは、既存の
[選択]
オプションに追加されます。
[IP の指定]
オプションを選択し、OC をアップグレードするロボットの IP アドレスを直接入力できます。インストーラは、古いバージョンの OC がロボットですでに使用可能であることを識別し、OC インスタンスをアップグレードすることを示すメッセージを表示します。その後、残りの手順に進み、インスタンスをアップグレードします。手順の詳細については、「オペレータ コンソール (OC)のインストール」を参照してください。
オペレータ コンソール インストーラ - Web アプリに関する考慮事項
アップグレード後、OC インストーラで展開またはアップグレードされた Web アプリを検証する必要があります。一部の Web アプリは手動でアップグレードする必要があります。
以下に、OC インストールの一部としてインストールされている Web アプリ、UIM で廃止された Web アプリ、およびアップグレードの実行後に手動でアップグレードする必要がある Web アプリに関する詳細を示します。
展開またはアップグレードされた Web アプリ
以下の Web アプリは、OC 20.3.0 (以降)インストーラで展開またはアップグレードされます。
  • accountadmin
  • policy_management_ws
  • dashboard
  • operatorconsole_portlet
  • mcs-ui-app
  • cabi
  • alarmviewer_api
  • reportscheduler (uim_reportscheduler 20.3.3)
  • slm
  • samlsso
  • nisapi
UIM OC WASP から廃止された Web アプリ
以下の Web アプリは、UIM 20.3.0 (以降)の OC WASP で廃止されました。
  • cloudmonitor
  • listdesigner
  • listviewer
  • mobile
  • mytickets
  • policyeditor
  • qoschart
  • relationshipviewer
  • レポート
  • reportscheduler (UMP reportscheduler)
  • servicedesk
  • slareports
  • unifiedreports
  • USM
  • saml-portlet
  • ump-theme
  • portal-compat-hook
  • ump-read-only-theme
プライマリ ハブからリモート OC インストールにより、アップグレード後にこれらの Web アプリの削除されていないフォルダがある場合、ユーザは OC のインストール後に手動で削除できます。
手動でアップグレードする Web アプリ
以下の Web アプリは、OC 20.3.0 (以降)のインストール後に手動でアップグレードする必要があります。これらの Web アプリの以前のバージョンが存在する場合、OC のインストール中にユーザに通知されます。
  • self_cert/ump_selfcert
  • uimapi
  • webservices_rest
  • ecometer_admin (dcimadmin)
  • ecometer_admin
アップグレード後のタスクの完了
アップグレードの完了後に、以下のタスクを実行します。
Web ブラウザのクリア
旧バージョンの UMP/OC から OC にアップグレードした場合は、キャッシュされる可能性がある旧バージョンのコンポーネントを削除するために、ブラウザに保存された情報を完全にクリアします。
OC 20.3.2 以降のでは、OC の古いバージョンから OC 20.3.2 以降にアップグレードする場合は、この手順を実行する必要はありません。
以下の手順に従います。
  1. OC からログアウトします。
  2. ブラウザのクッキーとキャッシュをクリアします。
  3. すべてのブラウザ ウィンドウを終了します。
  4. OC にログインします。
カスタム ACL で、デフォルトの管理者に新しい権限が追加されている場合、それらの権限はアップグレード後にカスタム ACL で自動選択されません。アップグレード後に、カスタム ACL でこれらの権限を手動で選択する必要があります。
(SAML SSO 設定のみ) xerceslmpl.jar の移動
8.31 より前のリリースで SAML シングル サインオンを使用するように UMP を設定していた場合は、<UMP_installation>\probes\service\wasp\webapps\ROOT\WEB-INF\lib ディレクトリにある xerceslmpl.jar
ファイルを移動または削除します。xerceslmpl.jar を移動していない場合、アップグレード後に OC にログインしようとすると「Unable to process SAML request」
というエラーが返されます。
トラブルシューティング
オペレータ コンソールのアップグレード後に wasp が起動しない
現象
: UIM 20.3.0 で OC インストーラを使用してオペレータ コンソールをアップグレードした後に wasp が起動しません。
解決策
: UIM 20.3.0 で OC インストーラを使用してオペレータ コンソールをアップグレードした後に wasp が起動しません。この問題は、インストール中に OC wasp から削除されなかった一部の廃止された Web アプリが原因である可能性があります。問題を解決するには、残っている Web アプリを手動で削除する必要があります。
廃止された Web アプリをクリーンアップするには、以下の手順に従います。
OC wasp の webapps フォルダ内に廃止された Web アプリがあるかどうかを確認します。
  • OC サーバの wasp.cfg から、廃止された Web アプリのセクションを削除します。この操作は、以下の 2 つの方法で実行できます。
    1. RAW 設定で wasp.cfg を開き、[セクションの削除]オプションを使用して、webapps フォルダの下に一覧表示された Web アプリのセクションを削除します。
    2. wasp.cfg を編集モードで開き、webapps の下のセクションを削除します。
  • wasp を非アクティブにします。
  • これらの Web アプリのフォルダを \Nimsoft\probes\service\wasp\webapps から削除します。
  • これらの Web アプリの .war ファイルを \Nimsoft\probes\service\wasp\webapps から削除します。
  • wasp を再起動します。
xerceslmpl.jar をルート UIM インストール ディレクトリ(Nimsoft)に移動することをお勧めします。