Perform the following tasks if required:

Open the log files to check whether files were updated successfully.
The log files contain the following results:

• Report on the MySQL update process
• Report on the updated Garoon data
• Report on the update program execution

If you installed MySQL bundled in the Garoon installer and installed Garoon in the default installation directory, the log files are generated in the following files (where the placeholder "###" represents a three-digit number):

• For Windows:

  • Installation log for MySQL: C:\WINDOWS\SysWow64\_cb_installer.log
  • Execution result of the update program: C:\inetpub\scripts\cbgrn\versionup_###.log
  • MySQL errors: C:\ProgramFiles\Cybozu\mysql-5.0\data\error.log

• For Linux:

  • Installation log for Garoon: /(directory where the installer was executed)/install.log
  • Installation log for MySQL: /(directory where the installer was executed)/install_cyde.log
  • Report on the update program execution: /var/www/cgi-bin/cbgrn/versionup_###.log
  • MySQL errors: /usr/local/cybozu/mysql-5.0/data/error.log

The following is an example of the log file generated on Windows:

Check whether the installation log for MySQL contains the error output.
The following errors may be reported on Windows, but the upgrade is completed successfully.

[ERROR] Check Groupmail  
[ERROR] Command = -c "C:\\Inetpub\\scripts\\cbgrn\\php.ini" -C -q -d output_buffering=false "(directory path)\\check_groupmail.csp"

However, if the error below is also reported after the errors above, the upgrade failed.

[ERROR] failed = 1

For a solution to the error, refer to Recovering Garoon from an Upgrade Failure.

Check whether the installation log for MySQL contains the error output.
If it contains any errors or warnings, restart MySQL after the upgrade. If no errors or warnings are reported to error.log when you restart, the upgrade is completed successfully.

To enable Garoon to connect to an LDAP server over SSL, additional configurations are required. For setting instructions, refer to Enabling SSL/TLS Connections to LDAP Servers.

When you upgrade Garoon from version 4.10.x or earlier, you must register a license for version 5.15.0. Garoon runs in trial mode until you register the license. If the license is not registered within 60 days after the upgrade, Garoon applications will be no longer accessible.

1. Log into Garoon with a system administrator account.

2. In the "System settings" screen, select "Basic system administration" tab.

3. Click License.

4. Click Manage licenses.

5. Click Register license.

6. Enter your license key and click "Register".

7. Check that the license information is correct and click "Register".

Weather information is unavailable temporarily immediately after an upgrade. Although weather information is received automatically every six hours, this means that weather information can be unavailable for up to about six hours.
To receive weather information immediately after an upgrade, you must receive it manually.

1. Log into Garoon with a system administrator account.

2. In the "System settings" screen, select "Application settings" tab.

3. Click "Cybozu Online Service".

4. Click "Receive event data".

5. Select the check box for weather information, and click "Receive".

When the Full Text Search Server is used, start Solr and Worker on the server machine where the Full Text Search Server is deployed.
It is recommended that you start the Full Text Search Server before starting Garoon.

1. From Administrative Tools on Windows, open "Services".
2. Select the following services, and click Start Service.

• Cybozu_SearchServer_Worker
• Cybozu_SearchServer_Solr

Run the following commands sequentially.

  /etc/init.d/cbss_worker start  
  /etc/init.d/cbss_solr start

For details on how to start the services, refer to the Full Text Search Server Guide.

When the Full Text Search Server is used, you must update indexes on the Full Text Search Server.
However, if you have executed "full_index.csp" to recreate indexes after the upgrade, you do not need to update indexes.
Index updates can be updated during business hours, because the load on Garoon is low.

• When to Update Indexes
  From the next version, if you upgrade Garoon to the latest version, it is recommended to update indexes after the upgrade.

  • Garoon 4.0.x
  • Garoon 4.2.0
  • Garoon 4.2.1
  • Garoon 4.2.2
    If you upgrade Garoon 4.2.3 or later to the latest version, you do not need to update indexes.

• Messages Displayed after the Command Execution
  By executing the command, indexes of the data related to Messages and Spaces are updated. Messages that are displayed are as follows.

  • When indexes of the data related to Messages are updated:
    "Finish indexing of message data" is displayed. If you can search the data related to Messages, updating indexes has been completed.
  • When indexes of the data related to Spaces are updated:
    "Finish indexing of space data." is displayed. If you can search the data related to Spaces, updating indexes has been completed.
  • When updating indexes is not necessary:
    "No need to update index." is displayed.

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

2. Start Command Prompt and move to the following directory:

   (CGI directory)/(installation identifier)

   Example:

   cd C:\\inetpub\\scripts\\cbgrn 

3. Type the following command and press the Enter key:

   .\\grn.exe -C -q code\\command\\fts\\update_index.csp exec

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

2. Move to the following directory:

   (CGI directory)/(installation identifier)

   Example:

   cd /var/www/cgi-bin/cbgrn

3. Type the following command and press the Enter key:

   ./grn.cgi -C -q code/command/fts/update_index.csp exec

If you have used the Workflow feature on Garoon before the upgrade, you may need to delete unnecessary data. By deleting unnecessary data, you can reduce data volume and expect the performance improvement.
We provide tools to delete unnecessary data. For details such as how to run the tool, refer to If you click Change on the "Change branching conditions for request route step" screen, records in the database related to the route branching may be duplicated. in the Cybozu Knowledge Base site (available only in Japanese).

If you have used the following versions of Garoon before the upgrade, some images posted in Bulletin Board may be missing.

• Version 5.0.0, 5.0.1, or 5.0.2 (without applying patches)

These losses may be caused while using the versions of Garoon mentioned above. This issue is not caused by the upgrade.

Garoon version 5.15.0 includes the tool to output the list of missing images. Run the tool and confirm whether some images are missing or not.
For details on the issue and how to run the tool, refer to Vulnerability of missing data in Bulletin Board in the Cybozu Knowledge Base site (available only in Japanese).