この節では、アップグレードに関する既知の問題とその解決方法を示します。
この問題はさまざまな Linux システムで発生しています。Java Desktop System 2 でもっとも一般的ですが、Red Hat ディストリビューションでも発生しています。
インストールプログラムの最後の画面で「アップグレードツールの起動」ボタンをクリックすると、そのインストールプログラムはアップグレード処理を完了するためのアップグレードツールの起動に失敗し、コマンドプロンプトに戻ることなくハングアップします。
この問題は、コマンド行インストールモードを使って代替アップグレードを実行している場合には発生しません。
GUI モードで代替アップグレードを実行してこの問題が発生した場合には、インストールプログラムを起動した端末ウィンドウで Ctrl+C を押すことにより、そのインストールプログラムを終了します。
その端末ウィンドウから次のコマンドを使ってアップグレードツールを起動します。
as-install/bin/asupgrade --source as-install/domains --target as-install --adminuser adminuser --adminpassword adminpassword --masterpassword changeit |
adminuser および adminpassword は、アップグレード中のインストールで使用されている値に一致する必要があります。
アップグレードツールがアップグレードプロセスを完了したあとは、ブラウザを起動して次の URL を入力することにより、「バージョン情報」ページを参照できます。
file://as-install/docs-ee/about.html |
製品を登録するインストールオプションを選択した場合には、「バージョン情報」ページ上の登録ページへのリンクをたどってください。
アップグレード後、ターゲットの domain.xml から次のエントリを削除し、サーバーを再起動します。
<jvm-options>-Djavax.net.ssl.keyStore=${com.sun.aas.instanceRoot} /config/keystore.jks</jvm-options>- <jvm-options>Djavax.net.ssl.trustStore=${com.sun.aas.instanceRoot} /config/cacerts.jks</jvm-options>
Enterprise Server 8.0 PE から 2.1.1 へのアップグレード時に、サーバーに null という名前のシステムコネクタがないというエラーがスローされ、sbs-manual に示されているような無効なユーザー情報が表示されます。ハードコードされた値を変更しても、同じエラーメッセージが表示されます。
このバグは、8.0 PE から Enterprise Server にアップグレードする場合にのみ発生します。回避策として、8.1、8.2、または 9.0 のいずれかにアップグレードしてから、Enterprise Server にアップグレードします。
インプレースアップグレード実行時に、ソースに複数のドメインがある場合、プロセスが中止になっても、インストーラはアップグレードツールを呼び出します。GUI モードで呼び出した場合にそうなります。
インプレースを CLI モードでインストールし、インストール処理の最後にインストーラがアップグレードツールを選択するプロンプトを表示したときに終了します。この操作を行っても、ドメインディレクトリにあるどのドメインも削除されません。アップグレードツールは bin ディレクトリから手動で呼び出す必要があります。
GUI モードでインプレースをインストールする場合は、処理中にドメインが失われることがないようにするために、ドメインルートにあるドメインのバックアップを取ります。インストール処理の最後に、インストーラがアップグレードツールを選択するプロンプトを表示したときに終了します。失われているドメインがあれば、ドメインバックアップしたドメインをドメインディレクトリにコピーします。アップグレードツールを起動して、手動でアップグレードを実行します。
AS 8.2 からのアップグレードで、8.2 インストール環境のマスターパスワードがターゲットのインストール環境に継承されません。これが原因となって、次の管理者ログイン時に認証エラーとなります。
Enterprise Server 2.1.1 のデフォルト管理パスワードは changeit です。8.2 からアップグレードしたあと、Enterprise Server にログインするときの問題を回避するために、次の 3 つの手順のいずれかを行なってください。
アップグレードを実行する前に、8.2 管理者パスワードを changeit に変更する。
アップグレード処理時にデフォルトの管理者パスワードを受け入れず、使用するパスワードを明示的に入力する。
デフォルトパスワードで Enterprise Server 2.1.1 にログインしたあと、ただちにパスワードを変更する。
英語以外の言語で asupgrade GUI を実行すると、この GUI のオンラインヘルプが選択した英語以外の言語にローカライズされていません。
現時点ではありません。オンラインヘルプは英語以外のすべての目標言語にローカライズされる予定です。
複数のドメインを含む構成をサイドバイサイドアップグレードすると、最後に処理されたドメインのノードエージェントだけが存在します。この問題は、アップグレードツールがドメインを処理するたびに、ターゲットの nodeagents ディレクトリを削除してから再作成するために発生します。
各ドメインの処理後に、nodeagents ディレクトリの zip ファイルを作成します。
すべてのドメインが処理されたあとで、作成した zip ファイルを解凍します。
これで、すべてのノードエージェントが存続します。
インプレースアップグレードの実行中に、すでに存在しているドメインの index.html ファイルが置換されません。表示されるサーバーのバージョンが古いままになります。この index.html ファイルは、SGES_BASE の index.html ファイルで置換できます。
SGES_BASE/lib/install/templates/ee/index.html DOMAIN_DIR/docroot/index.html |