Msmqinst.ini File Entries

The [Common Parameters] section in the Msmqinst.ini file specifies default options for all computers. Optionally, other [computer_name] sections for specific dependent client, independent client, and server computers specify settings that override the settings in the [Common Parameters] section for those computers and set settings for specific server types (for example the PSCs and BSCs).

Most of the Msmqinst.ini entries can appear in the [Common Parameters] section, a specific computer section, or both. Exceptions are noted in the following sections.

ControllerServer=: Setup searches for this entry when you install MSMQ independent clients and servers. This entry specifies the computer name of the site controller (PSC or PEC) for the independent client or server being installed. MSMQ dependent client setup does not use this entry because it gets the dependent client's controller server name from the supporting server (specified by SupportingServer=).
DataDevice=: Setup searches for this entry when you install a PEC, PSC, or BSC. This entry specifies both the location and size of the MQIS data device using the following format: <location>,<size>. For example:

	DataDevice=c:\msmq,50

The location specifies the drive and folder for the data device. The size is specified in megabytes, and must be an integer¾Decimal numbers are not allowed. For example, DataDevice=c:\msmq,50.5 is not valid

EnterpriseName=: Setup searches for this entry when you install a PEC. This entry specifies the enterprise name. The enterprise name can be up to 126 characters long, and can contain any characters.
SupportingServer=: Setup searches for this entry when you install an MSMQ dependent client. This entry specifies the computer name of the dependent client's supporting server. MSMQ dependent client setup doesn't automatically use this computer name, it is provided as the default. When Setup creates the default Msmqinst.ini file on an installation share, the SupportingServer= entry in the [Common Parameters] section is set to the computer name of the server. You can specify a different supporting server computer name for specific dependent clients by creating [computer name] sections for each dependent client and adding additional SupportingServer= entries.
IPAddresses=: Setup searches for this entry when you install MSMQ independent clients and servers. If you specify only a CN name, Setup associates the CN with all available IP addresses on the computer on which MSMQ is being installed. If you specify both a CN name and IP address, Setup associates only that specific IP address with the CN name. For example:

	IPAddresses=157.55.86.198,Seattle IP

You can specify multiple IP Address/CN pairs by separating them with semicolons (;). For example:

	IPAddresses=157.55.87.198,New York IP; 157.55.86.198,Seattle IP

Because Setup processes IPAddresses= entries from left to right, specific IP address/CN pairs that appear to the right of a CN name that appears without a CN address override previous settings. For example, on a computer with three IP addresses, the following setting sets two of the addresses to Seattle IP, and a third, specific address, to New York IP:

	IPAddresses=Seattle IP;157.55.86.198,New York IP

IPCNs=: Setup searches for this entry when you install the PEC. This entry creates an IP connected network for each name specified. Specify multiple CNs by separating the CN names with semicolons (;). For example:

	IPCN=Seattle IP;New York IP

IPXAddresses=: Setup searches for this entry when you install MSMQ independent clients and servers. If you specify only a CN name, Setup associates the CN with all available IPX addresses on the computer on which MSMQ is being installed. If you specify both a CN name and IPX address, Setup associates only that specific IPX address with the CN name. For example:

	IPXAddresses=00002402.00AA00BDCF04,Seattle IPX

Specify multiple IPX Address/CN pairs by separating them with semicolons (;). For example:

	IPXAddresses=00002402.00AA00BDCF04,New York IPX;
	00002402.00AA00BDCF04,Seattle IPX

Because Setup processes IPXAddresses= entries from left to right, specific IPX address/CN pairs that appear to the right of a CN name that appears without a CN address override previous settings. For example, on a computer with three IPX addresses, the following setting sets two of the addresses to Seattle IPX, and a third, specific address, to New York IPX:

	IPXAddresses=Seattle IPX;00002402.00AA00BDCF04,New York IPX

IPXCNs=: Setup searches for this entry when you install the PEC. This entry creates an IPX connected network for each name specified. Specify multiple CNs by separating the CN names with semicolons (;). For example:

	IPXCN=Seattle IPX;New York IPX

LogDevice=: Setup searches for this entry when you install a PEC, PSC, or BSC. This entry specifies both the location and size of the MQIS log device using the following format: <location>,<size>. For example:

	LogDevice=c:\msmq,8

The size is specified in megabytes, and must be an integer¾decimal numbers are not allowed. For example, LogDevice=c:\msmq,8.5 is not valid.

ServerType=: Setup searches for this entry when you install a PEC, PSC, BSC, or MSMQ routing server. This entry specifies which type of server to install. There are four valid settings: PEC, PSC, BSC, and RS.
SiteLinks=: Setup searches for this entry when you install a PSC. This entry specifies the link cost for each site using the following format: <sitename>,<linkcost>. Separate multiple sites with a semicolon (;). For example, to set the site link costs for two sites called NewYork and Seattle to 10 and 5, respectively, use the following entry:

SiteLinks=NewYork,10;Seattle,5

If no site name is specified but a site link cost is specified, the new site is linked to all existing sites with the specified number as the link cost.

Using a combination of the two previous examples, you can specify a default site link cost, and then specify specific site link settings for some sites that override the default. For example, the following SiteLinks= entry sets a default site link cost of 5 for the site links to all existing sites except the New York site¾that site link cost is set to 10:

SiteLinks=5; NewYork,10

SiteName=: Setup searches for this entry when you install a PEC or PSC. This entry specifies the name of the site to be created. The site name can be up to 31 characters long, and can contain any characters.
StopServices=: Setup searches for this entry when you install an MSMQ independent client or server. This entry specifies whether Setup can stop and restart the DTC and SQL Server services if either service is running. The two valid settings are Allow and Disallow. If StopServices=Disallow, Setup displays an error message stating that it cannot continue. The error message lists the currently running services that must be stopped for Setup to install MSMQ. Setup then exits. Setup assumes StopServices=True if it cannot find the entry
Semicolons (;): Setup ignores Msmqinst.ini file entries that begin with a semicolon (;). Use them to comment your Msmqinst.ini files.