Linux环境中的升级

此处说明在以下环境中Garoon的升级步骤。

  • OS：Red Hat Enterprise Linux 8
  • Web服务器服务：Apache 2.4.37
  • Web服务的CGI目录：/var/www/cgi-bin
  • Web服务器的文档根目录：/var/www/html
  • 安装标识符：cbgrn
  • MySQL：安装包中捆绑的MySQL
操作步骤：

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

  2. 停止服务器主机的Web服务器服务。 

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

  3. 停止调度服务。

    根据Garoon的版本，执行的命令有所不同。
    Garoon 5.x时：

    [root@garoon admin]# /etc/init.d/cyss_cbgrn stop

    Garoon 6.x时：

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

  4. 确保MySQL服务已启动。

    根据Garoon的版本，执行的命令有所不同。
    Garoon 5.x时：

    [root@garoon admin]# /etc/init.d/cyde_5_0 status

    Garoon 6.x时：

    [root@garoon admin]# systemctl status cyde_5_0.service

    如MySQL服务处于停止状态，请启动。
    Garoon 5.x时：

    [root@garoon admin]# /etc/init.d/cyde_5_0 start

    Garoon 6.x时：

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

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

    有关KeepAlive设置的确认、更改方法，请参考以下页面。
    详情请参考（仅Linux环境时）将Apache的KeepAlive设置为无效。

  6. 确认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)功能。

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

  8. 执行安装包。 

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

  9. 确认显示的内容，点击Y键后，按Enter键。 

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

  10. 同意试用许可协议时，输入“yes”，按Enter键。

    可按Space或Enter键滚动页面。
    不同意试用许可协议时，输入“no”，按Enter键。终止升级。

  11. 升级输入"yes"，然后按 Enter。 

    Garoon已安装。
1: 升级
2: 普通卸载（保留配置文件及数据库文件等资源文件）
3: 完全卸载（逐个目录删除所有资源）
[1|2|3]:

  12. 确认程序文件的安装位置，并输入数据库管理用户的密码，按Enter键。 

    程序文件安装在“/usr/local/cybozu”内。

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

Enter Password:

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

    开始安装。
    输入“no”，按Enter键，安装会停止。

    Summary of install configuration
程序文件的安装位置：	/usr/local/cybozu
数据库管理用户	cbroot
数据库管理用户的密码:	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]:

  14. 确认升级是否正常完成。 

    升级正常完成。
[Mon Sep 25 15:20:44 JST 2023][Garoon 6.0.x] Removing /usr/local/cybozu/mysql-5.0/files/cbgrn/fts...
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...

安装正常成功。
请启动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

  15. 启动调度服务。 

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

  16. 确保调度服务已停止。 

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

    如调度服务已启动，则显示执行中的进程编号。
    进程编号的范例：

    Main PID: 19221 (sched)

  17. 启动服务器主机的Web服务器服务。 

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

  18. 确认服务器主机的Web服务器服务是否已启动。 

    [root@garoon admin]# systemctl status httpd.service

    启动Web服务器服务后，运行状态中将显示 active (running)。
    运行状态的显示范例：

    Active: active (running)