# The moregroupware FAQ

## General

What is moregroupware?

moregroupware is another web based groupware. It contains modules like contact management, webmail, calendar and some more and it will be extended day by day.

Why the name "moregroupware" ?

We chose this name for two reasons. First, as a lot of people know, there are already some webgroupwares out there and we just want to point out that we know this fact and are prepared for this :) Second: one company which supports this project with manpower is called "Morelogs", so the "more" is some kind of reminissence to this company.

Why did you start another groupware project?

For the same reason many other people start writing software, the existant choices were not really the way we wanted to have it. We have a different focus than many other "competitors". We really wanted to have a good usability and moregroupware is on a good way to reach this goal.

This project looks cool, can I contribute?

Yes of course, each developer / docwriter / tester is invited to join the project. You can subscribe the moregroupware developer maillist and introduce yourself.

This FAQ looks nice, how do you made it?

For this FAQ, as for the rest of our documentation efforts, we use a quite new XML format called "DITA". It was invented by IBM and is in some ways a competitor to DocBook (very generally described). At some point we render these XML files via XSL to target documents like HTML or PDF.

Is there a user documentation for moregroupware?

It is being developed. We are happy to have this FAQ at the moment and we are working hard for various other documents, including a user documentation. Feel free to help!

## Installation

On what platforms runs moregroupware?

Basically it should run on any platform PHP runs on. Right now these are at least:

- Linux

- HP-UX

- Solaris

- OpenBSD

- MacOS X

- Windows 98/ME/2000/XP

Which webserver should/can I use?

We prefer using Apache because of it's stable nature, but you can use of course other webservers like IIS if you use windows. We suggest to use a webserver which can be accessed by PHP via its API, for example Apache, IIS or Netscape/IPlanet. If you must use a different webserver, you can always use the CGI interface of PHP, but this is not the most performant way. So basically you can use each webserver on the market.

What PHP version should I have?

You should have at least version 4.2.x This is partly due to the usage of the Smarty template engine, partly caused by other things. Older PHP versions are somewhat outdated anyway...

What database should I use?

We suggest to use MySQL because most of the developers use MySQL for developing and testing. But because of our database abstraction which is fully implemented in moregroupware, you should be able to use different databases like PostgreSQL or Oracle in the future. Before version 1.0 of moregroupware is released, we strongly suggest to use MySQL and make no promises that it works on other databases!

Where can i find the exact installation instructions?

This manual contains all needed information.

Is there a graphical installation procedure?

Yes.

Is there an update path / update procedure?

No, not right now. Its very tricky to implement a clever update mechanism, so for now, if you install a new version, you are mostly on your own to create the (perhaps) new/modified database structure and to get your existent data into the new database / structure. You will find help, though, in the moregroupware-all mailing list. We will post instructions for manual upgrades there.

## Administration

Is a rights management system included in the groupware?

Yes, you can create rights which are based on users or on usergroups. The rights will be on a per module basis, this means you can manage rights for each module differently. Not all modules support this yet, though.

Can I define several administrators?

Yes, thats easy. An administrator is by definition nothing more than a user which can access the administration module with its programs like groupmanagement or rightsmanagement. So each user can be an admin if he has the specific rights.

I created a user but this user can't see any modules, why?

Keep in mind that you must give the user the rights to see the modules. You can do this in two ways. You can give the user the rights for each module, or you can just put the user into a group which allready has the propriate rights. There is a standard group called "default" which should have basic rights for each module.

What do 'Display Level' and 'Module Level' mean?

'Display Level' determines the order of the modules in the main navigation menu. 'Module Level' is a bit harder to explain: it determines how strong a right is on a module. Anyway, since it is only used in one module (forum) to check if you are an admin... you may as well ignore this setting for the time being.

## Common errors and problems

I get errors during setup that tell me index creation failed on some database tables: "CREATE INDEX mimrecidx ON mgw_instmsg (recipient) Access denied for user: 'myusername@localhost' to database 'mydatabase'". Setup fails due to this. What can I do?

The best way would be to ask your system administrator why you dont have CREATE INDEX rights on your database. Alternatively you can delete the CREATE INDEX lines from the end of `modules/general/setup/install.sql`, and run setup again. Then it will speed up things if you create the indexes manually (either though phpMyAdmin or directly with "ALTER TABLE <tablename> ADD INDEX ( <fieldname> )").

I get something like "The script tried to execute a method or access a property of an incomplete object". What should i do?

Make sure that session_auto_start is disabled in php.ini!

I get something like "Warning: Smarty error: problem writing '/home/mlogemann/public_html/moregroupware/templates_c/contact_list.tpl.php.' in /usr/local/lib/php/Smarty.class.php on line 1081". What should i do?

You have a problem with the rights on the folder "templates_c" or "templates_wml_c". Just give the right "write others" to this folder (on file system level) and the problem should be solved. You should of course check your security rules whether this is the best way to do it.

## Miscellaneous

I found a bug, how can I report it?

There are several ways to report a bug. You can go to http://sourceforge.net/projects/moregroupware and submit an item to the bug tracker (the preferred way!). You can as well post to our moregroupware user mailing list. Whatever you do, include as much useful information as possible, especially the error message shown!

What about your license?

moregroupware is (mostly) licensed under the X11 license, some parts are GPL. Until release 0.5.3 the code was completely released under GPL. Read this FSF document to learn more about the X11 license. Its fully GPL compatible by the way.