EP Configuration – Single Web Server & Multiple AOS installations


How to configure multiple AX 4.0 Enterprise Portal sites on the same web server each pointing to a different instance of the .NET Business Connector, each with a different configuration pointing to different AOS?


By default , EP connects to the default configuration stored in the registry on the server.For the second EP on the same web server, create a new IIS virtual server in IIS and enable SharePoint and EP on this IIS virtual server as well.  Make sure they use differnet app pools ( even if the Identity / BC proxy account is the same).

On the Web server, make the following edits to the Web.config file in the wwwroot folder (for example, C:\inetpub\wwwroot where the Second Web server is installed in the C: drive):

 1) Add the Microsoft.Dynamics section group under <configSections>. Add the following text:

<sectionGroup name="Microsoft.Dynamics">

<section name="Session" type="System.Configuration.SingleTagSectionHandler, System, Version=1.0.5000.0, Culture=neutral,PublicKeyToken=b77a5c561934e089" />


2. Add the following Microsoft.Dynamics element under </system.web>. Add the following text to the file:


     <Session Timeout="15" Configuration="C:\Inetpub\wwwroot\axapta.axc" />


You can export the AX configuration pointing to the second AOS to a file  and refer it in the second step.

Note :

(1) Make sure you have two diferent app pools for these two IIS web sites even if the business connector proxy account is the same.
(2) Make sure the SharePoint site is registered in AX for the right AOS instance.( Administration -> Setup -> Internet -> Enterprise Portal -> Web sites)
(3) For Microsoft Dynamics Ax 2009, make sure both IIS Websites physical directoy ( for ex. c:\inetpub\wwwroot\vss\virtual directories\80\app_code) contains the "proxy" folder with proxy files. These files are generated for X++ classes used by EP when EP setup is run. If one of the virtual directory app_code folder does not have proxy files, you can either generate them manually from Ax Client -> Tools -> Development Tools -> Web Development tools -> Proxies or copy them from the other virutal directory if that exists 

Comments (30)
  1. mkraus81 says:


    i have the same problem..

    you solution don´t work…


        <Session Timeout="15" Configuration="C:Inetpubwwwrootaxapta.axc" />


    the parameter "configuration" will be ignored…

    can you please help me?

  2. mkraus81 says:

    oooh… sorry it work… i made a typing error.

  3. Oliver says:

    Hey meysun,

    I’m amazed to see this entry is the only article on the web adressing this exact scenario: Single Web Server, Multiple AOS installations.


    I’ve been trying the solution you provide, but keep getting a ‘File not found’ on a Sharepoint errorpage.

    Do you know of any resources describing the configuration settings possible in the web.config file?

    Thanks for the great post, and hopefully a quick response to my question 😉


  4. Venkatesh says:


    I had the same problem, but after seeing the solution that you have posted, everything’s fine.

    As you have stated, i have saved the .axc in my website folder.

    Now i can access EP with Admin login. But if any other user login to EP, an empty page shows up. I checked with the Server’s event viewer. It says


    Web session initialization for Microsoft Dynamics failed.

    Unknown user: <username>


    Microsoft Dynamics Business Connector Session 8.

    An X++ exception has occurred.

    Unknown user: <username>

    Please help me out!



  5. Mey M says:

    Make sure the user is configured in User relations in the AOS that you are connecting for the company of the web site

  6. S Butt says:

    I’ve followed the instructions above to get the portal working with LIVE AOS (at the moment its working on TEST AOS on the same box) and got the virtual IIS working but when I create the top level site and choose the template it still is showing the companies which are in the TEST AOS. Which means its not connecting to the LIVE. Also the C:Inetpubwwroot is the same path i’d used for new virtual IIS. Test one is using the same path as well. Any idea?

  7. sami says:

    i am a bigner for axapta web but i know the other,and i have just started by installing all necessary software like sharepoint and EP,

    but when i try to create website from EP wizard,it doesn’t work,what can i do???

    thanks in advance

  8. Gert-Jan says:


    I’ve tried making the changed to the web.config for the 2 sites I want to run.

    But I ran into the following problem.

    Only one of the two site can run at the same time.


    Portal 1 is at: http://localhost/ep

    Portal 2 is at: http://localhost:2716/testep

    When I go the portal 1 there is no problem it’s running fine, but as soon as I create portal 2, portal 1 becomes empty.

    So I recreate portal 1 but now portal 2 is empty.

    Can anyone help mee?

  9. sami says:


    i have a problem,

    error- .NET Business connector can’t find the session,the website doesn’t create.

    1-i am using 3 servers,one for Dynamic Ax,one for MOSS2007,the last one is for sqlServer(database),

    i try to install EP on sharepoint server and accessing the one which is server of Dynamic Ax database calling Dynamic,but is giving the above error,

    can you help me please brother????

    have a good time

  10. Mey M says:

    Make sure you have two diferent app pools for these two IIS web sites even if the business connector proxy account is the same.

    Also register the web site in the Ax client connecting to the right AOS

  11. rinusripsus says:

    Followed the procedure and confirm working.

    Thanks very much.

  12. Ken says:

    How would you handle hosting multiple EP sites on a AX 2009 configuration?  My initial thought was to create a seperate website for each AOS instance (different IIS ports).  Then create a sepearate SharePoint Web Application and then create the site collection manually from within SharePoint.  My only concern is how to tell SharePoint how to connect to my AOS instance.  Would you reference the AOS as outlined in your EP 4.0 example?  Any thoughts anyone has would be very helpful.

  13. Mey M says:

    Yes. You would reference the configuration file in web.config the same way you did in AX 4.0

  14. Prabhat says:

    Could you please help me out with the following scenario:

    I need to set up a DEV and TEST EP SITE which should hold different versions of the same content i.e., I will have two versions of the same Web Control (Which would be in the LAYOUTEP folder). How can I have such env setup and how can the sharepoint Layout and ControlTemplate folder be different for each web site ?

    Thanks in advance

  15. Sam says:


    I get a "The SiteMapProvider ‘DynamicsTopNavProvider’ cannot be found." error when trying to logon to the Sharepoint Central Administration 3.0 What could possibly be the problem ?

  16. wenni057 says:

    some aditional remarks.

    1 You place this code at the web.config file, so all site that use this one , have the same AOS, so different AOS’s on 2 sites both op Port 80 will not work.

    2 Check if the axc file works for an ordanary AX client!

    3 check that port number, server, and service name are placed in the ASC fine.

  17. Nits says:

    Hey, I have created new virtual server, What I need to do for enabling Sharepoint and EP ?

  18. Averied says:

    I get this error in eventvwr when I try to create the second site using the EP Template on sharepoint..


      en Microsoft.Dynamics.BusinessConnectorNet.Axapta.Logon(BC_PROXY_ACCOUNT_INFO* pBCProxyAccountInfo, String company, String language, String objectServer, String configuration)

      en Microsoft.Dynamics.BusinessConnectorNet.Axapta.LogonUsingBCProxyAccount(_SEC_WINNT_AUTH_IDENTITY_W* pImpersonatedUserAccount, NetworkCredential bcProxyCredentials, String company, String language, String objectServer, String configuration)

      en Microsoft.Dynamics.BusinessConnectorNet.Axapta.LogonAs(String user, String domain, NetworkCredential bcProxyCredentials, String company, String language, String objectServer, String configuration)

      en Microsoft.Dynamics.WebParts.SessionItem.Init()

    Any ideas?? The axc file is in it’s place and is working for a client

  19. Tutoo says:

    I have wss 3.0 installed on a Windows 2003 box and running Ax

    2009 with EP configured. I am unable to open the "Sharepoint Central

    Administration 3.0" site.

    "The SiteMapProvider ‘DynamicsTopNavProvider’ cannot be found. " is the

    error that is thrown.

  20. francesco says:

    I could not make it work.

    I have IIS 7.0 and there is no option "create a new IIS virtual server in IIS".

    Moreover I do not understand what does it mean "enable SharePoint and EP on this IIS virtual server".

    If someone could provide more detailed explanation    it would be helpful.

  21. Tomas says:


    I followed your instructions and got i to work om my local VPC image.

    However in our test-environment when installing the Role Center/EP (nr 2) I get the same error as described below:


    The files mensioned for deletion does not exist om my web-server so nothing to delete…

    This has the effect that the existing Ax-solution in SharePoint is retracted/deleted from SP.

    Any suggestions?

  22. Hi Tomas,

    From what I understand you problem is due to the absence of the AxWebPart.cab solution. With what I know this cab file should be present in the SharePoint for a successful installation of Enterprise Portal. Also this solution should be avaliable to both the website, this might need some exploration since it is possible to Deploy solution to multiple sites.

    To install the second site my recommendation would be not to use the setup as it will again try to install the solution. If possible to try to achieve all the setps manually, and finally Deploy axwebpart.cab file for the new second web site from the solutions management feature of SharePoint.

  23. Hakan Fatih YILDIRIM says:

    I have tried this on 80 port but web.config file gives a compilation error

    Unrecognized configuration section system.web/Microsoft.Dynamics.

    Any ideas ?

    Best Regards

  24. Andrey says:

    My setup is the folowin :Windows Server 2008 r2/SQL Server 2008 r2/Axapta 2009. So i have created secondary site linked it to another app pool. Put sharepoint objects inside -axwebaprts.cab is on secondary server also. Then i made proxies files from Ax they get there. Then i have made changes to web.config of the secondary web server. I also placed the axc for the needed configuration in there. I am still not sure what configuration should be there, I assumethe one i need to connect my EP secondary site 2. Then i open AX 2009 setup and start  EP portal setup. It show that the site will be created  on secondary site with the active Ax configuration I need to use. Finally when i open Ax i see that both new and old sites have the same content which is not from the new selected configuration

    So how to connect secondary EP site to show content from secondary axapta configuration and what i am doing wrong.

    Thanks in advance

  25. xvink says:

    Hi Meysun

    this indeed works for the .NET BC, but stil poses a problem when updating a site as Prabhat already mentioned.

    I used this solution to build a single webserver with multiple sites (development, test and acceptance). As this is a server with x64 O/S, I use the axupdateportal utility to deploy the websites from AX. When I run this utility, it first deploys the development, then the test and at last the acceptance portal. The problem arises when the utility exports the web controls from AX to Sharepoint. It does this to one single directory (layoutsep) for ALL installed portals. In my case, the acceptance portal is deployed last and so all web controls are from the acceptance environment.

    I can change the _layouts virtual directory of each site to refer to different layout directories, but the axupdateportal utility still deploys only to the layoutsep directory.

    Do you have any solution for this problem or is it just not possible?

  26. Mey M says:

    You have to map the different IIS Websites _layouts virutal directory to differnt physical folders.

    AXUpdatePortal will put the files to SharePoint layoutsep folder and you have to manually copy or write a job to copy to the right phycial folder mapping to your _layouts virutal directory.

  27. xvink says:

    Hi Meysun,

    thank you for your reply.

    How do I update only one site with the AXUpdatePortal? When I run it, it updates ALL sites, and thus the webcontrols in the layoutsep folder are the ones of the last updated site.  

  28. grajaa says:

    I am using 64-bit machine and have installed AX 2009 SP1, sharepoint 3.0 sp2 and ep. But I have issuse to Manage Deployments AX 2009>Administrator>Setup>Internet>Enterprise Portal>Manage Deployments>click "Manage Deployment cannot be run because Enterprise Portal is not deployed on this computer"  Then I tried AxUpdatePortal utility and cmd also but till i have that issue what I want to do Thanks

  29. Sudhir Paliwal says:

    I faced same problem for AX 2009 and solved it by changing port number from Business connector configuration through Admin tools>Ax 2009 configuration>Businesss connector.



Comments are closed.

Skip to main content