I’m evaluating Dekiwiki.  Since I run multiple wikis, if I convert one to Deki, I want to convert them all.  My wikis run on the same physical host, but with different domainnames.  Here’s how I created my second instance.  (To create a 3rd instance, substitute "3" for the "2" in the appropriate lines.)

Before you start this procedure, you must have at least one instance of the "Hayes" release of Dekiwiki running on your Unix/Linux server.

  1. When you installed your first instance, you un-tarred the source somewhere.  (I put mine in ~ /Deki_Wiki_1.8.1a_Hayes_source.)  cd into that directory. (e.g. cd ~ /Deki_Wiki_1.8.1a_Hayes_source)
    1. Decide where you are going to put your second instance.  This will be your DocumentRoot.  I'm using /usr/local/wikis/example.com.Substitute your DocumenRoot in the below commands:
    2. mkdir /usr/local/wikis/example.com
      cp -r web/*  /usr/local/wikis/example.com
      chown -R apache /usr/local/wikis/example.com
  2. Edit your httpd.conf file (often found in /usr/local/apache/conf or /etc/httpf/conf).
    1. Copy the entire "<VirtualHost *:80>" section for your first instance and paste it below your existing instance.
    2. In the newly pasted copy:
      1. Change ServerName to the dns name of your new instance.  For example, www.example.com.
      2. Change DocumentRoot to the DocumentRoot you selected above. (e.g. DocumentRoot "/usr/local/wikis/example.com")
      3. Change the port number on ProxyPass and ProxyPassReverse to an unused number.  I like using the last digit as my instance number. (e.g. My second wiki is on 8082).  For the rest of this procedure, '8082' means whatever port you used here.
  3. edit /etc/init.d/dekihost:
    1. Make a copy of the DEKI_PATH and the DEKI_SERVERNAME rows, changing the values to suit your new wiki, and adding a single digit (e.g. 2) after PATH and SERVERNAME (e.g. DEKI_PATH2 and DEKI_SERVERNAME2)
    2. Duplicate the first “su apache” line in both the start and the stop functions
    3. Make your copied lines reference the names you created above (e.g. DEKI_PATH2 and DEKI_SERVERNAME2, respectively).
    4. Inside the testDream function, copy and paste the original 7 lines, changing the copy to use the names you created above (e.g. DEKI_PATH2 and DEKI_SERVERNAME2, respectively).  Optional: Also change the echo –n “Dream…” to be something like echo –n “Dream2…”.
  4. Restart apache (e.g. service httpd restart)
  5. Restart dekihost (e.g. service dekihost restart)
  6. Open a browser to httpd://your-site-example.com/config/index.php.  (Use your site's URL.)
  7. Fill in the blanks and submit the form.  Be sure to use a different Site Name, Database Name, and DB username than your other instances!
  8. cd to the config directory under your DocumentRoot (e.g. cd /usr/local/wikis/example.com/config)
  9. cp mindtouch.deki.startup.xml /etc/dekiwiki/mindtouch.deki2.startup.xml (substitute your instance number for 2).
  10. cp LocalSettings.php to your DocumentRoot (e.g. cp LocalSettings.php /usr/local/wikis/example.com/)
  11. cp AdminSettings.php to your DocumentRoot (e.g. cp AdminSettings.php /usr/local/wikis/example.com/)
  12. Edit mindtouch.host.sh:
    1. change SCRIPT= to reference mindtouch.deki2.startup.xml (substitute your instance number).
    2. Change the HTTP_PORT to match the port number you used in your httpd.conf (above)
    3. Change the LOGFILE to a unique name (e.g. add a 2)
    4. Change the PIDFILE to a unique name (e.g. add a 2)
  13. touch /var/log/deki2-api.log (substitute the LOGFILE value you used above)
  14. chown apache /var/log/deki2-api.log (substitute the LOGFILE value you used above)
  15. cp mindtouch.host.sh /usr/local/wikis/example.com/bin/ (substitute the DocumentRoot portion of the name to match your DocumentRoot)