Multisite activation within the upgrade process

Customers upgrading from Microsoft Dynamics AX 2009 will need to activate Multisite Inventory prior to upgrading to Microsoft Dynamics AX 2012. Some customers will have already setup their system for multisite in some of their companies and will be notified during the readiness checks that multisite must be activated in their remaining companies prior to upgrading. This activation is handled by the standard Multisite Activation Wizard found under Administration - Setup - Multisite activation.

Customers upgrading from Microsoft Dynamics AX 4.0 have no option within the core product to setup multisite inventory because that feature was not introduced yet. These customers will need to specify their multisite inventory settings as part of the data upgrade checklist. The validation message for this particular section is somewhat misleading, and the current Upgrade Guide PDF file has the wrong checklist menu item name.

There are three typical validation messages that can arise due to multisite activation, and two of the messages listed here require the user to go through the Configure site structure step within the Prepare application data for preprocessing section of the checklist. However, that checklist section doesn’t get activated right away which makes it seem like the user cannot take the right action.

The following message will appear if there are any custom tables in the system which use the InventDimID extended datatype.

  • ·         Method Name: validateFullInventDimIdImpl
  • ·         Message: Fields referencing the inventory dimensions (InventDim) table have been added. Multisite activation code is missing for the following fields:
  • ·         Resolution: Add upgrade scripts

The resolution in this case of custom inventDimID fields is very generic and misleading. Clicking on the Details button will display a list of all the new fields and the tables that contain those fields, and would appear something like this:

The correct resolution to the issue with new custom dimensions is to inspect the dimension ID fields that are presented and determine if those records should have the InventDimID values changed so that they now include a default site. Once the decision is made for the fields, the next step is to customize the methods which list all of the InventDimID fields in the system in either a process list or an ignore list. In Microsoft Dynamics AX 4.0, the methods are found here:

  • ·         Class Name: DEL_InventSiteCheckFieldRegistrator_Core
  • ·         Method for processing: registerUpdateableFields
  • ·         Method for ignoring: registerNotUpdateableFields

In Microsoft Dynamics AX 2009, the methods are found here:

  • ·         Class Name: InventSiteActivateDimFieldsCheck
  • ·         Method for processing: updateableFields
  • ·         Method for ignoring: notUpdateableFields

In both cases, it is fairly easy to copy existing lines from the script and then add new lines at the end using the table name and field name for the custom InventDimID fields.

The two methods and messages which require the Configure site structure step are:

  • ·         Method Name: validateSiteStructureDefined
  • ·         Message: The site structure is not configured.


  • ·         Method Name: validateFullSiteConfigCompleteness
  • ·         Message: The site configuration is not complete.

Both of those validation errors recommend to the user to "Complete the Configure site structure item in the Pre-upgrade checklist." In order to get the Configure site structure option enabled so this step can be completed, the user can press the Fix button in the bottom half of the window or wait until fixing all of the other validation errors and doing the steps in the Prepare application data section.

Filling out the Configure site structure window

This walkthrough continues to outline how to finish multisite activation during the upgrade process.

  1. 1.       On Microsoft Dynamics AX 4.0, on the Prepare application data for upgrade checklist, the Configure site structure option is enabled, and the window can be opened (the menu option will not appear on Microsoft Dynamics AX 2009). On AX 2009, the option would need to be chosen prior to loading the upgrade XPO and can be found under Administration - Setup - System - Multisite activation.

  1. 2.       The user must create at least one site for each company that will be used for defaulting, regardless of if the company has any data in it. This is done by clicking the New record button or typing Ctrl-N to create new records. More than one site can be created for each company, but the site IDs must be unique across all companies, which means that you cannot define site 01 for both DMO and DAT companies for example.
  2. 3.       After creating the sites, switch to the Warehouses tab, and every warehouse must be assigned to one of the sites that were just created.
  3. 4.       After assigning sites to all warehouses, switch to the Work center groups tab and assign every record a site.
  4. 5.       Next, the user switches to the Defaults tab and has to assign a default site, warehouse and fallback warehouse for each company. The default warehouse will be created by the process and cannot currently exist in the company. It may be necessary to log in to some of the companies to create a warehouse to be able to use as the fallback warehouse in order to complete this window. If you do create a new default warehouse, you will need to close the Configure site structure window and re-open it to assign that default warehouse to a site on the Warehouses tab.
  5. 6.       After the window is filled out, clicking the Set to ready for upgrade button will launch a Validate multisite configuration wizard. Press Start on the wizard and if any errors arise, print the report and correct the errors until all is successful.