[documentation] multi site docs

[Boris Mann]

On 10/5/06, Gaele Strootman <eindgebruiker at gmail.com> wrote:

> Step 1:
> It would be clearer if you order it:
> - COMPLETELY separate sites
> - SHARE users ONLY
> - MIRROR sites
> What about the option of using a different database for each site? No
> need for prefixes.

Yep. You only need prefixing if you are limited in the number of MySQL
DBs you can run.

> Step 2:
> I would supply a table here to make it clearer:
> site:                            directory:
> www.example.com    /sites/default/settings.php
> sub1.example.com   /sites/sub1.example.com/settings.php
> etc.
>
> Step 3:
> What I do is: let Apache point to a different document root for every
> hostname, and let each document root be a symlink to the drupal
> directory. This is quite easy and gives you enough flexibility.

You definitely don't need to do this. This is the "hard" part that
Drupal handles automatically. Point all your hostnames at the same
DocRoot. One Drupal codebase. Create a folder in at /sites/domain1.com
that represents your http://domain1.com URL. Done. (still have to
create a separate database or do prefixing)

A general note: sharing users or other tables is difficult stuff. I
applaud attempts to document, BUT it should come with big bold letters
like "You should know what you're doing, this is powerful stuff, it is
trickery at the DB layer, and it is a trick that is essentially
unsupported". As opposed to separate multisite, which we have core
support for and "just works".

-- 
Boris Mann