update
[mir.git] / doc / INSTALL.mir
index e2174ca..06f1a0b 100755 (executable)
@@ -37,7 +37,9 @@ now customize config.properties for your needs.
 4. copy the mir/templates-dist-directory to mir/templates
 
 
-5. compile
+5. compile (do this as root so the permissions script is able to set
+the permissions and owners correctly).
+
        sh build.sh 
 
 
@@ -70,13 +72,14 @@ as user postgres:
        cat dbscripts/help*.sql | psql -Upostgres dbname
        cat dbscripts/populate*.sql | psql -Upostgres dbname
 
+
 10. Add the dupe prevention trigger to the database:
        cd dbscripts/dupetrigger
        
        There, read INSTALL and follow the instructions.
        
 
-11. Set permissions
+11. Set permissions -- IMPORTANT! READ THIS!
        We provide a script that sets all files' and direcories' permissions to
        a quite reasonable state. The most important thing you have to do after
     the invokation of this script is to ensure that the log files --
@@ -135,8 +138,8 @@ You should make sure that no copy of config.properties (neither in mir nor
 in Mir/src nor in Mir/WEB-INF/classes) is world-readable. Else you wouldn't
 have to install a password, anyway.
 
-If you can't access PostgreSQL after this for any reason, try to change
-"password" in /etc/postgresql/pg_hba.conf into "trust". This should disable
+If you can't access PostgreSQL after this for any reason, try and change
+"password" in /etc/postgresql/pg_hba.conf to "trust". This should disable
 any authentication method and make the database accessible again.
 
 that's it :)
@@ -150,3 +153,14 @@ and the openposting-servlet via
        http://host/OpenMir
 
 standard login is redaktion/indymedia
+
+
+
+TROUBLESHOOTING
+
+You can give these a try if anything goes wrong:
+
++ Restart Tomcat. Especially after compiling the sources Tomcat has to be
+  restarted.
+
++ Check file permissions and ownership. Try and run perms.sh.
\ No newline at end of file