2.2. アップグレードの実行

SGD のアップグレード方法は、単一サーバーアレイをアップグレードするのか複数サーバーアレイをアップグレードするのかによって異なります。SGD をカスタマイズした場合は、カスタマイズしたファイルの手動アップグレードが必要になることもあります。

2.2.1. フルライセンスの単一サーバーアレイをアップグレードする方法

  1. 中断中のセッションも含めて、アレイ内で実行中のユーザーセッションやアプリケーションセッションがないことを確認します。

  2. 新しいバージョンの SGD をインストールしてサーバーをアップグレードします。

2.2.2. フルライセンスの複数サーバーアレイをアップグレードする方法

複数サーバーアレイ内のすべての SGD サーバーは、同じバージョンの SGD ソフトウェア上で実行する必要があります。このため、アレイをアップグレードする場合は、アレイを解除してサーバーを個別にアップグレードしてから、アレイを再構築する必要があります。

  1. 中断中のセッションも含めて、アレイ内で実行中のユーザーセッションやアプリケーションセッションがないことを確認します。

  2. アレイを解除します。

    プライマリ SGD サーバー上で次のコマンドを実行して、セカンダリ SGD サーバーをアレイから切り離します。

    # tarantella array detach --secondary server
    

    セカンダリ SGD サーバーは、一度に 1 つずつ切り離してください。アレイの構造に変更を加えた場合は、SGD によって、その変更がアレイ内のすべての SGD サーバーにコピーされるのを待ってから、次の変更を行うようにしてください。プライマリ SGD サーバーで tarantella status コマンドを実行して、アレイのステータスを確認してください。

  3. 新しいバージョンのソフトウェアをインストールしてプライマリ SGD サーバーをアップグレードします。

  4. 新しいバージョンのソフトウェアをインストールしてセカンダリ SGD サーバーをアップグレードします。

  5. アレイを再構築します。

    すべての SGD サーバー上のクロックは同期している必要があります。時間差が 1 分を超えている場合、アレイの連結操作は失敗します。

    プライマリ SGD サーバー上で次のコマンドを実行して、セカンダリ SGD サーバーをアレイに追加します。

    # tarantella array join --secondary server
    

    セカンダリ SGD サーバーは、一度に 1 つずつ追加してください。アレイの構造に変更を加えた場合は、SGD によって、その変更がアレイ内のすべての SGD サーバーにコピーされるのを待ってから、次の変更を行うようにしてください。プライマリ SGD サーバーで tarantella status コマンドを実行して、アレイのステータスを確認してください。

    セカンダリ SGD サーバーはアレイに追加されると、プライマリ SGD サーバーにインストールされているすべてのライセンスキーを取得します。

2.2.3. カスタマイズした SGD インストールのアップグレード

アップグレード時に、SGD インストールプログラムは検出したカスタマイズ済みファイルを保持しますが、それらのアップグレードは行いません。これらのファイルは手動でアップグレードする必要があります。アップグレードが必要な可能性があるのは、次の 2 セットのファイルです。

  • SGD Web サーバーファイル – Web アプリケーションファイル、および SGD Web サーバーを構成するために使用されるファイル

  • SGD サーバーファイル – SGD サーバーで使用されるファイル (ログインスクリプトなど)

アップグレードの完了後に、次の 2 種類のカスタマイズされたファイルに注意を払う必要があります。

  • カスタマイズ済みファイル – 標準の SGD インストールに含まれるファイルのうち、SGD 管理者により変更されたもの

  • ビスポークファイル – ユーザーの組織が作成し、SGD インストールに追加したファイル

2.2.3.1. カスタマイズ済み SGD Web サーバーファイルのアップグレード

アップグレード時に、SGD インストールプログラムは、検出したすべてのカスタマイズ済み SGD Web サーバーファイルをバックアップします。バックアップされたファイルとその場所のリストは、/opt/tarantella/var/log/webservercustomized.list ログファイルに記録されます。

カスタマイズ済みファイルをアップグレードするには、diffpatch などのユーティリティーを使用して、バックアップされたファイルと標準の SGD インストールに含まれるファイルを比較し、相違点をマージします。

SGD インストールプログラムは、検出したすべてのビスポーク SGD Web サーバーファイルを新しいインストールにコピーします。これらのファイルは変更されません。

2.2.3.2. カスタマイズ済み SGD サーバーファイルのアップグレード

アップグレード時に、SGD インストールプログラムは、検出したカスタマイズ済み SGD サーバーファイルおよびビスポーク SGD サーバーファイルをバックアップし、次のログファイルを生成します。

  • /opt/tarantella/var/log/upgraded.files – 変更内容のサマリー

  • /opt/tarantella/var/log/customized.list – 管理者が編集または追加したファイルのリスト

  • /opt/tarantella/var/log/customizedchanged.list – アップグレードによって変更され、管理者が編集したファイルのリスト

  • /opt/tarantella/var/log/docrootjava.log – 元のインストールに新規追加されたか、元のインストールから変更された Java テクノロジファイルのリスト

これらのログファイルを使用して、手動でアップグレードする必要のあるファイルを特定します。

カスタマイズ済み SGD サーバーファイルを手動でアップグレードする方法

  1. カスタマイズ済みファイルのコピーを作成します。

  2. SGD のバージョン間での変更内容を特定します。

    customizedchanged.list ログファイルには、手動でアップグレードする必要のある、カスタマイズ済みファイルのリストが含まれています。このログファイルにリスト出力されるファイルごとに、システムには次の 3 つのバージョンが保持されています。

    • 古いカスタマイズ済みのバージョン。次のディレクトリのいずれかに格納されています。

      • /opt/tarantella/var/serverresources.oldversion - ログインスクリプト用。

      • /opt/tarantella/etc/data.oldversion - カラーマップなどその他のファイル用。

    • /opt/tarantella/etc/templates.oldversion ディレクトリ内にある、古いカスタマイズされていないバージョン。

    • /opt/tarantella/etc/templates ディレクトリ内にある、新しいカスタマイズされていないバージョン。

    diff などのユーティリティーを使用して、カスタマイズされていない古いファイルを、カスタマイズされていない新しいファイルと比較します。これで、SGD のバージョン間での変更内容がわかります。

  3. 変更内容をカスタマイズ済みファイルに適用します。

    patch などのユーティリティーを使用して、前の手順で特定した変更内容をカスタマイズ済みファイルのコピーに適用します。

  4. アップグレードしたカスタマイズ済みファイルを、新しい SGD インストールの正しい場所にコピーします。

ビスポーク SGD サーバーファイルを手動でアップグレードする方法

  1. ビスポークファイルのコピーを作成します。

  2. SGD のバージョン間での変更内容を特定します。

    docrootjava.log および customized.list ログファイルには、手動アップグレードが必要な可能性のあるビスポークファイルのリストが含まれています。

    ビスポークファイルをアップグレードする唯一の方法は、標準 SGD ファイルをバージョン間で比較して変更内容を特定し、それらの変更をビスポークファイルに適用することです。

    diff などのユーティリティーを使用して、カスタマイズされていない古いファイルを、カスタマイズされていない新しいファイルと比較します。これで、SGD のバージョン間での変更内容がわかります。

    変更内容を特定するには、次のファイルを比較します。

    • /opt/tarantella/etc/templates.oldversion ディレクトリ内にある、旧バージョンの標準 SGD ファイル。

    • /opt/tarantella/etc/templates ディレクトリ内にある、新バージョンの標準 SGD ファイル。

  3. 変更内容をビスポークファイルに適用します。

    patch などのユーティリティーを使用して、手順 2 で特定した変更内容をビスポークファイルのコピーに適用します。

  4. アップグレードしたビスポークファイルを、新しい SGD インストールの正しい場所にコピーします。