Mass deploy retail updates and customizations by using System Center Configuration Manager [AX 2012]

Updated: November 18, 2014

Applies To: Microsoft Dynamics AX 2012 R3

Use the Retail Update generator with System Center Updates Publisher to automate and centralize the deployment of customizations and updates to the retail components of Microsoft Dynamics AX.

ImportantImportant

Mass deployment of customizations is supported only for the Retail POS and Retail Channel Configuration Utility.

The Update generator is part of the Retail mass deployment toolkit, which is a command-line tool that you can use to automate and centralize the deployment of the retail components of Microsoft Dynamics AX.

System Center Updates Publisher enables you to import software updates from external catalogs, create and modify update definitions, export updates to external catalogs, and publish updates to a configured update server. When you use Updates Publisher to manage updates and publish them to the update server, administrators can detect and deploy published updates to client and server computers by using System Center Configuration Manager. For more information about Updates Publisher, see the System Center Updates Publisher documentation.

This topic includes the following information:

Prerequisite

For more information

Install the toolkit

Install the Retail mass deployment toolkit

TipTip
To see the full list of commands that are available for the Update generator, open a Command Prompt window in the folder where UpdateGenerator.exe is installed, and type UpdateGenerator.exe -?. To see the parameters that are available for a command, run the command UpdateGenerator.exe -? -o <command> -?.

Install System Center Updates Publisher 2011

System Center Updates Publisher

Use the following procedure to mass deploy updates to Retail components. For more information about how to apply hotfixes and updates to Retail components, see Deploy updates in a retail environment.

  1. To find updates, go to Microsoft Dynamics Lifecycle Services, select a project, and then click Updates. In the Updates to include with new installations section, select the update package that you want, and download it.

  2. Open a Command Prompt window and change the directory to the folder where UpdateGenerator.exe is located. By default, the file is located at <Drive>:\Program Files (x86)\Microsoft Dynamics AX\60\Retail Scaleout Deployment\UpdateGenerator.

  3. Run the following command to generate a catalog file that contains metadata from the update package (.msp):

    UpdateGenerator.exe <Path to .msp file> -o <outputfile.cab>

  4. Start System Center Updates Publisher.

  5. Import the generated catalog file into Updates Publisher and create an update package.

    NoteNote

    For information about how to use Updates Publisher, see the series of videos on TechNet.

  6. Publish the software updates package to System Center Configuration Manager.

  7. From System Center Configuration Manager, deploy the software updates to a target collection. If you are updating the Retail Channel Configuration Utility, also run the Configure Retail Channel database task sequence to run the utility after it has been patched.

Use the following procedure to deploy customizations to Retail components. Mass deployment of customizations is supported only for Retail POS and Retail Channel Configuration Utility.

NoteNote

Retail SDK and Visual Studio must be installed to complete this procedure. For information about how to install Retail SDK, see Install Retail SDK (Retail POS Plug-ins).

  1. Create the customization. For more information about how to customize Retail POS, see Extend Point of Sale.

  2. Start Visual Studio.

  3. Open the following project: My Documents > Retail SDK > Scaleout Deployment > CustomizationDeployment > CustomizationDeployment.csproj.

  4. Open the CustomizationDeployment.xml file.

  5. Enter values for patchName and company.

  6. List the source files that are needed for the customization.

  7. If you are customizing Retail Channel Configuration Utility, provide the path where the utility is installed. The default installation path is provided as an example in the file.

  8. Include the customizations in the Files folder in your project.

  9. Build the project. The binary .exe file will be used to generate a software update in Updates Publisher.

  10. Open a Command Prompt window and change the directory to the folder where UpdateGenerator.exe is located. By default, the file is located at <Drive>:\Program Files (x86)\Microsoft Dynamics AX\60\Retail Scaleout Deployment\UpdateGenerator.

  11. Run the following command to generate a catalog file:

    UpdateGenerator.exe <Path to .exe file> -o <outputfile.cab>

  12. Start System Center Updates Publisher.

  13. Import the catalog file into Updates Publisher and create an update package.

    NoteNote

    For information about how to use Updates Publisher, see the series of videos on TechNet.

    Use the following information where applicable.

    Property

    Value

    POS Product ID

    C29E75E5-D606-40A6-A619-9F7C45067952

    Channel Configuration Utility (Database Utility) Product ID

    AEDE45DD-25BA-48ED-8FC5-FD08B6747545

    Registry key

    HKLM > SOFTWARE > CompanyName > CustomizationName > ComponentName, where the component name is either “Retail POS” or “Retail Database Utility”

  14. Publish the software update package to System Center Configuration Manager.

  15. From System Center Configuration Manager, deploy the update package to a target collection. If you customized the Retail Channel Configuration Utility, run the Configure Retail Channel database task sequence to run the utility after it has been patched.


Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).

Community Additions

ADD
Show: