Howto install OGo 1.0beta2 on Debian Sarge Linux
================================================

Copyright (C) 2005 SKYRIX Software AG. All rights reserved.

THIS FILE IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS
OR IMPLIED, INCLUDING WITHOUT LIMITATION, ANY WARRANTY FOR INFORMATION, DATA,
SERVICES, OR UNINTERRUPTED ACCESS.

Please send us your questions and comments to support@skyrix.com so we can
make this file better and more useful for new OpenGroupware.org users.


1)
  Become root.
  $ su -

2)

  We're going to use 'apt' in order to install the required packages.
  You may need to reconfigure apt to use a proxy if you're behind one.
  The current apt configuration can be examined with:

    $ apt-config dump
    [more or less long list showing the current configuration]

  In order to use a proxy you have to edit the file '/etc/apt/apt.conf
  and add the lines:

    Acquire::http::Proxy "http://[[user][:pass]@]host[:port]";
    Acquire::ftp::Proxy "ftp://[[user][:pass]@]host[:port]";

  or by setting the following environment variables:

    $ export http_proxy="http://[[user][:pass]@]host[:port]"
    $ export ftp_proxy="ftp://[[user][:pass]@]host[:port]"

  (Please note that those environment variables have precedence over
   the proxy settings made in apt.conf)

  After all - run:

    $ apt-get update

  and check it's output - it will complain if any of the changes
  we've just made was erroneous.
   

3)
  The OpenGroupware.org installation requires apache and postgresql
  as well.

  If not already present, install them:

  $ apt-get update # (if not already done in the previous step)
  $ apt-get install postgresql apache

  HINT: you might consider replacing 'apache' with 'apache2-mpm-prefork'
        in the aforementioned command line if you prefer apache2 over apache(13).

4)
  Add the OpenGroupware.org package repositories to your '/etc/apt/sources.list':

  deb http://download.opengroupware.org/releases/unstable opengroupware-1.0beta.2-rock sarge
  deb http://download.opengroupware.org/releases/stable sope-4.4.0-cell sarge
  deb http://download.opengroupware.org/releases/unstable ThirdParty sarge

  and rerun:

    $ apt-get update

  once again in order to update your package cache.

5)
  You'r now ready to install:

  $ apt-get install opengroupware.org libapache-mod-ngobjweb opengroupware.org-environment

  HINTS: * you might consider replacing 'libapache-mod-ngobjweb' with 'libapache2-mod-ngobjweb'
           if you've chosen to favour apache2 over apache(13)

         * the 'opengroupware.org-environment' packages will ask you some questions
           during the preconfiugration stage - simply hit <OK> if this is your first install
           (it will then create an new OpenGroupware.org instance for you)

6)
  We need to reconfigure PostgreSQL in order to make the already created database
  visible to OpenGroupware.org (the database was created during the post installation
  stage of 'opengroupware.org-environment).
  To do so - please edit the following files:

  a) '/var/lib/postgres/data/postgresql.conf'

    * look for the line:

        #tcpip_socket = false

      and change it to:

        tcpip_socket = true

  b) '/var/lib/postgres/data/pg_hba.conf'

    * add the line:

        host  ogo  ogo  127.0.0.1  255.255.255.255 password

      into the proper context within the file, that is - it should
      be before any line reading like:

        host  all  all  127.0.0.1  255.255.255.255  ident sameuser

      or similar (which would override what we're trying to achieve).

      HINT: * This step might be not required if your server runs identd,
              because the default postgres pg_hba.conf would allow access
              then.
            * check '/var/log/postgresql/postgres.log' for messages like:

                LOG:  could not connect to Ident server at address "127.0.0.1",
                      port 113: Connection refused
                FATAL:  IDENT authentication failed for user "ogo"

  c) RESTART POSTGRESQL IN ORDER TO ACTIVATE ANY CHANGES YOU'VE MADE!

    /etc/init.d/postgresql restart

7)  restart apache, depending on the apache version you're prefering
    it's either:

    $ /etc/init.d/apache restart
    $ /etc/init.d/apache2 restart

8)  restart OpenGroupware.org:

    $ /etc/init.d/opengroupware.org restart

    HINT: * Run the command 'update-rc.d opengroupware.org defaults'
            if you intend to autostart OpenGroupware.org upon reboot.
            


  FINISHED! You're now ready to point your browser to:

    http://<the_host_you_install_opengroupware_upon>/OpenGroupware



ADDITIONAL SETUP REMARKS:
=========================

  I) There's no default root password set - if this is your very
     first OpenGroupware.org install (with a vanilla ogo database).
     Pointing your browser to the URL:

       http://<the_host_you_install_opengroupware_upon>/OpenGroupware

     will therefor log you straight into the root account.

     It's *strongly recommended* that you setup a proper password right now!
     To do so, click on 'Preferences' (bottom left corner) and then
     'edit password' (upper right corner).

 II) OpenGroupware.org can email you reminders on upcoming appointments.
     This functionality requires that you set the root password in
     the configuration file:

       /var/lib/opengroupware.org/.libFoundation/Defaults/skyaptnotify.plist

     The best way to do this (beeing already root on your servers console):

       $ su - ogo
       $ Defaults write skyaptnotify AptNotifySkyrixUser root
       $ Defaults write skyaptnotify AptNotifySkyrixPassword "THE_ROOT_PASSWORD"