Install Retail Headquarters


This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

Applies To: Microsoft Dynamics AX 2012 R3, Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack

The Retail Headquarters component installs runtime components that are required to enable key aspects of Retail functionality, such as the screen layout designer. This component must be installed on the Application Object Server (AOS) computer and on Microsoft Dynamics AX client computers.


Retail components are available with Microsoft Dynamics AX 2012 R3, AX 2012 R2, and AX 2012 Feature Pack.

Before you install Retail Headquarters

  • On the computer where you plan to install this component, run the prerequisite validation utility to verify that system requirements have been met. For information about how to run the prerequisite validation utility, see Check prerequisites.

    For more information about the hardware and software requirements for Microsoft Dynamics AX, see the system requirements.

  • Before you install Retail Headquarters, we recommend that you install the AOS, Microsoft Dynamics AX clients, and the Microsoft Dynamics AX databases with all required models.

Install Retail Headquarters

Use this procedure to install Retail Headquarters. If you install other Microsoft Dynamics AX components at the same time, the installation pages vary, depending on the components that you are installing.

  1. Start Microsoft Dynamics AX Setup. Under Install, select Microsoft Dynamics AX components.

  2. Advance through the first wizard pages.

  3. On the Modify Microsoft Dynamics AX installation page, click Add or modify components, and then click Next.

  4. On the Add or modify components page, select Retail headquarters, and then click Next.

  5. On the Prerequisite validation results page, resolve any errors. For more information about how to resolve prerequisite errors, see Check prerequisites. When no errors remain, click Next.

  6. On the Ready to install page, click Install.

  7. After the installation is completed, click Finish to close the wizard.

After you install Retail Headquarters

After you install the Retail Headquarters component on AOS computers and Microsoft Dynamics AX client computers, you must initialize the retail configuration.


Before you initialize the retail configuration, make sure that you have specified a language and a postal address for each legal entity where you will set up retail stores.

  1. Open the Microsoft Dynamics AX client.

  2. Click Retail > Setup > Parameters > Retail parameters.

  3. Click Initialize.

  4. Close the Microsoft Dynamics AX client.

  5. In Windows, open the Services control panel.

  6. Restart the Microsoft Dynamics AX Object Server service.