← Back to branch summary

~ubuntu-branches/ubuntu/vivid/gosa/vivid

« back to all changes in this revision

Viewing changes to gosa-core/INSTALL

Tags: 2.7.1-1
http://bugs.debian.org/620489
http://bugs.debian.org/620486
* New upstream release
* Updated packaging to not include smarty (Closes: #620489)
* Fixed case of POSIX (Closes: #620486)

Show diffs side-by-side

added added

removed removed

Lines of Context:
gosa-core/INSTALL
 
1
GOsa 2.6 QUICK INSTALL
 
2
======================
 
3
 
 
4
Prequisite:
 
5
 
 
6
You have a system up and running. It has apache and PHP installed
 
7
and there is a blank (or prefilled) but working LDAP available.
 
8
 
 
9
---
 
10
 
 
11
Installing GOsa from source:
 
12
 
 
13
Unpack the GOsa tarball and move the main gosa directory to
 
14
a place your webserver is configured to find it. The default
 
15
location will be /usr/share/gosa. For later reference, I assume
 
16
that you've choosen this path, too.
 
17
 
 
18
Create the directory /var/spool/gosa for the smarty compile directory.
 
19
Make it read/write for the webserver (additional chmod 770). You may
 
20
want to move it elsewhere, configure it in gosa.conf.
 
21
 
 
22
Create the configuration directory /etc/gosa and make sure
 
23
that your webserver can read it.
 
24
 
 
25
As a summmary, you now have these directories for GOsa:
 
26
 
 
27
/etc/gosa
 
28
/var/spool/gosa
 
29
/usr/share/gosa
 
30
 
 
31
Update the class cache:
 
32
 
 
33
Run "update-gosa" from the GOsa main directory.
 
34
 
 
35
After this has been done, include settings for GOsa in your apache
 
36
config:
 
37
 
 
38
# Set alias to gosa
 
39
Alias /gosa /usr/share/gosa/html
 
40
 
 
41
Assumed you've installed PHP >= 5.2.0, reload your apache webserver
 
42
and do your first GOsa dry run without configuration:
 
43
 
 
44
http[s]://your-server/gosa
 
45
 
 
46
GOsa setup will perform some basic system checks about general
 
47
prerequisites. The setup asks some questions and provides a
 
48
basic gosa.conf to save in /etc/gosa. Follow the instructions
 
49
until you're able to log in.
 
50
 
 
51
You're done. Lets play with the GUI.
 
52
 
 
53
---
 
54
 
 
55
* Installing from Packages
 
56
 
 
57
If you install GOsa from packages, all the steps from above will
 
58
be done automatically. Go to the setup:
 
59
 
 
60
http[s]://your-server/gosa
 
61
 
 
62
GOsa setup will perform some basic system checks about general
 
63
prerequisites. The setup asks some questions and provides a
 
64
basic gosa.conf to save in /etc/gosa. Follow the instructions
 
65
until you're able to log in.
 
66
 
 
67
You're done. Lets play with the GUI.
 
68
 
 
69
---
 
70
 
 
71
* Migrating an existing tree
 
72
 
 
73
To migrate an existing LDAP tree, you've to do all steps from above,
 
74
plus some modifications:
 
75
 
 
76
- GOsa only shows users that have the objectClass gosaAccount
 
77
  This one has been introduced for several reasons. First, there are
 
78
  cases you want to hide special accounts from regular admins (i.e.
 
79
  a samba admin account which is used to log windows machines into
 
80
  their domain, where chaning a password by accident has bad consequences).
 
81
  Secondly the gosaAccount keeps the lm/nt password hashes and the
 
82
  attributes for the last password change - with the consequence that
 
83
  adding a samba account "later" will not require the user to reset
 
84
  the password.
 
85
 
 
86
- GOsa only recognizes subtrees (or departments in GOsa's view of things)
 
87
  that have the objectClass gosaDepartment. You can hide subtrees from GOsa
 
88
  by not putting this objectClass inside.
 
89
 
 
90
The GOsa setup may be used to do these migrations, but it is not meant
 
91
to work in every possible circumstance. For the first time:
 
92
 
 
93
DO NOT WORK ON PRODUCTIVE DATA IF YOU DON'T KNOW WHAT YOU'RE DOING!
 
94
 
 
95
That should be all. Entries should be visible in GOsa now. Be aware that if
 
96
your naming policy of user cn's differs from the way GOsa handles it, the
 
97
entries get rewritten to a GOsa style dn.
 
98
 
 
99
---
 
100
 
 
101
* Further information
 
102
 
 
103
To improve this piece of software, please report all kind of errors, either
 
104
using the bug tracker on www.gosa-project.org or the button on the upper
 
105
right.
 
106
 
 
107
Documentation: https://www.gosa-project.org
 
108
Mailinglist:   https://oss.gonicus.de/mailman/listinfo/gosa/
 
109
Upgrade hints: https://oss.gonicus.de/labs/gosa/wiki/DocumentationInstallingUpdatingGOsa
 
110
 
 
111
Have fun!
 
112
 
 
113
---
 
114
Cajus Pollmeier <pollmeier@gonicus.de>