--- LONG.INSTALL.mir Sat Jan 18 09:44:09 2003
+++ LONG.INSTALL.mir-1.1-050116 Sun Jan 16 23:25:55 2005
@@ -1,6 +1,7 @@
MIR INSTALLATION HOWTO
Last updated: $Date: 2003/01/18 08:44:09 $
+Modified: $Date: 2005/01/16 21:49:50 $
----------------------------------------------------------------
Here is a short installation-howto of Mir, somewhat more explicit than
@@ -117,7 +118,12 @@
JkMount /servlet ajp13
jkMount /examples/* ajp13
#Include /var/lib/tomcat/conf/mod_jk.conf
-
+
+
+-> As of tomcat-4.1.30-6 under debian-sarge, you probably need the
+JkWorkersFile line more like:
+ JkWorkersFile /etc/libapache-mod-jk/workers.properties
+
restart tomcat(as root):
/usr/share/tomcat4/bin/shutdown.sh
/usr/share/tomcat4/bin/startup.sh
@@ -172,8 +178,10 @@
tar -xvf "name_of_file.tar"
-read the instructions in
+Read the instructions in
/usr/share/tomcat4/common/lib/jai_whatever_version_you_have/INSTALL-jai.txt
+but you should *ignore* the instruction to install the JRE and JDK binaries
+of JAI - you *only* need the CLASSPATH files.
Now add the JAI files to your CLASSPATH and LSD_LIBRARY_PATH:
JAIHOME=$TOMCAT_HOME/common/lib/jai-1_1_1_01/lib; export JAIHOME
@@ -230,6 +238,12 @@
edit perms.sh
+-> This set of permissions does not always work. With one debian-sarge
+installation, the permissions needed to be changed to
+chown tomcat4:nogroup instead of www-data:www-data
+
+
+
(d) Customize the templates
you need to edit the templates before compiling, or not all of your
@@ -242,6 +256,8 @@
if you are uasing 4.1, you wil need to make some minor changes to
mir/etc/web.xml
+
+
look for sections like this:
@@ -263,6 +279,10 @@
make sure to do the same for OpenMir and OutputMir.
+--> this comment may or may not be necessary as of Mir-20041106 CVS,
+since the replacement section is already present in the web.xml file;
+also, OutputMir is not present.
+
-------------------------------------------------------------
-------------------------------------------------------------
@@ -296,6 +316,19 @@
cd /path/to/tomcat/webapps (tomcat-4.0.x/webapps)
ln -s /path/to/Mir Mir
+-> As of Mir-20041106 CVS, if you compile mir with ant in the directory
+/path/to/Mir/
+then ant will place the WEB-INF directory as
+/path/to/Mir/bin/mir/WEB-INF/
+
+Then you should:
+ cd /path/to/tomcat/webapps
+ ln -s /path/to/Mir/bin/mir/WEB-INF Mir
+where "Mir" is the same name as in
+ JkMount /Mir ajp13
+above
+
+
dynamically reload Mir:
http://localhost:8180/manager/stop?path=/Mir
@@ -312,6 +345,20 @@
can skip the whole thing and live without "native" acceleration for image
manupulation.
+
+(i) (this should probably be done at an earlier step)
+-> As of as of Mir-20041106 CVS, you need to open up tomcat security,
+at least in debian-sarge.
+In the file
+ /etc/default/tomcat4
+set
+ TOMCAT4_SECURITY=no
+
+You can probably add back in some sort of security. Please update
+these INSTALL instructions and discuss this on the
+mir-coders at lists.indymedia.org mailing list.
+
+
(2) CREATE AND CONLFIGURE THE MIR DATABASE!
Review mir/etc/config.properties. Look carefully at the entries you
@@ -395,7 +442,8 @@
now exit psql:
\q
-save the following lines to a file called set.permissions:
+Save the following lines to a file called
+set.permissions:
select 'grant all on '||relname||' to Mir;'
from pg_class
@@ -404,6 +452,21 @@
-->be sure to replace "Mir" with your username!!!
+-> To a newbie user, it is not obvious how to execute this file.
+One method that works is the following:
+
+ (A) start up psql
+ (B) type in the above four lines -> you should be given many lines of
+output - cut/paste the output to a text file in another window - you
+will be able to spacebar through the full list of output lines,
+probably several screens long
+ (C) now cut/paste these output list of instructions back into the
+psql window
+
+Then again use click and paste to paste all of these instructions into your
+running psql shell.
+
+
(e) Apply neccessary changes to config.properties
--> if you folowed the instructions above, you shouldn't have to do
@@ -445,6 +508,14 @@
You may want to change your PostgreSQL password from time to time to make
database takeover harder. Rememer: Security is a process.
+
+(g) If you are installing a new mir setup with an old database,
+then you can put your old database into your new site with something
+like:
+
+pg_restore -d -U -W
+
+
----------------------------------------------------------------
AT THIS POINT YOU SHOULD HAVE A WORKING INSTAATION OF MIR! CHECK TO
@@ -489,7 +560,7 @@
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
+ file. Or add an equivalent AddType command to your httpd.conf. Of course
this assumes that the mod_mime is loaded.
that's it :)
@@ -506,6 +577,38 @@
users or passwords.
+14. cities.inc
+
+You can add a cronjob as the user who has write access to your mir
+installation
+
+crontab -e
+
+For a daily update add a line like:
+
+04 22 * * * /path/to/cities.sh >/dev/null 2>&1
+
+where you create a file like
+
+/path/to/private/scripts/cities.sh
+
+containing
+
+#!/bin/sh
+wget http://www.indymedia.org/cities.inc
+cp -p cities.inc /path/to/Mir/bin/mir/WEB-INF/etc/producer/cities.inc
+
+where /path/to/Mir/bin/mir/WEB-INF is the place where your compiled
+mir files are found (see above: ln -s soft link from tomcat/webapps).
+
+You can use another application like curl if you don't have wget.
+
+
+15. automatic redirection to your preferred index page
+
+
+
+
SEARCHING
The Mir code offers no internal search facilities, rather, the design
@@ -532,6 +635,13 @@
+ Check file permissions and ownership. Try and run perms.sh.
+* Look through
+/path/to/Mir/bin/mir/WEB-INF/log/*.log files for hints,
+e.g.
+tail -100 /path/to/Mir/bin/mir/WEB-INF/log/producer.log | more
+
+
----------------------------------------------------------------
$Date: 2003/01/18 08:44:09 $ - the Mir coders
+Modified: $Date: 2005/01/16 21:49:50 $