forget to add the config file itself...
[mir.git] / doc / INSTALL.mir
index 4f77dd9..4e255ad 100755 (executable)
@@ -7,7 +7,7 @@ prerequisites:
 - apache with mod_jk.so 
 - postgres 7.1.x
 - ant (a java-based make) 
-
+- jaxp-1.1 (a SAX 2.0 compliant XML parser, comes with ant >= 1.4)
 
 1. checkout the cvs
 
@@ -28,6 +28,10 @@ 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 
@@ -78,7 +82,11 @@ as user postgres:
 
 11. Set permissions
        We provide a script that sets all files' and direcories' permissions to
-       a quite reasonable state.
+       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 --
+    especially dbentity.log -- are not readable by users that could
+    compromise system security, because all passwords and the like will
+    be logged here.
        
        cp perms.sh-dist perms.sh
        # Now, change the install directory and group in perms.sh
@@ -86,6 +94,8 @@ as user postgres:
        ./perms.sh
 
 
+
+
 12. restart tomcat 
 
 13. configure mod_jk 
@@ -133,6 +143,21 @@ 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
 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: