Cybozu Garoon 3 Installation Guide - サイボウズ ... · 2 Cybozu Garoon 3 Installation Guide ... 4 1 Before Setting Up ... - a through z (lower case alphabet) - A through Z

Cybozu Garoon 3 Installation Guide

Edition 3.2

Cybozu, Inc.

Preface

Cybozu Garoon 3 Installation Guide 2

Preface This guide describes instructions on installation and initial configurations of Cybozu Garoon Version 3.1.0 on one server machine. This guide also explains how to upgrade your Garoon to version 3.1.0.

For instruction on installation or upgrade on an environment that has distributed application servers and a database server, refer to the Installation Guide For Server Distributed System.

Who Should Use This Guide The target audience of this guide is as follows: Operators:

They are in charge of the installation work of Cybozu Garoon.

Typographic Conventions Conventions Meaning

Note Indicates important information. Tip Provides a helpful hint or information. See “Section title” on page ###. Indicates a cross reference link to the detailed information.

Production Environment This guide is produced on the following environment: OS: Windows Server 2008 Standard x64(SP2) Web browser: Internet Explorer 8 Product version: Cybozu Garoon Version 3.1.0

The contents of a screen vary depending on the web browser that you are using.

Abbreviations Abbreviation Meaning

Garoon 3 Cybozu Garoon Version 3.1.0

Copying and reproducing this document You assume complete responsibility and risk for re-using the content of this manual.

CYBOZU SHALL NOT BE RESPONSIBLE FOR ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL LOSS OR DAMAGE OR ANY OTHER COMMERCIAL DAMAGE AND LOSS, IN CONNECTION WITH THE USE OF THE SERVICE.

You must include the following copyright statement in works that incorporate content from this manual:

This document contains content derived from the *** Guide, copyright Cybozu, Inc.

Copyrights and Trademarks All brand names and product names appearing in this document are registered trademarks or

trademarks of their respective holders. Our products may contain copyrighted products owned by other companies. Please refer to the following web site regarding trademarks and copyrights:

Preface


http://cybozu.com/en/company/trademark/ In this guide, the trademark symbol (TM) and registered symbol (R) are omitted.

OpenSSL (Copyright (c) 1998-2001 The OpenSSL Project. All rights reserved.) This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit. (http://www.openssl.org/) This product includes cryptographic software written by Eric Young. ([email protected]) This product includes software written by Tim Hudson. ([email protected])

Cybozu Garoon 3 Installation Guide Edition 3.2

Published by: Cybozu, Inc. July 2011

Copyright (C) 2011 Cybozu, Inc.

http://cybozu.com/en/

Contents


Contents Preface ....................................................................................................................... 2

Contents ....................................................................................................................... 4

1 Before Setting Up................................................................................................. 6

1.1 System Requirements.................................................................................................................... 6

1.1.1 Server Example for Garoon 3............................................................................................. 7

1.2 Network Configurations.................................................................................................................. 8

2 Installing............................................................................................................... 9

2.1 Preparing Information for Installation ............................................................................................. 9

2.2 Installing on Windows ...................................................................................................................11

2.2.1 Preparing for Installation....................................................................................................11

2.2.2 Installing............................................................................................................................ 12

2.2.3 Initializing Garoon 3 .......................................................................................................... 19

2.3 Installing on Linux......................................................................................................................... 21

2.3.1 Preparing for Installation................................................................................................... 21

2.3.2 Installing............................................................................................................................ 21

2.3.3 Initializing Garoon 3 .......................................................................................................... 24

2.4 Setting Up for Starting Garoon 3.................................................................................................. 26

2.4.1 Registering Customer Information.................................................................................... 26

2.4.2 Assigning Administrators .................................................................................................. 26

2.4.3 Changing Database Settings............................................................................................ 28

3 Upgrading ........................................................................................................... 30

3.1 Upgrading on Windows ................................................................................................................ 30

3.1.1 Preparing for Upgrading ................................................................................................... 30

3.1.2 Upgrading ......................................................................................................................... 31

3.2 Upgrading on Linux ...................................................................................................................... 33

3.2.1 Upgrading ......................................................................................................................... 33

3.3 Configuring After Upgrading......................................................................................................... 35

3.3.1 Verifying Log Files ............................................................................................................ 35

3.3.2 Executing Delete Privilege Program................................................................................. 37

4 Uninstalling ........................................................................................................ 39

4.1 Uninstalling on Windows .............................................................................................................. 39

4.2 Uninstalling on Linux .................................................................................................................... 40

Contents


Appendix A Stopping and Starting Services ................................................................. 42

Appendix A.1 Stopping Services............................................................................................................ 42

Appendix A.2 Starting Services.............................................................................................................. 42

Appendix B File Structure .............................................................................................. 44

Appendix B.1 File Structure on Windows .............................................................................................. 44

Appendix B.2 File Structure on Linux .................................................................................................... 46

Index ..................................................................................................................... 50

1 Before Setting Up


1 Before Setting Up This chapter explains the system requirements and the network configurations of Garoon 3. Read this chapter before installing or upgrading this product.

1.1 System Requirements The system requirements of Garoon 3 are as follows: (By 7/2011)

Note We will not support the products and the services that are listed but are no longer supported by their

manufacturers.

Server OS

OS Version

Windows Windows Server 2008 Standard(SP2) Windows Server 2008 Enterprise(SP2) Windows Server 2003, Standard Edition(SP2) Windows Server 2003, Enterprise Edition(SP2) Windows Server 2003 R2, Standard Edition(SP2) Windows Server 2003 R2, Enterprise Edition(SP2)

Windows(64bit) Windows Server 2008 R2 Standard x64 Windows Server 2008 R2 Enterprise x64 Windows Server 2008 R2 Standard x64(SP1) Windows Server 2008 R2 Enterprise x64(SP1) Windows Server 2008 Standard x64(SP2) Windows Server 2008 Enterprise x64(SP2) Windows Server 2003 R2, Standard x64 Edition(SP2) Windows Server 2003 R2, Enterprise x64 Edition(SP2) Windows Server 2003 Standard x64 Edition(SP2) Windows Server 2003 Enterprise x64 Edition(SP2)

Linux SUSE Linux Enterprise Server 11 Red Hat Enterprise Linux 6 Red Hat Enterprise Linux 5 Advanced Platform Red Hat Enterprise Linux 5 Red Hat Enterprise Linux AS (v. 4) Red Hat Enterprise Linux ES (v. 4)

Linux(64bit) SUSE Linux Enterprise Server 11 Red Hat Enterprise Linux 6 Red Hat Enterprise Linux 5 Advanced Platform Red Hat Enterprise Linux 5 Red Hat Enterprise Linux AS (v. 4) Red Hat Enterprise Linux ES (v. 4)

1.1 System Requirements


Web Server

OS Web Server

Windows Apache 2.0.x, 2.2.x Internet Information Service (IIS) 6.0, 7.0, 7.5

Linux Apache 2.0.x, 2.2.x

Web Browser

OS Web Browser

Windows Internet Explorer 6, 7, 8 ,9 Mozilla Firefox 3.6, 4.0

Mac OS Safari 4, 5 Mozilla Firefox 3.6, 4.0

iOS Safari

Android Android Browser

Tip Garoon 3 can also run on virtual environments. Performance degradation may occur depending on

your virtual environments. For the latest information for system requirements and limited functions, see the following page on

our website: http://products.cybozu.co.jp/garoon/product/environment/ This website is currently available only in Japanese.

Mail Server You need to install a mail server to use the E-mail feature. This product supports the following mail servers:

Protocol SMTP SMTPS POP3 POP3S IMAP4

This product currently supports only the e-mail receiving feature of IMAP4. You cannot use other features of IMAP4.

Authentication Method APOP POP before SMTP SMTP Authentication

1.1.1 Server Example for Garoon 3

The server architecture for installing Garoon 3 varies depending on the number of users. For more server examples, see the following page on our website. This website is currently available only in Japanese.

1 Before Setting Up


http://products.cybozu.co.jp/garoon/product/construction/

1.2 Network Configurations Garoon 3 uses HTTP or HTTPS to communicate with web browsers. You must open the port that is relevant to the communication protocol if you use Garoon 3 through a firewall.

Example of Combination of Port Number and Network Protocol

Protocol Common port number

HTTP 80

HTTPS 443

Database Engine Communication with Garoon 3 You must close the port that is used for the communication with the database engine because access

from outside the server is unnecessary. Keep the port number confidential. Garoon 3 uses port 3770 to communicate with the database engine. However, a different port number may be used, depending on your environment. The port number for the database engine can be found in the database engine configuration file

(my.ini). If you install Garoon 3 in default directories, my.ini is saved in the following directory:

Windows: C:¥Program Files¥Cybozu¥mysql-5.0¥etc¥my.ini Linux: /usr/local/cybozu/mysql-5.0/etc/my.ini

Port Number Setting [mysqld] port = 3770

You must have Internet connection to use the following features. We offer the Cybozu Online Service and the Notices from Cybozu, which are only available in Japanese. Cybozu Online Service (Weather forecast, Rokuyo) Notices from Cybozu RSS Reader (with subscription to RSS websites)

2.1 Preparing Information for Installation


2 Installing This chapter explains how to install Garoon 3.

Tip You need to configure Garoon 3 if you use SSL to connect to LDAP. For configuration steps, see the

following page on our website. http://manual.cybozu.co.jp/en/tech/sslsetup.html

For using SSL setting on Windows environment, see the following page on our website. https://support.cybozu.com/en-us/article/4139

2.1 Preparing Information for Installation The following programs and information are required for installing Garoon 3:

Item Description

Installer The latest installer can be downloaded on our website. The following Cybozu website is currently available only in Japanese:http://products.cybozu.co.jp/garoon/download/

Administrator password or superuser password

The password that is used to manage Garoon 3. This password is required for initializing Garoon 3.

System administrator information The information of the system administrator of Garoon 3. - User name - Login name - Password

Customer information The information of the customers of Garoon 3: - Company name - Pronunciation of company name If you want to change the logo, prepare either one of the following items: - Image file - URL for image file location

Document root directory The directory that is used for storing html files and image files for Garoon 3.

CGI directory The directory that is used for storing CGI program and setting files for Garoon 3.

Installation identifier The characters that are used for identifying Garoon 3. Valid characters are as follows: - a through z (lower case alphabet) - A through Z (upper case alphabet) - Underscore (_) - 0 through 9 Tip: - Numeric characters from 0 through 9 are only allowed after alphabetic characters. - You can enter up to 10 characters. - The installation identifier must be different from any identifiers that are currently used for Cybozu products.

2 Installing


Item Description

Database administrator password The password that is used to manage the Cybozu database engine (cbroot). You must keep this password strictly confidential.

Database user password The password that is used to access the Cybozu database engine. You must keep this password strictly confidential.

Time zone information The time zone information that will be used on Garoon 3. Prepare the time zone information of Garoon 3 users.

What is Sample Data? The sample data contains data that can help users understand more about Garoon 3 features. The sample data is only available when Japanese is selected for web browser setting while installation. This service is currently available only in Japanese.

2.2 Installing on Windows


2.2 Installing on Windows This section explains how to install Garoon 3 on a 64 bit Windows Server 2008 environment.

The description assumes that Garoon 3 has been installed on the following environment: Web server: IIS 7.0 CGI directory: C:¥inetpub¥scripts Document root directory: C:¥inetpub¥wwwroot

2.2.1 Preparing for Installation

Verify the following requirements before installing Garoon 3:

Have You Already Installed a Web Server?

If not, install a web server on the server and configure the web server to permit CGI execution.

See “Web Server” on page 7.

Note If there are other exe files on the same virtual directory, script map settings are required for each exe

file.

Tip For information on how to install a web server, see the following page on our website:

http://manual.cybozu.co.jp/en/tech/webinstall/ For scripts directory setting information, see the following page on our website:

http://manual.cybozu.co.jp/en/tech/webalias/

Configurations for IIS7 on Windows Server 2008 Environments You need to do the following configurations if you are using IIS7 on a Windows Server 2008 environment. The description assumes that Garoon 3 has been installed on the default installation directory.

1 From the Windows Start menu, click Control Panel > Administrative Tools > Server Manager.

2 Select Roles > Web Server (IIS) > Internet Information Services (IIS) Manager.

3 From the Connections pane screen, select Sites > Default Web Site > scripts.

4 On the Handler Mappings screen, select CGI-exe and click Edit.

5 On the Edit Script Map dialog, enter the path to grn.exe on Executable.

Example:

6 The Do you want to allow this ISAPI extension? message appears on the Edit Script Map

2 Installing


screen.

7 Click Yes.

Tip If other exe files on the same virtual directory use scripts, script map settings are required for each

exe file. Allowing the ISAPI extension enables the exe file to run as a CGI program. If you use Apache on a 64 bit Windows Server 2008 environment by default value, Apache files are

saved in the following directory:

C:¥Program Files (x86)¥Cybozu


1 Click Start > Programs > Administrative Tools > Internet Information Services (IIS) Manager.

2 Select Web Sites > Default Web Site > scripts.

3 Right click on scripts and select New > Virtual Directory.

4 Click Next and enter “cbgrn” for the Alias name.

5 Enter the following path to Path:

C:¥inetpub¥scripts¥cbgrn

6 Select Execute (such as ISAPI applications or CGI) and click Next.

7 Click Finish.

Tip To activate the ISAPI application, allow GGI execution.

Have You Gathered Necessary Information to Install Garoon 3?

Prepare information such as administrator password, installation identifier, and so on.

See “2.1 Preparing Information for Installation” on page 9.

2.2.2 Installing

This subsection explains the steps of installing Garoon 3 on Windows.

Note You must exit all Windows programs before running the installation program.



If you have already installed the web server, verify that the web server is running on the server. You must keep the database administrator password strictly confidential. If you lose the password,

you can not reset the password nor transfer Garoon 3 to other servers. Other than trial use, do not operate more than one Garoon 3 on a single server. The Microsoft Visual C++ 2008 SP1 Redistributable Package is installed. Do not remove it.

1 Log in to the server as an administrator.

2 Installing


2 Start the installer and click Next.

Click Cancel to cancel the installation.

3 Read the Software License Agreement carefully. If you agree with the Software License Agreement,

select “I agree to the Software License Agreement.” and click Next.

If you do not agree to the Software License Agreement, click Cancel. The installer will stop.



4 Verify the Cybozu application directory, and click Next.

If you want to change the Cybozu application directory, click Browse and select another installation directory.

5 Enter the database administrator password and click Next.

6 Verify the installation identifier and click Next.

The installation identifier must be different from any identifiers that are currently used for Cybozu products. The installation identifier that you have entered here will be included in the URL to access Garoon 3. If IIS is not started, or is not installed, the "Do you want to install a web server" message appears. Click Yes to install Apache.

2 Installing


See “Have You Already Installed a Web Server?” on page 11.

7 Verify the CGI directory and click Next.

If you want to change the CGI directory, click Browse and select another directory.

8 Verify the document root directory and click Next.

If you want to change the document root directory, click Browse and select another directory.



9 Verify the installation settings displayed on the screen and click Install.

The installation will start.

2 Installing


10 Click Finish on the InstallShield Wizard Complete screen.

11 If the “Jump to the top page of Cybozu(R) Garoon 3.1.0” message is displayed, click OK.

Next step is initializing Garoon 3.

See “2.2.3 1 n i t i a l i z i ng Garoon 3” on page 19.

Tip If Garoon 3 screen is not displayed properly, verify the following information:

The "IUSR_<computer name>" of IIS can access the document root directory. The virtual directory of the web server is set properly.

For information on how to create a virtual directory, see the following page on our website: http://manual.cybozu.co.jp/en/tech/webalias/

The installation log of both Garoon 3 and CyDE2 is saved in the following file: C:¥WINDOWS¥SysWow64¥_cb_installer.log

Installing Web Server If your server does not have a web server or your web server is stopped, the "Do you want to install a web server" message appears after step 6 of “2.3.2 Installing”. Click Yes to install a web server. Click No to cancel the installation of the web server and Garoon 3.

Tip If you use the Garoon 3 installer to install a web server, the following directory is the default

installation directory of the web server: CGI directory: C:¥Program Files¥Cybozu¥Apache2.2¥cgi-bin Document root directory: C:¥Program Files¥Cybozu¥Apache2.2¥htdocs



2.2.3 Initializing Garoon 3

When the installation has finished, set the administrator password and the database user password and initialize Garoon 3.

Note Make sure that you wait until the Welcome to Cybozu Garoon screen shows up, otherwise the

initialization will fail. For editing locale default setting, Garoon 3 initialization is required. All data will be deleted if you

initialize Garoon 3.

1 Select either one of the two following methods to initialize Garoon 3:

Initializing Garoon 3 from a Command Line Change to the directory where grn_command.exe is located. Run the following command to initialize Garoon 3: grn_command.exe -f code¥command¥grn_initialize.csp db_admin_password='cybozu' db_user_password='cybozu' garoon_admin_password='cybozu' default_timezone='Asia/Tokyo' default_locale='ja'

Initialization Command Description

db_admin_password Enter database administrator password.

db_user_password Enter database user password.

garoon_admin_password Enter administrator password.

default_timezon Enter time zone information.

default_locale Indicates locale information. Select a language from Japanese, English or Chinese.

Initializing Garoon 3 from a Web Browser Access the following URL:

http://(server IP address or host name)/scripts/cbgrn/grn.exe/initialize The description assumes that Garoon 3 has been installed on the default installation directory.

Enter the required fields on the Initialize Garoon screen and click Initialize.

Entry Fields on the “Initialize Garoon” Screen

Item Description

Database administrator "cbroot" is displayed.

Database administrator password * Enter the database administrator password that you set during the installation of Garoon 3.

Database user "cb_installation identifier" is displayed.

Database user password * Enter the password that is used to access the Cybozu database engine.

See “2.1Preparing Information for Installation” on page 9.

Database user password (Confirmation) * Re-enter the database user password for confirmation.

2 Installing


Item Description

Administrator password Enter the administrator password to access Garoon 3. Administrator or superuser has all administrative privileges for Garoon 3.

Administrator password (Confirmation) Re-enter the administrator password for confirmation.

"*" indicates required fields.

2 Select Language and Time zone and click Next.

Select which data to install and click Next. Only if the web browser is set in Japanese, the sample data are available. Otherwise this screen does not appear. Proceed to step 5. Select Don't install if you do not want install any data.

See “What is Sample Data?” on page 10.

3 Click the links displayed on the screen, and check the display of both the System administration

screen and the Application screen.

4 Start configuring Garoon 3.

See “2.4 Setting Up for Starting Garoon 3” on page 26.

2.3 Installing on Linux


2.3 Installing on Linux This section explains how to install Garoon 3 on a 64 bit Linux. The description assumes that Garoon 3 has been installed on the following environment: Web server: Apache CGI directory: /var/www/cgi-bin

Document root directory: /var/www/htmｌ

2.3.1 Preparing for Installation

Verify the following requirements before installing Garoon 3:

Have You Already Installed a Web Server? If not, install a web server on the server and configure the web server to permit CGI execution.

See “Web Server” on page 11.

Note You need to install a 32bit compatibility library. For more details on how to install a web server, see the

following page on our website: http://manual.cybozu.co.jp/en/tech/installsetup.html

Tip prefork is recommended for Apache.

Have You Gathered Necessary Information to Install Garoon 3? Prepare information such as administrator password, installation identifier, and so on.

See “2.1 Preparing Information for Installation” on page 9.

Is SELinux Disabled? Garoon 3 does not operate properly while SELinux is still active.

2.3.2 Installing

This subsection explains the steps of installing Garoon 3 on Linux.

Note If you have already installed the web server, verify that the web server is running on the server. You must keep the database administrator password strictly confidential. If you lose the password,

you can not reset the password nor transfer Garoon 3 to another server. Other than trial use, do not operate more than one Garoon 3 on a single server.

1 Log in to the server as a root user.

2 Installing


2 Move to the directory where the installer is located.

3 Execute the installer.

The description assumes that Garoon 3 has been installed by the installer for 64-bit environments.

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

4 Enter 'y' or 'n' according to the message shown, and then press the Enter key. 上記のメッセージが正しく表示されている場合は Y を入力します。 If the above message is displayed correctly, type 'Y', otherwise type 'N'.


type yes, and then press the Enter key.

Use the Space key or Enter key to scroll down. If you do not agree to the Software License Agreement, type “no” and then press the Enter key. The installer will stop.

6 Enter the installation identifier, and press the Enter key.

The installation identifier must be different from any identifiers that are currently used for Cybozu products. The installation identifier that you have entered here will be included in the URL to access Garoon 3.

Enter the installation identifier for the product that you want to install, uninstall, or upgrade. To install a new Cybozu Garoon instance, specify a different installation identifier. The installation identifier must be unique for each installation. Valid characters are: A-Z, a-z, 0-9, and underscore (_). The first character must be an alphabetic characters or an underscore (_). The installation identifier must be 10 characters or less. To upgrade or uninstall an already-installed product, specify its installation identifier. [cbgrn]:

7 Verify the directories of both the Garoon 3 program and the data and press the Enter key.

If you want to change the installation directory, type the absolute path of another directory and press the Enter key.

Specify a directory for program files. Check available free disk space. The data size may become large. [/usr/local/cybozu]

8 Enter the database administrator password and press the Enter key.

Enter the database administrator password twice (including confirmation). Set a password for database administrator (cbroot). Valid characters are: A-Z, a-z, 0-9, and underscore (_). Password must contain 6 characters and no more than 10. New Password: cbadmin Retype Password: cbadmin



9 Verify the CGI directory and press the Enter key.

If you want to change the CGI directory, type the absolute path of another directory and press the Enter key.

Enter the CGI directory. The installation directory is located in the CGI directory. Example: /var/www/cgi-bin/cbgrn [/var/www/cgi-bin]

10 Verify the document root directory and press the Enter key.

If you want to change the document root directory, type the absolute path of another directory and press the Enter key.

Specify the document root directory. The installation directory is located in the document root directory. Example: /var/www/html/cbgrn [/var/www/html]

11 Verify the user name that is used to execute the web server and press the Enter key.

Type a correct web server user name if the current user does not have the right to execute the web server, and press the Enter key.

Enter the web server user name. [apache]:

12 Confirm the displayed information. Type “yes” and press the Enter key if you want to start the

installation process.

The installation will start. Otherwise, type “no” and press the Enter key to cancel the installation.

Summary of install configuration Program files: /usr/local/cybozu Database administrator: cbroot 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 communicate with Cybozu database engine: 3770 Installation script for scheduling service: /etc/rc.d/init.d/cyss_cbgrn Uninstallation script for Cybozu product: /var/www/cgi-bin/cbgrn/uninstall_cbgrn Installation script for Cybozu database engine: /etc/rc.d/init.d/cyde_5_0 Uninstallation script for Cybozu database engine: /usr/local/cybozu/mysql-5.0/uninstall_cyde_5_0 Are you sure you want to install the product with the above settings? [yes or no]: yes

13 Confirm that the installation is complete. Installing Cybozu Database Engine. Installing CGI. Installing Cybozu Scheduling Service.

2 Installing


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 [root@garoon admin]#

Tip If Garoon 3 screen is not displayed properly, verify the following information:

Does the document root directory have proper access privileges? Is the virtual directory of the web server set properly?

For information on how to create a virtual directory, see the following page on our website: http://manual.cybozu.co.jp/en/tech/webalias/

Is SELinux disabled? The installation log of Garoon 3 and the installation log of CyDE2 are saved in the following locations:

Garoon 3: (The directory where the installer is located)/install.log CyDE2: (The directory where the installer is located)/install_cyde.log

2.3.3 Initializing Garoon 3

When the installation has finished, set the administrator password and the database user password from a web browser and initialize Garoon 3.

Note Make sure that you wait until the Welcome to Cybozu Garoon screen shows up, otherwise the

initialization will fail. You need to initialize Garoon 3 to delete the sample data. If you initialize Garoon 3 from a command line, you cannot install the sample data.

1 Select either one of the two following methods to initialize Garoon 3:

Initializing Garoon 3 from a Command Line Change to the directory where grn_command is located. Run the following command to initialize Garoon 3: grn_command.exe -f code¥command¥grn_initialize.csp db_admin_password='cybozu' db_user_password='cybozu' garoon_admin_password='cybozu' default_timezone='Asia/Tokyo' default_locale='ja'

Initialization Command Description

db_admin_password Enter database administrator password.

db_user_password Enter database user password.

garoon_admin_password Enter administrator password.



default_timezon Enter time zone information.

default_locale Indicates locale information. Select a language from Japanese, English or Chinese.

Initializing Garoon 3 from a Web Browser Access the following URL:

http://(server IP address or host name) /cgi-bin/cbgrn/grn.exe/initialize The description assumes that Garoon 3 has been installed on the default installation directory.

Enter the required fields on the Initialize Garoon screen and click Initialize.

Entry Fields on the “Initialize Garoon” Screen

Item Description

Database administrator "cbroot" is displayed.

Database administrator password * Enter the database administrator password that you set during the installation of Garoon 3.

Database user "cb_installation identifier" is displayed.

Database user password * Enter the password that is used to access the Cybozu database engine.

See “2.1Preparing Information for Installation” on page 9.

Database user password (Confirmation) *

Re-enter the database user password for confirmation.

Administrator password Enter the administrator password to access Garoon 3. Administrator or superuser has all administrative privileges for Garoon 3.

Administrator password (Confirmation)

Re-enter the administrator password for confirmation.


2 Select Language and Time zone and click Next.

3 Select which data to install and click Next.

Only if the web browser is set in Japanese, the sample data are available. Otherwise this screen does not appear. Proceed to step 5. Select Don't install if you do not want install any data.

See “What is Sample Data?” on page 10.

4 Click the links displayed on the screen, and check the display of both the System administration

screen and the Application screen.

5 Start configuring Garoon 3.

See “2.4 Setting Up for Starting Garoon 3” on page 26.

2 Installing


2.4 Setting Up for Starting Garoon 3 When Garoon 3 has finished the initialization, register the customer information and the system administrator information.

2.4.1 Registering Customer Information

Access the System administration screen of Garoon 3 and register the customer information.

1 You can access the System administration screen by one of the following ways:

After the initialization finishes, click System administration screen. Access from one of the following URLs:

Windows: http://(server IP address or host name)/scripts/cbgrn/grn.exe/system/index Linux: http://(server IP address or host name)/cgi-bin/cbgrn/grn.cgi/system/index

2 Enter the login name and the password of the administrator and click Login.

3 On the System administration screen, click Basic system administration > Customer

information > Verify customer information.

4 On the Verify customer information screen, click Edit.

5 On the Edit customer information screen, set necessary information, and then click Save.

You can set the following information:

Company name: Enter your company name. Pronunciation of company name: Enter the pronunciation of your company name. Logo (URL): Enter the URL of the logo image on the web server. Logo (File): Browse to the logo file on your computer.

Note If you configure a file to display logo on Garoon 3, every time you access Garoon 3, file data are

imported from servers. High levels of data communications may overload system performance. We recommend that you use image URL to display logo.

2.4.2 Assigning Administrators

This section explains how to grant Administrator role to users.

Adding Users Add users to Garoon 3.

1 On the System administration screen, click Basic system administration > Users >

Organization/user settings.

2.4 Setting Up for Starting Garoon 3


2 Click Add user on the Organization/user settings screen.

3 Enter necessary information on the Add user screen, and then click Add.

The user that has been added belongs to Unassigned users.

Entry Fields for User Information

Item Description

Name * Enter the user name. On “Default”, select one language among Japanese, English, and Chinese from the drop-down list, and then enter the user name. On “English spelling”, enter the user name in alphabet characters.

Login name * Enter the login name of the user. The login name must be unique.

Password Enter the password of the user.

Confirmation password Re-enter the password for confirmation.

Locale Select a locale. To select a locale, you must have at least one locale on the Locale settings screen.

Office Select an office. To select an office, you must have at least one office on the Office settings screen.

Organization membership The organizations of the user are displayed. To change the organizations of the user, click Change.

Priority organization Select a priority organization.

Display order Enter a number that is equal to or greater than 0 to decide the order of the user on the user list. The users will be displayed in the increasing order of display order. The users that have the same display order will be displayed in the registration order.

Status To deactivate the account, check this check box. The deactivated user account can not access Garoon 3.

Pronunciation Enter the pronunciation of the user name.

E-mail Enter an e-mail address.

Notes Enter some notes about the user.

Position Enter the position of the user.

Contact Enter the contact information.

URL Enter the website URL that relates to the user.

Picture Specify an image to display on the User details screen.


Granting Administrator Role to Users

1 On the System administration screen, click Basic system administration > Users > Role setting.

2 On the Role setting screen, click Administrators > Grant role to users.

3 Click Unassigned users on the tree on the left side of the Grant role to users screen.

To remove specific users that have been added, select the users in the lower box, and click Remove.

2 Installing


4 Select users to grant the Administrator role and click Add.

5 Click Grant role.

2.4.3 Changing Database Settings

If the on board memory in your server exceeds 4 GB, change the settings of mysqld. To change the mysqld settings, edit the Cybozu database engine configuration file (my.ini).

The my.ini file may be configured differently depending on the memory capacity of the server of the Cybozu database engine.

Recommended Configurations for my.ini

On board memory capacity Memory

4~8 GB8~12 GB

12~16 GB

16~24 GB

24~48 GB

over 48 GB

Memory capacity for Garoon 3 2 GB 5.2 GB 8.4 GB 12 GB 18 GB 36 GBsort_buffer_size 1 M 1 M 1 M 1 M 1 M 1 Mjoin_buffer_size 3 M 3 M 3 M 3 M 3 M 3 Mread_buffer_size 1 M 1 M 1 M 1 M 1 M 1 Mread_rnd_buffer_size 2 M 2 M 2 M 2 M 2 M 2 Mthread_cache_size 50 50 50 50 50 50max_connections 50 50 50 50 50 50

my.ini values

innodb_buffer_pool_size

1500M 4500M 7800M 11500M 17600M 36100M

Note Edit the my.ini file so that the total usage memory capacity of the OS, other programs, and Garoon 3

is under the on board memory capacity of the server.

Tip For more information on how to configure my.ini, consult our official partners or your vendor. If the memory on your server does not exceed 4 GB, mysqld is automatically configured.

Editing my.ini File

The following instruction on how to configure the my.ini file is divided into two parts: Windows and Linux.

Windows

1 From the Windows Start menu, click Control Panel > Administrative Tools > Services.

2 Select “Cybozu_Scheduling_Service_cbgrn”, and click Stop the service.

3 Select “Cybozu_Database_Engine_5_0” and click Stop the service.

4 Take a backup of the my.ini file.

If you have installed Garoon 3 in the default directories, my.ini is saved in the following directory: C:¥Program Files¥Cybozu¥mysql-5.0¥etc¥my.ini

2.4 Setting Up for Starting Garoon 3


5 Edit the values of my.ini

See “Recommended Configurations for my.ini” on page Recommended Configurations for my.ini28.

6 Select “Cybozu_Database_Engine_5_0” and click Start the service.

7 Select “Cybozu_Scheduling_Service_cbgrn” and click Start the service.

Linux

1 Stop the scheduling service.

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

2 Stop the Cybozu database engine.

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

3 Take a backup of the my.ini file.

If you have installed Garoon 3 in the default directories, my.ini is saved in the following directory:

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

4 Edit the values of my.ini

See “Recommended Configurations for my.ini” on page Recommended Configurations for my.ini28.

5 Start the Cybozu database engine.

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

6 Start the scheduling service.

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

3 Upgrading


3 Upgrading This chapter explains how to upgrade an old version of Garoon to the version 3.1.0.

Note Depending on the version of Garoon before the upgrade, some additional configurations may be

required. You must back up your Garoon data before performing the upgrade. For more details on Garoon data

backup, see the "Maintaining Garoon 3" on the "Administrator guide". Do not stop the backup program until it completes.

Tip To upgrade a Garoon, use the Garoon 3 installer. You can get the latest program and the latest

manual on our website. Select the program that is suitable for your server OS. Our following website is only in Japanese: http://products.cybozu.co.jp/garoon/download/

If you use Apache on a 64 bit Windows Server 2008 environment by default value, Apache files are saved in the following directory: C:¥Program Files (x86)¥Cybozu

For more help on the upgrade process, consult our official partners or your vendor.

3.1 Upgrading on Windows The description assumes that Garoon 3 has been installed on the following environment: Web server: IIS 7.0 CGI directory: C:¥inetpub¥scripts Document root directory: C:¥inetpub¥wwwroot Default installation identifier: “cbgrn”

3.1.1 Preparing for Upgrading

The following settings are required for upgrading an old version of Garoon to the version 3.1.0.

Note If there are other exe files on the same virtual directory, script map settings are required for each exe

file.


1 From the Windows Start menu, click Control Panel > Administrative Tools > Server Manager.

2 Select Roles > Web Server (IIS) > Internet Information Services (IIS) Manager.

3.1 Upgrading on Windows


3 From the Connections pane, select Sites > Default Web Site > scripts.

4 On the Handler Mappings screen, select CGI-exe and click Edit.

5 On the Edit Script Map dialog, enter the path to grn.exe on Executable.

Example:

6 The Do you want to allow this ISAPI extension? message appears on the Edit Script Map

screen.

7 Click Yes.

Tip If other exe files on the same virtual directory use scripts, script map settings are required for each

exe file. Allowing the ISAPI extension enables the exe file to run as a CGI program. If you use Apache on a 64 bit Windows Server 2008 environment by default value, Apache files are

saved in the following directory:

C:¥Program Files (x86)¥Cybozu


1 Click Start > Programs > Administrative Tools > Internet Information Services (IIS) Manager.

2 Select Web Sites > Default Web Site > scripts.

3 Right click on scripts and select New > Virtual Directory.

4 Click Next and enter “cbgrn” for the Alias name.

5 Enter the following path to Path:

C:¥inetpub¥scripts¥cbgrn

6 Select Execute (such as ISAPI applications or CGI) and click Next.

7 Click Finish.

Tip To activate the ISAPI application, allow GGI execution.

3.1.2 Upgrading

This subsection explains the steps of upgrading Garoon 3 on Windows.

3 Upgrading


1 Log in as an administrator to the server where Garoon 3 is installed.

Back up the data of the Garoon that you want to upgrade. For more details on backup, see the "Maintaining Garoon 3" on the "Administrator guide".

2 Stop the web server.


4 Select “Cybozu_Scheduling_Service_cbgrn”, and click Stop the service.



You must close the Services window once the Cybozu database engine starts. Otherwise the upgrade will fail.

7 Start the Garoon 3.1.0 installer.

8 Select “Maintain or update the instance of this application selected below” on the Existing Installed

Instances Detected screen.

9 Select which instance to upgrade and click Next.

10 Click Finish on the Upgrade complete screen.


12 Confirm that “Cybozu_Scheduling_Service_cbgrn” is started.

13 Start the web server.

Tip If the following message is displayed during the upgrade process, the upgrade is not necessary. Click

No to cancel the upgrade.

"Cybozu(R) Garoon version 3.1.0 has already been installed on this machine"

The upgrade log is saved in the following file: The installation log of Garoon 3 and CyDE2: C:¥WINDOWS¥SysWow64¥_cb_installer.log Upgrade log:C:¥WINDOWS¥SysWow64¥_cb_versionup.log Initialization log: C:¥WINDOWS¥SysWow64¥_cb_versionup_after.log Version up log of MySQL: C:¥WINDOWS¥SysWow64¥_cb_versionup_mark.log

The above logs are exported if Garoon of version 2.5.x is upgraded to a version after 3.0.0.

3.2 Upgrading on Linux


3.2 Upgrading on Linux The description assumes that Garoon 3 has been installed on the following environment: Web server: Apache CGI directory: /var/www/cgi-bin

Document root directory: /var/www/htmｌ

Default installation identifier: “cbgrn”

Note Depending on the version of Garoon before the upgrade, some additional configurations may be

required. You must back up your Garoon data before performing the upgrade. For more details on Garoon data

backup, see the "Maintaining Garoon 3" on the "Administrator guide". Do not stop the backup program until it completes. Put the installer in a directory that is executable and writable by the web server user. All directories

above the directory of the installer must be executable and writable by the web server user.

Tip To upgrade a Garoon, use the Garoon 3 installer. You can get the latest program and the latest

manual on our website. Select the program that is suitable for your server OS. Our following website is currently available only in Japanese: http://products.cybozu.co.jp/garoon/download/

For more help on the upgrade process, consult our official partners or your vendor.

3.2.1 Upgrading

This subsection explains the steps of upgrading Garoon 3 on Linux.


2 Stop the web server. [root@garoon admin]# /etc/init.d/httpd stop

3 Stop the scheduling service. [root@garoon admin]# /etc/init.d/cyss_cbgrn stop

4 Start the Cybozu database engine. [root@garoon admin]# /etc/init.d/cyde_5_0 start





3 Upgrading



8 If you agree with the Software License Agreement, type “yes” and press the Enter key.

If you do not agree to the Software License Agreement, type “no” and press the Enter key. The upgrade process will stop. Use the Space key or Enter key to scroll down.

9 Confirm the installation identifier of the target Garoon and press the Enter key.

10 Enter the installation identifier, and press the Enter key.

11 Enter '1' and press the Enter key.

Enter '2' for a partial uninstallation or enter '3' for a complete uninstallation, and then press the Enter key.

12 Confirm the displayed information. Type “yes” and press the Enter key.

The installation will start. Otherwise, type “no” and press the Enter key to cancel the installation.

Summary of install configuration Program files: /usr/local/cybozu Database administrator: cbroot 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 communicate with Cybozu database engine: 3770 Installation script for scheduling service: /etc/rc.d/init.d/cyss_cbgrn Uninstallation script for Cybozu product: /var/www/cgi-bin/cbgrn/uninstall_cbgrn Installation script for Cybozu database engine: /etc/rc.d/init.d/cyde_5_0 Uninstallation script for Cybozu database engine: /usr/local/cybozu/mysql-5.0/uninstall_cyde_5_0 Are you sure you want to install the product with the above settings? [yes or no]: yes

13 Confirm that the upgrade is complete. Installing Cybozu Database Engine. Installing CGI. 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

3.3 Configuring After Upgrading


Example: http://10.10.203.55/cgi-bin/cbgrn/grn.cgi [root@garoon admin]#

14 Confirm that the scheduling service is started. [root@garoon admin]# /etc/init.d/cyss_cbgrn status

15 Start the web server. [root@garoon admin]# /etc/init.d/httpd start

Tip The upgrade log is saved in the following file:

Installation log of Garoon 3: / (The directory where the installer is located)/install.log Installation log of CyDE2: / (The directory where the installer is located)/install_cyde.log

3.3 Configuring After Upgrading Depending on the version of Garoon before the upgrade, your system may need different configurations for the following items:

Note We recommend editing the values of the database server configuration file (my.ini) after the upgrade.

The performance of the database server may be enhanced if suitable values are set for the my.ini file.

See “Changing Database Settings” on page 28.

3.3.1 Verifying Log Files

Open the log files to check if the files are updated successfully. The log files contain the following information: Report on the MySQL update process Report on the update of Garoon data Report on the update program execution

If you install Garoon 3 in default directories, the logs are saved in the following directories:

### indicates a 3 digit number. Logs on Windows

Result after running the update program: C:¥inetpub¥scripts¥cbgrn¥versionup_###.log MySQL errors: C:¥ProgramFiles¥Cybozu¥mysql-5.0¥data¥error.log

Logs on Linux The result after running the update program: /var/www/cgi-bin/cbgrn/versionup_###.log MySQL errors: /usr/local/cybozu/mysql-5.0/data/error.log

How to See a versionup_###.log The description assumes that a versionup_###.log has been exported on Windows.

[Tue, 13 Jul 2010 13:01:46 +0900] DB root password corrected! [Tue, 13 Jul 2010 13:01:46 +0900] start upgrading mysqldb [Tue, 13 Jul 2010 13:03:28 +0900] execute mysql_upgrade command finished. [Tue, 13 Jul 2010 13:03:28 +0900] Looking for 'mysql.exe' as: C:¥Program Files¥Cybozu¥mysql-5.0¥bin¥mysql.exe

3 Upgrading


[Tue, 13 Jul 2010 13:03:28 +0900] Looking for 'mysqlcheck.exe' as: C:¥Program Files¥Cybozu¥mysql-5.0¥bin¥mysqlcheck.exe [Tue, 13 Jul 2010 13:03:28 +0900] Running 'mysqlcheck' with connection arguments: "--port=3770" "--host=127.0.0.1" [Tue, 13 Jul 2010 13:03:28 +0900] Running 'mysqlcheck' with connection arguments: "--port=3770" "--host=127.0.0.1" [Tue, 13 Jul 2010 13:03:28 +0900] cb_cbgrn._table_info OK [Tue, 13 Jul 2010 13:03:28 +0900] cb_cbgrn.tab_cb_backupmode OK (omission) [Tue, 13 Jul 2010 13:03:30 +0900] end upgrading mysqldb [Tue, 13 Jul 2010 13:03:33 +0900] 20100713 13:03:30 [INFO] Started updating. 20100713 13:03:30 [INFO] Started grn3.0.0_local_main. 20100713 13:03:30 [INFO] Updated the version number of system attribute. 3.0.0 20100713 13:03:30 [INFO] Successeed to delete table 'tab_grn_message_addressees' (omission) 20100713 13:03:33 [INFO] Finished updating. [Tue, 13 Jul 2010 13:03:40 +0900] 20100713 13:03:34 [INFO] Started updating after installation. 20100713 13:03:34 [INFO] Deleting old time zone data. (omission) 20100713 13:03:40 [INFO] Finished updating after installation. [Tue, 13 Jul 2010 13:03:40 +0900] start removing versionup scripts [Tue, 13 Jul 2010 13:03:40 +0900] end removing versionup scripts

a): Report on the MySQL Update b): Report on the Update of Garoon Data c): Report on the Update Program Execution

Depending on the version of Garoon before the upgrade, the update program may update the database. The following logs are exported if the database is updated. The process completes successfully.

Depending on the version of Garoon, the following logs are exported. The process completes successfully.

[Warning] The syntax '--log_slow_queries' is deprecated and will be removed in MySQL 7.0. Please use '--slow_query_log'/'--slow_query_log_file' instead.

Note If statuses other than “INFO” or “OK” are output, follow the instruction in the message to troubleshoot.

Tip If the following errors have “OK” status, the countermeasure is unnecessary.

mysql.help_category error : Table upgrade required. Please do "REPAIR TABLE `help_category`" or dump/ reload to fix it! (omission) Repairing tables mysql.help_category OK mysql.help_keyword OK mysql.help_topic OK mysql.proc OK mysql.time_zone_name OK

a)

b)

c)

3.3 Configuring After Upgrading


Example of mysql.general_log

[Tue, 13 Jul 2010 13:03:30 +0900] mysql.general_log [Tue, 13 Jul 2010 13:03:30 +0900] Error : You can't use locks with log tables. [Tue, 13 Jul 2010 13:03:30 +0900] status : OK

Example of mysql.slow_log

[Tue, 13 Jul 2010 13:03:30 +0900] mysql.slow_log [Tue, 13 Jul 2010 13:03:30 +0900] Error : You can't use locks with log tables. [Tue, 13 Jul 2010 13:03:30 +0900] status : OK

Example of Error Messages on Windows Environment

100713 14:46:05 InnoDB: Started; log sequence number 0 40732198 100713 14:46:06 [ERROR] Column count of mysql.db is wrong. Expected 22, found 20. Created with MySQL 50046, now running 50142. Please use mysql_upgrade to fix this error. 100713 14:46:06 [ERROR] mysql.user has no `Event_priv` column at position 29 100713 14:46:06 [ERROR] Event Scheduler: An error occurred when initializing system tables. Disabling the Event Scheduler. 100512 14:46:06 [Note] C:¥Program Files¥Cybozu¥mysql-5.0¥bin¥mysqld.exe: ready for connections. Version: '5.1.42-enterprise-cybozu' socket: '' port: 3770 MySQL Enterprise Server (Commercial) - Cybozu

For more help on the cause of the errors, consult our official partners or your vendor.

3.3.2 Executing Delete Privilege Program

When you have upgraded Garoon to version 3.0.x, delete privilege program execution is required. If needed, execute this program to remove the unnecessary privileges which are granted by the issue.

Note If you have grant privileges for Message to users on Garoon after upgrading to version. 3.0.0, we

recommend that you use the Garoon upgrade date in the "before=YYYY-MM-DD" parameter in the script file.

If you use a date later than the upgrade date in the "before=YYYY-MM-DD" parameter, all the privileges for Message might be removed.

Tip In case of executing the delete privilege program on Garoon of version 3.0.3, there is no need to

execute the delete privilege program on Garoon of version 3.1.0. For Garoon of version 2.5.4 or earlier, this program execution is not necessary.

For the command parameters and executing steps of Delete Privilege Program, refer to the following information.

Parameters exec Removes all the unnecessary privileges. The command without the

parameter "exec" displays the number of privileges that are going to be removed.

before=YYYY-MM-DD Removes the unnecessary privileges that have been granted before

3 Upgrading


the specified date using the "YYYY-MM-DD" format.

Windows

1 Move to the directory where the grn.exe is located. cd C:¥InetPub¥Scripts¥cbgrn

2 Run the following command. .¥grn_command.exe -f code¥command¥delete_messages_maintainer.csp [parameters]

Linux

1 Move to the directory where the grn.cgi is located. cd /var/www/cgi-bin/cbgrn

2 Run the following command. ./grn_command -f code/command/delete_messages_maintainer.csp [parameters]

4.1 Uninstalling on Windows


4 Uninstalling This chapter explains how to uninstall Garoon 3.

4.1 Uninstalling on Windows This section explains how to uninstall Garoon 3 on Windows.

Note Follow the following steps to uninstall the program completely. Otherwise, some files may remain on

your computer.

1 Log in to the server as an administrator.

2 From the Windows Start menu, click Control Panel > Programs and Features.

3 Select “Cybozu(R) Garoon 3.1.0 (cbgrn)” on the Programs and Features screen, and then click

Uninstall.

4 Select “Complete uninstallation” and click Next.

The uninstallation will start.

Click Cancel to cancel the uninstallation.

4 Uninstalling


5 Click Finish on the Maintenance Complete screen.

Then, remove the Cybozu(R) Database Engine 5.0.

6 Select “Cybozu(R) Database Engine 5.0” on the Programs and Features screen, and click

Uninstall.

7 Select “Complete uninstallation” and click Next.

The uninstallation will start.

Click Cancel to cancel the uninstallation.

4.2 Uninstalling on Linux This section explains how to uninstall Garoon 3 on Linux. To uninstall Garoon 3, use the Garoon 3 installer.

Note Follow the following steps to uninstall the program completely. Otherwise, some files may remain on

your computer.





4.2 Uninstalling on Linux





type “yes”, and then press the Enter key.

If you do not agree to the Software License Agreement, type “no” and press the Enter key to cancel the uninstallation. Use the Space key or Enter key to scroll down.

6 Confirm the Garoon 3 installation identifier for uninstalling.

7 Enter the installation identifier and press the Enter key.

8 Enter the installation identifier of the target Garoon 3 and press the Enter key. If you want to keep

the resources such as the configuration files and the database files, enter '2'.

9 If you want to uninstall the Cybozu database engine completely, enter '3', and then press the Enter

key.

4 Uninstalling


Appendix A Stopping and Starting Services

This appendix explains how to stop and start the scheduling service and the Cybozu database engine. The description assumes that Garoon 3 has been installed using the default installation identifier “cbgrn”.

Note The services are started and stopped differently.

Appendix A.1 Stopping Services Stop the scheduling service first, and then the Cybozu database engine.

Windows


2 Select “Cybozu_Scheduling_Service_cbgrn”1, and click Stop the service.

3 Select “Cybozu_Database_Engine_5_0” and click Stop the service.

Linux

1 Stop the scheduling service. [root@garoon admin]# /etc/rc.d/init.d/cyss_cbgrn stop

2 Stop the Cybozu database engine. [root@garoon admin]# /etc/rc.d/init.d/cyde_5_0 stop

Appendix A.2 Starting Services Start the Cybozu database engine first, and then the scheduling service.

Windows



3 Select “Cybozu_Scheduling_Service_cbgrn” and click Start the service.



Linux

1 Start the Cybozu database engine. [root@garoon admin]# /etc/rc.d/init.d/cyde_5_0 start

2 Start the scheduling service. [root@garoon admin]# /etc/rc.d/init.d/cyss_cbgrn start

4 Uninstalling


Appendix B File Structure The description assumes that Garoon 3 has been installed using the default installation identifier “cbgrn”. The files are classified into three categories. CGI application files Cybozu database engine files Image files

Appendix B.1 File Structure on Windows

CGI Application The CGI application of Garoon 3 is installed in the CGI directory that you set during the installation process. The CGI application files are saved in the directory that takes the name of the installation identifier, under the CGI directory. Example of CGI directory: C:¥inetpub¥scripts

Bold text indicates directory names. Normal text indicates file names. C:¥inetpub¥scripts CGI directory ├¥cbgrn Installation identifier │ └¥code Garoon program │ ├¥command │ ├¥doc_root │ ├¥include │ ├¥pear │ ├¥plugin │ ├¥sched │ └¥smarty │ ├¥extensions PHP extension files ├¥grn Configuration files ├¥help Help files │ ├¥system │ └¥user │ ├¥local Language resources ├¥page Template files ├¥sessiondatal PHP session data ├¥smarty │ ├¥cashed Cache data of the smarty library │ └¥compiled Compiled templates of the smarty library │ ├¥tmp Temporary files created by the PHP script ├¥upload Temporary uploaded files │ ├¥cacher.ini ├¥cbsearch.ini ├¥common.ini



├¥common.lic ├¥db_error.log ├¥delete_user.log ├¥garoo.ini ├¥garoon_lwc.ini ├¥garoon_policy.ini ├¥grn.exe ├¥libmysql.dll ├¥License.txt ├¥logger.ini ├¥lwc.ini ├¥php4ts.dll ├¥php.ini ├¥profile.ini ├¥sched.exe ├¥sched.ini ├¥sched.log ├¥state.ini └¥system_admin.ini

Cybozu Database Engine Files Cybozu database engine files are saved in the installation directory that you set during the installation process. Example of installation directory: C:¥Program Files¥Cybozu

Bold text indicates directory names. Normal text indicates file names. C:¥Program Files¥Cybozu Installation directory └¥mysql-5.0 Cybozu database engine files ├¥bin │ ├¥my_print_defaults.exe │ ├¥mysql.exe │ ├¥mysql_upgrade.exe │ ├¥mysqladmin.exe │ ├¥mysqlbinlog.exe │ ├¥mysqlcheck.exe │ ├¥mysqld.exe │ ├¥mysqldump.exe │ └¥mysqlimport.exe │ ├¥data Data and log of the database engine │ ├¥cb_cbgrn │ ├¥mysql │ ├¥error.log │ ├¥slow.log │ ├¥ib_logfile0 │ ├¥ib_logfile1 │ ├¥ib_logfile2 │ ├¥ibdata1 │ └¥mysql.pid │ ├¥etc │├¥Samples

4 Uninstalling


│└¥my.ini │ ├¥files Attached files of Garoon 3 │└¥cbgrn │ ├¥share │├¥charsets │├¥lang │└¥mysql_fix_privilege_tables.sql │ ├¥tmp └¥cb_version

Image Files Image files are saved in the directory that takes the name of the installation identifier. Example of document root directory: C:¥inetpub¥wwwroot

Bold text indicates directory names. Normal text indicates file names. C:¥inetpub¥wwwroot Document root directory └¥cbgrn Installation identifier ├¥3rd_party_license Third party license information ├¥api Files that are used by related products ├¥fw Framework image files ├¥grn Garoon 3 image files │ ├¥flash │ ├¥html │ └¥image │ └¥cybozu │ └¥re Image files that relate to rich text format ├¥html └¥image

Appendix B.2 File Structure on Linux

CGI Application The CGI application of Garoon 3 is installed in the CGI directory that you set during the installation process. The CGI application files are saved in the directory that takes the name of the installation identifier, under the CGI directory. Example of CGI directory: /var/www/cgi-bin

Bold text indicates directory names. Normal text indicates file names. /var/www/cgi-bin CGI directory └/cbgrn Installation identifier ├/code Garoon 3 program │ ├/command │ ├/doc_root │ ├/include │ ├/pear



│ ├/plugin │ ├/sched │ └/smarty │ ├/extensions PHP extension files ├/grn Configuration files ├/help Help files │ ├/system │ └/user │ ├/locale Resource information ├/page Template files ├/sessiondata PHP session data ├/smarty │ ├/cached Cache data of the smarty library │ └/compiled Compiled templates of the smarty library │ ├/tmp Temporary files created by the PHP script ├/upload_tmp Temporary uploaded files ├/cacher.ini ├/cbsearch.ini ├/common.ini ├/common.lic ├/cyss_cbgrn.pid └/db_error.log ├/garoon.ini ├/garoon_lwc.ini ├/garoon_policy.ini ├/grn.cgi ├/grn.exe ├/LICENSE.txt ├/logger.ini ├/lwc.ini ├/php.ini ├/profile.ini ├/sched ├/sched.ini ├/sched.log ├/script.log ├/state.ini ├/system_admin.ini └/uninstall_cbgrn

Cybozu Database Engine Files Cybozu database engine files are saved in the installation directory that you set during the installation process. Example of installation directory: /usr/local/Cybozu

Bold text indicates directory names. Normal text indicates file names.

/usr/local/cybozu Cybozu database engine files ├/mysql-5.0

4 Uninstalling


│ ├/bin │ │ ├/my_print_defaults │ │ ├/mysql │ │ ├/mysql_upgrade │ │ ├/mysqladmin │ │ ├/mysqlbinlog │ │ ├/mysqlcheck │ │ ├/mysqld │ │ ├/mysqld_safe │ │ ├/mysqldump │ │ └/mysqlimport │ │ │ ├/data │ │ ├/cb_cbgrn │ │ ├/mysql-5.0 │ │ ├/error.log │ │ ├/ib_logfile0 │ │ ├/ib_logfile1 │ │ ├/ib_logfile2 │ │ ├/ibdata1 │ │ └/mysql.sock │ │ │ ├/etc │ │ ├/Samples │ │ └/my.ini │ │ │ ├/files │ │ └/cbgrn │ │ │ ├/share │ │ ├/charsets │ │ ├/lang │ │ └/mysql_fix_privilege_tables.sql │ │ │ ├/tmp │ ├/cb_version │ └/uninstall_cyde_5_0 │ ├/openssl │ └/lib └/openldap ├/etc └/lib

Image Files Image files are saved in the directory that takes the name of the installation identifier. Example of document root directory: /var/www/html

Bold text indicates directory names. Normal text indicates file names. /var/www/html Document root directory └/cbgrn Installation identifier ├3rd_party_license Third party license information



├/api ├/fw Framework image files ├/grn Garoon 3 image files │ ├/flash │ ├/html │ └/image │ └/cybozu │ └/re Image files that relate to rich text format ├/html └/image

Start Up Scripts The start-up scripts are saved in the start-up script directory. Example of start-up script directory: /etc/rc.d/init.d

Cybozu database engine start-up script: /etc/rc.d/init.d/cyde_5_0 Scheduling service start-up script: /etc/rc.d/init.d/cyss_cbgrn

4 Uninstalling


Index

A Abbreviations ............................................................... 2

Administrator ........................................................ 13, 32

Administrator role ....................................................... 26

C Copyrights and Trademarks ......................................... 2

D Directory

CGI directory..................................... 16, 23, 44, 46

Document root directory.................... 16, 23, 46, 48

Installation directory .......................... 15, 22, 45, 47

Start-up script directory ....................................... 49

E Entry fields for user information.................................. 27

Executable ...........................................................11, 31

I Installation identifier ......................................... 9, 15, 22

L Log

Initialization log ................................................... 32

Installation log ......................................... 18, 24, 32

Upgrade log ........................................................ 32

Version up log of MySQL .................................... 32

M Mail server

Authentication Method .......................................... 7

Protocol................................................................. 7

Mail Server ................................................................... 7

my.ini file .......................................................... 8, 28, 35

P Password

Administrator password................................. 19, 24

Database administrator password ........... 10, 19, 25

Port number................................................................ 23

Port Number Setting..................................................... 8

Preface ......................................................................... 2

R Root user.................................................................... 21

S SELinux...................................................................... 21

Service

Cybozu database engine..................................... 42

Scheduling service .............................................. 42

Software License Agreement.................... 14, 22, 34, 41

System requirements

Server OS ............................................................. 6

Web Browser......................................................... 7

Web Server ........................................................... 7

T Time zone....................................................... 10, 20, 25

Typographic Conventions ............................................. 2

V Virtual directory............................................... 12, 18, 24

Virtual environments..................................................... 7

W Web server

Apache .......................................................... 21, 33

IIS.................................................................. 11, 30

Web server user name ............................................... 23

Who Should Use This Guide ........................................ 2

Documents

Cybozu Garoon 3 Installation Guide - サイボウズ ... · 2 Cybozu Garoon 3 Installation Guide ... 4 1 Before Setting Up ... - a through z (lower case alphabet) - A through Z