安装到Linux环境

说明将Garoon安装到Linux环境中的操作步骤。
以使用以下的环境为例进行说明。

  • OS：Red Hat Enterprise Linux 9
  • Web服务器服务：Apache 2.4.53
  • Web服务的CGI目录：/var/www/cgi-bin
  • Web服务器的文档根目录：/var/www/html
  • MySQL的安装方法：使用安装包中捆绑的MySQL
操作步骤：

  1. 使用root用户登录服务器主机。

  2. 确认httpd.conf，KeepAlive的设置是否为无效。

    有关确认/更改KeepAlive设置的方法，请参考（（仅Linux环境时）将Apache的KeepAlive设置为无效。

  3. 确认THP功能是否无效。 

    [root@garoon admin]# cat /sys/kernel/mm/transparent_hugepage/enabled

    如果“never”被[ ]选取时，说明THP功能无效。
    例：

    always madvise [never]

    如显示“[always] madvise never”或“always [madvise] never”，则THP功能有效。
    THP功能有效时请禁用THP功能。详情请参考（仅Linux环境时）禁用transparent hugepages(THP)功能。

  4. 移动到安装包所在的目录。

  5. 执行安装包。 

    [root@garoon admin]# sh grn-6.0.x-linux-x64.bin

  6. 确认所显示的内容，输入“Y”或“N”，再按Enter键。

    输入“Y”后，步骤7之后的信息将以日文显示。输入“N”后，步骤7之后的信息将以英文显示。此处以输入“Y”为范例说明之后的步骤。

    开始Garoon的安装。如此信息正常显示，则输入“Y”。  
Installing starts. If the above message is displayed correctly, type 'Y', otherwise type 'N'.

  7. 确认试用许可协议，如同意，输入“yes”后按Enter键。

    可按Space或Enter键滚动页面。

  8. 输入安装标识符，按Enter键。

    初始值为“cbgrn”。更改时输入新的安装标识符，再按Enter键。
    安装标识符用于访问Garoon的URL。

    请输入要在产品中使用的安装标识符。

可使用的字符为“a-z, A-Z, 0-9, _”。不能以数字开头。
安装标识符不得超过10个字符。
[cbgrn]:

  9. 选择要使用的MySQL。选择“1”并按Enter键。 

    选择是自动安装捆绑在安装包中的MySQL Community Server（GPL）（推荐），还是使用服务器中已安装的MySQL。  
1: 自动安装捆绑的MySQL Community Server（GPL）  
2: 使用服务器中已安装的MySQL  
[1|2]:

  10. 确认Garoon的程序和数据的安装目录，按Enter键。

    更改安装目录时，使用绝对路径输入目录，按Enter键。

    请指定程序文件的目录。  
数据较大，请注意磁盘剩余空间。  
[/usr/local/cybozu]:

  11. 输入数据库管理用户的密码，按Enter键。 

    请输入数据库管理用户(cbroot)的密码。
可使用的字符为“a-z, A-Z, 0-9, _”。
密码必须保持在6~10个字符以内。

Enter Password:

  12. 输入数据库连接用户的密码，按Enter键。 

    请输入数据库连接用户的密码。
可使用的字符为“a-z, A-Z, 0-9, _”。
密码必须保持在6~10个字符以内。

Enter Password:

  13. 输入Administrator的密码，按Enter键。 

    请输入“Administrator”的密码。  
Enter Password:
    • 密码请输入6~10个的半角字符。
    • 密码中可使用的字符串如下所示。
      • a-z
      • A-Z
      • 0-9
      • _
    • 密码中不可使用<、>、|、&。根据环境的不同，有可能其他符号也不可使用。

  14. 确认Web服务器的CGI目录，按Enter键。

    更改CGI目录时，使用绝对路径输入目录，按Enter键。

    设置CGI目录。  
安装位置为“（CGI目录）/cbgrn”。  
例: /var/www/cgi-bin/cbgrn  
[/var/www/cgi-bin]:

  15. 确认Web服务器的文档根目录，按Enter键。

    更改文档根目录时，使用绝对路径输入目录，按Enter键。

    请指定文件根目录。  
安装位置为“（文档根目录）/cbgrn”。  
例: /var/www/html/cbgrn  
[/var/www/html]:

  16. 确认Web服务器的执行用户名，按Enter键。

    Web服务器的执行用户名不同时，输入正确的执行用户名，按Enter键。

    请输入Web服务器的执行用户名。  
[apache]:

    显示“nobody”时，表示Web服务器服务没有启动。按Ctrl键和C键，中断安装。Web服务器服务启动后再次执行安装。

  17. 选择安装的数据，按Enter键。

    仅在步骤6时输入“Y”、并且显示语言为日文时，可选择安装数据。在步骤6中输入了“N”时，将不显示此信息。

    请选择要安装到Garoon中的数据。不安装任何数据时，请选择“不安装”。
1: 正常
   安装日本的节日及申请形式等标准数据。
2: 无
[1|2]:

    标准数据中已登记了节日及样本的申请形式等的数据。Garoon中新建用户并登录使用时，推荐安装标准数据。
    标准数据在之后也可安装。详情请参考Linux环境中的初始化。

  18. 确认显示的内容，如正确则输入“yes”，按Enter键。

    开始安装。

    Summary of install configuration
程序文件的安装位置：	/usr/local/cybozu
数据库管理用户	cbroot
数据库管理用户的密码:	cybozu
“Administrator”的密码：	cybozu
数据库连接用户的密码:	cybozu
数据的安装：	标准数据
安装标识符：	cbgrn
Web服务器的执行用户名：	apache
CGI程序的安装位置：	/var/www/cgi-bin/cbgrn
图像文件的安装位置：	/var/www/html/cbgrn
与MySQL进行通信时所使用的端口号	3770
调度服务的启动脚本：	/etc/systemd/system/cyss_cbgrn.service
产品的删除脚本：	/var/www/cgi-bin/cbgrn/uninstall_cbgrn
MySQL启动脚本	/etc/systemd/system/cyde_5_0.service
MySQL删除脚本	/usr/local/cybozu/mysql-5.0/uninstall_cyde_5_0

按照上述设置进行安装。是否执行？
[yes or no]:

  19. 确认安装是否正常完成。 

    Installing MySQL...
[Thu Sep 21 18:08:52 JST 2023] mysql: [Warning] Using a password on the command line interface can be insecure.
[Thu Sep 21 18:08:55 JST 2023] mysql: [Warning] Using a password on the command line interface can be insecure.
Installing CGI...
installing DB Script....
Installing Cybozu Scheduling Service...
Created symlink /etc/systemd/system/multi-user.target.wants/cyss_cbgrn.service → /etc/systemd/system/cyss_cbgrn.service.
Created symlink /etc/systemd/system/graphical.target.wants/cyss_cbgrn.service → /etc/systemd/system/cyss_cbgrn.service.
Installing Web files...
Copying license files...
Installing uninstall scripts...
DataBase Initialization...
done.

安装正常成功。
请启动web浏览器访问以下URL。

http://（服务器的FQDN或IP地址）/（CGI目录的虚拟路径）/cbgrn/grn.cgi

例)http://webserver.cybozu.co.jp/cgi-bin/cbgrn/grn.cgi
例)http://10.10.203.55/cgi-bin/cbgrn/grn.cgi

    安装过程中会出现以下警告，但安装将正常完成。无需处理。
    Warning: Using a password on the command line interface can be insecure.

  20. 设置Garoon的初始设置。

    详情请参考安装后的操作。

Linux环境中的初始化

删除样本数据和试用期间所登记的数据等，需初始化Garoon。
设置Garoon的Administrator的密码和数据库连接用户的密码，并初始化Garoon。

操作步骤：

  1. 启动命令行，停止调度服务。 

    [root@garoon admin]# systemctl stop cyss_cbgrn.service

  2. 移动到以下目录。 

    （CGI 目录） / （安装标识符）

    例：

    cd /var/www/cgi-bin/cbgrn

  3. 输入以下的命令 ，按Enter键。

    输入范例：

    ./grn.cgi -C -q code/command/grn_initialize.csp db_admin_password='cybozu' db_user_password='cybozu' garoon_admin_password='cybozu' default_timezone='Asia/Tokyo' default_locale='ja' init_data='1'

    参数：

    db_admin_password 输入数据库管理用户的密码。
    db_user_password 指定数据库连接用户的密码。
    garoon_admin_password 输入Administrator的密码。
    default_timezone 输入时区的信息。
    default_locale 为当地的信息。选择要使用的语言。
    ja：日文
    en：英文
    zh：中文
    init_data 指定是否安装数据。
    • 1：安装标准数据
    • 什么都不安装
    标准数据中已登记了节日及样本的申请形式等的数据。

  4. 输入"yes"，然后按Enter键。 

    Do you really initialize Garoon? (y/[n]) :

    输入“n”，按Enter键，则终止初始化。

  5. 确认初始化是否已正常完成。 

    Done in 18 minutes 18 seconds.

  6. 启动调度服务。 

    [root@garoon admin]# systemctl start cyss_cbgrn.service