Tuesday, 14 May 2013

Document service / AIF ports deployment for Dynamics AX2012

Deploying AIF ports involve several steps, that's to export the ports data, import, and reactivate.
The steps below shows the process to deploy Inbound ports.

  1. Create AIF definition group
    - Login to source environment, go to path: System administration > Common > Data export/import > Definition groups
    - Create new definition group record, click "Clear" button to clear the other default options, click OK

    - Click "Select tables" and enter "AifInboundPort" in 'Name of table', check the checkbox for 'Apply criteria' & 'Specify related tables'
    (you may repeat all the steps with "AifOutboundPort" as the value in 'Name of table' for deploying Outbound ports)

    - Click "Select related tables".
    - Make sure the relationship level is 2, if it is not, then click on the "<<" or ">>" to adjust it.
    - Uncheck "BarcodeSetup" and "ExtCodeTable", then click "Select all remaining levels".

    - After "Select all remaining levels" is clicked, additional tables will be selected.

    - Summary showing more tables are selected.

    - If you wanted to export only some of the Ports, then click "Export criteria".
    - Create a filter on "Port name" field, then select the Ports that you wanted to export/deploy.

  2. Export AIF Inbound Ports
    - Using the definition group created above, export the data from source environment.

  3. Import AIF Inbound Ports
    - Login to destination environment, go to path: System administration > Common > Data export/import > Import.
    - Select the source file (exported in Step #2) and import (you may select Advanced > Update existing record if you’re updating).

  4. Deactivate the imported ports
    - After the import is completed, deactivate all the ports that you’ve just imported.
    - Path: System administration > Setup > Services and Application Integration Framework > Inbound Ports
    - Select the Port name and click on "Deactivate"

  5. Register services
    #Option 1
    Path: System administration > Setup > Checklists > Initialization checklist
    Expand the Initialize system node
    Click "Set up Application Integration Framework"

    #Option 2
    Path: AOT > Services > Right click on the services > Add-Ins > Register services
    *Do this for each of the services you need

  6. Update the ports configuration
    Update the configuration details for each of the imported port.
    Eg. Update the URI that were used in the source environment to URI that's based on paths in the destination environment.

  7. Reactivate each of the port imported earlier
    - Path: System administration > Setup > Services and Application Integration Framework > Inbound Ports > Activate
  8. Test the port
    Pick one of the port and go to its URI.

    Eg: http://<ServerName>:<PortNumber>/MicrosoftDynamicsAXAif60/TECAddressService/xppservice.svc?wsdl

    If it returns the correct XML format, it works OK.
    If it returns error such as "Handler "svc-Integrated" has a bad module "ManagedPipelineHandler" in its module list", then open Visual Studio 2010 command prompt and execute "aspnet_regiis.exe-i".

More details: