インストールの準備をする
インストールに必要な情報やWebサーバーサービスのインストールなど、Garoonをインストールするために必要な準備を説明します。
インストールに必要な情報を準備する
Garoonのインストールに必要な情報は、次のとおりです。
項目 | 説明 |
---|---|
インストーラー | 最新版のインストーラーを次のページからダウンロードします。 https://garoon.cybozu.co.jp/support/package/download/ |
Administrator (Windows) またはroot (Linux) のパスワード | Garoonを管理するユーザーのパスワードです。Garoonを初期化するために必要です。 |
システム管理者の情報 | Garoonを管理するシステム管理者の情報です。
|
お客様情報 | Garoonを導入するお客様の情報です。次の情報を準備します。
|
データベース管理ユーザーのパスワード | MySQLを管理するユーザー(cbroot)のパスワードです。パスワードは厳重に管理してください。 |
データベース接続ユーザーのパスワード | MySQLに接続するユーザーのパスワードです。パスワードは厳重に管理してください。 |
インストール識別子 | Garoonを識別するための文字列です。使用できる文字は、次のとおりです。
|
CGIディレクトリー | GaroonのCGIプログラムや、設定ファイルなどを保存するディレクトリーです。 初期設定で選択されるディレクトリーは次のとおりです。
|
ドキュメントルートディレクトリー | GaroonのHTMLファイルや画像ファイルなどを保存するディレクトリーです。 初期設定で選択されるディレクトリーは次のとおりです。
|
(OS共通)Webサーバーサービスをインストールする
サーバーにWebサーバーサービスをインストールし、CGIを実行できるように設定します。詳細は、Webサーバー/Webブラウザーのインストールと設定を参照してください。
すでにWebサーバーサービスをインストールしている場合も上記のページを参照し、必要な設定がないかを確認してください。Garoonの運用のために、アクセス権や仮想ディレクトリーの設定が追加で必要な場合があります。
インストール後は、Webサーバーサービスが起動していることを確認します。
(OS共通)Webサーバーのアクセスログを設定する
Webサーバーのアクセスログでは、Garoonへの分間アクセス数や現象発生時のリクエスト内容、およびリクエストの処理時間などを確認できます。
使用するWebサーバーの種類により出力内容や設定は異なりますが、アクセスログに次の情報が含まれるようにしてください。
- 日時
- 接続元クライアントIP
- メソッド(GET、POSTなど)
- リクエストURL
- クエリ文字列
- HTTPステータス
- サーバーからクライアントへ送信したバイト数
- 処理時間
- UserAgent
- リファラー
Apacheの初期設定では、アクセスログに処理時間を出力する設定になっていない場合があります。
下記の手順に沿って、アクセスログに処理時間を出力するように設定します。
-
httpd.confを編集し、「%D」を記述します。
- 設定例(変更前):
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
- 設定例(変更後):
LogFormat "%h %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\" %D" combined
-
Apacheを再起動、または設定ファイルを再読み込みして、設定を反映させます。
(OS共通:インストール済みのMySQLを使用する場合のみ)MySQLの設定を変更する
Garoonのインストーラーには、MySQLが同梱されています。同梱されているMySQLを使用してGaroonを構築することを推奨しますが、すでにインストールされているMySQLを使用することもできます。
MySQLは、Garoonのインストーラーに同梱されているMySQLと同じ、バージョン 8.0.28のみ使用できます。
インストール済みのMySQLを使用する場合は、次の操作が必要です。
Garoonをインストールする前に、my.iniファイル、またはmy.cnfファイルに値を追記します。
-
MySQLサービスを停止します。
-
設定ファイルが存在するディレクトリーに移動します。
- Windows環境のディレクトリーの例:C:\ProgramData\MySQL\MySQL Server 8.0\my.ini
- Linux環境のディレクトリーの例:/usr/my.cnf
-
テキストエディターで設定ファイルを開き、次の値を記載して保存します。
すでに値が設定されている場合は、その値の行をコメントアウトして次の値を記載してください。
- Windows環境の場合 (my.ini)
[mysqld] sql_mode=NO_ENGINE_SUBSTITUTION
- Linux環境の場合 (my.cnf)
[mysqld] sql_mode=NO_ENGINE_SUBSTITUTION character-set-server = utf8mb4 collation-server = utf8mb4_general_ci skip-character-set-client-handshake [client] default-character-set=utf8mb4
-
MySQLサービスを起動します。
インストーラーの画面で「サーバーにインストール済みのMySQLを使用する」を選択し、MySQLの次の接続情報を入力します。
- MySQLがインストールされているディレクトリー
- MySQLのポート番号
- MySQLのルートパスワード
Garoonのインストール完了後、MySQLサービスを再起動する必要があります。
(Windows環境の場合のみ)仮想ディレクトリーを設定する
仮想ディレクトリーは、Webブラウザーで指定されるURLと、サーバー上の実ディレクトリーとを結びつける役割をします。Garoonをインストールする前に、WebサーバーのCGIディレクトリーを仮想ディレクトリーとして設定する必要があります。
仮想ディレクトリーについては、仮想ディレクトリーの作成方法を参照してください。
(Windows環境の場合のみ)コマンドプロンプトの簡易編集モードを無効にする
Windows環境の場合、コマンドプロンプトの簡易編集モードを無効にします。簡易編集モードが有効な場合、インストール中にテキストの選択などの操作をすると、処理が停止します。
コマンドプロンプトのタイトルバーを右クリックし、「プロパティ」を選択します。表示された設定画面で、「簡易編集モード」のチェックを外し、[OK]をクリックしてください。
(Linux環境の場合のみ)ApacheのKeepAlive設定を無効にする
Apache2.4(Red Hat Enterprise Linux 8と9に同梱)の初期設定では、KeepAliveが有効です。KeepAliveを無効にするため、設定ファイルに「KeepAlive Off」を記述します。
-
httpd.confを編集し、KeepAliveの設定を無効にします。
変更前:
User apache Group apache
変更後:
User apache Group apache KeepAlive Off
-
設定を変更したあとは、サーバーマシンのWebサーバーサービスを再起動します。
[root@garoon admin]# systemctl restart httpd.service
(Linux環境の場合のみ)transparent hugepages(THP)機能を無効にする
THP機能を無効にします。THP機能が有効な場合、Garoonの性能が劣化する場合があります。
-
THP機能が無効になっていることを確認します。
[root@garoon admin]# cat /sys/kernel/mm/transparent_hugepage/enabled
「never」が[ ]で囲まれていれば、THP機能は無効になっています。
例:always madvise [never]
「[always] madvise never」または「always [madvise] never」と表示された場合はTHPが有効になっています。手順2に進みます。
THPが無効になっている場合は、手順3に進みます。 -
THP機能を無効にします。
[root@garoon admin]# echo never > /sys/kernel/mm/transparent_hugepage/enabled
-
/etc/rc.d/rc.localに記述を追加し、再起動後もTHP機能が無効になるように設定します。
変更するファイル:/etc/rc.d/rc.local
変更前:touch /var/lock/subsys/local
変更後:
touch /var/lock/subsys/local echo never > /sys/kernel/mm/transparent_hugepage/enabled
-
/etc/rc.d/rc.localに実行権を設定します。
# chmod u+x /etc/rc.d/rc.local
(Linux環境の場合のみ)SELinuxを無効にする
Linux環境の場合はSELinuxを無効にします。有効になっていると、Garoonは正常に動作しません。
-
SELinuxの状態を確認します。
[root@garoon admin]# getenforce
コマンドを実行すると、次のいずれかが表示されます。
- Enforcing: 有効
- Permissive:デバッグモード(アクセス制限はかからないが、有効時と同様のログを出力)
- Disabled: 無効
SELinuxが無効になっていない場合は、次の手順に進みます。
-
grubbyパッケージがインストールされているかどうかを確認します。
[root@garoon admin]# rpm -q grubby
grubbyパッケージがインストールされている場合は、grubbyのバージョンが表示されます。
例:grubby-8.40-63.el9.x86_64
grubbyパッケージがインストールされていない場合は、次のコマンドを実行してインストールします。
[root@garoon admin]# yum install grubby
-
SELinuxを無効にします。
[root@garoon admin]# grubby --update-kernel ALL --args selinux=0
-
OSを再起動します。
(Linux環境の場合のみ)ApacheのMulti Processing Module(MPM)を変更する
Linux環境の場合、MPMはPrefork方式で動作するように設定します。
-
Server MPMの値を確認します。
# apachectl -V
例:
Server version: Apache/2.4.6 (Red Hat Enterprise Linux) (省略) Server MPM: prefork
prefork以外の値になっている場合、次の手順に進みます。
-
00-mpm.confを編集します。
「LoadModule mpm_prefork_module modules/mod_mpm_prefork.so」のコメントアウトを外します。
-
変更前:
# LoadModule mpm_prefork_module modules/mod_mpm_prefork.so
-
変更後:
LoadModule mpm_prefork_module modules/mod_mpm_prefork.so
-
-
「mpm_prefork_module」以外のLoadModuleをすべてコメントアウトします。
-
設定を変更したあとは、サーバーマシンのWebサーバーサービスを再起動します。
[root@garoon admin]# systemctl restart httpd.service
(Linux環境の場合のみ)Garoonに必要なライブラリーをインストールする
Linux環境の場合は、Garoonを運用するために必要なライブラリーがインストールされていることを確認します。
Garoonが使用するライブラリーの詳細は、Linux環境で必要なライブラリー(Garoon 6以降)を参照してください。