Windows SharePoint Services in Host Header Mode

Scenario: You want to deploy multiple Windows SharePoint Services (WSS) Sites in your organization, and each site should have its own domain name. You do not want to create a new IIS Virtual Server for each site. Can WSS handle this configuration?

Yes, but this configuration is not entirely intuitive. The most important aspect of this configuration is creating the configuration database to handle host headers. The only way to accomplish this is to create the config database using the stsadm.exe command line tool. If you use the SharePoint adminstration pages to create the config database, it will not be created in host header mode, and this configuration will not be possible.

After installing WSS but before doing anything in the Administration pages, go to the command prompt and navigate to the Program Files/Common Files/Microsoft Shared/web server extensions/60/bin folder. Run the stsadm.exe tool to create the database using this syntax:

stsadm -o setconfigdb -ds <database server name> -dn <database name> -hh

If you are not using integrated security for SQL, you must also include a username (-su) and password (-sp) in the command. The important piece is the -hh parameter which specifies Host Header mode.

Once the configuration database has been created, you can then create the sites. Make sure the server's hosts file is updated to specify the domain names you would like. For example, a hosts file for three team sites might look like this:

xx.xx.xx.xx       www.site1.com
xx.xx.xx.xx       www.site2.com
xx.xx.xx.xx       www.site3.com

Where xx.xx.xx.xx is the IP address of the server.

Then, create the sites using the stsadm.exe tool:

stsadm.exe -o createsite -url http://www.site1.com -ownerlogin <domain>\<username> -owneremail <email address>

Do this for each site. Navigate to the URL to select the template and your site will be created.

More information on this configuration can be found here: http://www.microsoft.com/resources/documentation/wss/2/all/adminguide/en-us/stsc03.mspx

BEWARE: This configuration will be broken if you install SharePoint Portal Server on the server. While Portal Server can be installed and reconnected to existing WSS Sites, this is NOT supported when using Host Header Mode. Portal wants all WSS sites to be addressed http://<Portal>/sites/<Site Name>.

To implement this configuration along with Portal, I suppose the best way is to install Portal on a separate server. Then each WSS Site can be linked to the Portal, and the Portal's Site Directory can be updated to link to the existing WSS Sites.

If someone is aware of a better implementation, please, let me know.

Print | posted on Wednesday, May 11, 2005 11:29 AM

Comments on this post

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
Great information! I was able to use the stsadm utility to setconfigdb - however, I kept getting errors using the stsadm createsite option - something about the server not being available?

Either way, as long as you run the setconfigdb as a command line - you can configure the individual sites manually through IIS first and then through the central administration tool for sharepoint!

Thanks for the information!
Left by Michael on Sep 25, 2005 10:42 AM

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
Do you know if there is anything special that needs to be done if implementing the local MSDE version of SharePoint Services with host headers? We are evaluating and do not want to create a SQL instance yet.
Left by Kane Prestwood on Jan 28, 2007 7:17 PM

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
Sorry, I forgot to mention that we are having trouble with certain actions in SharePoint trying to refer back to the server name instead of the host header, which is why I am posting.
Left by Kane Prestwood on Jan 28, 2007 7:19 PM

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
I don't think this pertains to WSS 3.0? If it does, the most common reason for host headers to fail is forgetting to set an "Alternate Access Mapping" (see Operations tab in Central Admin) for that host header. Doing this through the UI should then work.
Left by Carlos on Jun 28, 2007 12:23 PM

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
Suck ma balls biatch
Left by Bay Bay on Mar 09, 2008 8:52 PM

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
This is great information. Though I have a question because I have WSS/MOSS running on the the same sever. I have a portl/companyweb site all set up, I have the Central Administration site up and running but my SSP (shared services provider) is not up and running. Wondering if I can reate a new one without it affecting my current WSS/MOSS site?

Left by John Heck on Apr 14, 2009 7:02 AM

# re: Windows SharePoint Services in Host Header Mode

Requesting Gravatar...
I'm looking for a good shag!
Left by john beton on Apr 30, 2009 2:26 AM

Your comment:

 (will show your gravatar)