*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*--- Cybozu Garoon 3.0 Service Pack 3について *-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*--- 発行日：2011年04月18日 更新日：2011年04月28日 サイボウズ株式会社 このプログラムは、サイボウズ ガルーン バージョン 3.0.0の不具合を修正す るためのプログラムです。 Language Pack、Service Pack 1および、Service Pack 2をインストールして いる環境も修正の対象に含まれます。 このファイルでは、Cybozu Garoon 3.0 Service Pack 3のインストール手順を 説明しています。 このプログラムによって改修される不具合については、Service Pack 3のリリ ースノートを参照してください。 【注意】 ・このプログラムは、バージョン 3.0.x以外のガルーンには適用できません。 ・バージョン 3.0.0のガルーンにService Packを適用する場合は、Service Pack 3のみをインストールしてください。Service Pack 3はService Pack 1 とService Pack 2の内容を含みます。 ・このプログラムはアンインストールできません。 目次 ----------------------------------------------- ・Cybozu Garoon 3.0 Service Pack 3について ・修正、更新、および追加されるファイル ・作業を行う前に ・バックアップ ・Service Pack 3のインストール ・インストール後の確認 ・スクリプトファイルについて ・grn_mail_delete_old_preview_file.cspについて ・実行方法 ・ログの見かた ・delete_messages_maintainer.cspについて ・実行方法 ・ログの見かた ・注釈一覧 ----------------------------------------------- 【補足】 ・「a)」「b)」は注釈記号です。注釈の内容は、このファイルの下方に記載し た注釈一覧を参照してください。 ====================================================================== 修正、更新、および追加されるファイル ====================================================================== このプログラムによって、修正、更新、および追加されるファイルは、次のと おりです。 ※標準のインストール先ディレクトリに、ガルーン 3をインストールした場合 を例として説明しています。インストール識別子とディレクトリは、環境に 合わせて読み替えてください。 ※ディレクトリの表記はLinux環境の表記です。Windows環境の場合は「/」を 「\」に読み替えてください。 ■修正されるファイル ・CGI実行可能ディレクトリ ・ディレクトリ： ・Windows環境：C:\Inetpub\Scripts\cbgrn ・Linux環境 ：/var/www/cgi-bin/cbgrn ・サブディレクトリとファイル： ・code/doc_root/bulletin/_category_modify.csp a) ・code/doc_root/bulletin/_category_tree.csp a) ・code/doc_root/bulletin/_command_category_modify.csp a) ・code/doc_root/bulletin/folder_json.csp ・code/doc_root/bulletin/system/folder_json.csp ・code/doc_root/cabinet/_command_folder_modify.csp a) ・code/doc_root/cabinet/_folder_modify.csp a) ・code/doc_root/cabinet/_folder_tree.csp a) ・code/doc_root/cabinet/_upload.csp a) ・code/doc_root/cabinet/folder_json.csp ・code/doc_root/cabinet/system/folder_json.csp ・code/doc_root/grn/_org_json_26.csp a) ・code/doc_root/mail/folder_json.csp a) ・code/doc_root/mail/index.csp b) ・code/doc_root/mail/view.csp b) ・code/doc_root/report/cellular/look.csp a) ・code/doc_root/cbpapi/schedule/schedule_leave_events.csp ・code/doc_root/cbpapi/schedule/ schedule_leave_events_from_repeat_event.csp ・code/doc_root/cbpapi/schedule/schedule_get_events_by_target.csp b) ・code/doc_root/cbpapi/workflow/workflow_set_proxies.csp ・code/doc_root/grn/_org_json.csp ・code/doc_root/grn/popup_user_select_json.csp ・code/doc_root/link/category_json.csp ・code/doc_root/link/system/category_json.csp ・code/doc_root/memo/_prepend.csp ・code/doc_root/memo/folder_json.csp ・code/doc_root/message/folder_json.csp ・code/doc_root/message/system/inspection_search.csp b) ・code/doc_root/notification/personal/command_filter_setting.csp b) ・code/doc_root/report/_category_json.csp ・code/doc_root/report/cellular/look.csp ・code/doc_root/report/_send_form.csp b) ・code/doc_root/report/send_form.csp b) ・code/doc_root/schedule/_view_util.csp b) ・code/doc_root/schedule/cellular/command_delete.csp ・code/doc_root/schedule/json/accessible_facility_tree.csp ・code/doc_root/schedule/operation/_prepend.csp ・code/doc_root/schedule/operation/json/ facility_group_move_privilege_tree.csp ・code/doc_root/schedule/operation/json/ facility_privilege_tree.csp ・code/doc_root/schedule/system/_facility_group_parent_modify.csp ・code/doc_root/schedule/system/_prepend.csp ・code/doc_root/schedule/system/command_facility_group_delete.csp ・code/doc_root/schedule/system/json/facility_group_move_tree.csp ・code/doc_root/schedule/system/json/facility_tree.csp ・code/doc_root/star/index.csp b) ・code/doc_root/star/portlet/set_star_list.csp b) ・code/doc_root/system/authentication/login/ command_modify_default.csp ・code/doc_root/system/user/_prepend.csp ・code/doc_root/util_api/_api.csp b) ・code/doc_root/workflow/cellular/cancel.csp b) ・code/doc_root/workflow/cellular/comment.csp b) ・code/doc_root/workflow/cellular/detail.csp b) ・code/doc_root/workflow/cellular/list.csp b) ・code/doc_root/workflow/cellular/look.csp b) ・code/doc_root/workflow/cellular/search.csp b) ・code/doc_root/workflow/cellular/status.csp b) ・code/doc_root/workflow/command_handle.csp ・code/doc_root/workflow/operation/command_petition_export.csp b) ・code/doc_root/workflow/operation/petition_search.csp ・code/doc_root/workflow/_send_form.csp b) ・code/doc_root/workflow/send_confirm.csp b) ・code/doc_root/workflow/send_form.csp b) ・code/doc_root/workflow/system/command_petition_export.csp b) ・code/doc_root/workflow/system/petition_search.csp ・code/include/bulletin/category.csp a) ・code/include/bulletin/folder_tree.csp ・code/include/cabinet/access.csp a) ・code/include/cabinet/folder.csp a) ・code/include/cabinet/folder_tree.csp ・code/include/cabinet/hierarchy.csp a) ・code/include/cabinet/notification.csp a) ・code/include/cbpapi/schedule_logic.csp b) ・code/include/fw/date.csp a) ・code/include/grn/authentication.csp b) ・code/include/grn/error_code.csp b) ・code/include/grn/notification.csp b) ・code/include/grn/org_tree.csp a) ・code/include/grn/prepend.csp b) ・code/include/grn/upload.csp a) ・code/include/grn/uum.csp b) ・code/include/link/category_tree.csp ・code/include/mail/folder.csp a) ・code/include/mail/folder_tree.csp a) ・code/include/mail/include_send.csp a) ・code/include/mail/mail.csp ・code/include/mail/table.csp b) ・code/include/mail/utility.csp b) ・code/include/message/folder_tree.csp ・code/include/message/message_logic.csp b) ・code/include/presence/logic.csp b) ・code/include/schedule/application.csp b) ・code/include/schedule/facility_tree.csp ・code/include/schedule/portlet_view_util.csp b) ・code/include/schedule/view_util.csp a) ・code/include/util_api/error_code.csp a) ・code/include/util_api/logic.csp b) ・code/include/workflow/controller_util.csp ・page/en/bulletin/_category_form.tpl a) ・page/en/bulletin/_category_path.tpl a) ・page/en/cabinet/_file_list.tpl a) ・page/en/cabinet/_folder_form.tpl a) ・page/en/cabinet/_folder_path.tpl a) ・page/en/cbpapi/header.tpl a) ・page/en/grn/org_tree_26.tpl a) ・page/en/portal/personal/portlet_add.tpl a) ・page/en/portal/portlet/view_application_menu.tpl a) ・page/en/report/_attach_file.tpl a) ・page/en/schedule/print_personal_month.tpl b) ・page/en/sysapi/header.tpl a) ・page/en/util_api/header.tpl a) ・page/en/workflow/_attach_file.tpl a) ・page/en/workflow/item/view_file.tpl ・page/ja/bulletin/_category_form.tpl a) ・page/ja/bulletin/_category_path.tpl a) ・page/ja/cabinet/_file_list.tpl a) ・page/ja/cabinet/_folder_form.tpl a) ・page/ja/cabinet/_folder_path.tpl a) ・page/ja/cbpapi/header.tpl a) ・page/ja/grn/org_tree_26.tpl a) ・page/ja/portal/personal/portlet_add.tpl a) ・page/ja/portal/portlet/view_application_menu.tpl a) ・page/ja/report/_attach_file.tpl a) ・page/ja/schedule/print_personal_month.tpl b) ・page/ja/sysapi/header.tpl a) ・page/ja/util_api/header.tpl a) ・page/ja/workflow/_attach_file.tpl a) ・page/ja/workflow/item/view_file.tpl ・page/zh/schedule/print_personal_month.tpl b) ・code/plugin/grn/common/authentication/application/cbpapi.csp b) ・code/plugin/grn/common/authentication/application/sysapi.csp b) ・code/plugin/grn/common/authentication/application/util_api.csp b) ・code/plugin/grn/common/authentication/authenticate/sysapi.csp ・code/plugin/grn/common/authentication/authenticate /util_api.csp b) ・code/plugin/grn/common/authentication/login/sysapi.csp a) ・code/plugin/grn/common/authentication/login/util_api.csp b) ・locale/en/error/grn_util_api_.csp a) ・locale/ja/error/grn_util_api_.csp a) ・Language Packをインストールしている場合に修正される、サブディレク トリとファイル： ・code/smarty/libs/plugins/function.grn_mail_attach_file_link.php a) ・code/smarty/libs/plugins/function.grn_org_select.php b) ・code/smarty/libs/plugins/function.grn_user_add.php b) ・code/smarty/libs/plugins/function.grn_user_add_26.php b) ・code/smarty/libs/plugins/function.grn_single_user_add.php b) ・code/smarty/libs/plugins/function.grn_workflow_agent_add.php b) ・code/smarty/libs/plugins/function.grn_workflow_user_add.php b) ・page/zh/bulletin/_category_form.tpl a) ・page/zh/bulletin/_category_path.tpl a) ・page/zh/cabinet/_file_list.tpl a) ・page/zh/cabinet/_folder_form.tpl a) ・page/zh/cabinet/_folder_path.tpl a) ・page/zh/cbpapi/header.tpl a) ・page/zh/grn/org_tree_26.tpl a) ・page/zh/portal/personal/portlet_add.tpl a) ・page/zh/portal/portlet/view_application_menu.tpl a) ・page/zh/report/_attach_file.tpl a) ・page/zh/sysapi/header.tpl a) ・page/zh/util_api/header.tpl a) ・page/zh/workflow/_attach_file.tpl a) ・page/zh/workflow/item/view_file.tpl ・locale/en/message/grn/common/authentication/authenticate/ sysapi.csp ・locale/en/message/grn/common/authentication/login/sysapi.csp ・locale/zh/error/grn_util_api.csp ・locale/zh/message/grn/common/authentication/authenticate/ sysapi.csp ・locale/zh/message/grn/common/authentication/login/sysapi.csp ・ドキュメントルートディレクトリ ・ディレクトリ： ・Windows環境：C:\Inetpub\wwwroot\cbgrn ・Linux環境 ：/var/www/html/cbgrn ・サブディレクトリとファイル： ・api/2008/admin.wsdl ・api/2008/cabinet.wsdl ・api/2008/cabinet.xsd ・api/2008/report.wsdl ・api/2008/report.xsd a) ・api/2008/util_api.wsdl ・grn/html/Design-global.css a) ・grn/html/report.js a) ・grn/html/std.css a) ・grn/html/wfaf.js a) ■リビジョン番号が更新されるテーブルとファイル ・データベースエンジン ・ディレクトリ： ・Windows環境：C:\Program Files\cybozu\mysql-5.0\data\cb_cbgrn ・Linux環境 ：/usr/local/cybozu/mysql-5.0/data/cb_cbgrn ・テーブル： ・tab_cb_profiledata___system.frm b) ・CGI実行可能ディレクトリ ・ディレクトリ ・Windows環境：C:\Inetpub\Scripts\cbgrn ・Linux環境 ：/var/www/cgi-bin/cbgrn ・サブディレクトリとファイル： ・garoon.ini b) ・grn/10portal.ini b) ・grn/12link.ini b) ・grn/13schedule.ini b) ・grn/15message.ini b) ・grn/16bulletin.ini b) ・grn/17cabinet.ini b) ・grn/18memo.ini b) ・grn/19phonemessage.ini b) ・grn/20timecard.ini b) ・grn/21todo.ini b) ・grn/22address.ini b) ・grn/24mail.ini b) ・grn/25workflow.ini b) ・grn/26report.ini b) ・grn/40cbwebsrv.ini b) ・grn/41rss.ini b) ・grn/42cbdnet.ini b) ・grn/48presence.ini b) ・grn/49star.ini b) ・grn/50notification.ini b) ・grn/51cellular.ini b) ・grn/52sync.ini b) ・grn/60cbsearch.ini b) ・grn/61dezielink.ini b) ・grn/62dslink.ini b) ・locale/en/info.ini b) ・locale/ja/info.ini b) ・Language Packをインストールしている場合に更新される、サブディレク トリとファイル： ・locale/zh/info.ini b) ■追加されるファイル ・CGI実行可能ディレクトリ ・ディレクトリ： ・Windows環境：C:\Inetpub\Scripts\cbgrn ・Linux環境 ：/var/www/cgi-bin/cbgrn ・サブディレクトリとファイル： ・grn_service.dat ・code/command/grn_mail_delete_old_preview_file.csp a) ・code/plugin/grn/common/authentication/login/sysapi.csp ・locale/ja/message/grn/common/authentication/login/sysapi.csp 【補足】 ・grn_service.datは、Service Packのインストールの履歴を管理するために 使われます。 ・grn_mail_delete_old_preview_file.cspの詳細については、後述の 「grn_mail_delete_old_preview_file.cspについて」を参照してください。 ・delete_messages_maintainer.cspの詳細については、後述の 「delete_messages_maintainer.cspについて」を参照してください。 ====================================================================== 作業を行う前に ====================================================================== ・Windows環境の場合、作業はWindowsの「Administrator」権限を持つユーザ ーで行います。 ・Linux環境の場合、作業はrootユーザーで行います。 ・データベースへ誰もアクセスしていない状態で作業を行ってください。 ・バージョン 3.0.0のガルーンを新規でインストールした場合、インストール 後の初期化が完了したあとに、Service Pack 3をインストールする必要があ ります。 ・ガルーンを、バージョン 2.5.xから3.0.0にバージョンアップした場合、 versionup3.csp（更新プログラム）を実行したあとに、Service Pack 3をイ ンストールする必要があります。 ・Language Packは、Service Pack 3をインストールする前にインストールす る必要があります。Service Pack 3のインストール後は、Language Packを インストールできません。 ・Service Packをインストールする場合、サイボウズ データベースエンジン を停止する必要はありません。 ====================================================================== バックアップ ====================================================================== 作業を行う前に、インストール先ディレクトリをバックアップします。 ※標準のインストール先ディレクトリに、ガルーンをインストールした場合を 例として説明しています。インストール先ディレクトリやインストール識別 子が標準と異なる場合、そのディレクトリをバックアップしてください。 ※サーバー分離構成の場合、データベースサーバーのディレクトリのみをバッ クアップします。 1.バックアップ用のディレクトリを用意します 2.次のディレクトリを、手順1で作成したバックアップ用のディレクトリにコ ピーします Windows環境：C:\Program Files\Cybozu\mysql-5.0\data C:\Program Files\Cybozu\mysql-5.0\files Linux環境 ：/usr/local/cybozu/mysql-5.0/data /usr/local/cybozu/mysql-5.0/files ====================================================================== Service Pack 3のインストール ====================================================================== ■Windows環境の場合 1.サーバーマシンのWebサーバーを停止します ※サーバー分離構成の場合、すべてのアプリケーションサーバーでWebサー バーを停止します。 2.スケジューリングサービスを停止します 1)Windowsのスタートメニューから、[コントロールパネル]→[管理ツール] →[サービス]を選択します 2)「Cybozu_Scheduling_Service_cbgrn」を選択し、[サービスの停止]をク リックします ※Cybozu_Scheduling_Service_cbgrnは標準のサービス名です。インスト ール識別子を変更している場合、"cbgrn"の部分が異なります。 ※サーバー分離構成の場合、スケジューリングサービスが起動しているサ ーバーで作業を行ってください。スケジューリングサービスは、通常、 データベースサーバーで起動しています。 3.インストーラー「grn-3.0-sp3-windows.exe」を起動します 4.「検出された製品の確認」画面で、Service Pack 3をインストールする製品 を選択し、[次へ]をクリックします ※インストールが始まります。 5.「InstallShield Wizardの完了」画面が表示されたら、[完了]をクリックし ます 6.キャッシュを削除します。 次のディレクトリー内の、すべてのディレクトリーを削除します。 C:\Inetpub\Scripts\cbgrn\smarty\compiled ※compiledディレクトリーは削除しないでください。 7.サーバー分離構成の場合、ガルーンをインストールしたすべてのサーバーマ シンで、手順3から手順6までを実行します 8.スケジューリングサービスを起動します 1)Windowsのスタートメニューから、[コントロールパネル]→[管理ツール] →[サービス]を選択します 2)「Cybozu_Scheduling_Service_cbgrn」を選択し、[サービスの開始]をク リックします ※Cybozu_Scheduling_Service_cbgrnは標準のサービス名です。インスト ール識別子を変更している場合は、"cbgrn"の部分が異なります。 ※サーバー分離構成の場合、スケジューリングサービスが起動しているサ ーバーで作業を行ってください。スケジューリングサービスは、通常、 データベースサーバーで起動しています。 9.サーバーマシンのWebサーバーを起動します ※サーバー分離構成の場合、すべてのアプリケーションサーバーでWebサー バーを起動します。 これで作業は終了です。 【補足】 ・grn-3.0-sp3-windows.exeを実行すると、次のログが出力されます。 ・実行結果： C:\WINDOWS\system32\_cb_installer.log ・バージョンアップ結果： C:\WINDOWS\system32\_cb_update_version.log ■Linux環境の場合 1.Webサーバーを停止します [root@garoon admin]# /etc/init.d/httpd stop ※サーバー分離構成の場合、すべてのアプリケーションサーバーでWebサー バーを停止します。 2.スケジューリングサービスを停止します [root@garoon admin]# /etc/init.d/cyss_cbgrn stop ※cyss_cbgrnは標準のサービス名です。インストール識別子を変更している 場合、"cbgrn"の部分が異なります。 ※サーバー分離構成の場合、スケジューリングサービスが起動しているサー バーで作業を行ってください。スケジューリングサービスは、通常、デー タベースサーバーで起動しています。 3.インストーラー「grn-3.0-sp3-linux.bin」が存在するディレクトリに移動 します 4.インストーラー「grn-3.0-sp3-linux.bin」を実行します [root@garoon admin]# sh grn-3.0-sp3-linux.bin 5.表示された内容にしたがって、y または n を入力し、Enter キーを押しま す 6.Service Pack 3をインストールするガルーンのインストール識別子を入力 し、Enter キーを押します 7.表示された内容を確認し、インストールを開始する場合は、y を入力して、 Enter キーを押します ※インストールが始まります。 8.インストールが正常に終了したことを確認します。 9.キャッシュを削除します。 次のディレクトリー内の、すべてのディレクトリーを削除します。 /var/www/cgi-bin/cbgrn/smarty/compiled ※compiledディレクトリーは削除しないでください。 10.サーバー分離構成の場合、ガルーンをインストールしたすべてのサーバー マシンで、手順3から手順9までを実行します 11.スケジューリングサービスを起動します [root@garoon admin]# /etc/init.d/cyss_cbgrn start ※cyss_cbgrnは標準のサービス名です。インストール識別子を変更している 場合は、"cbgrn"の部分が異なります。 ※サーバー分離構成の場合、スケジューリングサービスが起動しているサー バーで作業を行ってください。スケジューリングサービスは、通常、デー タベースサーバーで起動しています。 12.サーバーマシンのWebサーバーを起動します [root@garoon admin]# /etc/init.d/httpd start ※サーバー分離構成の場合、すべてのアプリケーションサーバーでWebサー バーを起動します。 これで作業は終了です。 【補足】 ・grn-3.0-sp3-linux.binを実行すると、次のログが出力されます。 ・実行結果： /（grn-3.0-sp3-linux.binを実行したディレクトリ）/install_sp.log ・サーバー分離構成の場合、ほかのサーバーマシンにマウントしたまま Service Pack 3をインストールすると、アクセス権に関するエラーが発生す る場合があります。画面に次のようなエラーメッセージが表示されますが、 処理は正常に終了しています。 エラーメッセージの例： Installing Cybozu Database Engine... Installing CGI... chown: `/var/www/cgi-bin/cbgrn/sessiondata': 許可がありません chown: `/var/www/cgi-bin/cbgrn/sessiondata' の所有権を変更中: 許可さ れていない操作です chmod: changing permissions of `/var/www/cgi-bin/cbgrn/sessiondata': 許可されていない操作です mkdir: ディレクトリ `/usr/local/cybozu/mysql-5.0/files/cbgrn' を作成 できません: 許可がありません chown: cannot access `/usr/local/cybozu/mysql-5.0/files/cbgrn': 許可 がありません chmod: cannot access `/usr/local/cybozu/mysql-5.0/files/cbgrn': 許可 がありません （中略） Version up script of after install is running... Verion up after process finished successfully. Installing Cybozu Scheduling Service... Installing Web files... ====================================================================== インストール後の確認 ====================================================================== 1.Service Pack 3をインストールしたガルーンにアクセスします 2.ログイン画面のフッターに表示されるバージョン番号を確認します ※「Version 3.0.3」と表示されていれば、インストールは正常に終了して います。 *-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*--- スクリプトファイルについて *-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*--- 次のスクリプトファイルについて説明します。 ・grn_mail_delete_old_preview_file.csp ・delete_messages_maintainer.csp ====================================================================== grn_mail_delete_old_preview_file.cspについて ====================================================================== grn_mail_delete_old_preview_file.cspは、ガルーンを運用しているサーバー に蓄積された不要なデータを削除するための、スクリプトファイルです。 grn_mail_delete_old_preview_file.cspを実行すると、次の不具合によってサ ーバーに蓄積された、メールの添付ファイルを削除できます。 ・メールにファイルが添付されている場合、「メールの転送」画面を表示する と、ガルーンを運用しているサーバーに添付ファイルが蓄積される grn_mail_delete_old_preview_file.cspの実行方法と、実行時に出力されるロ グについて説明します。 ※標準のインストール先ディレクトリに、ガルーン 3をインストールした場合 を例として説明しています。インストール識別子とディレクトリは、環境に 合わせて読み替えてください。 ---------------------------------------------------------------------- 実行方法 ---------------------------------------------------------------------- 次のコマンドを実行します。 ・Windows環境： cd C:\InetPub\Scripts\cbgrn .\grn.exe -q -C -f code\command\grn_mail_delete_old_preview_file.csp (引数) ・Linux環境： [root@garoon admin]# cd /var/www/cgi-bin/cbgrn [root@garoon admin]# ./grn.cgi -q -C -f code/command/grn_mail_delete _old_preview_file.csp (引数) ※サーバー分離構成の場合、いずれかのアプリケーションサーバーで上記のコ マンドを実行します。 ※コマンドとともに使用できる引数については、後述の「引数」を参照してく ださい。 ■引数 ・exec： データやファイルを削除します。execを省略すると、削除する予定のファ イルの数が表示されます。 ・before=YYYY-MM-DD： 指定した日付(YYYY-MM-DD)より前に作成されたデータやファイルを削除しま す。 before=YYYY-MM-DDを省略すると、コマンドを実行した日時より前に作成さ れたデータやファイルを削除します。 ・max_count=##： 指定した数のファイルを削除します。##に、ファイルの数を指定します。こ の引数を使用する場合は、execを使用する必要があります。 ・max_duration=##： 開始から指定した時間が経過すると、削除処理を終了します。##に、処理時 間を分で指定します。 この引数を使用する場合は、execを使用する必要があります。 ---------------------------------------------------------------------- ログの見かた ---------------------------------------------------------------------- grn_mail_delete_old_preview_file.cspを実行すると、ログが出力されます。 ログの出力先は、次のとおりです。 ・Windows環境： C:\InetPub\Scripts\cbgrn\grn_mail_delete_old_preview_file.log ・Linux環境： /var/www/cgi-bin/cbgrn/grn_mail_delete_old_preview_file.log Linxu環境でコマンドを実行した場合に出力されるログを例に、ログの見かた を説明します。 ■引数を使用しなかった場合 ・コマンド： [root@garoon admin]# ./grn.cgi -q -C -f code/command/grn_mail_delete _old_preview_file.csp ・ログ： 2010-11-21 10:18:50 Writing to log file: /var/www/cgi-bin/cbgrn/grn_ mail_delete_old_preview_file.log 2010-11-21 10:18:50 Garoon: Version 3.0.2 2010-11-21 10:18:50 Operating System: Linux garoon 2.6.18-194.3.1.el 5 #1 SMP Thu May 13 13:09:10 EDT 2010 i686 2010-11-21 10:18:50 Command Line Parameters: 2010-11-21 10:18:50 Starting 2010-11-21 10:18:50 1 files are going to be deleted. 2010-11-21 10:18:50 Done in 0 seconds. 上記のログに、次の実行結果が出力されています。 ・1 files are going to be deleted.： 削除する予定のファイルの数が表示されています。 ■引数にexecを使用した場合 ・コマンド： [root@garoon admin]# ./grn.cgi -q -C -f code/command/grn_mail_delete _old_preview_file.csp exec ・ログ： 2010-11-21 10:23:24 Writing to log file: /var/www/cgi-bin/cbgrn/grn_ mail_delete_old_preview_file.log 2010-11-21 10:23:24 Garoon: Version 3.0.2 2010-11-21 10:23:24 Operating System: Linux garoon 2.6.18-194.3.1.el 5 #1 SMP Thu May 13 13:09:10 EDT 2010 i686 2010-11-21 10:23:24 Command Line Parameters: exec 2010-11-21 10:23:24 Starting 2010-11-21 10:23:24 1 files are going to be deleted. 2010-11-21 10:23:24 deleting record: table_id:1, record_id:2 2010-11-21 10:23:24 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/2 2010-11-21 10:23:24 1 files were deleted. 2010-11-21 10:23:24 Done in 0 seconds. 上記のログに、次の実行結果が出力されています。 ・deleting record: table_id:1, record_id:2： テーブル（table_id=1）のレコード（record_id=2）が削除されたことを 表します。 ・deleting file: /usr/local/cybozu/mysql-5.0/files/cbgrn/mail/grn_ma il_filebody___p1/0/0/2： 添付ファイル（grn_mail_filebody___p1/0/0/2）が削除されたことを表し ます。 ・1 files were deleted. 削除されたファイルの数が表示されています。 ■引数にmax_countを使用した場合 ・コマンド： [root@garoon admin]# ./grn.cgi -q -C -f code/command/grn_mail_delete _old_preview_file.csp exec max_count=1 ・ログ： 2010-11-21 10:30:42 Writing to log file: /var/www/cgi-bin/cbgrn/grn_ mail_delete_old_preview_file.log 2010-11-21 10:30:42 Garoon: Version 3.0.2 2010-11-21 10:30:42 Operating System: Linux garoon 2.6.18-194.3.1.el 5 #1 SMP Thu May 13 13:09:10 EDT 2010 i686 2010-11-21 10:30:42 Command Line Parameters: exec max_count='1' 2010-11-21 10:30:42 Starting 2010-11-21 10:30:42 2 files are going to be deleted. 2010-11-21 10:30:42 deleting record: table_id:1, record_id:3 2010-11-21 10:30:42 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/3 2010-11-21 10:30:42 Stopped processing by reaching the max_count 2010-11-21 10:30:42 1 files were deleted. 2010-11-21 10:30:42 Done in 0 seconds. 上記のログに、次の実行結果が出力されています。 ・Stopped processing by reaching the max_count： 削除されるファイルの数がmax_countに達し、プログラムが処理を停止し たことを表します。 ■引数にmax_durationを使用した場合 ・コマンド： [root@garoon admin]# ./grn.cgi -q -C -f code/command/grn_mail_delete _old_preview_file.csp exec max_duration=1 ・ログ： 2010-11-21 10:33:40 Writing to log file: /var/www/cgi-bin/cbgrn/grn_ mail_delete_old_preview_file.log 2010-11-21 10:33:40 Garoon: Version 3.0.2 2010-11-21 10:33:40 Operating System: Linux garoon 2.6.18-194.3.1.el 5 #1 SMP Thu May 13 13:09:10 EDT 2010 i686 2010-11-21 10:33:40 Command Line Parameters: exec max_duration='1' 2010-11-21 10:33:40 Starting 2010-11-21 10:33:40 5 files are going to be deleted. 2010-11-21 10:34:00 deleting record: table_id:1, record_id:4 2010-11-21 10:34:00 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/4 2010-11-21 10:34:20 deleting record: table_id:1, record_id:5 2010-11-21 10:34:20 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/5 2010-11-21 10:34:40 deleting record: table_id:1, record_id:6 2010-11-21 10:34:40 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/6 2010-11-21 10:35:00 deleting record: table_id:1, record_id:7 2010-11-21 10:35:00 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/7 2010-11-21 10:35:00 Stopped processing by passing the max_duration. 2010-11-21 10:35:00 4 files were deleted. 2010-11-21 10:35:00 Done in 1 minute 20 seconds. 上記のログに、次の実行結果が出力されています。 ・Stopped processing by passing the max_duration.： max_durationで指定した時間が経過し、プログラムが処理を停止したこと を表します。 ■ファイルの削除に失敗した場合 ・コマンド： [root@garoon admin]# ./grn.cgi -q -C -f code/command/grn_mail_delete _old_preview_file.csp exec ・ログ： 2010-11-21 10:44:11 Writing to log file: /var/www/cgi-bin/cbgrn/grn_ mail_delete_old_preview_file.log 2010-11-21 10:44:11 Garoon: Version 3.0.2 2010-11-21 10:44:11 Operating System: Linux garoon 2.6.18-194.3.1.el 5 #1 SMP Thu May 13 13:09:10 EDT 2010 i686 2010-11-21 10:44:11 Command Line Parameters: exec 2010-11-21 10:44:11 Starting 2010-11-21 10:44:11 2 files are going to be deleted. 2010-11-21 10:44:11 deleting record: table_id:1, record_id:9 2010-11-21 10:44:11 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/9 2010-11-21 10:44:11 deleting record: table_id:1, record_id:10 2010-11-21 10:44:11 deleting file: /usr/local/cybozu/mysql-5.0/files /cbgrn/mail/grn_mail_filebody___p1/0/0/10 2010-11-21 10:44:11 failed to delete /usr/local/cybozu/mysql-5.0/fil es/cbgrn/mail/grn_mail_filebody___p1/0/0/10 2010-11-21 10:44:11 1 files were deleted. 2010-11-21 10:44:11 Done in 0 seconds. 上記のログに、次の実行結果が出力されています。 ・failed to delete /usr/local/cybozu/mysql-5.0/files/cbgrn/mail/grn_ mail_filebody___p1/0/0/10： 添付ファイル（grn_mail_filebody___p1/0/0/10）の削除に失敗したこと を表します。 【補足】 ・プログラムが処理を開始してから、ファイルの削除に失敗するまでに削除さ れたファイルやデータは、元に戻りません。 ・プログラムがファイルの削除に失敗する主な原因は、次のとおりです。 ・ファイルが存在しない ・プログラムを実行したユーザーに、ファイルを削除する権限がない ====================================================================== delete_messages_maintainer.cspについて ====================================================================== delete_messages_maintainer.cspは、メッセージを変更および削除する権限を 削除するためのスクリプトファイルです。 delete_messages_maintainer.cspを実行すると、次の不具合によってメッセー ジの宛先に設定されたユーザーに付与された権限を削除できます。 ・ガルーンをバージョン2.5.4以前から3.0.0以降にバージョンアップすると、 メッセージの宛先に設定されているユーザーに、そのメッセージを変更また は削除する権限が付与される場合がある。 この不具合は、メッセージの宛先に、バージョン2.5.4以前のガルーンで社内 メールを送信したことがあるユーザーが含まれている場合に発生します。 delete_messages_maintainer.cspの実行方法と、実行時に出力されるログにつ いて説明します。 標準のインストール先ディレクトリに、ガルーン 3をインストールした場合を 例として説明しています。インストール識別子とディレクトリは、環境に合わ せて読み替えてください。 【注意】 ・ガルーンをバージョン 3.0.0にバージョンアップしてから、メッセージに権 限を設定している場合は、バージョンアップ日を引数(before=YYYY-MM-DD) に指定してスクリプトファイルを実行することを推奨します。 ・バージョンアップした日付より後の日付を指定すると、メッセージを変更お よび削除する権限のすべてが削除される場合があります。 ---------------------------------------------------------------------- 実行方法 ---------------------------------------------------------------------- 次のコマンドを実行します。 ※サーバー分離構成の場合、いずれかのアプリケーションサーバーで下記のコ マンドを実行します。 ※コマンドとともに使用できる引数については、後述の「引数」を参照してく ださい。 ・Windows環境： cd C:\InetPub\Scripts\cbgrn .\grn.exe -q -C -f code\command\delete_messages_maintainer.csp (引数) ・Linux環境： cd /var/www/cgi-bin/cbgrn ./grn.cgi -q -C -f code/command/delete_messages_maintainer.csp (引数) ■引数 ・exec： 権限を削除します。execを省略すると、権限を削除されるメッセージの数が 表示されます。 ・before=YYYY-MM-DD： 指定した日付(YYYY-MM-DD)より前に付与された権限を削除します。 ---------------------------------------------------------------------- ログの見かた ---------------------------------------------------------------------- delete_messages_maintainer.cspを実行すると、ログが出力されます。 ログの出力先は、次のとおりです。 ・Windows環境： C:\InetPub\Scripts\cbgrn\delete_messages_maintainer.log ・Linux環境： /var/www/cgi-bin/cbgrn/delete_messages_maintainer.log Windows環境でコマンドを実行した場合に出力されるログを例に、ログの見か たを説明します。 ■引数にbefore=YYYY-MM-DDだけを使用する場合 ・コマンド： grn.exe -q -C -f code\command\delete_messages_maintainer.csp before=YYYY-MM-DD ・ログ： 2011-03-16 17:36:01 Writing to log file: C:\inetpub\scripts\cbgrn \delete_messages_maintainer.log 2011-03-16 17:36:01 Garoon: Version 3.0.3 2011-03-16 17:36:01 Operating System: Windows NT WIN-M4VN83DUUIV 6.1 build 7600 ((null)) i586 2011-03-16 17:36:01 Command Line Parameters: before='2010-03-01' 2011-03-16 17:36:01 Starting 2011-03-16 17:36:01 Done in 0 seconds: Hit 3 records. 上記のログに、次の実行結果が出力されています。 ・ Done in 0 seconds: Hit 3 records. 権限が削除される予定のメッセージの件数が出力されます。 ■すべての引数を使用する場合 ・コマンド： grn.exe -q -C -f code\command\delete_messages maintainer.csp exec before=YYYY-MM-DD ・ログ： 2011-03-16 17:38:16 Writing to log file: C:\inetpub\scripts\cbgrn \delete_messages_maintainer.log 2011-03-16 17:38:16 Garoon: Version 3.0.3 2011-03-16 17:38:16 Operating System: Windows NT WIN-M4VN83DUUIV 6.1 build 7600 ((null)) i586 2011-03-16 17:38:16 Command Line Parameters: before='2010-03-01' exec 2011-03-16 17:38:16 Starting 2011-03-16 17:38:16 Deleted maintainer of mid=5. 2011-03-16 17:38:16 Deleted maintainer of mid=6. 2011-03-16 17:38:16 Deleted maintainer of mid=7. 2011-03-16 17:38:16 Done in 0 seconds: Deleted maintainer 3 records. 上記のログに、次の実行結果が出力されています。 ・Deleted maintainer of mid=5： メッセージ(mid5)に、付与された権限が削除されたことを表します。 ・Done in 0 seconds: Deleted maintainer 3 records. 権限が削除されたメッセージの数が表示されています。 *-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*--- 注釈一覧 *-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*-----*--- ・バージョン 3.0.0のガルーンに、Service Pack 3を適用した場合、すべての ファイルが、修正、更新および追加されます。 ・バージョン 3.0.1のガルーンに、Service Pack 3を適用した場合、a)とb)の ファイルが修正、更新および追加されます。 ・バージョン 3.0.2のガルーンに、Service Pack 3を適用した場合、b)のファ イルが修正、更新および追加されます。 ---------------------------------------------------------------------- サイボウズ株式会社 ※サイボウズ、Cybozu、ガルーン および Garoon はサイボウズ株式会社の登 録商標です。 ※記載された商品名、各製品名は各社の登録商標または商標です。また、当社 製品には他社の著作物が含まれていることがあります。 個別の商標･著作物に関する注記については、弊社のWebサイトを参照してく ださい。 http://cybozu.co.jp/company/copyright/other_companies_trademark.html なお、本文中では、(TM)マーク、(R)マークは明記していません。 Copyright (C) 2011 Cybozu, Inc.