"Metadata for object of type XmlPort with id xxxxx is in a failed state" error message when you run an XMLPort in the RoleTailored client in Microsoft Dynamics NAV 2009

Hotfix information

A supported hotfix is available from Microsoft. There is a "Hotfix download available" section at the top of this Knowledge Base article. If you are encountering an issue downloading, installing this hotfix, or have other technical support questions, contact your partner or, if enrolled in a support plan directly with Microsoft, you can contact technical support for Microsoft Dynamics and create a new support request. To do this, visit the following Microsoft website:

https://mbs.microsoft.com/support/newstart.aspx

You can also contact technical support for Microsoft Dynamics by phone using these links for country specific phone numbers. To do this, visit one of the following Microsoft websites:

Partners

https://mbs.microsoft.com/partnersource/resources/support/supportinformation/Global+Support+Contacts

Customers

https://mbs.microsoft.com/customersource/support/information/SupportInformation/global_support_contacts_eng.htm

In special cases, charges that are ordinarily incurred for support calls may be canceled if a Technical Support Professional for Microsoft Dynamics and related products determines that a specific update will resolve your problem. The usual support costs will apply to any additional support questions and issues that do not qualify for the specific update in question.

After you apply this hotfix, the exception does not cause an unexpected crash. In this situation, a handled error message is written to the Application log instead.

How to obtain the Microsoft Dynamics NAV hotfix or update files

After you request a Microsoft Dynamics NAV hotfix, a hyperlink will be sent to you in an e-mail.


The e-mail will contain a hyperlink and a password. You can use the hyperlink to download the Microsoft Dynamics NAV hotfix or the update files. When you click the hyperlink, the File Download – Security Warning dialog box opens. Then, you are prompted to run, to save, or to cancel the download.


If you click Run, the files start the download and the extraction process. You must specify a folder for the new files, and then provide the password.


If you click Save, you must specify a path for saving the compressed file. When you open the file that you saved, you are prompted to specify a path for the files. Then, you must provide the password provided in the e-mail.


If you click Cancel, the download process stops.

How to install a Microsoft Dynamics NAV hotfix or an update file

The Microsoft Dynamics NAV platform hotfixes and updates are made available as single files. To install a Microsoft Dynamics NAV hotfix or an update, you must replace the existing Microsoft Dynamics NAV installation files with the hotfix or the update files. To do this, follow these steps.

Step 1: Replace the files in the Microsoft Dynamics NAV Classic Client installation

In the Microsoft Dynamics NAV Classic Client installation, replace the following files by using the hotfix or the update file. To replace the existing Microsoft Dynamics NAV files, follow these steps:

1. Close the Microsoft Dynamics NAV Classic Client.
2. Locate the Microsoft Dynamics NAV Classic Client installation directory. The Microsoft Dynamics NAV Classic Client is usually installed in the following directory:
   
   C:\Program Files\Microsoft Dynamics NAV\60\Classic
3. Copy the files that you downloaded.
   
4. Paste the files that you downloaded into the Microsoft Dynamics NAV Classic Client installation directory.
   
5. Click Yes to overwrite the files in the directory.

Step 2: Replace the files in the Microsoft Dynamics NAV RoleTailored client installation

In the Microsoft Dynamics NAV RoleTailored client installation, replace the following files by using the hotfix or the update file. To replace these files, follow these steps:

1. Close the Microsoft Dynamics NAV RoleTailored client.
   
2. Locate the Microsoft Dynamics NAV RoleTailored client installation directory. The Microsoft Dynamics NAV RoleTailored client is usually installed in the following directory:
   
   C:\Program Files\Microsoft Dynamics NAV\60\RoleTailored Client
3. Copy the files that you downloaded.
   
4. Paste the files that you downloaded into the Microsoft Dynamics NAV RoleTailored client installation directory.
   
5. Click Yes to overwrite the files in the directory.

Step 3: Replace the files in the Microsoft Dynamics NAV Server installation

In the Microsoft Dynamics NAV Server installation, replace the following files by using the hotfix or the update file. To replace these files, follow these steps:

1. Stop the Microsoft Dynamics NAV Server.
2. Locate the Microsoft Dynamics NAV Server installation directory. The Microsoft Dynamics NAV Server is usually installed in the following directory:
   
   C:\Program Files\Microsoft Dynamics NAV\60\Service
3. Copy the files that you downloaded.
   
4. Paste the files that you downloaded into the Microsoft Dynamics NAV Server installation directory.
   
5. Click Yes to overwrite the files in the directory.
6. Start the Microsoft Dynamics NAV Server.

Step 4: Replace the files in the Microsoft Dynamics NAV Application Server installation

If you have Microsoft Dynamics NAV Application Server installed, replace the following files in the Microsoft Dynamics NAV Application Server installation by using the hotfix or the update files. To replace the files, follow these steps.

1. Stop the Microsoft Dynamics NAV Application Server.
2. Locate the Microsoft Dynamics NAV Application Server installation directory. The Microsoft Dynamics NAV Application Server is usually installed in the following directory:
   
   C:\Program Files\Microsoft Dynamics NAV\60\Application Server
3. Copy the files that you downloaded.
4. Paste the files that you downloaded into the Microsoft Dynamics NAV Application Server installation directory.
5. Click Yes to overwrite the files in the directory.
6. Start the Microsoft Dynamics NAV Application Server.

Step 5: Replace the files in the Microsoft Dynamics NAV SDK installation

If you have Microsoft Dynamics NAV SDK installed, replace the following files.
To replace the files, follow these steps.

1. Locate the Microsoft Dynamics NAV SDK installation directories. The Microsoft Dynamics NAV SDK is usually installed in the following directories:
   
   C:\Program Files\Microsoft Dynamics NAV\60\SDK\CFRONT
   C:\Program Files\Microsoft Dynamics NAV\60\SDK\Communication Components
   C:\Program Files\Common Files\Microsoft Dynamics NAV\Communication Component
2. Choose the SDK to update, either C/Front or Communication Components.
3. Copy the files that you downloaded.
4. Paste the files that you downloaded into the appropriate Microsoft Dynamics NAV SDK installation directory.
5. Click Yes to overwrite the files in the directory.

Note If you downloaded a hotfix or an update for the communication components, you must register the .dll files individually.

Step 6: Replace the files in the Microsoft Dynamics NAV ODBC driver installation

If you have the Microsoft Dynamics NAV ODBC driver installed, replace the following files in the Microsoft Dynamics NAV ODBC driver installation. To replace the files, follow these steps.

1. Locate the Microsoft Dynamics NAV ODBC driver installation directory. The Microsoft Dynamics NAV ODBC driver is usually installed in the following directory:
   
   C:\Program Files\Microsoft Dynamics NAV\60\ODBC
2. Copy the files that you downloaded.
3. Paste the files that you downloaded into the Microsoft Dynamics NAV ODBC driver installation directory.
4. Click Yes to overwrite the files in the directory.

Prerequisites

You must have one of the following products installed to apply this hotfix:

• Microsoft Dynamics NAV 2009 R2
• Microsoft Dynamics NAV 2009 Service Pack 1 (SP1)

Special note for Microsoft Dynamics NAV 2009 Service Pack 1
Before you apply this hotfix to a Microsoft Dynamics NAV 2009 Service Pack 1 installation, make sure that the current Microsoft Dynamics NAV 2009 SP1 installation has build number 32074 or a later build number. For more information, visit one of the following Microsoft websites, depending on whether you are a partner or a customer:
Partner
Combined Hotfix Release for Microsoft Dynamics NAV 2009 SP1 and Microsoft Dynamics NAV 2009 R2

Customer
Combined Hotfix Release for Microsoft Dynamics NAV 2009 SP1 and Microsoft Dynamics NAV 2009 R2

If the build number of the current Microsoft Dynamics NAV 2009 Service Pack 1 installation is less than 32074, you must perform one of the following steps before you can install this hotfix:

• Install hotfix 2496107. For more information, click the following article number to view the article in the Microsoft Knowledge Base:
  2496107 Platform hotfix resource files for Microsoft Dynamics NAV 2009 Service Pack 1
• Perform a solution upgrade to Microsoft Dynamics NAV 2009 R2. For more information about how to perform a solution upgrade from Microsoft Dynamics NAV 2009 Service Pack 1 to Microsoft Dynamics NAV 2009 R2, visit the following Microsoft website:
  Install and Upgrade Instructions for Microsoft Dynamics NAV 2009 R2
  

For information about how to find the build number in Microsoft Dynamics NAV, visit one of the following Microsoft websites, depending on whether you are a partner or a customer:
Partner
How to Find the Build Number in Microsoft Dynamics NAV

Customer
How to Find the Build Number in Microsoft Dynamics NAV

Removal information

You cannot remove this hotfix.