Wednesday, September 17, 2014

How to Install multiple AX clients for different versions on same computer

Hi everyone!

Usually quite many people are working with more than only one version of the AX at the same time.
Having the client installed to own computer makes it easier to connect to different environments.

Installing AX 2009 and AX 2012 clients side by side is easy and can be done with just running the installer from the AX media as the clients are installed to different paths by default (C:\Program Files (x86)\Microsoft Dynamics AX\50\Client and C:\Program Files (x86)\Microsoft Dynamics AX\60\Client)


The problem


The problem comes when you should be having clients to different versions of AX 2012.
AX builds are by design backward compatible to earlier versions as long as the two first version numbers match (6.2.1000.4051 - R2 CU7 - kernel supports a 6.2.1000.156 - R2 CU1 - application version).
Though it is recommended by Microsoft to NOT to mix kernel versions of client and service itself, so that if you have service version of 6.2.1000.156 (AX 2012 R2 CU1) you should be using client with the same version number. 



To the solution


OK, so we should match our client version with the service version, but what if we have 2 clients with different service versions. One with AX 2012 R2 CU6 and one with AX 2012 R3. In this case the R3 client is not even backward compatible with R2 CU6 service and even if it was, it wouldnt be supported by Microsoft.

If we try to install AX 2012 R3 client to a computer that already has AX 2012 R2 client installed, we only face an error message saying: "An older version of Microsoft Dynamics AX has been detected"

The solution is to copy the contents of AX client folder to a new folder on the same path (e.g. C:\Program Files (x86)\Microsoft Dynamics AX\60\Client_R3)
and use separate applications to match the versions of clients and the services.


Install multiple AX 2012 Clients on same computer


So, we can have AX 2009 client and AX 2012 clients installed at the same time, but now we need a new client for AX 2012 R3 RTM. We cant install a new client with installer, because older version of the client for AX 2012 already exists.

Here is what we have to do.
  1.  AX 2012 client folder is by default located in C:\Program Files (x86)\Microsoft Dynamics AX\60\Client
    Now we have to create a new folder with a different name (e.g.
    Client_R3)



  2. Install AX 2012 R3 client to a computer that does not have previous versions of AX 2012 client installed. (e.g. the R3 AOS server)
  3. Create a configuration file (.axc) for your AX 2012 R3 environment with Microsoft Dynamics AX Configuration Utility
  4. Copy the content of your R3 Client folder to your computer to Client_R3 folder that you just created.
  5. Copy the configuration file for the R3 environment to your computer

  6. Create a shortcut for your R3 Client and add the path to your configuration file after the target application path (e.g. "C:\Program Files (x86)\Microsoft Dynamics AX\60\Client_R3\Bin\Ax32.exe" "C:\AX client configurations\AX2012R3.axc")


    Rename the shortcut to correspond the environment it is connecting to.
  7. Repeat to get a client for each service version that you need to get connected to.
Congratulations, now you have AX client for all versions on same computer!

7 comments:

  1. You can't just copy the files because assemblies that AX client requires won't be in GAC which are normally installed by the AX installer. AX client will not function properly with this method.

    ReplyDelete
  2. We were able to create an R2 CU7 client and an R3 client on the same workstation. Everything seemed ok until we tried to run a report.
    The R2 client doesn't appear to be able to find the correct DLLs to run the report.
    Did you have this issue and were you able to resolve it?

    ReplyDelete
    Replies
    1. Hi,
      No i did not have this issue.

      Have you solved this issue yet? if not, could you send me more information about this so i could look up for it?

      Delete
    2. Also, better alternative for this whole post would be to create virtual machines for different environments to your workstation.

      Delete
  3. We are also facing Report Issue.

    Peter, were you able to resolve it?

    ReplyDelete
  4. http://axtechblog.blogspot.com/

    ReplyDelete
  5. Very nice article. Is there a way to have AX2012R2 & R3 run on the same system so I don't have to use two different machines?

    ReplyDelete