4.1 アップグレードのシナリオ

次のセクションでは、数種類のiManagerのアップグレードのシナリオについて説明します。

4.1.1 iManager 3.0へのアップグレード

iManagerのバージョンを2.7.7.xからiManager 3.0にアップグレードする際の全体的なシナリオを以下に示します。パッチとサポートパックは累積型なので、iManagerインストールをアップグレードするには、入手できる最新のサービスパックまたはパッチをインストールするだけで十分です。

iManagerをアップグレードするには次の手順を実行します。

iManagerにログインします。
［設定］>［プラグインのインストール］>［利用できるNovellプラグインモジュール］をクリックします。［利用できるNovellプラグインモジュール］ページが表示されます。
NovellダウンロードWebサイトに移動し、最新のサポートパックまたはパッチをダウンロードします。
iManagerの、［Novellプラグインモジュール］の下の［追加］をクリックします。
サポートパックまたはパッチと共にダウンロードしたNPMファイルに移動して選択し、［OK］をクリックします。
Novellプラグインモジュールリストから、アップグレードするiManager 3.0のサポートパックまたはパッチを選択し、［インストール］をクリックします。
［使用許諾書］ページがiManagerにより表示される場合、使用許諾書を読み、［同意する］を選択します。
［OK］をクリックします。進捗状況が表示されます。インストールを中止する場合は、［中止］をクリックします。

インストールが完了したら、［閉じる］をクリックします。インストールが成功したことを示す次のメッセージが表示されます。

Success: The plug-in module has been successfully installed. 
You must now restart Tomcat in order for the changes to take effect.
After Tomcat restarts, if Role Based Services is installed you will need to configure the newly installed modules.

コマンドラインインタフェースを開いて次のコマンドを入力し、Tomcatを再起動します。
```
/etc/init.d/novell-tomcat8 stop
```
```
/etc/init.d/novell-tomcat8 start
```

4.1.2 LinuxでiManager 3.0にアップグレードする

iManager のインストール中に、以前にインストールされたiManager 2.7.7.xのバージョンが検出された場合、インストールされているバージョンをアップグレードするようプロンプトが表示されます。アップグレードを選択すると、インストールプログラムは、既存のJREおよびTomcatを最新バージョンに置き換えます。また、iManagerが最新バージョンにアップグレードされます。

重要:スタンドアロンのiManagerパッケージを、OESバージョンが稼働しているサーバにインストールしないでください。その代わり、OESバージョンのパッチチャネルを使用して最新のiManagerバージョンにアップグレードする必要があります。

インストールの準備をするために、iManagerのインストールに関する前提条件と考慮事項とLinuxサーバへのiManagerのインストールに関する考慮事項にあるインストール条件のチェックリストを確認します。

iManagerのインストール処理により、次の製品がサーバにインストールされます。

Tomcat 8.0.22
Java 1.8.0_66

(状況による)変更されたserver.xmlおよびcontext.xml設定ファイルがある場合、アップグレードを実行する前に、それらのファイルのバックアップコピーを他の場所に作成してください。アップグレードプロセスはこれらの設定ファイルを置き換えます。
NetIQダウンロードWebサイトで、iManager製品を検索してiManager 3.0を選択します。次に、iMan_30_linux.tgzをサーバ上のディレクトリにダウンロードします。
次のコマンドを用いて、iManagerフォルダに展開します。

tar -zxvf iMan_30_linux.tgz
シェルを開き、/extracted_directory/iManager/installs/linuxディレクトリに移動します。

このパスは、iManagerのファイルをコピーまたは展開したディレクトリに対する相対パスです。
rootまたはrootと同等の権限でログインしている状態で、次のコマンドのいずれか1つを入力します。

コマンドライン(テキスト)インストールをする場合は、次のコマンドを入力します。

./iManagerInstallLinux.bin

GUIインストールをする場合は、次のコマンドを入力します。

./iManagerInstallLinux.bin -i gui

正常にインストールされると、インストール中に提示された質問の答えに基づいた値で、環境設定ファイル(/var/log/installer.properties)が生成されます。このファイルを変更してサイレントインストール用に使用することができます。詳細については、セクション 2.3, iManagerのサイレントインストールを参照してください。
iManagerのスプラッシュスクリーンで言語を選択し、［OK］をクリックします。
アップグレードのプロンプトが表示されたら、［アップグレード］を選択します。
イントロダクションに目を通し、［次へ］をクリックします。
使用許諾書に同意して、［次へ］をクリックします。

メモ:デフォルトで、iManagerの以前のバージョンで環境設定されたHTTPポートおよびSSLポートの値がiManagerの最新バージョンの環境設定に使用されます。
［IPv6を有効にする］ウィンドウで［はい］をクリックしてIPv6を有効にし、［次へ］をクリックします。

または次の手順で、iManagerのインストール後でもIPv6を有効にできます。
1. <USER_INSTALL_DIR>\Tomcat\conf\catalina.propertiesファイルを開きます。
2. catalina.propertiesファイルに以下の設定項目を設定します。
```
java.net.preferIPv4Stack=false              
```
```
java.net.preferIPv4Addresses=true
```
3. Tomcatを再起動します。
TLS証明書で使用する証明書公開鍵アルゴリズムを指定して、［次へ］をクリックします。

オプションは次のとおりです。
- RSA: 証明書は2048ビットRSA鍵ペアを使用します。
- ECDSA 256: 証明書は曲線secp256r1によるECDSA鍵ペアを使用します。
- ECDSA 384: 証明書はECDSA鍵ペアを曲線secp384r1と一緒に使用します。
デフォルトでは、［RSA］が選択されます。
ステップ 15で選択された証明書に基づき、TLS通信用の次のサイファレベルをiManagerで構成できます。
- RSA: この証明書では4つのサイファレベルが可能。
  - なし: どんなタイプのサイファレベルも可能。
  - 低: 56ビットまたは64ビットのサイファが可能。
  - 中: 128ビットのサイファが可能。
  - 高: 128ビットより大きいサイファが可能。
- ECDSA 256: この証明書では1つのサイファレベルだけが可能。
  - SUITEB 128のみ: 128ビットのサイファが可能。
- ECDSA 384: この証明書では2つのサイファレベルが可能。
  - SUITEB 128: 128ビットのサイファまたは256ビットのサイファが可能。
  - SUITEB 192: 256ビットのサイファが可能。
ECDSA証明書の場合、iManagerはスイートBのサイファのみを許可します。

デフォルトでは、サイファレベルは［なし］に設定されています。選択したサイファレベルは、Tomcatサーバの再起動後に有効になります。
次へをクリックします。
「アップグレード前の概要」ページを確認して、［次へ］をクリックします。

アップグレード中に、新しいiManagerのファイルがインストールされ、環境設定が変更されます。アップグレードには数分かかる可能性があります。アップグレードが完了すると、［アップグレードが完了しました］ページに、インストールの成功または失敗の状態が表示されます。
［完了］をクリックして、インストールを終了します。

［はじめに］ページが表示されたら、アクセスを始める前にiManagerが初期化するのを待ちます。

iManagerにアクセスするには、［はじめに］ページの最初のリンクをクリックしてログインします。詳細については、『NetIQ iManager管理ガイド』の「iManagerにアクセスする」を参照してください。
(状況による) server.xmlおよびcontext.xml設定ファイルのバックアップコピーを、アップグレード処理に先立って作成している場合、新しい設定ファイルをバックアップコピーで置き換えてください。

4.1.3 WindowsでiManager 3.0にアップグレードする

iManager 3.0のインストール中に、以前にインストールされたiManager 2.7.xのバージョンが検出された場合、インストールされているバージョンをアップグレードするようプロンプトが表示されます。アップグレードを選択すると、インストールプログラムは、既存のJREおよびTomcatを最新バージョンに置き換えます。さらに、iManagerが最新バージョンにアップグレードされます。

eDirectoryと同じマシンでiManagerサーバを実行する方法については、『NetIQ iManager管理ガイド』の「同じコンピュータでeDirectoryとiManagerを実行する(Windowsのみ)」を参照してください。

(状況による)変更されたserver.xmlおよびcontext.xml設定ファイルがある場合、アップグレードを実行する前に、それらのファイルのバックアップコピーを他の場所に作成してください。アップグレード処理により設定が置き換えられ、ファイルに保存されます。
iManagerフォルダにiMan_30_win.zipファイルを展開します。
extracted_directory\iManager\installs\winフォルダから、iManagerInstall.exeファイルを実行してください。
iManagerのスプラッシュスクリーンで言語を選択し、［OK］をクリックします。
［イントロダクション］ページで、［次へ］をクリックします。
使用許諾書に同意して、［次へ］をクリックします。
アップグレードのプロンプトが表示されたら、［アップグレード］を選択します。

メモ:デフォルトで、iManagerの以前のバージョンで環境設定されたHTTPポートおよびSSLポートの値がiManagerの最新バージョンの環境設定に使用されます。
［検出の概要］ページを確認して、［次へ］をクリックします。

[検出の概要]ページには、iManagerがインストールされた後に使用するサーブレットコンテナおよびJVMソフトウェアの最新バージョンが表示されます。
TLS証明書で使用する証明書公開鍵アルゴリズムを指定して、［次へ］をクリックします。

以下のオプションがあります。
- RSA: 証明書は2048ビットRSA鍵ペアを使用します。
- ECDSA 256: 証明書は曲線secp256r1によるECDSA鍵ペアを使用します。
- ECDSA 384: 証明書はECDSA鍵ペアを曲線secp384r1と一緒に使用します。
デフォルトのオプションは［RSA］です。
ステップ15で選択した証明書に基づき、TLS通信用の次のサイファレベルをiManagerで構成できます。
- RSA: この証明書では4つのサイファレベルが可能。
  - なし: どんなタイプのサイファレベルも可能。
  - 低: 56ビットまたは64ビットのサイファが可能。
  - 中: 128ビットのサイファが可能。
  - 高: 128ビットより大きいサイファが可能。
- ECDSA 256: この証明書では1つのサイファレベルが可能。
  - SUITEB 128のみ: 128ビットのサイファが可能。
- ECDSA 384: この証明書では2つのサイファレベルが可能。
  - SUITEB 128: 128ビットのサイファまたは256ビットのサイファが可能。
  - SUITEB 192: 256ビットのサイファが可能。
ECDSA証明書の場合、iManagerはスイートBのサイファのみを許可します。

デフォルトでは、サイファレベルは［なし］に設定されています。選択したサイファレベルは、Tomcatサーバの再起動後に有効になります。
［IPv6を有効にする］ウィンドウで［はい］をクリックしてIPv6を有効にし、［次へ］をクリックします。

または次の手順で、iManagerのインストール後でもIPv6を有効にできます。
1. <USER_INSTALL_DIR>\Tomcat\conf\catalina.propertiesファイルを開きます。
2. catalina.propertiesファイルに以下の設定項目を設定します。
```
java.net.preferIPv4Stack=false              
```
```
java.net.preferIPv4Addresses=true
```
3. Tomcatを再起動します。
［インストール前の概要］ページを確認して、［インストール］をクリックします。

アップグレード処理には数分かかることがあります。

アップグレードが完了すると、［アップグレードが完了しました］ページに、インストールの成功または失敗の状態が表示されます。
メモ:Windowsでは、インストールが成功していたとしても、［Install Complete(インストール完了)］ページに次のようなエラーメッセージが表示されます。
```
The installation of iManager Install 3.0 is complete, but some errors occurred during the install.
Please see the installation log <Log file path> for details. Press "Done" to quit the installer.
```
特定のエラーメッセージが表示されたら、次の手順を実行します。
1. ［Install Complete(インストール完了)］ページのエラーメッセージで指定されているログファイルのパスをメモします。
2. ［Install Complete(インストール完了)］で[完了]をクリックします。
3. ログファイルを開きます。
4. ログファイルに次のようなエラーがある場合は、エラーメッセージを無視します。インストールが成功し、iManagerは正常に機能します。
```
Custom Action: com.novell.application.iManager.install.InstallDLLs 
Status: ERROR 
Additional Notes: ERROR - class com.novell.application.iManager.install.InstallDLLs NonfatalInstallException C:\WINDOWS\system32\msvcr71.dll (The process cannot access the file because it is being used by another process)
```
[完了]をクリックして、インストールを終了します。

［はじめに］ページがブラウザウィンドウに表示されます。

iManagerにアクセスするには、初期化されるまで待つ必要があります。

iManagerにアクセスするには、［はじめに］ページの最初のリンクをクリックしてログインします。詳細については、『NetIQ iManager管理ガイド』の「iManagerにアクセスする」を参照してください。
(状況による) server.xmlおよびcontext.xml設定ファイルのバックアップコピーを、アップグレード処理に先立って作成している場合、新しい設定ファイルをバックアップコピーで置き換えてください。

4.1.4 iManagerのサイレントアップグレード

サイレント(非対話型)アップグレードでは、ユーザインタフェースは表示されず、ユーザに対する質問も行われません。代わりに、InstallAnywhereがプロパティファイルから必要な情報を収集しながらインストールを遂行します。

LinuxおよびWindowsサーバで、すべてのデフォルト値をそのまま使用して標準的なサイレントインストールを実行するには、次の手順に従います。

コンソールウィンドウを開き、ダウンロードしたiManagerファイルがあるディレクトリを参照します。
コマンドラインで、次のコマンドを実行します。

Linuxの場合:

./iManagerInstall< platform>.bin -i silent

Windowsの場合:

iManagerInstall.exe -i silent