X-Git-Url: http://erislabs.net/gitweb/?a=blobdiff_plain;f=doc%2FINSTALL.mir;h=e2174ca8853d86533574c90ab3224af374432f21;hb=03409c6775d8c0c1d7c000bb91f0bd474bc8dbf0;hp=dfd7af277731db9355e3bf357d557e626cd69bf2;hpb=b1a26cd0129b475448c9c39999ecc47592b0cd9c;p=mir.git diff --git a/doc/INSTALL.mir b/doc/INSTALL.mir index dfd7af27..e2174ca8 100755 --- a/doc/INSTALL.mir +++ b/doc/INSTALL.mir @@ -7,38 +7,146 @@ 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 + +CVS LOGIN: + + cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs login + password: cvs + +CVS CHECKOUT: + + cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs co mir -1. checkout the cvs: -cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs login -password: cvs -cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs lco mir 2. customize the config: -cd mir/source -cp config.properties-dist to config.properties -edit config.properties -3. configure the build.sh file with java_home + cd mir/source + cp config.properties-dist config.properties + +now customize config.properties for your needs. + + +3. configure the build.sh file with java_home + cp build.sh-dist build.sh + chmod 755 build.sh + + +4. copy the mir/templates-dist-directory to mir/templates + + +5. compile + sh build.sh + + +6. Link in the webapps directory of tomcat to the install directory (the +directory is called "Mir" and is located in the same directory in which +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 + + +8. create a new database +the database name should be the same as in config.properties +as user postgres: + createdb dbname + + +9. create base table + psql -Upostgres dbname < dbscripts/create_pg.sql + 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 + 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 + + + + +12. restart tomcat + +13. configure mod_jk + +insert the following patch into /etc/apache/httpd.conf. Edit the directories +to suit your needs. + + +JkWorkersFile /usr/share/tomcat/conf/workers.properties +Include /usr/share/tomcat/conf/mod_jk.conf-auto + + +Do not put any JkMount lines into your httpd.conf! + +If mod_jk.conf-auto doesn't get written or is 0 bytes in size, check your +system for file ownership/permissions problems. + + +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: + +# psql -U postgres Mir +alter user postgres with password 'yourpassword'; + + +Then, in /etc/postgresql/pg_hba.conf you should make sure that nobody can +use the database without a password: + +local all password +host all 127.0.0.1 255.0.0.0 password +host all 0.0.0.0 0.0.0.0 reject -4. Link in the webapps directory of tomcat to the install directory (the directory is called Mir). -5. copy the mir/template-dist-directory to mir/template +Then, change the database password line in config.properties: -6. run sh buil.sh +Database.Username=postgres +Database.Password=yourpassword -7. create a new database (the dbname should be the same as in config.properties) -as user postgres: createdb dbname +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. -8. run psql dump of create_pg.sql: -psql -Upostgres dbname < create_pg.sql +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. -8. run psql dump of help*.sql files. +that's it :) -9. chmod 777 Mir/log +now the admin-application is accesable via: -10. restart tomcat + http://host/Mir -11. configure mod_jk +and the openposting-servlet via + + http://host/OpenMir -12. now the admin-application is accesable by: http://host/Mir and the openposting-servlet by http://host/OpenMir> +standard login is redaktion/indymedia