Applying Service Updates to On-Prem Environment in D365 F&O

 Hello Devs!

In case of On-Premises environments we need to apply service updates using CMD and below are the series of steps and commands.



Prerequisites:

1) Access to LifeCycle Services(LCS). 

Step 1 : 

 Login to LCS, Check for the latest available service updates and download it.

Download package and Unzip the package(Don't forget to unblock it before extracting, Right click and check unblock).

Step 2 :

Navigate to the folder where file has been extracted using CMD and Execute the below command to check for the installed versions of the services

ServiceUpdate2 is my folder where I have extracted the file. 

C:\ServiceUpdate2>AXUpdateInstaller.exe list

Copy and save the output for future use, In my case it look like this

Now, Edit DefaultTopologyData file placed within the extracted folder.  Add those services which we have copied in last step and change the machine name(In my case its VW-LAB-Dyndev1).

Step 3 :
We need to execute below series of command. 

Note : In my case the I was using C Drive and DP2 is my folder where I have extracted the file.

1) The folder in which the package is placed, it should be non user folder and there should be no space within title of the folder (All folders that are in file path)

Example : C/User/Download (Will result in error, User folder error)

C/Program files/Package (Will result in error, space within path).

Series of CMD commands:

You should rename the RunbookFile 

1) Check the available list of Runbook

C:\DP2>AXUpdateInstaller.exe list

2) 

C:\DP2>AXUpdateInstaller.exe generate -runbookid="AFPRunBookId-runbook" -topologyfile="DefaultTopologyData.xml" -servicemodelfile="DefaultServiceModelData.xml" -runbookfile="AFPRunBookId-runbook.xml"

Note : "AFPRunBookId-runbook" is the book title in my case, You have to set as per your case.

3) 

C:\DP2>AXUpdateInstaller.exe import -runbookfile=AFPRunBookId-runbook.xml

Note : "AFPRunBookId-runbook" is the book title in my case, You have to set as per your case.

4) 

C:\DP2>AXUpdateInstaller.exe execute -runbookid=AFPRunBookId-runbook.xml

5)

C:\DP2>AXUpdateInstaller.exe execute -runbookid=AFPRunBookId-runbook

It will take 3-4 hours as it involve more than 60 steps to be completed for successful service update. After the installation you can compare the versions.


Things to note :
1) Step may fails and it could be due to multiple issues for that we can check the log file placed in the same extracted folder and then "Rerun" the step again using below command.
In my case the command look like this
C:\ServiceUpdate2>AXUpdateInstaller.exe execute -runbookid="AFPRunBookId-runbook" -rerunstep=19

Standard command : 
AXUpdateInstaller.exe execute -runbookid=[runbookID] -rerunstep=[stepID]

2) There is a flaw in scrips from MS and normally step 24 fails due to reporting service error. Just restart the service and rerun the step again using above command or restart the service before step 24. 

Hope you find this information helpful.