aboutsummaryrefslogtreecommitdiffstats
path: root/misc/linux-opengroupware/files/INSTALL.fbsd
blob: f7a3a467e6f1bf5901dacdc6806679a4da8621be (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
#$Id: INSTALL.fbsd,v 1.2 2003/09/13 14:59:49 frank Exp $
GENERAL NOTE:

    You're welcome to ask questions about OpenGroupware
    at

        http://www.opengroupware.org

    too. :p Don't hesitate.


1)  First of all - you must have linux compat mode
    activated.

    Refer to:

    http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/linuxemu.html

    on how to do this.

    In short.... my rc.conf contains:
    
        linux_enable="YES"

    and I recompiled my kernel with the following options:

        # Enable Linux ABI emulation
        options         COMPAT_LINUX

        # Enable the linux-like proc filesystem support (requires COMPAT_LINUX
        # and PSEUDOFS)
        options         LINPROCFS

    (kernel compilation is further described in:
    http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/kernelconfig-building.html)

    You also want to add the following line into your /etc/fstab:

        linproc                 /compat/linux/proc      linprocfs rw 0 0

    (If you don't have linproc mounted - OGo will coredump :P - so check twice)


2)  Make sure, that your PostgreSQL Installation
    listens on TCP Port 5432!

    Typing (as root)

        `netstat -an -p tcp|grep -i 5432`

    should show you if it is.
    The output might look like:

        [root@minax]/usr/local/pgsql/data: netstat -an -p tcp|grep -i 5432
        tcp4       0      0  *.5432                 *.*                    LISTEN

    (Hoping that it is really PostgreSQL showing up there :))

        `lsof -Pni|grep -i 5432`

    should give you better results since it gives an output like this:

        [root@minax]/usr/local/pgsql/data: lsof -Pni|grep -i 5432
        postgres  411 pgsql    3u  IPv4 0xc428cca8      0t0  TCP *:5432 (LISTEN)

    If there's no output at all (ie. nothing similiar to what you've just seen)
    then you must reconfigure PostgreSQL.
    To do so edit:

        '/usr/local/pgsql/data/postgresql.conf'

    and make sure that there's the following line active:

        tcpip_socket = true

    After applying this modification save and exit 'postgresql.conf'.
    Now restart PostgreSQL (there should be a start/stop script in your
    local_startup dir:

        `/usr/local/etc/rc.d/010.pgsql.sh stop`
        `/usr/local/etc/rc.d/010.pgsql.sh start`

    Voila!

3)  Add an include statement into your current apache configuration,
    typically located in:

        '/usr/local/etc/apache/httpd.conf'

    Edit this file and add the following line:

        'include /compat/linux/opt/opengroupware.org/OpenGroupware.org.apacheinclude'

    (best place to add this might depend on your individual configuration, in my
    configuration I simply added this line at the very end of my httpd.conf)

    Restart apache to activate the changes just made.

        `/usr/local/etc/rc.d/apache.sh stop`
        `/usr/local/etc/rc.d/apache.sh start`

4)  Add a postgresql User/Database for OpenGroupware:

        `su - pgsql`
        `createdb ogo`
        `createuser -A -D ogo`

    Install the database scheme:

        `psql ogo ogo`
        
        a shell like environment appears know.... type there:

        \i /compat/linux/opt/opengroupware.org/Database/PostgreSQL/pg-build-schema.psql

        ...and the database scheme gets installed.

        Leave this shell with

        \q

        and CTRL-D back to your `root` account.

5)  Restart PostgreSQL again.

6)  Start OpenGroupware:


        `/usr/local/etc/rc.d/ogo.sh.sample start`


NOW POINT YOUR BROWSER TO:

    http://<host.where.you.installed.tld>/OpenGroupware/

and enjoy! :)


-- 

    Frank Reppin