Share This Post

Dynamics AX Updates

Microsoft Dynamics AX Update Portal Utility

The AX Update Portal utility, installed with Microsoft Dynamics AX, can be used to deploy the Enterprise Portal sites. It can also be used to deploy the modifications or additions you have made to existing Enterprise Portal Sites. The utility makes deployment easier because it can deploy web-related changes to the Enterprise Portal site on an IIS site (virtual server) in just one step. It can also be used to deploy or update specific resources for the Enterprise Portal site.

Common Deployment Scenarios

You can have the multiple Enterprise Portal sites on an IIS site (virtual server). For example, you could have the development site and the live site. You would make modifications to the development site. After the modifications have been tested, you would deploy them to a live site. Typically, you do this by pointing 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 an Enterprise Portal site. You would repeat this procedure Enterprise Portal site where you want to deploy the changes. The AX Update Portal utility can make this process easier, by allowing you to deploy the updated resources to each of the sites in just one step.

Another common scenario is installing the new application for Enterprise Portal. To do this, you would import the resources for the new application from a .xpo file or a .axmodel file into the AOT. Then you would point the AOT to each Enterprise Portal web site and deploy the web-related items for a  new application to each site. The action to import new resources into the AOT has to be performed only one time. However, the deployment to an Enterprise Portal web site must be performed for each separate site and often involves multiple steps. The AX Update Portal utility can create this process easier. With it, you can deploy the new app to each specific Enterprise Portal site.

Using AX Update Portal

AX Update Portal

AX Update Portal

AX Update Portal.exe is the command-line utility that is installed with Microsoft Dynamics AX. The AX Update Portal utility is found in the following location on the IIS server on which an Enterprise Portal is installed:

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

On each Microsoft Dynamics AX client, AX Update Portal utility is found in the following location:

C:\Program Files\Microsoft Dynamics AX\60\EnterprisePortalTools

To see details of the commands that can be performed, type the following command:

AxUpdatePortal.exe

If you add the -iisreset parameter for the command, IIS will be reset after the update operation has been completed.

Examples

The following examples show common ways that the Dynamics AX Update Portal is used.

Listing Virtual Servers

A virtual server is the IIS web site that has been extended with SharePoint. To list the virtual servers and IIS websites for the current computer, use the following command:

AxUpdatePortal -listvirtualservers

This command may not be helped for some configurations of Enterprise Portal and Microsoft Dynamics AX. If you encounter the error when using this command, consider using the Get-SPWebApplication cmdlet to list the virtual servers. This cmdlet is part of the PowerShell cmdlets added with SharePoint.

Deploying a New Virtual Server Site

To deploy the new virtual server site to an IIS web server that already has Enterprise Portal installed, use the following command:

AxUpdatePortal –deploy –websiteurl http:// ServerName[:port]/Sites/SiteName

ServerName – The name of a server on which Enterprise Portal is running.

SiteName – The name of a new virtual server site.

Creating a site for a virtual server

If you deployed the new virtual server site but did not include the –createsite parameter, you can use the following command to create the Enterprise Portal site for that virtual server site:

AxUpdatePortal –createsite –websiteurl http:// serverName[:port]/Sites/SiteName

ServerName – The name of a server on which Enterprise Portal is running.

SiteName – The name of a virtual server site for which the Enterprise Portal site is being created.

Updating the web components on the Enterprise Portal site

To update the web components on the Enterprise Portal site, use the following command:

AxUpdatePortal –updateall –websiteurl http:// serverName[:port]/Sites/SiteName

ServerName – The name of a server on which Enterprise Portal is running.

SiteName – The name of a virtual server site for which the web components are to be updated.

The below table lists the web components that are updated:

AOT Location Items Deployed
\Web\Web Files\Web Parts  Any SharePoint web parts that have been included to the AOT.
Web\Web Files\Page Definitions  All page definitions
\Web\Web Files\List Definitions  All list definitions
Web\Web Files\Static Files  Static files such as the cascading style sheets and features.
\Web\Web Files\Web Controls  All User controls.
Web\Web Modules  All web modules

Updating proxies on an Enterprise Portal site

To update all of the proxies on the Enterprise Portal site, use the following command:

AxUpdatePortal –proxies –websiteurl http:// serverName[:port]/Sites/SiteName

ServerName – The name of a server on which Enterprise Portal is running.

SiteName – The name of a virtual server site for which all of the proxies are to be updated.

This command deploys the proxies for the Visual Studio projects from AOT that have the Deploy To EP property set to Proxies.

Updating the images on an Enterprise Portal site

To update all of the images on the Enterprise Portal site, use the following command:

AxUpdatePortal –images –websiteurl http:// serverName[:port]/Sites/SiteName

ServerName – The name of a server on which Enterprise Portal is running.

SiteName – The name of a virtual server site for which all of the images are to be updated.

Images from the Company Image, ECP Presentation, and the EcoRes Product Image tables are deployed to each Enterprise Portal site. Product catalog images are deployed as well.

Share This Post

Leave a Reply

avatar
  Subscribe  
Notify of
Skip to toolbar