標準ライセンス版の更新時の注意点
このページでは、Handbook Studioライセンス版を更新する際の手順と注意事項についてご紹介いたします。
現在ご使用中のバージョンにより、手順が異なりますのでHandbook Studioの「環境設定／Handbook Studioについて」をご確認いただき、お使いのバージョンをご確認の上、各項をご参照ください。
Handbook Studio 4.0.5〜5.0.1をお使いのお客様
Handbook Studio 〜4.0.4をお使いのお客様
Handbook Studio 5.0.2をお使いのお客様へ
5.0.5へマイグレートしていただくために現在お使いの5.0.2を5.0.4へ更新いただく手順をご紹介いたします。
更新時の注意事項について
・ 更新コマンドでは、実行中にインターネットサーバーへ接続し、各種更新データを取得します。必ず、インターネットへ接続できる環境で実行してください。
・ 更新作業を実施する前に必ずバックアップを取得してください。Handbook Studioセットアップガイドに記載されている、バックアップの実施、および、VMwareのスナップショット機能をご使用ください。
・ 更新後、Handbook Studioの操作においてブラウザ上での動作が不正となる場合がございます。これは、以前のHandbook Studioの情報がブラウザのキャッシュに残っているため発生いたしますので、更新後ご利用になる際は、一旦、ブラウザ上のキャッシュをクリアしたうえでご使用ください。
▼ブラウザのキャッシュクリア方法については下記をご覧ください
http://handbook.jp/support/clear-cache/
5.0.2から5.0.4への更新作業
更新作業は、Handbook Studioが実行されておりますLXDコンテナ内で行いますので最初に以下のコマンドでLXDコンテナにログインしてください。なお、以降の各コマンドの実行は、Handbook Studioコンテナが実行されているサーバー内でセットアップガイドのデフォルト値でインストールされていることを想定しております。
$ ssh ubuntu@192.168.56.35
現在お使いのバージョンは、以下のコマンドでご確認いただけます。バージョンアップ作業は、1バージョンずつバージョンを上げていただく必要がございますので、必ず現在お使いのバージョンをご確認ください。
$ sudo /var/local/onservices/handbook/bin/update.sh
You are using Handbook Studio 5.0.2
5.0.2から5.0.3への更新
$ sudo /var/local/onservices/handbook/bin/update.sh 5.0.3
〜更新ログ〜
### DONE ###
5.0.3から5.0.4への更新
$ sudo /var/local/onservices/handbook/bin/update.sh 5.0.4
〜更新ログ〜
### DONE ###
Handbook Studioへブラウザでアクセスし、問題なくHandbook一覧が表示されることをご確認ください。
これで、Handbook Studio 5.0.5への移行準備が整いました。
お客様ログインから、お客様情報ページのHandbook Studio 5.0.5のインストールパッケージをダウンロードいただき、パッケージに含まれる、セットアップガイド、マイグレーションガイドに沿って、Handbook Studio 5.0.5環境のセットアップ後、5.0.4環境からデータ移行を行ってください。
Handbook Studio 4.0.5〜5.0.1のバージョンをお使いのお客様へ
以下に4.0.5以降の更新方法をご紹介いたします。
現在お使いのバージョンは、以下のコマンドでご確認いただけます。バージョンアップ作業は、1バージョンずつバージョンを上げていただく必要がございますので、必ず現在お使いのバージョンをご確認ください。
$ sudo /var/local/onservices/handbook/bin/update.sh
例）現在4.0.5をお使いで5.0.1に更新する場合
以下の6つのコマンドを順次実行します。$ sudo /var/local/onservices/handbook/bin/update.sh 4.0.6$ sudo /var/local/onservices/handbook/bin/update.sh 4.0.7$ sudo /var/local/onservices/handbook/bin/update.sh 4.0.8(4.0.9はリリースをスキップしたため4.0.8の次は4.0.10となります)
$ sudo /var/local/onservices/handbook/bin/update.sh 4.0.10$ sudo /var/local/onservices/handbook/bin/update.sh 5.0.0$ sudo /var/local/onservices/handbook/bin/update.sh 5.0.1
LDAPオプションなどを利用するために usersets.php を変更しているお客様
4.0.5以降のアップデートにおいては、usersets.phpが更新対象からはずれておりますので、当該ファイルのバックアップ、および内容確認は不要です。
Handbook 3でLDAPオプションなどを利用するためにusersets.phpを変更している場合は、アップデートを実行する前に当該ファイルのバックアップ、もしくは更新内容を保存しておいてください。ファイルの場所は以下のとおりです。
/var/local/onservices/heinesen/config/usersets.php
Handbookではアップデート時に可能な限りファイル変更個所をマージしますが、変更内容が消失する可能性もあるためです。
更新時の注意事項について
・ 更新コマンドでは、実行中にインターネットサーバーへ接続し、各種更新データを取得します。必ず、インターネットへ接続できる環境で実行してください。
・ 更新作業を実施する前に必ずバックアップを取得してください。Handbook Studioセットアップガイドに記載されている、バックアップの実施、および、VMwareのスナップショット機能をご使用ください。
・ 更新後、Handbook Studioの操作においてブラウザ上での動作が不正となる場合がございます。これは、以前のHandbook Studioの情報がブラウザのキャッシュに残っているため発生いたしますので、更新後ご利用になる際は、一旦、ブラウザ上のキャッシュをクリアしたうえでご使用ください。
▼ブラウザのキャッシュクリア方法については下記をご覧ください
http://handbook.jp/support/clear-cache/
セットアップガイドに掲載していないコマンドの実行の禁止
お使いの環境によってsshターミナルによるログイン時に以下のメッセージが表示される場合があります。
- New release '16.04.4 LTS' available.
- Run 'do-release-upgrade' to upgrade to it.
Handbook Studioは、現在使用中のOSバージョン以外には対応しておりませんので、上記のdo-release-upgrade
を実行するとHandbook Studioが起動できなくなります。運用上、システム環境に影響を及ぼすようなコマンドでセットアップガイドに掲載されたコマンド以外は実行しないでください。
補足
- アップデートによるiPhone/iPad/Androidの各Handbookアプリへの影響はありませんが、最新のアプリのご利用を推奨します。
Handbook Studio 5.0.1から5.0.2への移行について
Handbook Studio 5.0.1から5.0.2へは、実行環境が異なりますため、これまでの更新方法とは、手順が異なります。以下のページをご参照の上、更新を行ってください。
【ご注意】Handbook Studio 5.0.2のインストールパッケージは、既にお客様サイトでのご提供を終了しております。5.0.2のインストールパッケージをお持ちで無い場合は、お客様サイトよりお問合せフォームにてサポート宛てお問い合わせください。
