doc/INSTALL.mir

   1 Here is a short installation-howto of Mir.
   2
   3
   4 prerequisites:
   5
   6 - tomcat
   7 - apache with mod_jk.so
   8 - postgres 7.1.x
   9 - ant (a java-based make)
  10 - jaxp-1.1 (a SAX 2.0 compliant XML parser, comes with ant >= 1.4)
  11
  12 1. checkout the cvs
  13
  14 CVS LOGIN:
  15
  16         cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs login
  17         password: cvs
  18
  19 CVS CHECKOUT:
  20
  21         cvs -d :pserver: cvsanon@brazil.indymedia.de:/var/cvs co mir
  22
  23
  24 2. customize the config:
  25
  26         cd mir/source
  27         cp config.properties-dist config.properties
  28
  29 now customize config.properties for your needs.
  30
  31
  32 3. configure the build.sh file with java_home
  33         cp build.sh-dist build.sh
  34         chmod 755 build.sh
  35
  36
  37 4. copy the mir/templates-dist-directory to mir/templates
  38
  39
  40 5. compile
  41         sh build.sh
  42
  43
  44 6. Link in the webapps directory of tomcat to the install directory (the
  45 directory is called "Mir" and is located in the same directory in which
  46 you installed the "mir" directory).
  47         cd /usr/share/tomcat/webapps
  48         ln -s Mir-install-dir Mir
  49
  50 7. Modify your tomcat startup script and add an LD_LIBRARY_PATH variable
  51 that points to the WEB-INF/lib directory of your Mir install dir. (called
  52 "Mir"). Add something like the following at the top of tomcat.sh (tomcat.sh
  53 is found in the "bin/" dir. under $TOMCAT_HOME):
  54     LD_LIBRARY_PATH=/path/to/Mir-install-dir/WEB-INF/lib
  55
  56 An alternaive way to avoid this is to copy any dynamic library files
  57 ending with ".so" in WEB-INF/lib to your jre/jdk lib directory (where the
  58 other ".so" files live). Or, you can skip the whole thing and live without
  59 "native" acceleration for image manipulation
  60
  61
  62 8. create a new database
  63 the database name should be the same as in config.properties
  64 as user postgres:
  65         createdb dbname
  66
  67
  68 9. create base table
  69         psql -Upostgres dbname < dbscripts/create_pg.sql
  70         cat dbscripts/help*.sql | psql -Upostgres dbname
  71         cat dbscripts/populate*.sql | psql -Upostgres dbname
  72
  73 10. Add the dupe prevention trigger to the database:
  74         cd dbscripts/dupetrigger
  75
  76         There, read INSTALL and follow the instructions.
  77
  78
  79 11. Set permissions
  80         We provide a script that sets all files' and direcories' permissions to
  81         a quite reasonable state. The most important thing you have to do after
  82     the invokation of this script is to ensure that the log files --
  83     especially dbentity.log -- are not readable by users that could
  84     compromise system security, because all passwords and the like will
  85     be logged here.
  86
  87         cp perms.sh-dist perms.sh
  88         # Now, change the install directory and group in perms.sh
  89         edit perms.sh
  90         ./perms.sh
  91
  92
  93
  94
  95 12. restart tomcat
  96
  97 13. configure mod_jk
  98
  99 insert the following patch into /etc/apache/httpd.conf. Edit the directories
 100 to suit your needs.
 101
 102 <IfModule mod_jk.c>
 103 JkWorkersFile /usr/share/tomcat/conf/workers.properties
 104 Include /usr/share/tomcat/conf/mod_jk.conf-auto
 105 </IfModule>
 106
 107 Do not put any JkMount lines into your httpd.conf!
 108
 109 If mod_jk.conf-auto doesn't get written or is 0 bytes in size, check your
 110 system for file ownership/permissions problems.
 111
 112
 113 14. Add a password to your PostgreSQL user and link it to Mir (optional)
 114
 115 Add a hard to guess password to the PostgreSQL user database:
 116
 117 # psql -U postgres Mir
 118 alter user postgres with password 'yourpassword';
 119
 120
 121 Then, in /etc/postgresql/pg_hba.conf you should make sure that nobody can
 122 use the database without a password:
 123
 124 local            all                                                                               password
 125 host         all         127.0.0.1     255.0.0.0           password
 126 host         all         0.0.0.0       0.0.0.0             reject
 127
 128
 129 Then, change the database password line in config.properties:
 130
 131 Database.Username=postgres
 132 Database.Password=yourpassword
 133
 134 You should make sure that no copy of config.properties (neither in mir nor
 135 in Mir/src nor in Mir/WEB-INF/classes) is world-readable. Else you wouldn't
 136 have to install a password, anyway.
 137
 138 If you can't access PostgreSQL after this for any reason, try to change
 139 "password" in /etc/postgresql/pg_hba.conf into "trust". This should disable
 140 any authentication method and make the database accessible again.
 141
 142 that's it :)
 143
 144 now the admin-application is accesable via:
 145
 146         http://host/Mir
 147
 148 and the openposting-servlet via
 149
 150         http://host/OpenMir
 151
 152 standard login is redaktion/indymedia