付録B 前バージョンからの移行手順

ここでは、単一サーバにインストールされているPRIMECLUSTER GDを前バージョンから本バージョンに移行する手順を説明します。クラスタシステムの場合は、クラスタ製品のインストールガイドを参照してください。

注意

/etc/modprobe.d/gds.confファイルが存在し、"options sfdsksys sfdsksys_major=<メジャー番号>"が記載されているシステムにおいて、アップグレードする場合、以下の操作を実施してください。

[アップグレード前]

/etc/modprobe.d/gds.confファイルを削除してください。
システムディスクのミラーリングを設定している場合、システムディスクのミラーリングを解除してください。

[アップグレード後]

[アップグレード前]の操作においてシステムディスクのミラーリングを解除した場合は、システムディスクのミラーリングを再設定してください。

アップグレードを実施する前に、dd(1)コマンドなどを利用してシステム全体のバックアップを実施してください。また、本章に示す手順はコンソールで実行してください。

修正のダウンロード
UpdateSiteからPRIMECLUSTER GD 4.6A20の最新のUpdateSite形式の修正、および修正情報ファイルをダウンロードしてください。
シングルユーザモードに移行します。
現在のデフォルトターゲットの確認を行います。
注意
- デフォルトターゲット(以下の例では『multi-user.target』)は、環境によって異なります。
- 後でデフォルトターゲットを戻すため、現在のデフォルトターゲットを記録しておいてください。
```
# systemctl get-default <Return>
multi-user.target
```
シングルユーザモードにするために、デフォルトターゲットの変更を行います。
```
# systemctl set-default rescue.target <Return>
```
システムの再起動を行います。
```
# shutdown -r now <Return>
```
既存の環境から基本ソフトウェアのアップデートを行う場合は、本手順で実施します。アップデート手順については、各一括修正説明書を参照してください。
以下の手順を実行します。
1. バックアップディレクトリを作成します。
```
# mkdir /<mydir> <Return>
```
2. PRIMECLUSTER Web-Based Admin Viewの動作環境をバックアップします。
```
# cp -p /opt/FJSVwvbs/etc/webview.cnf /<mydir> <Return>
# cp -p /opt/FJSVwvbs/etc/.policy /<mydir> <Return>
# cp -p /opt/FJSVwvbs/etc/wvlocal.cnf /<mydir> <Return>
```
  Plugin.html ファイルの設定が変更されていないか確認します。
  テキストエディタにより/opt/FJSVwvbs/etc/Plugin.html ファイルを開いて、下記のエントリがデフォルト値(60)になっていることを確認します。
  デフォルト値と異なる場合、後で元に戻すために、その値を記録してください。
```
<PARAM NAME = Initial_wait VALUE ="60">
```
3. GLSを使用している場合は、GLSの動作環境をバックアップします。
```
# /opt/FJSVhanet/usr/sbin/hanetbackup -d /<mydir> <Return>
```
  バックアップファイル名は、"hanetYYYYMMDD.bk"です。なお、YYYYMMDDはコマンド実行日の情報です。(YYYY：西暦、MM：月、DD：日)
4. GDSの動作環境をバックアップします。
```
# cp -p /etc/sysconfig/devlabel /<mydir> <Return>
# cp -p /etc/sysconfig/devlabel.d/devname_conf /<mydir> <Return>
```
5. DVDをDVDドライブにセットし、マウントします。
```
# mount -t iso9660 -r /dev/<デバイスファイル名> <DVD-ROMマウントポイント> <Return>
```
```
以降で、DVDのマウントポイントを<DVDROM_DIR>とします。
```
6. 以下のスクリプトを実行し、一部のPRIMECLUSTERパッケージを削除します。
```
# cd <DVDROM_DIR>/Tool <Return>
# ./upgrade_uninstall <Return>
Are you sure to remove a part of PRIMECLUSTER from your system (y or n) ? y <Return>
・
・
The uninstallation finished successfully.
```
7. 以下のスクリプトを実行し、パッケージを新規または上書きインストールします。
```
# cd <DVDROM_DIR>/Tool <Return>
# ./cluster_install -e PCL-GDS <Return>
・
・
The installation finished successfully.
```
  注意
  - cluster_installスクリプト実行の結果、上記のようなメッセージ出力とはならず、次のようなメッセージが出力されることがあります。
    # ./cluster_install -x xx <Return> INFO: no package to update
    このメッセージは、インストールしようとしたすべてのパッケージについて、DVDに収録されたものよりも新しいバージョンのパッケージがすでにシステムにインストール済みであり、アップグレードの必要がないことをあらわします。
    問題ではありませんので、手順は継続して実行してください。
  - cluster_installスクリプト実行中下記のようなメッセージが出力されることがあります。
    # ./cluster_install -x xx <Return> Installing package <XXXXXXXXXXX> ... skipped.
    このメッセージは、インストールしようとしたパッケージについて、DVDに収録されたものと同じバージョンのパッケージがすでにシステムにインストール済みであり、アップグレードの必要がないことをあらわします。問題ではありませんので、手順は継続して実行してください。
8. GLSを使用している場合は、以下のスクリプトを実行し、パッケージを新規または上書きインストールします。
```
# cd <DVDROM_DIR>/Tool <Return>
# ./cluster_install -e PCL-GLS <Return>
・
・
The installation finished successfully.
```
9. DVDをDVDドライブから取り出します。
```
# cd / <Return>
# umount <DVDROM_DIR> <Return>
# eject cdrom <Return>
```
10. PRIMECLUSTERの修正を適用してください。
  適用方法、留意事項等については各修正の修正情報ファイルを参照してください。
11. 2.でバックアップしたPRIMECLUSTER Web-Based Admin Viewの動作環境をリストアします。
```
# cp -p /<mydir>/webview.cnf /opt/FJSVwvbs/etc/webview.cnf <Return>
# cp -p /<mydir>/.policy /opt/FJSVwvbs/etc/.policy <Return>
# cp -p /<mydir>/wvlocal.cnf /opt/FJSVwvbs/etc/wvlocal.cnf <Return>
```
  2.で Plugin.html ファイルの設定変更があった場合、値を元に戻します。
  Plugin.htmlファイルの設定が変更されていない場合、本手順は不要です。
  テキストエディタにより/opt/FJSVwvbs/etc/Plugin.html ファイルを編集し、2.で控えた値 (以下の例では "xx") に書き戻します。
```
(例)
【変更前】
<PARAM NAME = Initial_wait VALUE ="60">
【変更後】
<PARAM NAME = Initial_wait VALUE ="xx">
```
12. GLSを使用している場合は、3.でバックアップしたGLSの動作環境をリストアします。
```
# /opt/FJSVhanet/usr/sbin/hanetrestore -f /<mydir>/hanetYYYYMMDD.bk <Return>
```
13. 4.でバックアップしたGDSの動作環境をリストアします。
```
# cp -p /<mydir>/devlabel /etc/sysconfig/devlabel <Return>
# cp -p /<mydir>/devname_conf /etc/sysconfig/devlabel.d/devname_conf <Return>
```
14. Web-Based Admin Viewのjava_homeの環境変数を設定します。
```
# /etc/opt/FJSVwvbs/etc/bin/wvSetparam java_home /opt/FJSVwvbs/jre <Return>
```
システムをリブートします。
マルチユーザモードにするために、デフォルトターゲットの変更を行います。
```
# systemctl set-default multi-user.target <Return>
```
システムの再起動を行います。
```
# shutdown -r now <Return>
```