October 02, 2016

How to deploy a Package [AX7]

Hi Folks,
[Make sure you will run every application as admin]
I hope many of us already moved on Next version of Dynamics AX. Today I am going to demonstrate “How to Deploy a Package in AX7”. In current version, we have new architecture for code deployment. Now we don’t have the option for ad hoc import, like we did using XPO export import. Now AX is very different in terms of deployment, code movement and build etc, Please refer this post for more details this architecture.
Every customization must be moved using deployable package from one environment to another. There two ways to move this package on target environment.
A. Using LCS services.
B. Manual using command prompt.
Here I’ll show using command prompt, as I found its better than LCS (After successfully deploy many packages J)
Follow below steps,
clip_image002
1. Create Deployment Package:
Run VS as admin, Go to Dynamics AX menu. Select Create a deployment package as shown below.
clip_image003
Choose your package from list and path to save this file
image
Click on create.
It will take few minutes to complete this process.
2. Upload on LCS shared library:
However, we are not using LCS in this demo, but it’s always a good practice to maintain all deployment package on LCS. You can use this library to deploy this package to any environment that is part of your project.
Upload this file to LCS, shared asset library> S/w deployable package
clip_image007
Click on + button, Fill the details, select the package
clip_image008
Add file and, upload the same.
clip_image009
After upload done, click on confirm.
3. Open Other environment (RDP).
4. Copy this package to this box (Download this package from LCS there. OR copy paste there).
5. Now, first right click on zip file, unlock this. Expend it.
Now run this command for all child folders, unlock this zip file using PowerShell command
Get-ChildItem C:\Users\axlocaladmin\Downloads\ AXDeployablePackage_20160923_05_36_14-recurse | Unblock-File –Confirm
clip_image011
6. Generate runbook for this package.
    a. Open command prompt as administrator
    b. Navigate to your package folder
    c. Run below command
On any VM, run the following command to generate the runbook.
AXUpdateInstaller.exe generate –runbookid=[runbookID] –topologyfile=[topologyFile] –servicemodelfile=[serviceModelFile] –runbookfile=[runbookFile]
Here is an explanation of the parameters that are used in this command:
      i. [runbookID] – A parameter that is specified by the developer who applies the deployable package
      ii. [topologyFile] – The path of the DefaultTopologyData.xml file
      iii. [serviceModelFile] – The path of the DefaultServiceModelData.xml file
      iv. [runbookFile] – The name of the runbook file to generate (for example, AOSRunbook.xml)
Example
AXUpdateInstaller.exe generate -runbookid=" AXDeployablePackage_20160923_05_36_14-runbook" -topologyfile="DefaultTopologyData.xml" -servicemodelfile="DefaultServiceModelData.xml" -runbookfile=" AXDeployablePackage_20160923_05_36_14-runbook.xml"
The runbook provides the sequence of steps that must be run to update the environment. The following illustration shows an example of a runbook file. Each step in a runbook is associated with an ID, a machine name, and step execution details.
Sometimes runbook id will not generated correctly, so you have to manually update the same in runbook file. Simply copy your folder name and out it as runbook id in xml file.
clip_image013
This process will generate a runbook xml file into package folder.
7. Import the runbook by running the following command.
AXUpdateInstaller.exe import -runbookfile=[runbookFile]
Example
AXUpdateInstaller.exe import -runbookfile=" AXDeployablePackage_20160923_05_36_14-runbook.xml"
clip_image015
8. Verify the runbook.
AXUpdateInstaller.exe list
clip_image017
  1. Execute the runbook.
AXUpdateInstaller.exe execute -runbookid=[runbookID]
Example
AXUpdateInstaller.exe execute -runbookid=" AXDeployablePackage_20160923_05_36_14-runbook"
  1. Export the runbook.
AXUpdateInstaller.exe export -runbookid=[runbookID] -runbookfile=[runbookFile]
Example
AXUpdateInstaller.exe export -runbookid="VAL200AA2BMEDIU-runbook" -runbookfile="VAL200AA2BMEDIU-runbook.xml"
AXUpdateInstaller updates the runbook file after each step is run on a VM. The runbook also logs information about each step.
clip_image019
Troubleshooting:
1. Sometimes you will get some issue on execution, so it’s better to rename the package folder and use old name in runbook.
For eg: If your package file name is like “AXDeployablePackage_20160923_05_36_14” Than you have to rename this folder as “AXDeployablePackage”. Now unlock this folder using PowerShell and try with further steps.
2. For more detail check below links.
https://ax.help.dynamics.com/en/wiki/installing-deployable-package-in-ax7/

-Harry

September 15, 2016

Menu buttons are not appearing on Dynamics AX application

Hi Folks,

When you access AX application on DEV/TEST/SAND box (server directly) you will miss several menu/option buttons.

clip_image001

clip_image002

clip_image004

Same issue is with LCS portal.

clip_image005

clip_image007

To fix this issue, just add both URL as trusted site. To do this follow below easy steps:

1. Open Internet explorer

2. Go to Option->Security->trusted site and add both there

clip_image008

clip_image010clip_image011

Now open refresh your pages and check….

clip_image013

clip_image014

Now it look more catchy , isn’t it.