In the install documentation, on the multi-site page (http://drupal.org/getting-started/6/install/multi-site), it is not clear what database steps need to be taken for multi-site. It talks only about the structure of the ...../sites/ subdirectories and how that can be set up, such as ...../sites/sub.example.com.site3/settings.php and which resulting URLs those settings will be active for.

It mentions nothing about the database repercussions of making more of those subdirectories. Perhaps this is part of why this "very powerful feature... is often mis-understood." Do we assume that for every directory we make under ..../sites/ we need to repeat all of the 5 previous pages of instructions? (1. "Grant write permissions" - possibly needs repeating depending on the options passed when the default dir was copied; 2. "Create the database" - I guess this needs to be repeated but how would a new reader know this; 3. "Run the install script"; 4. "File system"; 5. "Cron tasks" - it is not clear if running this once will handle all sites of a multi-site site or must it be re-run with each distinct site. )

Also, it would be easier if you advised people to not just copy the whole sites/default/ directory, but also to do a fresh copying of default.settings.php to settings.php so each new site of the multi-site is getting a fresh start, not getting all the pre-made choices of the first site that the person made.

It should also mention that the web server configuration (VirtualHost or whatever) must first be directing those host.domain.tld URLs to the Drupal root directory structure. The advice to move all the the files to the top level /var/www/html is not very useful if /var/www/html contains subdirectories for several virtual hosts and not all will use Drupal.

Comments

Noyz’s picture

Component: Installation » Correction/Clarification

Changed the component to reflect the new component categorization. See http://drupal.org/node/301443

johnvsc’s picture

Version: » 6.x-1.x-dev
Status: Active » Needs review

I created http://drupal.org/node/428596 to address this Documentation request

MGParisi’s picture

Status: Needs review » Closed (fixed)

I reviewed both Noyz and Johnvec, could use work to be great, but its Good!

So Thumbs up and Closed!

MGParisi’s picture

Status: Closed (fixed) » Fixed

Changed to Fixed

Status: Fixed » Closed (fixed)

Automatically closed -- issue fixed for 2 weeks with no activity.