28 June 2019

D365FO: update local Hyper-V dev environment

It is possible to update local Hyper-V machine, running D365FO image provided by Microsoft, to a new release. Run the following steps before installing update deployment package to make the update process smooth and easy:

  1. Edit C:\Windows\System32\drivers\etc\hosts file, add the following line:
    127.0.0.1 MININT-F36S5EH
  2. Download update deployment package from LCS, right mouse click on the file from File Explorer, click Unblock button. If Unblock button is not visible, the file is already unblocked
  3. Extract deployment package to a local folder. Open Command Prompt window, go to that folder and run the following command:
    AXUpdateInstaller.exe list

    This will list all the services installed on the current machine, which could be updated. Copy the list, edit DefaultTopologyData.xml and add all the services below existing AOSService. You should get something similar to the following:

    
    <?xml version="1.0" encoding="utf-8"?>
    <TopologyData xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
      <Name>AX topology</Name>
      <MachineList>
        <Machine>
          <Name>localhost</Name>
          <ServiceModelList>
            <string>AOSService</string>
            <!-- DefaultTopologyData are only for dev vhd, which we only support AOS update-->
            <!-- Create a new topology data for your Cloud AX topology-->
            <string>ALMService</string>
            <string>BIService</string>
            <string>DevToolsService</string>
            <string>DIXFService</string>
            <string>MROneBox</string>
            <string>PayrollTaxModule</string>
            <string>PerfSDK</string>
            <string>ReportingService</string>
            <string>RetailCloudPos</string>
            <string>RetailHQConfiguration</string>
            <string>RetailSDK</string>
            <string>RetailSelfService</string>
            <string>RetailServer</string>
            <string>RetailStorefront</string>
            <string>SCMSelfService</string>
          </ServiceModelList>
        </Machine>
      </MachineList>
      <BackupScript>
        <FileName />
        <Automated>false</Automated>
        <Description>Please backup your environment now, set this step to complete once you finished backup</Description>
      </BackupScript>
    </TopologyData>
Now you are ready to follow standard procedure to deploy a deployment package.

No comments:

Post a Comment