Upgrading in the Linux Environment

This section describes how to upgrade Garoon, based on the following assumptions:

  • OS：Red Hat Enterprise Linux 8
  • Web server service: Apache 2.4.37
  • CGI directory of the Web server: /var/www/cgi-bin
  • Document root directory of the Web server: /var/www/html
  • Installation identifier: cbgrn
  • MySQL: Installing MySQL bundled in the Garoon installer
Steps:

  1. Log into the server machine as a root user.

  2. Stop the Web server service on the server machine. 

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

  3. Stop the scheduling service.

    The command to execute varies depending on the Garoon version you are using.
    For Garoon 5.x:

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

    For Garoon 6.x:

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

  4. Check that the MySQL service is running.

    The command to execute varies depending on the Garoon version you are using.
    For Garoon 5.x:

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

    For Garoon 6.x:

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

    Start the MySQL service if it is not running.
    For Garoon 5.x:

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

    For Garoon 6.x:

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

  5. Check httpd.conf to ensure that KeepAlive is disabled.

    For details on how to check or edit KeepAlive settings, refer to the following section:
    For details, refer to (Only for Linux) Disabling KeepAlive in Apache.

  6. Check that the THP function is disabled. 

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

    If "never" is surrounded by [ ], the THP function is disabled.
    Example:

    always madvise [never]

    If "[always] madvise never" or "always [madvise] never" is displayed, the THP function is enabled.
    Disable THP, if it is enabled. For details, refer to (Only for Linux) Disabling Transparent Huge Pages (THP).

  7. Move to the directory where the installer exists.

  8. Execute the installer. 

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

  9. Check the displayed information, type 'Y', and then press the Enter key. 

    Installing starts. このメッセージが正しく表示されている場合はY を入力します。  
Installing starts. If the above message is displayed correctly, type 'Y', otherwise type 'N'.

  10. If you agree with the Software License Agreement, type "yes" and press the Enter key.

    To scroll the window, press the Space or Enter key.
    If you do not agree with the Software License Agreement, type "no" and press the Enter key. The upgrade process will stop.

  11. Select the upgrade option. Type '1' and press the Enter key. 

    Garoon is already installed.
1: Upgrade
2: Partial Uninstallation (Customizable resource files and database files remain undeleted.)
3: Complete Uninstallation (Completely remove the directory including all features and components.)
[1|2|3]:

  12. Confirm the directory where program files will be installed. Type the database administrator password and press the Enter key. 

    Cybozu program files will be installed in the directory "/usr/local/cybozu".

Enter a password for the database administrator (cbroot).
Valid characters are: a-z, A-Z, 0-9, and underscore (_).
Passwords must be 6 to 10 characters.

Enter Password:

  13. Check the displayed information. If it is correct, type "yes", and then press the Enter key.

    The installation will start.
    To cancel the installation, type "no" and press the Enter key.

    Summary of install configuration
Installation directory for program files:	/usr/local/cybozu
Database administrator:	cbroot
Database administrator password:	cybozu
Installation identifier:	cbgrn
Web server user name:	apache
CGI installation directory:	/var/www/cgi-bin/cbgrn
Installation directory for image files:	/var/www/html/cbgrn
Port number for communicating with MySQL:	3770
Installation script for scheduling service:	/etc/systemd/system/cyss_cbgrn.service
Uninstallation script for Cybozu products:	/var/www/cgi-bin/cbgrn/uninstall_cbgrn
Installation script for MySQL:	/etc/systemd/system/cyde_5_0.service
Uninstallation script for MySQL:	/usr/local/cybozu/mysql-5.0/uninstall_cyde_5_0

Are you sure you want to install the product with the above settings? Are you sure?
[yes or no]:

  14. Confirm that the upgrade has completed successfully. 

    Upgrade completed successfully.
[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...

The installation has completed successfully.
Start a web browser and access the URL below:

http://(FQDN or IP address of the server)/(virtual path to the CGI directory)/cbgrn/grn.cgi

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

  15. Start the scheduling service. 

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

  16. Check that the scheduling service is running. 

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

    When the scheduling service is running, this command returns the process ID of the running process.
    Example of a returned process ID:

    Main PID: 19221 (sched)

  17. Start the Web server service on the server machine. 

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

  18. Check that the Web server service is running on the server machine. 

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

    When the Web Server Services are running, the service status shows "active (running)".
    Example of the service status:

    Active: active (running)