<?xml version="1.0" encoding="iso-8859-1"?>
<appendix id="appendix_faq">
  <title>The moregroupware FAQ</title>
  
  <section id='appendix_faq_general'> 
    <title>General</title> 
    <qandaset>
      <qandaentry> 
        <question>
          <para>What is moregroupware?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Why the name "moregroupware" ?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Why did you start another groupware project?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>This project looks cool, can I contribute?</para>
        </question>
        <answer>
          <para>Yes of course, each developer / docwriter / tester is
            invited to join the project. You can subscribe the moregroupware
            developer maillist and introduce yourself.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>This FAQ looks nice, how do you made it?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Is there a user documentation for moregroupware?</para>
        </question>
        <answer>
          <para>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!
          </para>
        </answer>
      </qandaentry>
    </qandaset>
  </section>
  <section id='appendix_faq_installation'> 
    <title>Installation</title> 
    <qandaset>
      <qandaentry> 
        <question>
          <para>On what platforms runs moregroupware?</para>
        </question>
        <answer>
          <para>Basically it should run on any platform PHP runs on. Right now
            these are at least:
            <itemizedlist>
              <listitem>
                <para>Linux</para>
              </listitem>
              <listitem>
                <para>HP-UX</para>
              </listitem>
              <listitem>
                <para>Solaris</para>
              </listitem>
              <listitem>
                <para>OpenBSD</para>
              </listitem>
              <listitem>
                <para>MacOS X</para>
              </listitem>
              <listitem>
                <para>Windows 98/ME/2000/XP</para>
              </listitem>
            </itemizedlist>
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Which webserver should/can I use?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>What PHP version should I have?</para>
        </question>
        <answer>
          <para>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...
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>What database should I use?</para>
        </question>
        <answer>
          <para>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!
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Where can i find the exact installation instructions?</para>
        </question>
        <answer>
          <para>This manual contains all needed information.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Is there a graphical installation procedure?</para>
        </question>
        <answer>
          <para>Yes.</para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Is there an update path / update procedure?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
    </qandaset>
  </section>
  
  <section id='appendix_faq_administration'> 
    <title>Administration</title> 
    <qandaset>
      <qandaentry> 
        <question>
          <para>Is a rights management system included in the groupware?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>Can I define several administrators?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>I created a user but this user can't see any modules, why?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>What do 'Display Level' and 'Module Level' mean?</para>
        </question>
        <answer>
          <para>'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.
          </para>
        </answer>
      </qandaentry>
    </qandaset>
  </section>
  
  <section id='appendix_faq_errors'> 
    <title>Common errors and problems</title> 
    <qandaset>
      <qandaentry> 
        <question>
          <para>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?</para>
        </question>
        <answer>
          <para>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 <filename>modules/general/setup/install.sql</filename>, and run setup again. Then it will speed up things if you create the indexes manually (either though phpMyAdmin or directly with "ALTER TABLE &lt;tablename&gt; ADD INDEX ( &lt;fieldname&gt; )").
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>I get something like "The script tried to execute a method or access a property of an incomplete object". What should i do?</para>
        </question>
        <answer>
          <para>Make sure that session_auto_start is disabled in php.ini!</para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>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?</para>
        </question>
        <answer>
          <para>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.
          </para>
        </answer>
      </qandaentry>
    </qandaset>
  </section>
  <section id='appendix_faq_misc'> 
    <title>Miscellaneous</title> 
    <qandaset>
      <qandaentry> 
        <question>
          <para>I found a bug, how can I report it?</para>
        </question>
        <answer>
          <para>There are several ways to report a bug. You can go to <ulink url="http://sourceforge.net/projects/moregroupware">http://sourceforge.net/projects/moregroupware</ulink> 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!
          </para>
        </answer>
      </qandaentry>
      <qandaentry> 
        <question>
          <para>What about your license?</para>
        </question>
        <answer>
          <para>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 <ulink url='http://www.fsf.org/licenses/license-list.html#GPLCompatibleLicenses'>this FSF
            document
          </ulink>
          to learn more about the X11 license. Its fully GPL compatible by the way.
        </para>
      </answer>
    </qandaentry>
  </qandaset>
</section>
</appendix>
