[documentation] [Documentation task] Drupal multi-site setup documentation: request for comments

Thu Jan 4 11:57:17 UTC 2007

Issue status update for 
http://drupal.org/node/104340
Post a follow up: 
http://drupal.org/project/comments/add/104340

 Project:      Documentation
 Version:      <none>
 Component:    Admin Guide
 Category:     tasks
 Priority:     normal
 Assigned to:  venkat-rk
 Reported by:  venkat-rk
 Updated by:   venkat-rk
 Status:       active

Thanks for all the inputs, encouragement and links:-)

venkat-rk

Previous comments:
------------------------------------------------------------------------

Wed, 20 Dec 2006 01:45:05 +0000 : venkat-rk

I thought I woud take a stab at trying to write to a multi-site set up
guide with inputs from the community. I may only be able to do this in
little bits, though.

After reading some forum posts and the sections in Robert Douglass'
book, I have the following broad structure in mind. Feel free to suggest
additions or changes for a better structure. Once we agree upon the
structure, I will add book pages and post them for review. 

*I. Introduction*

* What is multi-site
* Benefits of multi-site

*II. Options for Multi-site*

* Multi-site using one code base and different databases for different
domains/sub-domains
* Multi-site using one code base and one database with prefixed tables
for different domains/sub-domains

*III. Ways to configure Multi-site in Drupal*

* Using Apache Vhosts (editing httpd.conf)
* Using symlinks

*IV. Setting up Multi-site step by step*

* Create a database on the specific domain/sub-domain or run prefix.sh
and create a prefixed database
* For each site, create a subdirectory under ..sites/
* Put settings.php under that subdirectory and configure the db
parameters
* Create a files directory under the subdirectory
* Update the file system path at ../admin/settings

*V. Setting up site specific modules and themes*

* Put under a separate 'modules' and 'themes' directory within the
subdirectory

What else? What about sharing tables between sites and across
databases? What about setting up multi-site using Cpanel or Plesk? Any
best practices?

Please chip in with comments, suggestions and links to make this a
useful guide. After a few significant comments/posts, I will post an
updated structure on this thread.

Thanks in advance,
Venkat.

------------------------------------------------------------------------

Wed, 20 Dec 2006 19:50:13 +0000 : Gary Feldman

"Using Apache Vhosts (editing httpd.conf)

"
Keep in mind that many users won't have access to httpd.conf, but may
have access to tools such as CPanel.  People who are maintaining their
own httpd.conf files probably don't need as much help as those who
don't.

------------------------------------------------------------------------

Thu, 21 Dec 2006 02:26:08 +0000 : venkat-rk

You are right about httpd.conf, but I ran into an interesting situation
with a shared hosting provider who gives access to it. I think it is
ixwebhosting.com

Also the idea is to capture all important stuff in the handbook. There
may be situations when even relative non-geeks get a VPS and try to do
this (I know I am one!), so this section would help them.

------------------------------------------------------------------------

Fri, 22 Dec 2006 16:09:24 +0000 : karldied

Gary wrote: People who are maintaining their own httpd.conf files
probably don't need as much help as those who don't.

venkat-rk wrote: There may be situations when even relative non-geeks
get a VPS and try to do this (I know I am one!), so this section would
help them.

I'm another of those relative non-geeks who have access to httpd.conf,
but need help. Thanks!

------------------------------------------------------------------------

Fri, 22 Dec 2006 16:41:48 +0000 : CogRusty

About httpd.conf, don't forget the people who download and install an
AMP package with whatever default settings and want to give Drupal a
try. Judging by the support questions, they seem to be many and
inexperienced. Both Windows users who just want it to work and Linux
folks fiddling randomly.

------------------------------------------------------------------------

Sat, 23 Dec 2006 11:48:52 +0000 : venkat-rk

@CogRusty: Good point. Will keep it in mind.

------------------------------------------------------------------------

Thu, 04 Jan 2007 09:39:52 +0000 : pcwick

I think this looks like a great start to a much needed doc.  In answer
to your questions, I think I would structure thus:

II. Options for Multi-site

    * Multi-site using one code base and different databases for
different domains/sub-domains
    * Multi-site using one code base and one database with prefixed
tables for different domains/sub-domains
    * Sharing tables between sites and across databases

III. Ways to configure Multi-site in Drupal
    * Using Apache Vhosts (editing httpd.conf)
    * Using symlinks
    * Using Cpanel or a similar web panel

- I think it probably best to refer users to the documentation for
their respective panel.  Dreamhost, for example, uses a proprietary web
panel.  

You'll definitely want to reference "Use the /sites directory to keep
Drupal tidy" under best practices: http://drupal.org/node/53705

I'm wondering if the installer complicates the multi-site setup
procedure for newer users.  Perhaps you'll want to indicate that you are
describing a fully manual install, or maybe explain how to build a
multi-site setup when the user has already created a single-site setup
with the installer.  Seems some sort of clarification along these lines
will be useful to those who have never manually installed Drupal.

You might want to mention that themes and modules placed in the new
"sites/ALL" directory will be common to all sites. 
http://drupal.org/node/22283

You probably know, but some of your work is already done in INSTALL.txt