This section describes how to migrate Garoon from Linux environment to other servers.

• Server migrations should be performed by the following users.
  • On Windows:
    Users who have local Administrator rights on the server machine
  • On Linux:
    Users with root privilege
• The following must be identical on the source and destination servers to migrate:
  • Garoon versions:
    The revisions must be identical in revision level. You can check the version of your product in the footer on the screen. Example for Garoon version 6.0.1:
    • 6: Major Version
    • 0: Minor Version
    • 1: Revision
  • Installation identifier:
    You can check the installation identifier from the Garoon access URL.
    For the following URLs, the installation identifier is "cbgrn".
    http://192.0.2.0/cgi-bin/cbgrn/grn.cgi
  • database user password
• If the server OS type or host name are changed during server migration, the migrated Garoon access URL will be changed.
  For details, see the article in FAQ about activities that require changing IP addresses or host names of the Garoon server.

The following example shows that migrating your Garoon on Linux to a Windows environment:

• On Linux:
  • Installation identifier: cbgrn
  • CGI Directory: /var/www/cgi-bin
  • MySQL installation directory: /usr/local/cybozu
• On Windows:
  • Installation identifier: cbgrn
  • CGI directory: C:\inetpub\scripts
  • MySQL installed directory: C:\Program Files\Cybozu

1. Back up all the Garoon data on Linux.

   For details, refer to Backing up Garoon Using mysqldump.

2. Installs and initializes Garoon on the Windows environment.

   You must match the source and destination Garoon versions, installation identifiers, and database user passwords.
   The passwords for database administrative user and Administrator are optional. At the end of this procedure, the password will be the one you have set before the migration.

3. Copy the backed up data in step 2 to the Windows environment and restore it.

   For details, see the "Restoring Garoon Using mysqldump" section.

4. Ensure that you can access Garoon in the Windows environment.

Migrate your Garoon on Linux to another Linux environment.

1. On the source server, back up the data in Garoon.

   For details, see the following page:
   Backing up Garoon Using OS Commands
   Backing up Garoon Using mysqldump

2. Installs and initializes Garoon on the destination server.

   You must match the source and destination Garoon versions, installation identifiers, and database user passwords.
   The passwords for database administrative user and Administrator are optional. At the end of this procedure, the password will be the one you have set before the migration.

3. Copy the backed up data in step 1 to the destination server environment and restore it.

   For details, refer to the following pages:
   Restoring Garoon Using OS Commands
   Restoring Garoon Using mysqldump

4. Ensure that you can access Garoon in the destination environment.