first cut of merge of STABLE-pre1_0 into HEAD. I won't even guarantee that it

[mir.git] / doc / INSTALL.mir

diff --git a/doc/INSTALL.mir b/doc/INSTALL.mir
index 4e255ad..06f1a0b 100755 (executable)
--- a/doc/INSTALL.mir
+++ b/doc/INSTALL.mir
@@ -28,10 +28,6 @@ CVS CHECKOUT:
 
 now customize config.properties for your needs.
 
-    modify etc/web.xml to change the xml-config
-    parameter to point to where your server.xml file is
-    (in ../Mir i.e /path/to/Mir/server.xml)
-
 
 3. configure the build.sh file with java_home
         cp build.sh-dist build.sh 
@@ -41,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 
 
 
@@ -74,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 --
@@ -139,25 +138,10 @@ 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.
 
-15. configure apache's mod_mime to recognize .m3u and .pls files:
-
-The web server (of the media host) must recognize the .m3u and .pls file
-extensions and send the proper "audio/x-mpegurl" and "audio/x-scpls" mime-types
-respectively.  If the web server is apache, it's easy, just add:
-           *
-audio/x-mpegurl                 m3u
-audio/x-scpl                    pls
-              *
-to the file pointed to by the "TypesConfig" command in your apache config file.
-Or add and equivalent AddType command to your httpd.conf.  Of course this
-assumes that the mod_mime is loaded.
-                   *
-If the web server is not apache, then your on your own.
-
 that's it :)
 
 now the admin-application is accesable via:  
@@ -169,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