This is an installation guide.

Multitiki appeared in tiki 1.7, it was one of my first contributions in june 2003. After some time and evolution this special tiki setup is now robust and well-tested. The current documentation talks about the 1.9 multitiki version. There is an alternative proposed by ggeller on RecipeMultiTiki that is more adapted to 1.8 version.

Multiki under Windows XP
For those who want to setup Multitiki under Windows XP, please check MultitikiWindowsXP

Following steps only apply to GNU/Linux environment.

Run setup.sh with an extra parameter that will be the name of your virtual tiki. Either TIKI_VIRTUAL, SERVER_NAME, or HTTP_HOST can be used to detect in which multitiki to go fdepending the apache configuration. Here is what I typed to add http://lir.be test website to my multitiki collection.

su ./setup.sh mose www-data 02775 lir.be

The script will :

• verify that web-writable dirs exist, as well as virtual subdir
• change perms to those dirs to make apache can write in it
• update the file db/virtuals.inc that is in 1.9 the central file where all virtuals are listed

Re-activate your web-install file if your neutralized it by a chmod. for example

chmod 444 tiki-install.php

Point your browser on http://yourtiki/tiki-install.php (if it doesn't work, try to add "lang=en" to the URL: http://yourtiki/tiki-install.php?lang=en). There should be a new item in the menu on the topleft, indicating the state of the db connection (actually the existence and validity of the local.php file for that virtual). That menu is based on db/virtuals.inc file so you can want to change things manually there for tuning. Clicking on the link activates the virtual web-install page like if it was a lone tiki. Then you can follow the install steps :

• give connection settings, that step will create a file named db/lir.be/local.php in my case
• select a db operation, either feeding a created but empty db, or upgrading a 1.8.3 version.

The best known way is to change perms on the tiki-install, if you use cvs it won't break all things

chmod 500 tiki-install.php

On already setup multitiki, you can perform the required operation with command line. For example in case of the lir.be that we saw above :

mysqladmin -uroot -p create tiki_dbname
mysql -uroot -p tiki_dbname < db/tiki.sql
# optionaly, if you want some prepared set of tiki :''
# mysql -uroot -p tiki_base < db/profiles/BasicEnabled.prf
mysql -uroot -p -e "grant usage on *.* to tiki_user@localhost identified by 'tiki_pass';" tiki_dbname 
mysql -uroot -p -e "grant all on tiki_dbname.* to tiki_user@localhost identified by 'tiki_pass';" tiki_dbname

then copy the local.php from another instance of the multitiki, edit it and change the dbname, user and password accordingly to the above creation.
Here is the console shoot of a 5-minutes install of a new multitiki :

Tikiwiki uses his database a lot for storing most content. Therefore, some temporary or volatile content is written to disk, in some directories

• templates_c (smarty pre-compiled templates)
• temp (general temporary dir for tiki)
• temp/cache (centralized cache dir)
• modules/cache (used by smarty)
• img/wiki_up (where are stored wiki images)
• img/wiki (where are stored images generated by jgraphpad)
• maps/ (if maps feature is used)

• db/lir.be/ (where there is a simple local.php file for db connection)
• templates/lir.be/ (for templates)
• styles/lir.be/ (for css and images linked to css)

  
  

• templates/lir.be/styles/moreneat/tiki-showpage is used if exists, else
• templates/lir.be/tiki-showpage is used if exists, else
• templates/styles/moreneat/tiki-showpage is used if exists, else
• templates/tiki-showpage is used (because it exists)

mose

OPTIONAL
MULTITIKI ON SUBDOMAIN ONLY

To do multitiki according to the subdomain name (www, subdomain1, subdomain2...) whatever the main domain name is, add the following lines to tiki-db.php after line 55. That will select the database
according to subdomain only. You must then have run the script to create the directory for subdomain.

$pattern="(.*)\.(.*)\.([[:alpha:]]{3})";
eregi($pattern,$_SERVER['HTTP_HOST'],$results);
$subdomain=$results[1];

then this line after conditions on HTTP_HOST

elseif (isset($_SERVER['HTTP_HOST']) and is_file('db/'.$subdomain.'/local.php')) {
		$multi = $subdomain;

END MULTITIKI ON SUBDOMAIN ONLY

Note
Before 1.9rc4, make sure you have $tikidomain_multi = true; in db/tiki-db.php
Since 1.9rc4 that is not necessary anymore.

InstallVirtualHosting

feedback is welcome, feel free to edit that page for adding or changing

• Multitiki
• Multitiki Akira : several instances of tiki in subdirectories, based on a single tiki installation on the server
• MultiTiki 3.0 Installation for Windows XP