FIX: The Host Integration Server 2009 Configuration tool does not update any features that were already configured when you perform an unattended configuration
On a computer that is running Microsoft Host Integration Server 2009, you use the Configuration tool (Configuration.exe) to perform unattended configurations at a command prompt. Then, Host Integration Server features that were already configured are not updated. Therefore, any new configuration changes that are specified in the Host Integration Server configuration XML file for features that were already configured will not be implemented.
The following is one example of how this problem can be observed:
Configuration /s configuration XML file /l log file
Note The configuration XML file placeholder represents the path and the file name of the Host Integration Server 2009 configuration file (for example, C:\HIS2009_Server_Config.xml).
The configuration XML file that is specified in the command contains the updated password for the Host Integration Server service account, together with any other configuration changes that have to be made to the Host Integration Server configuration.
After the Configuration.exe command finishes, you will find that the Host Integration Server services cannot start because of a logon error. The error occurs because the Configuration tool cannot update the service account password.
The Host Integration Server Configuration tool does not let you reconfigure features that were already configured when you perform an unattended configuration.
Hotfix informationA supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing this specific problem. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.
If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.
Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft Web site: Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.
PrerequisitesYou must have Host Integration Server 2009 installed to apply this hotfix.
Restart informationYou do not have to restart the computer after you apply this hotfix.
Registry informationYou do not have to change the registry.
Hotfix Replacement informationThis hotfix does not replace any other hotfixes.
Hotfix file informationThis hotfix contains only those files that are required to correct the issues that this article lists. This hotfix may not contain of all the files that you must have to fully update a product to the latest build.The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
32-bit (x86) version
|File name||File version||File size||Date||Time||Platform||SP requirement|
64-bit (x64) version
|File name||File version||File size||Date||Time||Platform||SP requirement||Service branch|
The Host Integration Server 2009 Configuration tool can be run interactively to make configuration changes to the Host Integration Server system.
Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.
After you apply this hotfix, the Host Integration Server 2009 Configuration tool will update Host Integration Server features that were already configured when you perform unattended configurations. The Configuration tool will try to stop and restart the SnaBase service, and the other Host Integration Server services that depend on the SnaBase service, at the end of the unattended configuration process. Therefore, an unattended configuration should not be performed if users are connected to Host Integration Server, because they will lose their sessions when the services are restarted.
The following are some things to be aware of after you apply this hotfix to a Host Integration Server 2009 system:
- The SNA DDM service may not restart at the end of the configuration process. If this occurs, this service may have to be started manually if it is configured for Automatic startup in the Services Microsoft Management Console (MMC).
- If the unattended configuration process fails for any reason, the SNA RPC and SNA MngAgent services may stop even though the SnaBase service was not stopped. These services may have to be manually restarted after the failed configuration process.
- If any of the Host Integration Server services that depend on the SnaBase service cannot be stopped by the Configuration tool during the configuration process, the SnaBase service cannot stop. In this case, you have to manually stop and restart the SnaBase service and any other Host Integration Servers that must be running in order to enable the new configuration changes.
- If Host Integration Server 2009 is uninstalled after this hotfix is installed, the program listing for this hotfix is not removed from the list of installed updates in Add or Remove Programs on Windows Server 2003 or Windows XP, or in Programs and Features on Windows Server 2008 or Windows Vista.
For more information about software update terminology, click the following article number to view the article in the Microsoft Knowledge Base:
824684 Description of the standard terminology that is used to describe Microsoft software updates
Article ID: 972040 - Last Review: 10/07/2011 18:13:00 - Revision: 2.0
Microsoft Host Integration Server 2009
- kbexpertiseadvanced kbfix kbsurveynew kbqfe kbautohotfix KB972040