Modifying the Properties of a Host Instance in the BizTalk Administration Console

Administrators use the BizTalk Administration console or WMI to modify host instances.

For information about the user rights required to change the properties of a host instance, see the "User rights required to manage host instances" section of Required User Rights for Managing BizTalk Hosts and Host Instances.

For information about using WMI to modify a host instance, see MSBTS_HostInstance (WMI).

You can modify the service account running a host instance. You can also disable a host instance. For example, if you want to preserve the settings for a host instance and you do not want it to start, you can disable it.

Host instances of trusted hosts and host instances of non-trusted hosts cannot use the same service accounts. If you want to change the trust setting of a host instance and the host instance uses a service account that other host instances use, you can do one of the following:

  • You can change the service account of the host instance for which you want to change the trust settings to a new service account.
  • You can change the service account of the host instance to an existing service account that other host instances with the same trust setting use.
  • You can delete the host instance, and re-create it with a different trust setting and service account.

Warning  You must change the credentials for a host instance by updating the properties of the host instance. If you change the credentials by using Microsoft Windows Server™ 2003 Services or Computer Management consoles, the host instance may not function properly.

Warning  If you change the credentials of a host instance, you must also change the corresponding SQL Server credentials. If you do not update the SQL Server credentials, the host instance will not function properly.

Warning  If you enter an incorrect password for a running host instance when you update the host instance credentials, the host instance state changes to "unknown." The inconsistent state change prevents you from starting or stopping the host instance service. To correct this, you must right-click the host instance, click Install, and type the correct password.

To modify the properties of a host instance

  1. Click Start, point to All Programs, point to Microsoft BizTalk Server 2004, and then click BizTalk Server Administration.
  2. In the Administration console, expand the Microsoft BizTalk Server 2004 (local) node, double-click Hosts, and then click the host.
  3. In the results pane, right-click the host instance, and click Properties.
  4. In the Properties dialog box, click Change to modify the service account information.
  5. In the Provide account information dialog box, do the following:
    Use thisTo do this
    Logon Type the name of the new service account under which the host instance will run.
    Password Type the password for the service account.
  6. Click OK.
  7. In the Confirm account information dialog box, do the following:
    Do thisTo do this
    NoClick to return to the Properties dialog box.
    YesClick to add an additional account. Repeat steps 5 and 6.
  8. In the Properties dialog box, click Disable to disable the host instance.
  9. Click OK.

See Also

Managing BizTalk Hosts and Host Instances

Adding Host Instances in the BizTalk Administration Console

Starting a Host Instance in the BizTalk Administration Console

Stopping a Host Instance in the BizTalk Administration Console

Deleting a Host Instance in the BizTalk Administration Console

To download updated BizTalk Server 2004 Help from www.microsoft.com, go to http://go.microsoft.com/fwlink/?linkid=20616.

Copyright © 2004 Microsoft Corporation.
All rights reserved.
Show: