Before Setting Up

Points to Be Checked before Setting Up

This section explains system requirements as well as the ports that are used by Garoon. Make sure that you read through this section before you install or upgrade Garoon.

System Requirements

The system requirements for Garoon are as follows (as of October 2022).

Supported Operating Systems
OS Version
Windows (64bit) Windows Server 2019 Standard Edition
Windows Server 2019 Datacenter
Windows Server 2022 Standard Edition
Windows Server 2022 Datacenter
Linux (64bit) Red Hat Enterprise Linux 7
Red Hat Enterprise Linux 8
Supported Web Server Services
OS Web Server Services
Windows (64bit) Internet Information Service (IIS) 10.0
Linux (64bit) Apache 2.4.x
Supported Web Browsers
OS Web Browsers
Windows Latest version of Microsoft Edge
Latest version of Mozilla Firefox
Latest version of Google Chrome
Mac Latest version of Safari
Latest version of Mozilla Firefox
Latest version of Google Chrome
iOS iOS 14 Safari
iOS 15 Safari
Android Latest version of Chrome for Android
Mail Servers

To use the e-mail client feature, a separate mail server is also required. Garoon supports the following mail servers:

Protocol

Garoon currently supports IMAP4 and IMAP4S only for receiving e-mails.

  • SMTP
  • SMTPS
  • POP3
  • POP3S
  • IMAP4
  • IMAP4S
Authentication Method
  • APOP
  • POP before SMTP
  • SMTP Authentication
  • Advanced authorization (OAuth 2.0) for Gmail and Exchange Online:
    Available in Garoon version 5.5.1 or later. After you configure an e-mail server with specifying the OAuth client in System Administration, users can use the advanced authorization (OAuth 2.0) to send/receive emails by performing the authorization in their "E-mail account details" screen.
Encryption Protocol
  • TLS

Ports Used by Garoon

This section describes ports used by Garoon. When a firewall is deployed, you must open only necessary ports for protocols you are using.

Screen capture: Image of the communication between clients and the application server

Communication Between Clients and the Application Server
Protocol Port Number Commonly Used
HTTP TCP80
HTTPS TCP443
Features that Require Internet Access

To use Cybozu Online Service (weather forecasts and Rokuyo), Garoon must be able to access the Internet. Please note that Cybozu Online Service is provided only in Japanese.

Required Settings for the IPv6 Environment

To run Garoon on a server using IPv6 communication, you must edit the MySQL configuration file (my.ini or my.cnf). The following steps assume that MySQL bundled in the installer has been installed:

For Windows

Steps:
  1. Log in to the server machine as a user who has Administrator rights.

  2. On Windows, from Administrative Tools, open "Services".

  3. Select "Cybozu_Scheduling_Service_cbgrn" and click "Stop Service".

  4. Select "Cybozu_Database_Engine_5_0", and click "Stop Service".

  5. Open the my.ini file.

    The my.ini file exists in the following directory if you installed MySQL bundled in the installer:

    • C:\Program Files\Cybozu\mysql-5.0\etc\my.ini

  6. In the [mysqld] section, include the statement "bind-address=::".

    Before change:

    #UNCOMMENT_ONPRE_LIN user = %HTTPD_USER%  
    skip-name-resolve  
    port = 3770  
    #socket = C:/Program Files/Cybozu/mysql-5.0/data/mysql.sock  
    (Omitted)

    After change:

    #UNCOMMENT_ONPRE_LIN user = %HTTPD_USER%  
    skip-name-resolve  
    port = 3770  
    #socket = C:/Program Files/Cybozu/mysql-5.0/data/mysql.sock  
    bind-address=::  
    (Omitted)

  7. On Windows, from Administrative Tools, open "Services".

  8. Select "Cybozu_Database_Engine_5_0" and click "Start Service".

  9. Select "Cybozu_Scheduling_Service_cbgrn" and click "Start Service".

For Linux

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

  2. Stop the scheduling service.

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

  3. Stop the MySQL service.

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

  4. Open the my.ini file.

    The my.ini file exists in the following directory if you installed MySQL bundled in the installer:

    • /usr/local/cybozu/mysql-5.0/etc/my.ini

  5. In the [mysqld] section, include the statement "bind-address=::".

    Before change:

    [mysqld]  
    user = apache  
    skip-name-resolve  
    port = 3770  
    socket = /usr/local/cybozu/mysql-5.0/data/mysql.sock  
    (Omitted)

    After change:

    [mysqld]  
    user = apache  
    skip-name-resolve  
    port = 3770  
    socket = /usr/local/cybozu/mysql-5.0/data/mysql.sock  
    bind-address=::  
    (Omitted)

  6. Start the MySQL service.

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

  7. Start the scheduling service.

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