Inserted some lines about the Apache config and how to setup the symlink
[mir.git] / doc / INSTALL.mir
1 Here is a short installation-howto of Mir.
2
3
4 prerequisites: 
5
6 - tomcat 
7 - apache with mod_jk.so 
8 - postgres 7.1.x
9 - ant (a java-based make) 
10
11
12 1. checkout the cvs
13
14 CVS LOGIN:
15
16         cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs login 
17         password: cvs 
18
19 CVS CHECKOUT:
20
21         cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs co mir 
22
23
24 2. customize the config: 
25
26         cd mir/source 
27         cp config.properties-dist config.properties 
28
29 now customize config.properties for your needs.
30
31
32 3. configure the build.sh file with java_home
33         cp build.sh-dist build.sh 
34         chmod 755 build.sh
35
36
37 4. copy the mir/template-dist-directory to mir/template 
38
39
40 5. compile
41         sh build.sh 
42
43
44 6. Link in the webapps directory of tomcat to the install directory (the 
45 directory is called "Mir" and is located in the same directory in which 
46 you installed the "mir" directory). 
47         cd /usr/share/tomcat/webapps
48         ln -s Mir-install-dir Mir
49
50
51 7. create a new database 
52 the database name should be the same as in config.properties
53 as user postgres: 
54         createdb dbname 
55
56
57 8. create base table
58         psql -Upostgres dbname < dbscripts/create_pg.sql
59         cat dbscript/help*.sql | psql -Upostgres dbname
60
61 9. chmod 777 Mir/log 
62
63 10. restart tomcat 
64
65 11. configure mod_jk 
66
67 insert the following patch into /etc/apache/httpd.conf. Edit the directories
68 to suit your needs.
69
70 <IfModule mod_jk.c>
71 JkWorkersFile /usr/share/tomcat/conf/workers.properties
72 Include /usr/share/tomcat/conf/mod_jk.conf-auto
73 </IfModule>
74
75 Do not put any JkMount lines into your httpd.conf!
76
77 If mod_jk.conf-auto doesn't get written or is 0 bytes in size, check your
78 system for file ownership/permissions problems.
79
80 that's it :)
81
82 now the admin-application is accesable via:  
83
84         http://host/Mir 
85
86 and the openposting-servlet via  
87         
88         http://host/OpenMir
89
90 standard login is redaktion/indymedia