Chapter 2. Setting up more.groupware

Table of Contents

Requirements
Upgrade
Getting more.groupware
Downloading more.groupware releases
Downloading more.groupware snapshots
Downloading more.groupware from CVS
Preparing the more.groupware setup
Troubleshooting
Known bugs
Webmail 2
General strange behavior of more.groupware

Setting up more.groupware is described in this and the following chapters. Generally you should read this chapter, as it tells you about some basic requirements and skills you should have available and ready. Then you only need to read one of the following chapters, depending on the operating system you want to install more.groupware on.

Requirements

To successfully install more.groupware you need at least the following software packages on your machine, regardless of the operating system in use.

  • A webserver (Apache is recommended)

  • PHP 4.1 or later with XML support

  • Adatabase server (MySQL 3.23.x/4.x or PostgreSQL 7.x)

  • PHP session auto start must be disabled!

It is necessary to have a . (dot) in your PHP include_path. Look at php.ini to check this.

If want to create GANTT charts in the projects module, you will need support for the GD library in your PHP installation. On windows this should only be a matter of uncommenting extension=php_gd.dll in your php.ini, on most Linux distributions it similar.

You do not need PDF or IMAP support compiled into PHP for the current releases, nor do you need XML DOM. We handle those needs with PHP-only libraries. It does not harm to have those things compiled into PHP, though.

We intend to support more databases in the future. Right now MySQL works best, and PostgreSQL support is getting better (the core modules should work). Other databases will follow later.

When you want to run more.groupware on MySQL 4.1.x, watch out when reating the database. Do not set the default charset/collation to utf8, as then varchar fields default to utf8. And the max length of a primary key is 500 bytes, not characters. This will cause problems with admin2, as some fields are longer and used as primary key.

You should try to run more.groupware with register_globals disabled, if it doesn't work, it's a bug. The same is true for magic_quotes_gpc and magic_quotes_runtime, both should be off. Those are not strict requirements, though.

[Note]Note

The setup will check all those (and some more) things, and tell you when something is wrong or missing.