安装准备

对安装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”的数字
CGI目录 保存Garoon的CGI程序和配置文件等的目录。
初始设置的目录如下所示。
  • Windows环境：C:\Inetpub\scripts
  • Linux环境：/var/www/cgi-bin
文档根目录 保存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的初始设置中，有可能设置了不向访问日志输出处理时间。
按以下步骤，设置向访问日志输出处理时间。

操作步骤：

  1. 编辑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

  2. 重启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文件中添加值。

操作步骤：

  1. 停止 MySQL 服务。

  2. 移动到配置文件所在的目录。

    • Windows环境的目录示例：C:\ProgramData\MySQL\MySQL Server 5.7\my.ini
    • Linux环境的目录示例：/usr/my.cnf

  3. 使用文本编辑器打开配置文件，添加以下的值并保存。

    已设置有值时，请注释掉该值的行再输入以下的值。

    • 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

  4. 启动 MySQL 服务。

安装时输入MySQL的连接信息

在安装程序页面选择“使用服务器中已安装的MySQL”，输入MySQL的以下连接信息。

  • MySQL的安装目录
  • MySQL的端口号
  • MySQL的root密码
安装后重启MySQL服务

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

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

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

（仅Windows环境时）关闭命令提示符的快速编辑模式

使用Windows环境时，需关闭命令提示符的快速编辑模式。未关闭快速编辑模式时，如在安装过程中进行选择文本等操作，将导致处理停止。
右键点击命令提示符的标题栏，选择“属性”。在显示的设置页面中，取消勾选“快速编辑模式”，然后点击[确定]。

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

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

操作步骤：

  1. 编辑httpd.conf，将KeepAlive设置为无效。

    更改前：

    User apache  
Group apache

    更改后：

    User apache  
Group apache  
KeepAlive Off

  2. 更改设置后，重启服务器主机的Web服务器服务。 

    ［root@garoon admin］# systemctl restart httpd.service

（仅Linux环境时）禁用transparent hugepages(THP)功能

将THP功能设置为无效。如果启用THP功能，Garoon的性能可能会下降。

操作步骤：

  1. 确认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。

  2. 将THP功能设置为无效。 

    ［root@garoon admin］# echo never > /sys/kernel/mm/transparent_hugepage/enabled

  3. 在/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

  4. 在/etc/rc.d/rc.local中设置执行权限。 

    # chmod u+x /etc/rc.d/rc.local

（仅Linux环境时）设置SELinux为无效

Linux环境时SELinux设为无效。若为有效，Garoon将无法正常运行。

操作步骤：

  1. 确认SELinux是否为有效。

    执行以下命令：

    [root@garoon admin]# getenforce

    显示以下任一项。

    • Enforcing： 有效
    • Permissive：调试模式（无连接限制，和有效时输出相同的日志）
    • Disabled：无效

  2. SELinux设为无效。

    SELinux有效时，打开SELinux的设置文件（/etc/sysconfig/selinux），更改“SELINUX”的值。

    • 更改前：
    SELINUX=enforcing
    • 更改后：
    SELINUX=disabled

  3. 重新启动OS。

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

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