Hitachi

Hitachi Advanced Data Binder システム構築・運用ガイド


8.8.3 修正版HADBオプションに入れ替える手順

8.8.1 修正版HADBサーバとの入れ替え前に実施すること」で説明していることを実施したあとに,ここで説明している手順に従って修正版HADBオプションに入れ替えてください。

重要
  • 修正版HADBオプションとの入れ替え作業をする前に,修正版HADBオプションのバージョンに対応する修正版HADBサーバの入れ替え作業を完了しておく必要があります。修正版HADBオプションのインストール時に,修正版HADBオプションと修正版HADBサーバのバージョンが対応しているかどうかのチェックが実行されます。バージョンが対応していない場合は,KFAA91581-Eメッセージが出力されて修正版HADBオプションのインストールがエラーになります。

  • 修正版HADBオプションとの入れ替え作業は,HADBサーバを終了したあとに実施してください。

  • 修正版HADBオプションとの入れ替え作業中にrootのパスワードの入力が必要になるため,rootのパスワードを事前に設定しておいてください。

  • インストールデータに関する注意事項があります。修正版HADBオプションとの入れ替え作業をする前に,「8.2 インストール」の注意事項を参照してください。

修正版HADBオプションに入れ替える前に実施する作業

/usr/local/lib64ディレクトリがあるかどうかを確認してください。

  • /usr/local/lib64ディレクトリがない場合

    1. root/usr/local/lib64ディレクトリを作成してください。

    2. HADB管理者に対して,/usr/local/lib64ディレクトリに対する読み取り権限と実行権限を付与してください。

      ただし,HADB管理者がrootのときは作業不要です。

  • /usr/local/lib64ディレクトリがある場合

    1. 次のファイルのバックアップを取得してください。ただし,次のファイルがないときは作業不要です。

      libaws-cpp-sdk-s3-crt.so

      libaws-cpp-sdk-core.so

    2. rootに対して,/usr/local/lib64ディレクトリへの読み取り権限,書き込み権限,および実行権限を付与してください。

    3. HADB管理者に対して,読み取り権限と実行権限を付与してください。

      ただし,HADB管理者がrootのときは作業不要です。

修正版HADBオプションに入れ替える手順
  1. HADB管理者のOSアカウントでOSにログインする

    今まで使用していたHADB管理者のOSアカウントで,サーバマシンのOSにログインしてください。

    重要

    HADB管理者のOSアカウントを変更しないでください。HADB管理者のOSアカウントを変更した場合,修正版HADBオプションとの入れ替えが正しくできないおそれがあります。

  2. インストールデータを格納するディレクトリを作成する

    修正版HADBオプションのインストールデータを格納するディレクトリを作成します。

    mkdir /home/adbmanager/install

    上記の例では,インストールデータを格納するディレクトリとして/home/adbmanager/installを作成しています。

  3. インストールデータを格納するディレクトリに書き込み権限を付与する

    インストールデータを格納するディレクトリ(この例では/home/adbmanager/install)に対して,HADB管理者が書き込みできるように書き込み権限を付与してください。

    chmod 755 /home/adbmanager/install
  4. CD-ROMファイルシステムをマウントする

    修正版HADBオプションのインストールデータが格納されているCD-ROMファイルシステムを自動マウントしてください。

    CD-ROMファイルシステムが自動マウントされていない場合,次のコマンドを実行してCD-ROMファイルシステムをマウントしてください。

    mount /dev/cdrom /media

    下線部分は,CD-ROMファイルシステムのマウントディレクトリ名です。環境によって異なります。

    重要

    CD-ROMのディレクトリ名やファイル名は,ご使用の環境によっては,ここの説明内容と表示が異なることがあります。OSのlsコマンドを実行して,表示されたディレクトリ名をそのまま入力してください。

  5. インストールデータをコピーする

    マウントしたCD-ROMファイルシステムに格納されている次のファイルを,手順2.で作成したインストールデータを格納するディレクトリにコピーしてください。

    • tar.gz形式のファイル

    • adboptinstallコマンドの実行形式ファイル

    cp /media/hitachi_advanced_data_binder_s3option-$VER.tar.gz /home/adbmanager/install
                                                                                      ...a
    cp /media/adboptinstall /home/adbmanager/install                                  ...b

    [説明]

    1. tar.gz形式のファイル(修正版HADBオプションのプログラムの圧縮ファイル)をコピーします。

    2. adboptinstallコマンドの実行形式ファイル(修正版HADBオプションのインストールコマンド)をコピーします。

    上記の例では,すべてのファイルを/home/adbmanager/installディレクトリ下にコピーしています。

    下線部分は,CD-ROMファイルシステムのマウントディレクトリ名です。環境によって異なります。

    $VERは,修正版HADBオプションのバージョンとリリース番号です。

    (例)03-02-/Aの場合 → $VERは「0302a-0

    重要

    上記の2つのファイルは,必ず同じディレクトリにコピーしてください。異なるディレクトリにコピーすると,修正版HADBオプションとの入れ替えが実行できません。

  6. コピーしたファイルが破損していないことを確認する

    手順5.でコピーしたファイルが破損していないことを確認します。次のコマンドを実行してください。

    cd /home/adbmanager/install
    sha256sum -c /media/adbhashfile_s3option_sha256.txt

    下線部分は,CD-ROMファイルシステムのマウントディレクトリ名です。環境によって異なります。

    ファイルが破損しているおそれがある(ファイルのハッシュ値が異なる)場合は,エラーを示すメッセージが出力されます。この場合,手順5.から作業をし直してください。

    出力されるメッセージの詳細については,OSのマニュアルを参照してください。

  7. 権限を付与する

    HADB管理者がadboptinstallコマンド(修正版HADBオプションのインストールコマンド)を実行できるように,adboptinstallコマンドに対する読み取り権限と実行権限を付与してください。

    また,tar.gz形式のファイルに対する読み取り権限も付与してください。

    chmod 500 /home/adbmanager/install/adboptinstall
    chmod 400 /home/adbmanager/install/hitachi_advanced_data_binder_s3option-$VER.tar.gz

    $VERは,修正版HADBオプションのバージョンとリリース番号です。

  8. 修正版HADBオプションをインストールする

    adboptinstallコマンドを実行して,修正版HADBオプションをインストールしてください。

    /home/adbmanager/install/adboptinstall s3option

    下線部分には,手順2.で作成したインストールデータを格納するディレクトリを指定します。

    重要

    adboptinstallコマンドを実行すると,OSのsuコマンドを使用してAWS SDK for C++ライブラリもインストールします。このとき,rootのパスワードの入力を要求するOSのメッセージが出力されます。メッセージに従いパスワードを入力してください。なお,OSのsuコマンドの実行に失敗するとadboptinstallコマンドのリターンコードは8となります。

    なお,rootのパスワードが設定できない環境の場合,suコマンドが実行された際にrootのパスワードを入力できないため,adboptinstallコマンドによるAWS SDK for C++ライブラリのインストールができません。そのため,KFAA91585-Qメッセージ(AWS SDK for C++ライブラリのインストールを実行するかどうかを応答するメッセージ)が出力されたときは,nまたはN(インストールを実行しない)を応答してください。この場合,「AWS SDK for C++ライブラリのインストール手順」に示す手順に従って,AWS SDK for C++ライブラリを必ずインストールしてください。

    メモ
  9. 修正版HADBオプションが正常にインストールされたことを確認する(その1)

    次のファイルが格納されていることを確認してください。

    • $ADBDIR/lib/libadbcldstge-aws.so

    • /usr/local/lib64/libaws-cpp-sdk-s3-crt.so

    • /usr/local/lib64/libaws-cpp-sdk-core.so

  10. 正版HADBオプションが正常にインストールされたことを確認する(その2)

    サーバディレクトリ直下にadboptinst_s3option.logファイルが格納されていることを確認してください。

    adboptinst_s3option.logファイルを開き,内容を確認してください。修正版HADBオプションが正常にインストールされている場合は,次のどちらかの情報が記載されています。

    • P-aaaa-bbbb Hitachi Advanced Data Binder vv-rr (yyyymmddhhmmss)

    • P-aaaa-bbbb Hitachi Advanced Data Binder vv-rr-/s (yyyymmddhhmmss)

    P-aaaa-bbbbは,HADBサーバのPP形名を示しています。

    vv-rrまたはvv-rr-/sは,HADBサーバのバージョンです。

    yyyymmddhhmmssは,修正版HADBオプションのインストールの実行日と時刻です。

    メモ
    • adboptinst_s3option.logファイルがすでにある状態のときにadboptinstallコマンドを実行すると,adboptinst_s3option.logファイルの内容が更新されます。また,adboptinstallコマンドを複数回実行した場合,最後に実行した日付と時刻が記載されます。

    • adboptinstallコマンドのリターンコード(KFAA91552-Iメッセージに出力されるリターンコード)が0または4以外の場合,adboptinst_s3option.logファイルの内容は更新されません。

  11. HADBサーバを正常開始する

    adbstartコマンドを実行して,HADBサーバを正常開始してください。

    adbstart

    HADBサーバが正常開始すると,修正版HADBオプションの入れ替えが完了します。

AWS SDK for C++ライブラリのインストール手順

上記の手順の8.で,rootのパスワードが入力できないためにAWS SDK for C++ライブラリをインストールできなかった場合は,次の手順でAWS SDK for C++ライブラリをインストールしてください。

インストールCD-ROM中のHADBオプションのtar.gz形式のファイルに格納されているAWS SDK for C++ライブラリをインストールしてください。

手順

  1. rootユーザでログインする

  2. 次のファイルのバックアップを取得する

    • /usr/local/lib64/libaws-cpp-sdk-core.so

    • /usr/local/lib64/libaws-cpp-sdk-s3-crt.so

  3. インストールCD-ROMに格納されている次のファイルを解凍する

    • hitachi_advanced_data_binder_s3option-$VER.tar.gz

      $VERは,HADBオプションのバージョンとリリース番号です。

    tar xvfp hitachi_advanced_data_binder_s3option-$VER.tar.gz
  4. 次のライブラリを/usr/local/lib64にコピーまたは上書きコピーする

    <コピーの場合>

    • libaws-cpp-sdk-core.so

    • libaws-cpp-sdk-s3-crt.so

    cp hitachi_advanced_data_binder_s3option_$VER/aws/lib/libaws-cpp-sdk-core.so /usr/local/lib64
    cp hitachi_advanced_data_binder_s3option_$VER/aws/lib/libaws-cpp-sdk-s3-crt.so /usr/local/lib64

    <上書きコピーの場合>

    cp -r -p hitachi_advanced_data_binder_s3option_$VER/aws/lib/libaws-cpp-sdk-core.so /usr/local/lib64
    cp -r -p hitachi_advanced_data_binder_s3option_$VER/aws/lib/libaws-cpp-sdk-s3-crt.so /usr/local/lib64
  5. コピーしたファイルの所有者とグループをrootに変更する

    chown root libaws-cpp-sdk-core.so
    chown root libaws-cpp-sdk-s3-crt.so
    chgrp root libaws-cpp-sdk-core.so
    chgrp root libaws-cpp-sdk-s3-crt.so
  6. 手順の3.で解凍したときに作成された次のディレクトリを削除する

    • hitachi_advanced_data_binder_s3option_$VER

■KFAA91581-Eメッセージが出力された場合

次のディレクトリに対する書き込み権限と実行権限がない場合,adboptinstallコマンドがエラーになり,KFAA91581-Eメッセージが出力されます。この場合,ディレクトリに対する読み取り権限,書き込み権限,および実行権限を付与してください。

  • 環境変数ADBDIRに指定したサーバディレクトリ

  • インストールデータを格納したディレクトリ

また,環境変数ADBDIRに指定したパスにサーバディレクトリが存在しない場合も,adboptinstallコマンドがエラーになり,KFAA91581-Eメッセージが出力されます。この場合,環境変数ADBDIRに正しいサーバディレクトリのパスを指定してください。

■KFAA91558-Wメッセージが出力された場合

HADB管理者のOSアカウントではなく,rootadboptinstallコマンドを実行した場合,KFAA91558-Wメッセージ(警告メッセージ)が出力されます。通常,HADB管理者のOSアカウントで,adboptinstallコマンドを実行します。そのため,KFAA91558-Wメッセージが出力された場合は,rootadboptinstallコマンドを実行して問題がないかどうかを確認してください。

問題がある場合は,KFAA91558-Wメッセージが出力されたあとに出力されるKFAA91559-Qメッセージの入力要求に対して,nまたはNを入力してください。そのあとで,HADB管理者のOSアカウントでadboptinstallコマンドを実行してください。

なお,root以外のスーパユーザでadboptinstallコマンドを実行した場合は,KFAA91558-Wメッセージは出力されません。

メモ

rootは,OSのid -uコマンドを実行して表示される値が0のユーザを指します。また,OSのsuコマンドを使用して,ほかのOSユーザからrootに切り替えたあとで,OSのid -uコマンドを実行して表示される値が0のときも含みます。