Exciting! Microsoft Dynamics AX 2012 R3 has been released. One of the major new features is the new Warehouse management module. This module also supports the use of mobile devices to register inventory transactions in the warehouse. The mobile application is HTML based and real-time. It support transactions for all kinds of inventory transactions such as receiving goods, putting, picking, cycle counting. This post will tell you how to install the Warehouse Mobile Devices Portal on a server.


Before I will go into the installation part, I will first share a picture which shows the architecture of the Warehouse Mobile Devices Portal. Simply explained: With help of the Internet Information Server, a webbrowser can access Work (specific warehouse task) and interact with it.


The mobile device communicates with the IIS server with http requests. The IIS server runs an application which communicates with the AOS via WCF services in XML. Some configuration on e.g. appearance is setup in AX and will be communicated to the IIS server. An example is the CSS style sheet which to use. In this way it is possible to have an own look and feel in the web application. Also this can be used to support efficiently more types of devices (small screens and larger screens).

How to install?

When you want to use mobile devices to register the work in the warehouse, you have to install the Warehouse Mobile Devices Portal. As shown in the picture above, Internet Information Server must be running on the machine where you want to install this application.

  1. Run Microsoft Dynamics AX Setup. Choose the option to Add or modify components.
  2. On the Add or modify compponents step, enable the option Warehouse Mobile Devices Portal.
  3. Some pre-requisites are checked. E.g. the Internet Information Server must be installed as well as the ASP.NET MVC version 2 runtime.
  4. When you need to configure the Warehouse Portal, you need to specify an user which is a user in Microsoft Dynamics AX as has the role Warehouse mobile device user assigned.
    Also note that the Default company of this user will determine for which company the portal will operate. I would recommend to create a dedicated (internal) user which is only used for running this portal application.
    WMDP1-09So within this step of the setup, you need to specify the internal user which meets the above mentioned requirements.
  5. Within the field Website port, you need to specify an IP port number which will be used to communicate between the web browser and the Internet Information Server. In my example I used port 13500.
  6. When you setup the portal, there is an uncommon additional step with Best practices. It gives unexperienced administrators some guidance which setup should be completed to have the mobile device working with the correct user and secure enough. You have to mark the Complete checkboxes to continue the setup.
  7. After the summary the AX setup will install the Warehouse Mobile Devices Portal.

When the setup is finished successfully, you can find the application in the folder C:Program files (x86)Microsoft Dynamics AX60. This folder contains a folder with an instance and application files to run the portal via the Internet Information Server. One of the subfolders contains the CSS style sheets. You can add or change the style sheets to have another look and feel.


When you open the Internet Information Services (IIS) Manager, you can notice the portal has been installed and you can review some settings.


When you want to run the Mobile device, you need to open an internet browser on a device and type the URL http://[Machinename]:[Website port]. In my example the machine name is AX2012R3 and the website port 13500 was specified in the Microsoft Dynamics AX setup. You can create a friendlier URL and redirect to the original URL.


Now you can Log on with a Work user and start moving the goods.

There is more…

Within my next post I will discuss how to setup and maintain multiple instances of the Warehouse Mobile Devices Portal.

That’s all for now. Till next time!

11 replies
  1. Mustafa Chohan
    Mustafa Chohan says:

    This is great post, but we are stuck with this installation. I just have following questions,

    * We have single server environment, do we need to modify port in Webconfig file.

    * What need to be the port for net.tcp://localhost:8201/DynamicsAx/Services/WHSMobileDevicesServices

    * Our default TCP IP Port is 2714 , whereas WSDL Port is 8104

    * We are getting error : Sorry, an error occurred while processing your request. Please retry your request or contact your system administrator. on clicking Log on to the mobile device

    • André Arnaud de Calavon
      André Arnaud de Calavon says:

      Hi Mustafa,

      This error can occur if you have used an user account for the mobile devices portal which is not a user in Microsoft Dynamics AX, or this user has not the appropriate rights in AX.
      You can look into the Windows event viewer for more details on the error. E.g. the next error could be logged when you have used a wrong user: “Object Server 01: An error has occurred in the services framework. Method: AifMessageInspector::AfterReceiveRequest. Error: System.ServiceModel.FaultException: Failed to logon to Microsoft Dynamics AX.”

  2. Mustafa Chohan
    Mustafa Chohan says:


    Thanks for response, we resolved the issue. The main problem was were using the old server R2 one. We un-installed R2 and installed R3 with contoso. Somehow setup was trying to connect to old R2 Ports, we update the web.config file with correct port and it worked.


  3. Sasidhar
    Sasidhar says:

    Installation completed smooth in AX2012R3, able to access the URL without any issues. When i login with the account it doesnt proceed further on the server. it still stays on the login screen.

    Any ideas ????? Can you suggest.

    • André Arnaud de Calavon
      André Arnaud de Calavon says:

      Do you have any error messages? If so, please go to the Microsoft Dynamics community and add a forum question. (http:/community.dynamics.com)

  4. Arun
    Arun says:


    We are facing same issue. We tried all methods posted on this forum but still no luck.

    1) While installing we gave 13500 as port, and updated it in web config file accordingly. 2)We also updated the username@domain field in the web config file. 3)We’ve also done the recommended settings in AX (WHM user role, creating a worker, assigning a default company). Could you please help us on this, we’ve been trying this from past few days.

    Thanks in advance!

  5. Manoj
    Manoj says:

    This is very good post. I tried to configure it till IIS Manager. When ever i tied to open Mobile Device Portal I am getting error “HTTP Error 503. The service is unavailable”. Can you please suggest where I am going wrong?

    Thanks in advance


    • André Arnaud de Calavon
      André Arnaud de Calavon says:

      Hi Manoj,

      Please check if in the IIS application pool if the portal is running or in a stopped state. If stopped, try to start it. If you encounter errors, you can search in the Windows events for possible reasons.

  6. Rohan
    Rohan says:

    Hi Andre,
    We have created a customization related to creating transfer orders in AX through WMDP.
    The code piece is working perfectly fine when we are testing it in AX using WHSWorkExecute form. But, when we try to access the same in the web browser, nothing works.

    The requirement is to create transfer order lines on a transfer order based on certain validations. The form works fine in AX but while opening in the web browser, it does not take any data and refreshes the same screen again and again.

    Is there any configuration that is missing? I would request if anyone can provide their input on this.


Leave a Reply

Want to join the discussion?
Feel free to contribute!

Leave a Reply

Your email address will not be published. Required fields are marked *

This site uses Akismet to reduce spam. Learn how your comment data is processed.