Msiproperty.ini File Properties
You can customize your deployment of Visual Studio Team System Team Foundation Server by modifying up to three msiproperty.ini files before you install it. Each file contains properties for a component of Team Foundation and is located in one of the following directories:
Component |
Directory |
|---|---|
Team Foundation Server |
Drive:\InstallFolder\AT |
Team Foundation Server Proxy |
Drive:\InstallFolder\Proxy |
Team Foundation Build |
Drive:\InstallFolder\BUILD |
When you install Team Foundation Server, you specify most installation properties in the Setup program. You should modify an msiproperty.ini file only if you must change a property that you cannot change in the Setup program. If you must troubleshoot installation, you can open the installation log files and determine which values are assigned to properties in the msiproperty.ini files. By default, the log files are located in the following directory on the computer where you installed Team Foundation Server:
Drive:\Documents and Settings\SetupAccount\Local Settings\Temp \VSMsiLogxxxx.txt
If you installed Team Foundation Server from a Terminal Services session, the installation logs will be located in %temp% or %temp%\.
The msiproperty.ini files configure Team Foundation Server during installation. After you complete installation, you should use the administrative tools for Team Foundation to update the deployment. For more information about how and where Team Foundation Server stores configuration information, see Managing Configuration Settings for Team Foundation Server.
For a description of each property that is defined in an msiproperty.ini file for Team Foundation Server, see one of the following sections:
Properties that Support Custom Deployment Scenarios
Properties that Require Periodic Updating
Properties that Should Not Be Modified
Properties that Support Custom Deployment Scenarios
Before you install Team Foundation Server, you can modify the properties in the following table to support a custom deployment scenario.
Note
To customize the port assignment for the SharePoint Central Administration site in the installation wizard for Team Foundation Server, you must select the Use a server already running Windows SharePoint Services check box. For more information about how you can customize your deployment of Team Foundation Server, see "How to: Customize Deployment of Team Foundation" in the Team Foundation Server Installation Guide. You can download the most recent version of this guide from the Microsoft Download Center.
Property |
Description |
|---|---|
VSTF_AS_INSTANCE |
The name of the database instance that hosts the TfsWarehouse database. The format is ComputerName for the default instance and ComputerName\MyInstanceName for a named instance. ComputerName corresponds to the name of the server where SQL Server Analysis Services is installed. To specify a named instance with no dependency on SQL Server Browser Service or to specify a fixed port, use the format ComputerName: PortNumber. |
VSTF_AS_ACCOUNT |
The name of the service account that has access to the database for SQL Server Analysis Services. |
VSTF_AS_DATABASE |
The name of the database for SQL Server Analysis Services. The value assigned is TfsWarehouse. |
VSTF_RS_REPORTS_URI |
The URI of the reporting Web site for Team Foundation Server. The default value is http://[ComputerName]/Reports/. |
VSTF_RS_REPORTSERVER_URI |
The URI of the ReportServer Web site for Team Foundation Server. The default value is http://[ComputerName]/ReportServer/. |
VSTF_RS_SERVER |
The name of the server that hosts SQL Server Reporting Services for Team Foundation Server. The default value is [ComputerName]. .gif "Note") Note:
When Reporting Services is hosted on the application-tier server, the value must be set to [ComputerName].
|
VSTF_WEBSITE_PORT |
The number of the TCP port that the Web site for Team Foundation Server or Team Foundation Server Proxy uses. The default value is 8080 for Team Foundation Server and 8081 for Team Foundation Server Proxy. |
VSTF_WSS_ADMIN_PORT |
The number of the TCP port that is assigned to SharePoint Central Administration. The default value is 17012. |
VSTF_WSS_SITE_PORT |
The number of the TCP port that is assigned to SharePoint Products and Technologies. The default value is 80. |
VSTF_WSSSQL_PORT |
The number of the TCP port that the Web site for SQL Server Reporting Services uses. The default value is 80. |
Properties that Might Require Periodic Updating
If you change the domain or the name of the service account for Team Foundation Server, TFSSERVICE, or for SQL Server Reporting Services, TFSREPORTS, you might need to update the corresponding property in the msiproperty.ini file. This change might be required for servicing operations, such as repairing Team Foundation Server and installing or uninstalling service packs, to succeed.
Note
For more information about how to change the name of a service account, see How to: Change the Service Account or Password for Team Foundation Server and How to: Change the Service Account or Password for SQL Server Reporting Services.
Property |
Description |
|---|---|
VSTF_AS_ACCOUNT |
The name of the service account that has access to the database for Analysis Services. |
VSTF_AS_DATABASE |
The name of the database for Analysis Services. The value assigned is TfsWarehouse. |
VSTF_DOMAIN |
The name of the domain for the account under which the Team Foundation Server Service runs. |
VSTF_RS_DOMAIN |
The name of the domain where the service account for Reporting Services is defined. |
VSTF_RS_USERID |
The account under which the SQL Server Reporting Services (for example, TFSREPORTS). runs to gather reporting data about Team Foundation Server. |
VSTF_USERID |
The account under which the service account for Team Foundation Server runs (for example, TFSSERVICE). |
Properties that Should Not Be Modified
The following sections define groups of properties that are related to each other. You should not modify these properties.
General Properties of the Application Tier
General Properties of the Data Tier
Properties of SharePoint Products and Technologies
Properties of SQL Server Reporting Services
Properties of Team Foundation Server Proxy
Properties that Define Application Pool Names and Service Names
Database Name Properties
General Properties of the Application Tier
The following table describes properties that define the location and access of the application tier for Team Foundation Server. All of these properties are specified in the msiproperty.ini file for Team Foundation Server. Some properties are also specified in the msiproperty.ini files for Team Foundation Server Proxy and Team Foundation Build.
.gif "Important note") Important Note: |
|---|
Do not modify these properties in an Msiproperty.ini file. You should set these properties when you run the installation wizard for Team Foundation Server. |
Property |
Description |
|---|---|
VSTF_APPLICATION_NAME |
The name of the Team Foundation Server application. The default value is VSTEAM. |
VSTF_AT_MACHINE_NAME |
The name of the application-tier server for Team Foundation. The default value is [ComputerName]. |
VSTF_ATTACHMENT_SHARE_NAME |
The name of the database that tracks attachments in work items for Team Foundation. The default value is WorkItemAttachments. |
VSTF_LOCAL_DOMAIN |
The name of the domain for the local user account (VSTF_LOCAL_USERID). |
VSTF_LOCAL_USERID |
The name of the local user account under which the Team Foundation Server Service runs. |
VSTF_NOTIFY_EMAIL |
The name of the e-mail address from which Team Foundation Server notifications appear to come. |
VSTF_PASSWORD |
The password of the service account for Team Foundation Server. |
VSTF_SERVICE_TYPE |
A value that indicates the service account type, whether it is a domain account (0) or a built-in account (1). |
VSTF_SMTP_SERVER |
The name of the server from which e-mail notifications are sent. |
VSTF_WEBSITE_ROOT_NAME |
The name that is assigned to the root Web site for Team Foundation Server. This property is defined for Team Foundation Server and Team Foundation Server Proxy. The default values are Team Foundation Server for Team Foundation Server and Team Foundation Server Proxy for Team Foundation Server Proxy. |
VSTF_WEBSITE_SERVER |
The name of the application-tier server for Team Foundation Server. This property is defined for Team Foundation Server and Team Foundation Server Proxy. |
General Properties of the Data Tier
The following table describes properties that define the location and access of the data tier for Team Foundation.
| Important Note: |
|---|
Do not modify these properties in an Msiproperty.ini file. You should set these properties in the installation wizard for Team Foundation Server. |
Property |
Description |
|---|---|
VSTF_DB_SERVER |
The name of the database instance that hosts the operational databases for Team Foundation. If you are connecting to a data-tier cluster, you must specify the name of the virtual-server cluster. The default value is [ComputerName]. Note:
For a single-server deployment, you must leave the value as [ComputerName].
|
VSTF_INSTANCE_NAME |
The name of the instance that you specified when you installed Microsoft SQL Server 2005. |
VSTF_SERVICES_CONNECTION_ STRING_DATASOURCE |
The text string that the application tier uses to connect to the data tier. This string defines the connectionString attribute in the Services Web.config file. |
VSTF_SERVICES_CONNECTION_STRING_DATASOURCE_HOSTNAME |
The text string that specifies the name of the data-tier server. |
Properties of SharePoint Products and Technologies
The following table lists the properties that define the location and access of the server that runs the version of SharePoint Products and Technologies that is used with Team Foundation Server.
| Important Note: |
|---|
Do not change the values of these properties. |
Property |
Description |
|---|---|
VSTF_INSTALL_WSS |
The setting that specifies whether to install Windows SharePoint Services. The default value is 1 (Yes). |
VSTF_WSS_ADMIN_HOST |
The name of the server that hosts the SharePoint Central Administration site. The default value is [ComputerName]. Note:
When the SharePoint Central Administration site is hosted on the application-tier server, the value must be set to [ComputerName].
|
VSTF_WSS_ADMIN_SCHEME |
The name of the protocol scheme set for the administration site for SharePoint Products and Technologies. The default value is http. |
VSTF_WSS_DOMAIN |
The name of the domain for the account that is used to run SharePoint Products and Technologies. |
VSTF_WSS_PASSWORD |
The password of the service account for SharePoint Products and Technologies. |
VSTF_WSS_SERVER |
The name of the server that hosts SharePoint Products and Technologies. The default configuration is to install Windows SharePoint Services on the same computer as the application-tier server for Team Foundation. The default value is [ComputerName]. Note:
When Windows SharePoint Services is hosted on the application-tier server, the value must be set to [ComputerName].
|
VSTF_WSS_SITE |
The URL of the default Web site for SharePoint Products and Technologies. The default is http://[ComputerName]. |
VSTF_WSS_SITE_FOLDER |
The name of the folder that is assigned to SharePoint Products and Technologies for Team Foundation Server. The default value is sites. |
VSTF_WSS_SITE_HOST |
The name of the server that hosts SharePoint Products and Technologies for Team Foundation Server. The default value is [ComputerName]. Note:
When SharePoint Products and Technologies is hosted on the application-tier server, the value must be set to [ComputerName].
|
VSTF_WSS_SITE_PATH |
The name of the path that is assigned to SharePoint Products and Technologies for Team Foundation Server. The default value is sites. |
VSTF_WSS_SITE_SCHEME |
The name of the protocol scheme set for the team sites for SharePoint Products and Technologies. The default value is http. |
VSTF_WSS_SITENO |
The number of SharePoint Products and Technologies Web sites at installation. The default value is 1. This value reflects that one site, the default Web site, is provisioned. |
VSTF_WSS_USERID |
The name of the service account for SharePoint Products and Technologies (for example, TFSWSS). |
Properties of SQL Server Reporting Services
The following table lists the properties that define access to SQL Server Reporting Services.
| Important Note: |
|---|
Do not change the values of these properties. |
Property |
Description |
|---|---|
VSTF_REPORTINGUSER |
The name of the data source account for SQL Server Reporting Services. The value is derived from [VSTF_RS_DOMAIN]\[VSTF_RS_USERID]. |
VSTF_RS_PASSWORD |
The password of the service account for Reporting Services. |
VSTF_VDIR_REPORTSERVER |
The virtual directory for the ReportServer Web site. The default value is ReportServer_MyInstanceName. |
Properties of Team Foundation Server Proxy
The following table describes properties that are specified only in the msiproperty.ini file for Team Foundation Server Proxy.
Note
For information about how to change configuration settings for Team Foundation Server Proxy, see How to: Enable Version Control Caching for Team Foundation Server Proxy and How to: Change Cache Settings for Team Foundation Server Proxy.
Property |
Description |
|---|---|
ATP_CACHE_DIR |
The directory path of the file cache. This directory contains one folder for each application tier for which the proxy is configured. The value specified defines the <CacheRoot> attribute in the configuration file for Team Foundation Server Proxy. The default value is Drive:\Program Files\Microsoft Visual Studio 2008 Team Foundation Server\Web Services\VersionControlProxy\Data. |
ATP_CACHE_SIZE |
A numeric value that represents the size limit of the cache, in megabytes. The value specified defines the <CacheLimit> attribute in the configuration file for Team Foundation Server Proxy. The default value is 200. |
ATP_VROOT |
The name of the virtual root directory defined for Team Foundation Server Proxy. The default value is VersionControlProxy. |
VSTF_ATP_MACHINE_NAME |
The name of the server that hosts Team Foundation Server Proxy. The default value is [ComputerName]. |
Properties that Define Names of Application Pools and Services
The following table describes those properties in the msiproperty.ini file that define the names of application pools and SQL Server services.
| Important Note: |
|---|
Do not change the value of a property for a service name. |
Property |
Description |
|---|---|
VSTF_APPPOOL_NAME |
The name of the application pool for Team Foundation Server. The default value is Microsoft Team Foundation Server Application Pool. |
VSTF_PROXY_APPPOOL_NAME |
The name of the application pool for Team Foundation Server Proxy. The default value is Microsoft Team Foundation Server Proxy Application Pool. |
VSTF_SERVICENAME_MSSQL |
The name of the service for SQL Server. The default value is MSSQL$MyInstanceName. |
VSTF_SERVICENAME_SQLAGENT |
The name of the service for SQL Server Agent. The default value is SQLAGENT$MyInstanceName. |
VSTF_SERVICENAME_SQLFTE |
The name of the service for SQL Server FullText Search. The default value is MSFTESQL$MyInstanceName. |
VSTF_SERVICENAME_SQLOLAP |
The name of the service for SQL Server Analysis Services. The default value is MSOLAP$MyInstanceName. |
Database Name Properties
The following table describes the properties that define the names of the Team Foundation databases.
| Important Note: |
|---|
Do not change the value of a property for a database name. |
Property |
Description |
|---|---|
TB_DB_NAME |
The name of the database for Team Foundation Build. The default value is TfsBuild. |
CTDATABASE |
The name of the database for tracking work items in Team Foundation. The default value is TfsWorkItemTracking. |
BISDBNAME |
The name of the registration database for Team Foundation. The registration database contains information about projects, areas, iterations, permissions, group membership, and other registration data. The default value is TfsIntegration. |
BISDWDBNAME |
The name of the database for Analysis Services, which contains the data for building the warehouse that Reporting Services uses. The default value is TfsWarehouse. |
H_DB_NAME |
The name of the version-control database for Team Foundation. The default value is TfsVersionControl. |
H_ADMIN_DB_NAME |
The name of the history database that contains a log of all Web service requests for Team Foundation Server that occurred in the last seven days. The default value is TfsActivityLogging. |
See Also
Concepts
Understanding the Data Warehouse Architecture