Install Windows SharePoint Services 3.0 by using the command line

Applies To: Windows SharePoint Services 3.0

 

Topic Last Modified: 2010-11-08

In this article:

• Install software requirements

• Determine required accounts for installation

• Install Windows SharePoint Services 3.0 by running Setup at a command prompt

• Configure the server by using the Psconfig command-line tool

• Perform additional configuration tasks

• Create a Web application and a site collection by using the Stsadm command-line tool

• Configure the trace log

This article discusses how to do a clean installation of Windows SharePoint Services 3.0 in a server-farm environment by using command-line tools.

Command-line tools enable you to customize the configuration of Windows SharePoint Services 3.0. Additionally, you can streamline deployment by using command-line tools in combination with other administrator tools to automate unattended installations.

To install Windows SharePoint Services 3.0 on a server farm, you have to complete the following steps:

1. Plan your deployment and ensure that you have installed all the software requirements.

2. Determine the required accounts that are used during installation.

3. Install Windows SharePoint Services 3.0 by running Setup at a command prompt and specifying a configuration file.

4. Configure the server by using the Psconfig command-line tool with the appropriate options.

5. Create a Web application by using the Stsadm command-line tool.

6. Create a site collection by using the Stsadm command-line tool.

Install software requirements

Before you run Setup, you must perform several actions to prepare your deployment. For more information about the complete list of actions you must perform before installation, see Install Windows SharePoint Services 3.0 for a server farm environment. Ensure that you have the following software requirements before you run Setup:

• Windows SharePoint Services 3.0 on a clean installation of the Windows Server 2003 operating system with the most recent service pack. To install Windows SharePoint Services 3.0 on Windows Server 2008, see Chapter overview: End-to-end deployment scenarios (Windows SharePoint Services).

  Note

  All the instances of Windows SharePoint Services 3.0 in the farm must be in the same language. For example, you cannot have both English and Japanese versions of Windows SharePoint Services 3.0 in the same farm.

• The Microsoft .NET Framework version 3.0. The .NET Framework version 3.0 download contains the Windows Workflow Foundation technology, which is required by workflow features.

  Note

     You can also use the Microsoft .NET Framework version 3.5. You can download the .NET Framework version 3.5 from the Microsoft Download Center (https://go.microsoft.com/fwlink/?LinkId=110508).

• ASP.NET 2.0 enabled in the Internet Information Services (IIS) Manager on all servers that are running Windows SharePoint Services 3.0.

• Microsoft SQL Server 2000 or Microsoft SQL Server 2005 with the most recent service pack running on at least one database server before you install Windows SharePoint Services 3.0 on your Web servers.

To deploy a server farm, you must have at least one server computer acting as a Web server and an application server, and one server computer acting as a database server.

Determine required accounts for installation

Before installing Windows SharePoint Services 3.0 at a command prompt, you should understand the two-tier security model for Windows SharePoint Services 3.0, and the detailed account permissions that are required for each configuration. For more information, see the following resources:

• Plan for security roles (Windows SharePoint Services)

• Plan for administrative and service accounts (Windows SharePoint Services)

• Windows SharePoint Services security account requirements (https://go.microsoft.com/fwlink/?LinkId=92885&clcid=0x409)

The following table describes the accounts that are used during installation and configuration of Windows SharePoint Services 3.0. You must create and configure these accounts before you run Setup.

Account	Purpose	Requirements
Setup user account	The Setup user account is used to run the following: Setup on each server. The SharePoint Products and Technologies Configuration Wizard. The Psconfig command-line tool. The Stsadm command-line tool.	Domain user account. Member of the Administrators group on each server on which Setup is run. SQL Server login on the computer that is running SQL Server. Member of the following SQL Server security roles: securityadmin fixed server role dbcreator fixed server role If you run Stsadm command-line tool commands that read from or write to a database, the Setup user account must be a member of the db_owner fixed database role for the database.
Server farm account or database access account	The server farm account is used to: Configure and manage the server farm. Act as the application pool identity for the SharePoint Central Administration application pool. Run the Windows SharePoint Services Timer service.	Domain user account. Additional permissions are automatically granted for the server farm account on Web servers and application servers that are joined to a server farm. The server-farm account is automatically added as a SQL Server login on the computer that is running SQL Server, and added to the following SQL Server security roles: dbcreator fixed server role securityadmin fixed server role db_owner fixed database role for all databases in the server farm

Install Windows SharePoint Services 3.0 by running Setup at a command prompt

After you have determined the required accounts for the installation, you can install Windows SharePoint Services 3.0. To install Windows SharePoint Services 3.0, you have to do the following:

1. Install Windows SharePoint Services 3.0 and save the SharePoint.exe file to your computer.

2. Extract the SharePoint.exe file.

3. Select a Config.xml file.

4. Run Setup with the selected Config.xml file.

Depending on your hardware requirements, you have to install Windows SharePoint Services 3.0 from one of the following resources, and save the SharePoint.exe file to your computer:

• Windows SharePoint Services 3.0 with the latest service pack (https://go.microsoft.com/fwlink/?LinkID=105656&clcid=0x409)

• Windows SharePoint Services 3.0 x64 with the latest service pack (https://go.microsoft.com/fwlink/?LinkID=105802&clcid=0x409)

The SharePoint.exe file has to be extracted, which you do at the command prompt:

drive:\path\SharePoint.exe /extract:drive:\path

The folder to which you extracted the SharePoint.exe file contains examples of configuration (Config.xml) files. These example files are stored under the \Files folder in the root directory of the DVD, in folders that correspond to different scenarios. These example files are described in the following table.

Configuration file	Description
Setup\Config.xml	Single server installation
SetupFarmSilent\Config.xml	Server-farm installation in silent mode
SetupGradualUpgradeSilent\Config.xml	Gradual upgrade of an existing farm in silent mode
SetupSilent\Config.xml	Single server installation in silent mode
SetupUpgradeSilent\Config.xml	In-place upgrade of an existing farm in silent mode

Example

The following example shows the configuration for setting up a farm in silent mode (SetupFarmSilent).

<Configuration>

<Package Id="sts">

<Setting Id="REBOOT" Value="ReallySuppress"/>

<Setting Id="SETUPTYPE" Value="CLEAN_INSTALL"/>

</Package>

<Logging Type="verbose" Path="%temp%" Template="Microsoft Windows SharePoint Services 3.0 Setup(*).log"/>

<Setting Id="SERVERROLE" Value="WFE"/>

<Setting Id="USINGUIINSTALLMODE" Value="0"/>

<Display Level="none" CompletionNotice="no" />

</Configuration>

Run Setup with a Config.xml file at a command prompt

1. On the drive on which Windows SharePoint Services 3.0 is installed, change to the root directory to locate the setup.exe file.

2. Run Setup with the selected Config.xml file.

   setup /config<path and file name>

   Note

   You can select one of the example configuration files, or customize your own configuration file.

3. Press ENTER.

Setup is now finished.

Example

To set up a farm in silent mode, type the following command at a command prompt, and then press ENTER:

setup /config Files\SetupFarmSilent\config.xml

You can also customize your own configuration file. To control the installation, first edit the Config.xml file in a text editor to include the elements that you want with the appropriate settings for those elements. Then run setup /config <path and file name> to specify that Setup runs and uses the options that you set in the Config.xml file. For example, a typical configuration option includes adding a location for a log file, <Logging Type="off" | "standard"(default) | "verbose" Path="path name" Template="file name.log"/>, which you can view if command-line installation fails.

For more information about the options available for customizing the configuration file, see Config.xml reference (Windows SharePoint Services).

For more information about the command-line options for Setup, see Setup.exe command-line reference (Windows SharePoint Services).

Configure the server by using the Psconfig command-line tool

You use the Psconfig command-line tool to configure Windows SharePoint Services 3.0 after Setup has finished. In server-farm deployments, you use the Psconfig command-line tool to create a new farm or to connect to an existing farm. The tool is located on the drive on which SharePoint Products and Technologies is installed in the following directory: %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\12\Bin.

Psconfig installs the SharePoint Central Administration Web site on the first server in your farm. Therefore, we recommend that the first server on which you install Windows SharePoint Services 3.0 is a server from which you want to run the Central Administration Web site.

For more information about the SharePoint Products and Technologies Configuration Wizard and the Psconfig command-line tool and its operations and parameters, see Command-line reference for the SharePoint Products and Technologies Configuration Wizard (Windows SharePoint Services).

The following procedure describes how to configure the first server in your farm. How to add servers to your farm is described at the end of this procedure.

Configure Windows SharePoint Services 3.0 on a farm by using the Psconfig command-line tool

1. On the drive on which SharePoint Products and Technologies is installed, change to the following directory: %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\12\Bin.

2. Create the configuration database:

   psconfig -cmd configdb -create -server <database server name> -database <database name>

   [ -dbuser<domain\user name> -dbpassword <password>]

   -user <domain\user name> -password <password>

   -admincontentdatabase <Central Administration Web application content database name>

   Note

   The dbuser and dbpassword parameters are only used in deployments that use SQL Server authentication. If you are using Windows authentication, these parameters are not required.

3. Install the Help collection:

   psconfig -cmd helpcollections -installall

4. Perform resource security enforcement:

   psconfig -cmd secureresources

5. Register services in the server farm:

   psconfig -cmd services -install

   Note

   After installing services, you must start and configure Windows SharePoint Services Search by using the Stsadm command-line tool:

   1. stsadm -o spsearch -action start -farmserviceaccount <domain\user name> -farmservicepassword <password>[-database name <content database name>][-database server <server instance>][-search server<search server name>]

      For more information, see Spsearch: Stsadm operation (Windows SharePoint Services).

      Note

      Use the domain and user account information for the server farm account that you created and configured previously.

   2. Provision the services of the farm:

      psconfig -cmd services –provision

6. Register all features:

   psconfig -cmd installfeatures

7. Provision the SharePoint Central Administration Web application:

   psconfig -cmd adminvs -provision -port <port> -windowsauthprovider onlyusentlm

8. Install shared application data:

   psconfig -cmd applicationcontent –install

The SharePoint Central Administration Web site has now been created.

We recommend that you install and configure Windows SharePoint Services 3.0 on all the farm servers before you create sites.

To connect to an existing configuration database and join the server to an existing server farm, you have to run the configdb command together with the -connect parameter instead of the create parameter.

psconfig -cmd configdb -connect -server <server name> -database <database name>

Use the psconfig -cmd adminvs -provision -port <port> -windowsauthprovider onlyusentlm command if you want to provision the SharePoint Central Administration Web application on additional servers, which minimizes the risk if the server that is running the SharePoint Central Administration Web application fails.

To successfully complete the command-line installation, you must use the Stsadm command-line tool to create a Web application and a site collection for the farm. However, before you create a Web application and a site collection, we recommend that you first perform some additional configuration tasks.

Perform additional configuration tasks

After you have installed Windows SharePoint Services 3.0, we recommend that you perform the following administrative tasks:

• Configure incoming e-mail settings (Windows SharePoint Services)

• Configure outgoing e-mail settings (Windows SharePoint Services)

• Configure workflow settings (Windows SharePoint Services)

• Configure diagnostic logging settings (Windows SharePoint Services)

• Configure antivirus settings (Windows SharePoint Services)

Create a Web application and a site collection by using the Stsadm command-line tool

After you create and configure Windows SharePoint Services 3.0 on a farm, you must use the Stsadm command-line tool to create a Web application and a site collection. A Web application is composed of an Internet Information Services (IIS) site together with a unique application pool. When you create a new Web application, you also create a new database and define the authentication method that is used to connect to the database.

If you are in an extranet environment in which you want different users to access content by using different domains, you might also need to extend a Web application to another IIS Web site. This action exposes the same content to different sets of users by using an additional IIS Web site to host the same content.

Create a Web application and a site collection by using the Stsadm command-line tool

1. On the drive on which SharePoint Products and Technologies is installed, change to the following directory: %COMMONPROGRAMFILES%\Microsoft shared\Web server extensions\12\Bin.

2. Type the following command, and then press ENTER:

   stsadm -o extendvs

   -url <URL name>

   -ownerlogin <domain\user name>

   -owneremail <e-mail address>

   [-exclusivelyusentlm]

   [ownername <display name>]

   [databaseuser <database user name>]

   [-databaseserver <database server name>]

   [-databasename <new content database name>]

   [databasepassword <database password>]

   [lcid <language>]

   [sitetemplate <site template>]

   [description]

   [sethostheader]

   [-apidname <application pool name>]

   [-apidtype {configurableID | NetworkService}]

   [-apidlogin <domain\user name>]

   [-apidpwd <application pool password>]

   For more information, see Stsadm command-line tool (Windows SharePoint Services) and Extendvs: Stsadm operation (Windows SharePoint Services).

Example

The following command creates a Web application and a site collection with the URL http://intranet that uses the corporate team site template.

stsadm -o extendvs -url http://intranet -ownerlogin <domain\user name> -owneremail <user@domain.com>-sitetemplate STS#0 -exclusivelyusentlm -databaseserver <database server name> -databasename <content database name> -apidname <application pool name> -apidtype {configurableID | NetworkService} -apidlogin <domain\user name> -apidpwd <password>

If you do not specify the template to use, site owners can choose the template when they first browse to the site.

If you want to create additional Web applications or site collections by using the Stsadm command-line tool, you can use either the extendvs or createsite operation.

The extendvs operation extends a Web application and creates a new content database. The createsite operation creates a site collection at a specific URL with a specified user as site owner.

For more information, see Createsite: Stsadm operation (Windows SharePoint Services) and Createsiteinnewdb: Stsadm operation (Windows SharePoint Services).

The extendvs operation also enables administrators to specify the language of the site collection by using the Locale ID (LCID) parameter. If you do not specify an LCID, the language of the server is used for the site collection. For more information about the available LCID values, see List of Locale ID (LCID) Values as Assigned by Microsoft(https://go.microsoft.com/fwlink/?LinkId=63028&clcid=0x409).

After creating sites, you might want to configure alternate access mappings. Alternate access mappings direct users to the correct URLs during their interaction with Windows SharePoint Services 3.0 (while browsing to the home page of a Windows SharePoint Services 3.0 Web site, for example). Alternate access mappings enable Windows SharePoint Services 3.0 to map Web requests to the correct Web applications and sites, and they enable Windows SharePoint Services 3.0 to serve the correct content back to the user. For more information, see Plan alternate access mappings.

Configure the trace log

The trace log can be useful for analyzing problems that might occur. You can use events that are written to the trace log to determine what configuration changes were made in Windows SharePoint Services 3.0 before the problem occurred.

By default, Windows SharePoint Services 3.0 saves two days of events in the trace log files. This means that trace log files that contain events that are older than two days are deleted. When you are using the Windows SharePoint Services Search service, we recommend that you configure the trace log to save seven days of events.

You can use the Diagnostic Logging page in Central Administration to configure the maximum number of trace log files to maintain, and how long (in minutes) to capture events to each log file. By default, 96 log files are kept, each one containing 30 minutes of events.

96 log files * 30 minutes of events per file = 2880 minutes (two days) of events.

You can also specify where the log files are written or accept the default path.

Trace log files can help you troubleshoot issues related to configuration changes of the Windows SharePoint Services Search service. Because problems related to configuration changes are not always immediately discovered, we recommend that you save all trace log files that the system creates on any day that you make any configuration changes. Store these log files for some time in a safe location that will not be overwritten. We recommend that you store log files on a hard disk partition that is used to store log files only.

Download this book

This topic is included in the following downloadable books for easier reading and printing:

• Deployment for Windows SharePoint Services 3.0 technology

• Installation Guide for Windows SharePoint Services 3.0

See the full list of available books at Downloadable content for Windows SharePoint Services 3.0.