Configure your environment with a dedicated Data Management Framework service
You can have dedicated nodes that contain Microsoft SQL Server Integration Services (SSIS), or you can install SSIS on other node types. If you want dedicated SSIS nodes, specify which machines host the node type by entering the details for the nodes in your ConfigTemplate.xml file.
If your use of the Data Management Framework (DMF) is low, you might not want to have dedicated nodes. Instead, you can specify which nodes SSIS is installed on. In the ServiceFabricCluster section of your ConfigTemplate.xml file, update the hasSSIS attribute to true for each virtual machine (VM). In this case, you should set the disabled attribute to true for the SSISNodeType node type in the ConfigTemplate.xml file.
Note
If you disable the SSISNodeType node type but don't set the hasSSIS attribute on any node, the scripts and installation logic provision the DMF service to all nodes of the BatchOnlyAOSNodeType type. If that node type doesn't exist, the DMF service is provisioned to all nodes of the AOSNodeType type.
New environments (10.0.32 and later)
If you deploy an environment as of Application Version 10.0.32, it contains a dedicated service for DMF.
Existing environments (10.0.31 and earlier)
If you deployed your Dynamics 365 for Finance + Operations (on-premises) environment before Application Version 10.0.32, you can manually configure it to use a dedicated service for DMF.
Important
If you use an environment that was deployed before Application Version 10.0.32, you must update the environment to Application Version 10.0.32 or later before you can configure it to use a dedicated service for DMF.
Use new nodes
For information about how to add a new node to your cluster, see Add an SSIS node to an existing environment.
Use existing nodes
Ensure that you download the latest infrastructure scripts. For information, see Update the infrastructure scripts.
If you don't already have a group managed service account (gMSA) for the DMF service, create it by updating your ConfigTemplate.xml file, and run the following command.
.\Create-GMSAAccounts.ps1 -ConfigurationFilePath .\ConfigTemplate.xml
Run the following script to create the file share.
.\New-FileShares.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -FileShareReference "dixf"
Run the following script to apply the required configuration and permissions to each file share.
.\Configure-FileShares.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -FileShareReference "dixf" .\Configure-FileShares.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -FileShareReference "aos"
If you want the DMF service to run on specific nodes, you can update your ConfigTemplate.xml file. Set the hasSSIS property to true for the nodes that you want.
Note
As of infrastructure scripts 2.20.0 and local agent 3.3.0, node tag management is automatically performed, and no action is required if a node is restarted. If you use an older version of the infrastructure scripts or local agent, you must run the following command from a node that belongs to the Azure Service Fabric cluster.
.\Set-SFDynamicNodeTags.ps1 -ConfigurationFilePath .\ConfigTemplate.xml
Export the certificates.
# Exports certificates into a directory VMs\<VMName>. All of the certs are written to the infrastructure\Certs folder. .\Export-Certificates.ps1 -ConfigurationFilePath .\ConfigTemplate.xml
Export the scripts.
.\Export-Scripts.ps1 -ConfigurationFilePath .\ConfigTemplate.xml -D365FOVersion <application version: i.e. 10.0.40>
Complete the prerequisites.
.\Complete-PreReqs-AllVMs.ps1 -ConfigurationFilePath .\ConfigTemplate.xml
Set up the following predeployment script: TSG_EnableDixfService.ps1.
In Microsoft Dynamics Lifecycle Services, use the Apply updates option to apply an update to the environment. The servicing flow automatically enables and deploys the new DMF service.