AxUpdatePortal Utility

The AxUpdatePortal utility, installed with Service Pack 1 of Microsoft Dynamics AX, is often needed when deploying changes, such as modifications, or additions, you have made in other existing External Portal Sites. It will help you deploy Web-related changes to all Enterprise Portal sites on an IIS server in just one step.

Important

The AxUpdatePortal utility does not create new Web sites. It only helps deploy incremental changes to existing Enterprise Portal sites.


Common Deployment Scenarios

You can have multiple Enterprise Portal sites on an IIS server. For example, you could have a "development" site and a "live" site. You would make modifications in the development site. After the modifications have been tested, you would deploy them to the live site. Typically, you do this by pointing the AOT to the Enterprise Portal site to which you want to deploy the changes. In the AOT, you will deploy the Web-related items to the Enterprise Portal site. Repeat this procedure for each Enterprise Portal site where you want to deploy the changes.

Another common scenario is installing a new application for Enterprise Portal. To do this, you would import the resources for the new application from an .xpo file into the AOT. Then you would point the AOT to each Enterprise Portal Web site and deploy the Web-related items for the new application to each site. The action to import the new resources into the AOT has to be performed only one time. However, the deployment to the Enterprise Portal Web site must be performed for each separate site and often involves multiple steps.

Using AxUpdatePortal

AxUpdatePortal.exe is a command-line utility that is installed with Service Pack 1 for Microsoft Dynamics AX. This utility can update all the Enterprise Portal Web sites on an IIS server with the Web-related items from the AOT.

The AxUpdatePortal utility is found in the following location on the IIS server on which Enterprise Portal is installed:

C:\Program Files\Microsoft Dynamics AX\50\Setup

When you run AxUpdatePortal.exe, it deploys the Web-related items from the AOT to every Enterprise Portal site on the IIS server. If you are running Enterprise Portal on multiple servers, you must run AxUpdatePortal.exe on each server.

The AxUpdatePortal.exe is run from a command line, and must be run with administrative privileges. If you are running the AxUpdatePortal.exe on a system that uses User Account Control (UAC) you must open the Command Prompt by right-clicking on it in the Start menu and choosing Run as administrator.

The following examples show the common ways the utility can be run.

AxUpdatePortal

AxUpdatePortal -updateWebSites

AxUpdatePortal -verbose > "C:\EPUpdate.log"

AxUpdatePortal -iisreset

AxUpdatePortal -updateWebSites -verbose > "C:\EPUpdate.log"

If AxPortalUpdate.exe is run without parameters, it deploys the following items from the AOT to the IIS server. These items are deployed to each virtual server (port) on the IIS server.

AOT Location

Items Deployed

\Resources

Image files

\Web\Web Files\Static Files

Static files such as cascading style sheets, and features.

\Web\Web Files\Static Files\Proxies

All proxies. Existing proxies are deleted first.

\Web\Web Files\Web Controls

All User controls.

\Web\Web Files\Web Parts

Dynamics AX Web parts.

\Web\Web Files\Site Definitions

AxSiteDef_v3_xip.

\Web\Web Files\Site Templates

All site templates.

Images from the CompanyImage, EmplTable, and ECPPresentation tables are also deployed to each Enterprise Portal site.

If you include the -updateWebSites parameter, the items listed earlier in this section are deployed to the IIS server. In addition, the following items are deployed from the AOT to each Enterprise Portal site on the IIS server:

AOT Location

Items Deployed

\Web\Web Files\Page Definitions

All page definitions

\Web\Web Files\List Definitions

All list definitions

If you include the -iisreset parameter, IIS will be reset after all the Enterprise Portal sites have been updated.

If you include the -verbose parameter, the AxUpdatePortal utility will display detailed information about what items are being deployed. Typically, you will direct this output to a log file as shown in the following example:

AxUpdatePortal -updateWebSites -verbose > "C:\EPUpdate.log"

Important

The AxUpdatePortal utility does not deploy items from the \Web\Web Modules node of the AOT. If you have added or made changes to Web Module items in the AOT, you must deploy these changes manually from the AOT.