Add a Host Instance

Overview

You can use the BizTalk Server Administration Console or Windows Management Instrumentation (WMI) to add host instances. In BizTalk Server you can only add a host instance to one server at a time. For more information about host instances, see Host Instances. For information about using WMI to add a host instance, see MSBTS_HostInstance (WMI) in the UI guidance and developers API namespace reference.

Adding a host instance maps the instance of a given host to an instance of BizTalk Server. If you have an existing host instance that you must repair, you can update the host instance properties. You must stop an existing host instance before you can add it again. For information about stopping a host instance, see How to Stop a Host Instance.

Prerequisites

To perform this procedure, you must be logged on as a member of the Administrators group and the BizTalk Server Administrators group.

In addition, you must also be a member of the db_securityadmin SQL Server Database role and the securityadmin SQL Server Role on the server(s) where the following databases are:

• BAM Primary Import (BAMPrimaryImport)

• BizTalk Management (BizTalkMgmtDb)

• BizTalk MessageBox (BizTalkMsgBoxDb) (all)

• BizTalk Tracking (BizTalk DTADb)

• Rule Engine (BizTalkRuleEngineDb)

Steps

1. Click Start, click All Programs, click Microsoft BizTalk Server 20xx, and then click BizTalk Server Administration.

2. In the console tree, expand BizTalk Server Administration, expand the BizTalk group, and then click Platform Settings.

3. Right-click Host Instances, click New, and then click Host Instance.

4. In the Host Instance Properties dialog box, do the following, and then click OK:

   Use this	To do this
   Host name	Displays the name of the host associated with the selected server.
   Server	Displays the server associated with the selected host.
   Logon	Displays the account name of the new service account under which the host instance will run.
   Configure	Click to display the Logon Credentials dialog box, where you can enter the account name and password of the account under which the host instance will run.
   Disable host instance from starting	Select this check box to change the status of the selected host from enabled to disabled. Disabling a host instance is useful if you do not want the host instance to start, but you do want to preserve its settings.

   After you install a host instance, you must start it so that it can route messages to the MessageBox databases. For information about starting a host instance, see How to Start a Host Instance.

Known Issues

A BizTalk Host instance is created with a status of "Uninstall failed" if the designated BizTalk Server runtime computer is not available during host instance creation

Problem

If the BizTalk Administration Console is installed on a machine that is remote to a BizTalk Server runtime computer, it is possible to attempt to create a host instance on the remote BizTalk Server computer even if the BizTalk Server computer is unavailable.

If you attempt to create an instance of a BizTalk host on a BizTalk Server computer that is unavailable, a dialog box with the following error message is displayed:

Installation of instace of host <host name> on server <server name> failed.

Additional information:

The RPC server is unavailable. (WinMgmt)

When you click OK to dismiss the dialog box, a dialog box with the following error message is displayed:

Cleaning up aborted installation of host <host name> on server <server name> failed.

Additional information:

A failure occurred when deleting the Windows NT service BTSSvc{<GUID>}. (WinMgmt)

When you click OK to dismiss this dialog box, the instance of the BizTalk host will be visible in the BizTalk Administration Console with a Status of Uninstall failed.

Cause

When a host instance is created, an entry is made in the BizTalk Management database before the host instance is installed onto the designated BizTalk Server computer. If the installation of the host instance onto the designated BizTalk Server computer fails, the BizTalk Administration program will attempt to uninstall the host instance but since the designated BizTalk Server computer is unavailable the uninstall fails as well.

Resolution

If a BizTalk host instance is created in the BizTalk Admininstration Console with a status of Uninstall failed, delete the host instance and recreate the host instance after the designated BizTalk Server computer becomes available.

See Also

Managing BizTalk Hosts and Host Instances Start a Host Instance Stop a Host Instance Delete a Host Instance Modify Host Instance Properties