X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2FINSTALL.mir;h=06f1a0b4d3dde6edcd4f75f796de91a85987d60f;hb=c60a95adcf91d0ca0705a1b781ee239df8e901fb;hp=d74d5ecda69365b55266b53ffacea0720f939909;hpb=af4410ddc9f186482684164837b7a2926c115574;p=mir.git

diff --git a/doc/INSTALL.mir b/doc/INSTALL.mir
index d74d5ecd..06f1a0b4 100755
--- a/doc/INSTALL.mir
+++ b/doc/INSTALL.mir
@@ -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
 
@@ -34,10 +34,12 @@ now customize config.properties for your needs.
         chmod 755 build.sh
 
 
-4. copy the mir/template-dist-directory to mir/template 
+4. copy the mir/templates-dist-directory to mir/templates
+
 
+5. compile (do this as root so the permissions script is able to set
+the permissions and owners correctly).
 
-5. compile
 	sh build.sh 
 
 
@@ -47,29 +49,55 @@ you installed the "mir" directory).
 	cd /usr/share/tomcat/webapps
 	ln -s Mir-install-dir Mir
 
+7. Modify your tomcat startup script and add an LD_LIBRARY_PATH variable
+that points to the WEB-INF/lib directory of your Mir install dir. (called
+"Mir"). Add something like the following at the top of tomcat.sh (tomcat.sh
+is found in the "bin/" dir. under $TOMCAT_HOME):
+    LD_LIBRARY_PATH=/path/to/Mir-install-dir/WEB-INF/lib
+
+An alternaive way to avoid this is to copy any dynamic library files 
+ending with ".so" in WEB-INF/lib to your jre/jdk lib directory (where the 
+other ".so" files live). Or, you can skip the whole thing and live without
+"native" acceleration for image manipulation
+
 
-7. create a new database 
+8. create a new database 
 the database name should be the same as in config.properties
 as user postgres: 
 	createdb dbname 
 
 
-8. create base table
+9. create base table
 	psql -Upostgres dbname < dbscripts/create_pg.sql
-	cat dbscript/help*.sql | psql -Upostgres dbname
-	cat dbscript/populate*.sql | psql -Upostgres dbname
+	cat dbscripts/help*.sql | psql -Upostgres dbname
+	cat dbscripts/populate*.sql | psql -Upostgres dbname
 
-9. Add the dupe prevention trigger to the database:
+
+10. Add the dupe prevention trigger to the database:
 	cd dbscripts/dupetrigger
 	
 	There, read INSTALL and follow the instructions.
 	
 
-10. chmod 777 Mir/log 
+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 --
+    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
+	edit perms.sh 
+	./perms.sh
+
+
 
-11. restart tomcat 
 
-12. configure mod_jk 
+12. restart tomcat 
+
+13. configure mod_jk 
 
 insert the following patch into /etc/apache/httpd.conf. Edit the directories
 to suit your needs.
@@ -85,7 +113,7 @@ If mod_jk.conf-auto doesn't get written or is 0 bytes in size, check your
 system for file ownership/permissions problems.
 
 
-13. Add a password to your PostgreSQL user and link it to Mir (optional)
+14. Add a password to your PostgreSQL user and link it to Mir (optional)
 
 Add a hard to guess password to the PostgreSQL user database:
 
@@ -110,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 :)
@@ -125,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