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

[CogRusty]

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:   CogRusty
 Status:       active

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.




CogRusty



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!