Upgrading on Linux

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. 

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

  4. Check the status of the MySQL service. 

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

    Start the MySQL service if it is not running.

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

  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-5.15.0-linux-x64.bin

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

    Garoonのインストールを開始します。 このメッセージが正しく表示されている場合は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. Choose the option to upgrade. 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 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/rc.d/init.d/cyss_cbgrn
Uninstallation script for Cybozu products:	/var/www/cgi-bin/cbgrn/uninstall_cbgrn
Installation script for MySQL:	/etc/rc.d/init.d/cyde_5_0
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.
Installing Cybozu Scheduling 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]# /etc/init.d/cyss_cbgrn start

  16. Check that the scheduling service is running. 

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

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

    sched(31622) is running...

  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)