update TODO and explain mime-types in web.xml

[mir.git] / doc / INSTALL.mir

diff --git a/doc/INSTALL.mir b/doc/INSTALL.mir
index 00c1341..25b6545 100755 (executable)
--- a/doc/INSTALL.mir
+++ b/doc/INSTALL.mir
@@ -8,6 +8,8 @@ prerequisites:
 - postgres 7.1.x
 - ant (a java-based make) 
 - jaxp-1.1 (a SAX 2.0 compliant XML parser, comes with ant >= 1.4)
+- the JAI image framework (Java Advanced Imaging) versin 1.1.1 . get it from 
+  java.sun.com. ** NOTE: it must be placed in tomcat's common/lib directory **
 
 1. checkout the cvs
 
@@ -98,7 +100,7 @@ application call that you want to connect as a specific user. If you access
 the database from any other user's account, use the -U flag to connect to
 PostgreSQL as the database superuser ("postgres"):
 
-       createdb -U postgres Mir 
+       createdb -U postgres --encoding=unicode Mir 
 
 Please note that if you create the database from inside the psql application,
 the database name will likely be converted to lowercase letters.
@@ -139,8 +141,18 @@ in Mir/src nor in Mir/WEB-INF/classes nor in the directory tree you compiled
 Mir from) is world-readable. Else you wouldn't have to install a password,
 anyway.
 
+9e. Tweak mime-type extensions mappings in etc/web.xml file.
 
-9e. Setup PostgreSQL so that all connections have to pass a password
+*** Note the defaults should be o.k for most installations ***
+
+Add or remove any mime types you wish to support. This is used to figure
+out the mime-type when (broken browsers?) browsers don't send the mime-type
+in the content-type header field when uploading a media file. Note add the
+moment you still have to add these to the media_type SQL table as well which
+maps the mime-types to the correct mediaHandler class. See the comments in
+the MirMedia class in javadoc for more details.
+
+9f. Setup PostgreSQL so that all connections have to pass a password
 
 In /etc/postgresql/pg_hba.conf you should make sure that nobody can
 use the database without a password:
@@ -191,6 +203,14 @@ If mod_jk.conf-auto doesn't get written or is 0 bytes in size, check your
 system for file ownership/permissions problems.
 
 
+13. configure apache
+
+edit http.conf:
+* set the document root to the same directory as in the mir config file
+* enable shtml includes:
+  - add LoadModule includes_module /usr/lib/apache/1.3/mod_include.so
+  - make sure your directory contains "Options Includes"
+
 
 that's it :)
 
@@ -213,4 +233,4 @@ 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
++ Check file permissions and ownership. Try and run perms.sh.