README

   1 GOsa2.1 README
   2 ==============
   3
   4 * Information
   5
   6 GOsa is a LDAP administration frontend for user administration. It
   7 is NO GENERIC frontend to dictionary servers. Informations are stored
   8 in the way the underlying conecpts suppose them to be stored (i.e.
   9 people accounts are stored in "ou=people" subtrees, etc.) This can
  10 be configured marginally.
  11
  12 Additionally, eGOsa is a java-applet based extension to GOsa made by
  13 Alejandro Escanero Blanco <alex@ofmin.com>.
  14
  15 Complete setups applying Kerberos, AFS, LDAP, Mail, Proxy and Fax setups
  16 are not trivial at all. You should be familiar with these components and
  17 with your UNIX installation, of cause. This file is (and will not be)
  18 an introduction to any of these components. See INSTALL for a quick
  19 overview about what to do, to get the things up and running. A complete
  20 GOsa infrastructure howto is work in progress and not released yet.
  21
  22
  23 * Translations
  24
  25 GOsa is not available in your native language? Just take the message.po
  26 file out of the locales directory and put your translations into the
  27 msgstr fields. You may look at the de/LC_MESSAGES for the way how it
  28 works.
  29
  30 If you're ready with that, create a directory for your language using
  31 the ISO shortcuts (i.e. es for spain) with a subdirectory LC_MESSAGES.
  32 Put your messages.po in there and run "msgfmt messages.po" from that
  33 directory. Make sure your apache has locale support or, in case of debian,
  34 that the specific locale will be generated (via dpkg-reconfigure locales).
  35
  36 You may want your translations to be included in the main GOsa repository,
  37 then just send the .po file to me.
  38
  39
  40 * NOTES
  41
  42 You'll need php-cups (http://www.cups.org) and php-krb5 (pear) in order
  43 to get full functionality. To make shared folders work in a proper way,
  44 you either need a recent PHP or a patched one for the get_acl functions
  45 (see contrib/patches). Basically GOsa will run without these.
  46
  47 Be sure that 'gosaUserTemplates' are not able to log into your server,
  48 since they may have no password set. Example configs can be found in
  49 the contrib directory.
  50
  51 Have fun!
  52
  53 ---
  54 Cajus Pollmeier <pollmeier@gonicus.de>
  55