安装准备

对安装Garoon时需要进行的准备进行说明，如安装所需的信息及Web服务器服务的安装等。

准备安装所需的信息

安装Garoon所需的信息如下。

项目	说明
安装包	最新版的安装包可从以下页面下载。（日文） https://garoon.cybozu.co.jp/support/package/download/
Administrator(Windows)或root(Linux)的密码	管理Garoon的用户的密码。初始化Garoon时需要。
系统管理员的信息	管理Garoon的系统管理员的信息。用户名称登录名称密码
客户信息	导入Garoon的客户的信息。准备以下的信息。法人姓名法人姓名（拼音）更改页面中显示的图标时，准备以下任一项目。图片文件表示图片文件保存地址的URL
数据库管理用户的密码	管理MySQL的用户（cbroot）的密码。请妥善管理密码。
数据库连接用户的密码	连接MySQL的用户的密码。请妥善管理密码。
安装标识符	用于识别Garoon的字符串。可使用的字符如下所示。 “a”到“z”的小写字母 “A”到“Z”的大写字母 “_”（下划线） “0”到“9”的数字补充初始值显示为“cbgrn”。不能以数字开头。最多可使用10个字符。若已安装其他的Cybozu产品，请指定与已有的安装标识符不同的标识符。
CGI目录	保存Garoon的CGI程序和配置文件等的目录。初始设置的目录如下所示。 Windows环境：C:\Inetpub\scripts Linux环境：/var/www/cgi-bin 补充 Windows环境时，安装Garoon前需先将CGI目录设置为虚拟目录。详情请参考虚拟目录的创建方法。
文档根目录	保存Garoon的HTML文件和图片文件等的目录。初始设置的目录如下所示。 Windows环境：C:\Inetpub\wwwroot Linux环境：/var/www/html

（OS共通）安装Web服务器服务

给服务器中安装Web服务器服务，并将CGI设置成可执行状态。
即使在已安装有Web服务器服务的情况下，也有可能需要为运行Garoon而进行追加设置，如设置访问权限及虚拟目录等。
无论是全新安装还是已安装有Web服务器，请务必先参考Web服务器/Web浏览器的安装和设置，进行必要的设置。
安装完成后确认Web服务器已经启动。

（OS共通）设置Web服务器的访问日志

可在Web服务器的访问日志中确认Garoon每分钟的访问次数、发生问题时的请求内容、以及请求的处理时间等。
所用Web服务器的种类不同，输出的内容和设置也有所不同，请确保访问日志中包含以下信息：

日期和时间
连接源客户端IP
方法（GET、POST等）
请求URL
查询字符串
HTTP状态
从服务器向客户端发送的字节数
处理时间
UserAgent
来源

使用Apache时

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时，需进行以下操作。

安装前修改MySQL的配置文件（my.ini或my.cnf）

安装Garoon前，在my.ini文件或my.cnf文件中添加值。

操作步骤：

停止 MySQL 服务。
移动到配置文件所在的目录。
- Windows环境的目录范例：C:\ProgramData\MySQL\MySQL Server 5.7\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的端口号
MySQL的root密码

安装后重启MySQL服务

Garoon安装完成后，需要重新启动MySQL服务。

向才望子咨询全文搜索服务器的构成步骤

使用已安装的MySQL时，全文搜索服务器的构成需要专门的设置。请咨询才望子。
使用Garoon的安装包中捆绑的MySQL时，可按照通常的步骤构成全文搜索服务器。

（仅Windows环境时）设置虚拟目录

虚拟目录对Web浏览器中指定的URL与服务器上实际的目录起到相互关联的作用。安装Garoon前，需先将Web服务器的CGI目录设置为虚拟目录。
关于虚拟目录，请参考虚拟目录的创建方法。

（仅Linux环境时）将Apache的KeepAlive设置为无效

在Apache2.4（捆绑在Red Hat Enterprise Linux 7和8中）的初始设置中，KeepAlive为有效。配置文件中对“KeepAlive Off”进行了描述，以便将KeepAlive设置为无效。

操作步骤：

编辑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功能有效时，可能对Garoon4.10及之后版本的性能产生影响。

操作步骤：

确认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设为无效。
SELinux有效时，打开SELinux的设置文件（/etc/sysconfig/selinux），更改“SELINUX”的值。
- 更改前：
```
SELINUX=enforcing
```
- 更改后：
```
SELINUX=disabled
```
重新启动OS。

（仅Linux环境时）安装Garoon所需的library

Linux环境时，确认已经安装了运行Garoon所需要的library。
Garoon使用的library的详情，请参考Linux环境中所需的library（Garoon 5.x.x及之后版本）。