バージョンアップ後に必要な作業

必要に応じて次の作業を行います。

ログを確認する

ファイルの更新が正常に終了したかどうかを確認するために、ログファイルの内容を確認します。
ログファイルには、次の結果が出力されます。

  • MySQLの更新結果
  • Garoonで使用するデータの更新結果
  • 更新プログラムの実行結果

インストーラーに同梱されているMySQLをインストールし、既定のディレクトリーにGaroonをインストールした場合は、次のファイルにログが出力されます。### は3桁の数字を表します。

  • Windows環境の場合:

    • MySQLのインストールログ:C:\WINDOWS\SysWow64\_cb_installer.log
    • 更新プログラムの実行結果:C:\inetpub\scripts\cbgrn\versionup_###.log
    • MySQLのエラー:C:\ProgramFiles\Cybozu\mysql-5.0\data\error.log
  • Linux環境の場合:

    • Garoonのインストール結果:/(インストーラーを実行したディレクトリー)/install.log
    • MySQLのインストール結果:/(インストーラーを実行したディレクトリー)/install_cyde.log
    • 更新プログラムの実行結果:/var/www/cgi-bin/cbgrn/versionup_###.log
    • MySQLのエラー:/usr/local/cybozu/mysql-5.0/data/error.log

更新プログラムの実行結果(versionup_###.log)の見かた

Windows環境を例として説明します。 画面キャプチャー:更新プログラムの実行結果

a):Garoonで使用するデータの更新結果
b):更新プログラムの実行結果

MySQLのインストールログ(_cb_installer.logまたはinstall_cyde.log)の確認

MySQLのインストールログにエラーが出力されているかどうかを確認します。
Windows版の場合、次のエラーが出力されることがありますが、バージョンアップは正常に完了しています。

[ERROR] Check Groupmail  
[ERROR] Command = -c "C:\Inetpub\scripts\cbgrn\php.ini" -C -q -d output_buffering=false "ディレクトリーパス\check_groupmail.csp"

ただし、上記のエラーに加えて次のエラーが出力されている場合、バージョンアップに失敗しています。

[ERROR] failed = 1

対処方法については、バージョンアップに失敗したGaroonの復旧方法を参照してください。

MySQLのエラー(error.log)の確認

MySQLのエラーログにエラーや警告が出力されているかどうかを確認します。
エラーや警告が出力されている場合、バージョンアップ終了後にMySQLを再起動してください。再起動したときにerror.logにエラーや警告が出力されなければ、バージョンアップは正常に完了しています。

LDAPにSSLで接続するために必要な設定を確認する

Garoonで利用しているLDAPにSSLで接続する場合は、接続のための設定が必要です。設定の手順については、SSL/TLSを使用して、LDAPサーバーに接続するために必要な設定を参照してください。

ライセンスを登録する

4.10.x以前のバージョンからGaroonをバージョンアップした場合は、バージョン 5.15.0のライセンスを登録します。ライセンスを登録するまでは試用期間とみなされます。バージョンアップしてから60日以内にライセンスが新規登録されなかった場合は、Garoonのアプリケーションを使用できなくなります。

操作手順:
  1. システム管理者のアカウントでGaroonにログインします。

  2. 「システム管理」画面で、「基本システムの管理」タブを選択します。

  3. [ライセンス] をクリックします。

  4. [ライセンスの管理]をクリックします。

  5. [ライセンスを登録する]をクリックします。

  6. ライセンスキーを入力し、[登録する]をクリックします。

  7. ライセンスの内容を確認し、[登録する]をクリックします。

天気データを受信する

バージョンアップ直後は、天気データが一時的にクリアされます。天気データは6時間ごとに自動取得されますが、場合によっては最長で6時間前後天気が表示されません。
バージョンアップ後、すぐに天気データを受信したい場合は、手動で天気データを受信します。

操作手順:
  1. システム管理者のアカウントでGaroonにログインします。

  2. 「システム管理」画面で、「各アプリケーションの管理」タブを選択します。

  3. [ネット連携サービス]をクリックします。

  4. [イベントデータの受信]をクリックします。

  5. 天気予報のチェックボックスを選択し、[受信する]クリックします。

全文検索サーバーを起動する

全文検索サーバーを使用している場合は、全文検索サーバーが動作しているサーバーマシンで、WorkerとSolrを起動します。
全文検索サーバーの起動は、Garoonを起動させる前に実行することを推奨します。

Windows環境の場合

1.Windowsの管理ツールから、「サービス」を開きます。
2.次のサービスを選択し、[サービスの開始]をクリックします。

  • Cybozu_SearchServer_Worker
  • Cybozu_SearchServer_Solr
Linux環境の場合

次のコマンドを順に実行します。

/etc/init.d/cbss_worker start  
/etc/init.d/cbss_solr start

サービスを起動する方法の詳細は、全文検索サーバーガイドを参照してください。

全文検索サーバーのインデックスを更新する

全文検索サーバーを利用している場合は、全文検索サーバーのインデックスを更新します。
バージョンアップ後にfull_index.cspを実行してインデックスを再作成した場合は、インデックスの更新は不要です。
インデックスの更新がGaroonにかける負荷は低いため、業務時間中でもインデックスを更新できます。

  • インデックスを更新するタイミング
    次のバージョンから、最新版のGaroonにバージョンアップする場合は、バージョンアップ後にインデックスを更新してください。

    • Garoon 4.0.x
    • Garoon 4.2.0
    • Garoon 4.2.1
    • Garoon 4.2.2
      Garoon 4.2.3以降から、最新版のGaroonにバージョンアップした場合、インデックスを更新する必要はありません。
  • コマンド実行後に表示されるメッセージ
    コマンドを実行すると、メッセージおよびスペースに関するデータのインデックスが更新されます。表示されるメッセージは、次のとおりです。

    • メッセージに関するデータのインデックスが更新された場合:
      「Finish indexing of message data.」と表示されます。Garoonで、メッセージに関するデータを検索できれば、インデックスの更新は完了です。
    • スペースに関するデータのインデックスが更新された場合:
      「Finish indexing of space data.」と表示されます。Garoonで、スペースに関するデータを検索できれば、インデックスの更新は完了です。
    • インデックスの更新が不要だった場合:
      「No need to update index.」と表示されます。

Windows環境の場合

  1. サーバーマシンにローカルの Administrator権限を持つユーザーでログインします。

  2. コマンドプロンプトを起動し、次のディレクトリーに移動します。

    (CGI ディレクトリー)/(インストール識別子)

    例:

    cd C:\inetpub\scripts\cbgrn

  3. 次のコマンドを入力し、Enterキーを押します。

    .\grn.exe -C -q code\command\fts\update_index.csp exec

Linux環境の場合

  1. サーバーマシンにrootユーザーでログインします。

  2. 次のディレクトリーに移動します。

    (CGI ディレクトリー)/(インストール識別子)

    例:

    cd /var/www/cgi-bin/cbgrn

  3. 次のコマンドを入力し、Enterキーを押します。

    ./grn.cgi -C -q code/command/fts/update_index.csp exec

ワークフローの不要なデータを削除する

バージョンアップ前のGaroonでワークフロー機能を利用していた場合、不要なデータの削除が必要になる場合があります。不要なデータを削除することで、データ量の削減とパフォーマンスの向上を見込めます。
不要なデータを削除するツールを提供しています。ツールの実行方法などの詳細は、不具合情報公開サイトの「申請経路ステップの分岐条件の変更」画面で[変更する]をクリックすると、データベース内で経路分岐に関するレコードが重複する場合がある。という記事を参照してください。(日本語のみの提供です)

掲示板の画像に欠落がないか確認する

バージョンアップ前に、次のバージョンのGaroonを使用していた場合、Garoonの掲示板に投稿された画像の一部が欠落している可能性があります。

  • バージョン 5.0.0、5.0.1、または5.0.2(パッチ未適用)

この欠落は、上記バージョンのGaroonの使用中に起こる可能性があるものです。バージョンアップによって発生するものではありません。

バージョン 5.15.0のGaroonには、欠落した画像の一覧を出力するツールが同梱されています。ツールを実行し、欠落した画像がないかどうか確認してください。
不具合の詳細と、ツールの実行方法については、不具合情報公開サイトの掲示板に関するデータ欠落の脆弱性という記事を参照してください。(日本語のみの提供です)