Export (0) Print
Expand All
1 out of 2 rated this helpful - Rate this topic

Setup parameters reference [AX 2012]

Updated: March 27, 2014

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

The following table lists the parameters that control the general behavior of Setup. For example, the parameters are used to specify a parameter file, display or hide the Setup wizard, and specify the location of all related files.

Parameter

Default value

Description

AcceptLicenseTerms

0

Specify whether you want to accept the terms of the license agreement.

  • 0 – Do not accept the license terms.

  • 1 – Accept the license terms.

If HideUI=1, AcceptLicenseTerms must be set to 1. If AcceptLicenseTerms=0, an error message is displayed, and installation cannot continue.

If HideUI=0, the License Terms screen is displayed, regardless of the setting of AcceptLicenseTerms.

ImportantImportant

Only models that are published by Microsoft are covered under the license terms for Microsoft Dynamics AX.

LogDir

See the description.

Specify where the log files for the Setup, Setup Support, and Windows installers are saved.

By default, the following path is used:

%<Program Files>%\Microsoft Dynamics AX\60\Setup Logs\YYYY-MM-DD HH:MM-SS

NoteNote

When log files are saved to the default location, they are arranged in dated folders to protect existing log files from being overwritten. If you override the default LogDir value, the logs are saved to the exact folder that you specify. Any existing log file in that folder is overwritten.

The path can be fully qualified, or it can be relative to the location of the Setup.exe file. Relative paths can include upward qualifiers, such as "..\..\".

InstallPath

%ProgramFiles%\Microsoft Dynamics AX\60

Specify the root path for all Microsoft Dynamics AX files that are installed on a computer.

InstallPath32Bit

%ProgramFiles(x86)%\Microsoft Dynamics AX\60

Specify the root path for all 32-bit Microsoft Dynamics AX files that are installed on a computer. This parameter is valid only when you install Microsoft Dynamics AX components on a 64-bit operating system. You cannot specify the same path for both 64-bit and 32-bit files.

ResetIIS

1

Specify whether you want Internet Information Services (IIS) to be restarted after Microsoft Dynamics AX is installed.

  • 0 – Restart IIS after installation.

  • 1 – Do not restart IIS after installation.

This parameter is used when you install web services on IIS, reporting extensions, and Enterprise Portal for Microsoft Dynamics AX.

UpdatesPath

<DVD directory>\Updates

Specify the location of updates that have been downloaded for Microsoft Dynamics AX. This includes updates for the Setup application.

ConfigurePrerequisites

0

Specify whether mandatory prerequisites are installed and configured automatically as part of Setup.

  • 0 – Do not install and configure mandatory prerequisites.

  • 1 – Install and configure all mandatory prerequisites.

Setup does not automatically configure optional prerequisites.

HideUI

0

Specify whether the Setup wizard is displayed.

  • 0 – Display the wizard.

  • 1 – Hide the wizard, and run Setup in silent mode.

OptInCEIP

1

Specify whether you want to participate in the Customer Experience Improvement Program.

  • 0 – Opt in to the Customer Experience Improvement Program.

  • 1 – Do not opt in to the Customer Experience Improvement Program.

For more information about the Customer Experience Improvement Program, see http://go.microsoft.com/fwlink/?LinkId=221577.

UseMicrosoftUpdate

0

Specify whether you want the current computer to participate in Microsoft Update.

  • 0 – Opt in to Microsoft Update.

  • 1 – Do not opt in to Microsoft Update.

If the current computer already participates in Microsoft Update, this parameter is ignored.

ParmFile

None

Specify the path of a file that contains other parameters.

If you use this parameter, it must be the only parameter, and the parameter file must contain all the other parameters that you want to specify.

In the parameter file, each parameter's Name=Value combination must be on a separate line. You can use ExampleParmFile.txt, which is available in the DVD\Support folder, as an example.

NoteNote

Do not include double quotation marks in parameter files. Because line returns are used as delimiters in a parameter file, values that otherwise require double quotation marks do not require them here.

To prevent a line in a parameter file from being run, type a number sign (#) before the line.

The path can be fully qualified, or it can be relative to the location of the Setup.exe file. Relative paths can include upward qualifiers, such as "..\..\".

The following table lists the parameters that control how Setup interacts with the Microsoft Dynamics AX databases.

Parameter

Default value

Description

InstallDatabase

0

Specify whether the Microsoft Dynamics AX database is created.

  • 0 – Do not create the database.

  • 1 – Create the database, unless a database of the same name already exists.

  • 2 – Create or replace the database.

DbSqlServer

The default database instance on the local computer

Specify the instance of SQL Server to connect to. The instance can be specified as a server, or as a fully qualified server and instance.

This parameter is valid and required only if InstallDatabase > 0, or if InstallAos=1.

DbSqlDatabaseName

MicrosoftDynamicsAx

Specify the name of the SQL Server database.

The database name must not include spaces or any of the following characters: backslashes (\), slashes (/), periods (.), commas (,), colons (:), brackets ([ ]), parentheses (( )), or hyphens (-).

This parameter is valid and required only if InstallDatabase > 0.

SkipSignatureVerification

0

Specify whether digital signatures for model files are verified.

  • 0 – Verify digital signatures for model files.

  • 1 – Do not verify digital signatures for model files.

Security noteSecurity Note

If you import an unsigned model file to the model store, you create a security risk. We recommend that you not use this parameter unless you are confident that a model file is safe to install.

DbSqlModelStoreBaseline

MicrosoftDynamicsAxBaseline

Specify the name of the database that is used for the baseline model store.

Caution noteCaution

Do not use this parameter. We recommend that you install the baseline model store by using the Setup wizard.

DbConnectionTimeout

The default value for the database

Specify the time-out value for the database connection. The value that you set overrides the default value for the database connection time-out, 30 seconds. In most cases, we recommend that you not change this value. However, if the database server is on a remote computer, you may have to increase the time that is allowed for Setup to connect to the database.

AdditionalModelFiles

None

Specify the optional models to install. To include multiple model files, separate the values by using a semicolon (;). If this parameter is not specified, no optional models are installed.

If an optional model file is not located in the DVD\Models folder, you must specify the full path of the file.

For example: AdditionalModelFiles=<Drive>:\<FolderLocation>\<model>.model

ImportantImportant

Only models that are published by Microsoft are covered under the license terms for Microsoft Dynamics AX.

UpgradeDB

0

Specify whether the database that an AOS instance connects to is marked for upgrade.

  • 0 – Do not mark the database for an upgrade.

  • 1 – Mark the database for an upgrade.

When you use this parameter, you also must supply the name of an AOS instance by using the AosInstanceName parameter. Setup uses the registry to obtain port information for the specified AOS instance. Therefore, it is not necessary to include parameters for port numbers.

ModelStoreBackupDir

NoteNote

This option is available only if Microsoft Dynamics AX 2012 R2 or AX 2012 R3 is installed.

None

Specify the location where the model store backup file is created during a database upgrade.

Make sure to select a drive with sufficient disk space for the model store backup.

If you specify a value for this parameter, it is not necessary to specify a value for the parameter ModelStoreBackupFile.

ModelStoreBackupFile

NoteNote

This option is available only if Microsoft Dynamics AX 2012 R2 or AX 2012 R3 is installed.

None

Use this parameter to import an existing model store backup file that has already been upgraded. Setup will import the backup file into the model store.

If you specify a value for this parameter, it is not necessary to specify a value for the parameter ModelStoreBackupDir.

The following table lists the parameters that control how Setup installs and removes Application Object Server (AOS).

Parameter

Default value

Description

InstallAos

0

Specify whether an instance of AOS is installed.

  • 0 – Do not install an instance of AOS.

  • 1 – Install an instance of AOS.

If the setting of AosInstanceName matches the name of an instance that was previously installed, and InstallAos=1, the Windows installer runs in maintenance mode and does not change any settings.

Up to 99 AOS instances can be installed.

AosInstanceName

MicrosoftDynamicsAx

Specify the name of the AOS instance. The name must be unique.

This parameter is required if InstallAOS=1.

You can optionally specify this parameter when you install components that require an AOS connection, such as the client.

AosPort

None

Specify the TCP/IP port number on which the AOS instance receives requests from the client or .NET Business Connector.

This parameter must be set to a numeric value between 1 and 65535.

You can optionally specify this parameter when you install components that require an AOS connection, such as the client.

AosWsdlPort

None

Specify the port number on which the AOS instance receives WSDL requests.

This parameter must be set to a numeric value between 1 and 65535.

You can optionally specify this parameter when you install components that require an AOS connection, such as the client.

AosStart

1

Specify whether Setup starts the AOS service after the AOS instance is installed.

  • 0 – Do not start the AOS service.

  • 1 – Start the AOS service.

UpgradeAos

NoteNote

This option is available only if Microsoft Dynamics AX 2012 R2 or AX 2012 R3 is installed.

0

Specify whether an instance of AOS is upgraded.

  • 0 – Do not upgrade an instance of AOS.

  • 1 – Upgrade an instance of AOS.

This parameter is valid only if InstallAOS=1.

When you use this parameter, you also must supply the name of an existing AOS instance by using the AosInstanceName parameter. Setup uses the registry to obtain port information for the specified AOS instance. Therefore, it is not necessary to include parameters for port numbers.

AosAccount

The Network Service account

Specify the account that the Windows service for AOS runs as. The AOS instance uses this account to connect to the Microsoft Dynamics AX database.

If you specify an account, the value must be in the format domain\account. You cannot specify your own account or a local computer account. You can specify a managed service account that is installed on the computer. To specify a managed service account, use the format domain\ServiceAccountName$.

AosAccountPassword

None

Specify the password that is associated with the AOS account.

If you use a managed service account, this parameter is not required.

If you use a standard domain account, you must specify a value for this parameter if you specify a value for the AosAccount parameter.

AosNetTcpPort

None

Specify the port number on which the AOS instance receives net.tcp requests.

This parameter must be set to a numeric value between 1 and 65535.

AOSStartupTimeout

300

Specify how long, in seconds, Setup must wait for the AOS instance to start. Specify a value for this parameter if Setup cannot continue until the AOS instance starts, such as when you install Enterprise Portal at the same time.

Make sure that the value that you specify is large enough so that the AOS instance has time to start. If the value for this parameter is too small, some components cannot be installed.

RemoveAos

0

Specify whether an installed instance of AOS is removed.

  • 0 – Do not remove the AOS instance.

  • 1 – Remove the AOS instance.

The following table lists the parameters that control how Setup installs and removes Enterprise Portal.

Parameter

Default value

Description

InstallEnterprisePortal

0

Specify whether components for Enterprise Portal are installed.

  • 0 – Do not install Enterprise Portal.

  • 1 – Install Enterprise Portal.

EnterprisePortalWebSite

None

Specify the website that is configured for Enterprise Portal on the local computer. This parameter is required if InstallEnterprisePortal=1.

EnterprisePortalCreateWebSite

1

Specify whether a website for Enterprise Portal is configured by using SharePoint Products and Technologies:

  • 0 – Do not create a site.

  • 1 – Create a site.

  • 2 – Overwrite the existing site.

NoteNote

If you use this parameter when you install Enterprise Portal, you can use only one URL per website. If you want to use multiple URLs for a website, you must install Enterprise Portal by using the Setup wizard.

EnterprisePortalConfigureForWss

1

Specifies whether to configure the virtual server for Enterprise Portal.

  • 0 – Do not configure the virtual server.

  • 1 – Configure the virtual server.

If this parameter is set to 1, Setup configures the application pool to run as the user of the .NET Business Connector proxy. Additionally, Setup verifies that NTLM authentication is enabled.

RemoveEnterprisePortal

0

Specify whether an installed instance of Enterprise Portal is removed.

  • 0 – Do not remove Enterprise Portal.

  • 1 – Remove Enterprise Portal.

The following table lists the parameters that control how Setup installs and removes Enterprise Search.

Parameter

Default value

Description

InstallSearch

0

Specify whether Enterprise Search is installed.

  • 0 – Do not install Enterprise Search.

  • 1 – Install Enterprise Search.

ContentAccessAccount

None

Specify the account that the search service runs as. Enterprise Search uses this account to crawl the data in the Microsoft Dynamics AX database.

If you specify an account, the value must be in the format domain\account.

You cannot specify your own account or a local computer account.

ContentAccessAccountPassword

None

Specify the password that is associated with the account for the search crawler.

If you use a standard domain account, you must specify a value for this parameter if you specify a value for the ContentAccessAccount parameter.

RemoveSearch

0

Specify whether an installed instance of Enterprise Search is removed.

  • 0 – Do not remove Enterprise Search.

  • 1 – Remove Enterprise Search.

The following table lists the parameters that control how Setup installs and removes Help Server.

Parameter

Default value

Description

InstallHelpServer

0

Specify whether Help Server is installed.

  • 0 – Do not install Help Server.

  • 1 – Install Help Server.

If you install Help Server, you must also specify a value for ClientAosServer.

HelpServerWebSite

0

Specify the website that is configured for Help Server on the local computer. This parameter is required if InstallHelpServer=1.

HelpServerPhysicalDirectory

0

Specify the location of the physical directory of the website.

HelpServerAccount

0

Specify the account that is used for the application pool of the Help Server website.

If you specify an account, the value must be in the format domain\account.

You cannot specify your own account or a local computer account.

HelpServerAccountPassword

0

Specify the password that is associated with the account for the Help Server application pool. Help Server uses this account to access the Help content on the web server.

If you use a standard domain account, you must specify a value for this parameter if you specify a value for the HelpServerAccount parameter.

HelpServerInstallContent

None

Specify the Help collections and languages that are installed.

To include multiple collections or languages, separate the values by using a semicolon (;).

The U.S. English (en) version of the Application user Help collection is required. If you install another language, and the required collection was not previously installed, the collection is automatically installed together with the language that you install.

RemoveHelpServer

0

Specify whether Help Server is removed.

  • 0 – Do not remove Help Server.

  • 1 – Remove Help Server and all Help content that was provided by Microsoft. Customized Help content that was created for your organization is not removed.

The following table lists the parameters that control how Setup installs and removes Management Reporter for Microsoft Dynamics ERP.

NoteNote

Management Reporter is available through Setup starting with cumulative update 7 for Microsoft Dynamics AX 2012 R2.

Parameter

Default value

Description

InstallManagementReporter

0

Specify whether Management Reporter is installed.

  • 0 – Do not install Management Reporter

  • 1 – Install Management Reporter.

When you install Management Reporter, you must specify values for the parameters DbSqlServer and DbSqlDatabaseName.

ManagementReporterServerPort

4712

Specify the port that Management Reporter uses for communication.

ManagementAosServer

None

Specify the name of the server that hosts the AOS instance that Management Reporter will connect to.

ManagementAosPort

None

Specify the port number on which the AOS instance that is used by Management Reporter receives TCP/IP requests.

This parameter must be set to a numeric value between 1 and 65535.

ManagementAosNetTcpPort

None

Specify the port number on which the AOS instance that is used by Management Reporter receives net.tcp requests.

This parameter must be set to a numeric value between 1 and 65535.

DataMartDbName

ManagementReporterDM

Specify the name of the database that hosts the data mart for the Management Reporter integration.

ManagementReporterDbName

ManagementReporter

Specify the name of the Management Reporter database.

IntegrationUserAccount

None

Specify the account that is used to run integrations between Management Reporter and Microsoft Dynamics AX.

If you specify an account, the value must be in the format domain\account.

IntegrationUserPassword

None

Specify the password that is associated with the Management Reporter integration account.

You must specify a value for this parameter if you specify a value for the IntegrationUserAccount parameter.

IntegrationUserId

AXIntUsr

Enter the Microsoft Dynamics AX user ID of the integration user.

UseExistingAccount

0

Specify whether the integration user account already exists in Microsoft Dynamics AX.

  • 0 – Do not use an existing account.

  • 1 – Use an existing account.

ManagementServiceUserAccount

None

Specify the service account for Management Reporter. We recommend that you use the AOS service account.

If you specify an account, the value must be in the format domain\account.

ManagementServiceUserPassword

None

Specify the password that is associated with the Management Reporter service account.

You must specify a value for this parameter if you specify a value for the ManagementServiceUserAccount parameter.

RemoveManagementReporter

0

Specify whether Management Reporter is removed.

  • 0 – Do not remove Management Reporter.

  • 1 – Remove Management Reporter.

The following table lists the parameters that control how Setup installs and removes the reporting extensions for Microsoft SQL Server Reporting Services.

Parameter

Default value

Description

InstallReportingServicesExtensions

0

Specify whether the reporting extensions are installed.

  • 0 – Do not install the reporting extensions.

  • 1 – Install the reporting extensions.

Reporting Services extensions can be installed only one time.

ReportingServicesInstance

The first instance of Reporting Services

Specify the instances of Reporting Services that are configured. This parameter is required if more than one instance of Reporting Services is installed on a computer.

NoteNote

If you specify a named instance, you must type the name by using all uppercase letters.

RemoveReportingServicesExtensions

0

Specify whether the reporting extensions are removed.

  • 0 – Do not remove the reporting extensions.

  • 1 – Remove the reporting extensions.

The following table lists the parameters that control how Setup configures Microsoft SQL Server Analysis Services for Microsoft Dynamics AX.

Parameter

Default value

Description

ConfigureAnalysisServices

0

Specify whether Analysis Services is configured for Microsoft Dynamics AX.

  • 0 – Do not configure Analysis Services.

  • 1 – Configure Analysis Services.

AnalysisServicesInstance

<ServerName>$MSSQLServerOLAPService

Specify the instance of Analysis Services instance to connect to. The instance can be specified as a server, or as a fully qualified server and instance.

To specify a named instance, use the format <ServerName>$MSOLAP$<InstanceName>.

AnalysisServicesOLAPAccounts

None

Specify the account that the Analysis Services service uses to access the Microsoft Dynamics AX OLTP database. Usually, this account is the service logon account for the selected Analysis Services instance.

If you specify an account, the value must be in the format domain\account.

RemoveAnalysisServices

0

Specify whether the configuration of Analysis Services for Microsoft Dynamics AX is removed.

  • 0 – Do not remove the Analysis Services configuration.

  • 1 – Remove the Analysis Services configuration.

The following table lists the parameters that control how Setup installs and removes the Microsoft Dynamics AX client. You can use Setup.exe and setup parameters to perform mass deployments of clients. For more information, see Mass deployment of the Microsoft Dynamics AX Windows client.

Parameter

Default value

Description

InstallClientUI

0

Specify whether the user interface for the client is installed.

  • 0 – Do not install the client user interface.

  • 1 – Install the client user interface.

ClientConfig

1

Specify whether the Microsoft Dynamics AX Configuration utility is installed together with the client.

If .NET Business Connector is installed, the Microsoft Dynamics AX Configuration utility is always installed.

  • 0 – Do not install the Microsoft Dynamics AX Configuration utility.

  • 1 – Install the Microsoft Dynamics AX Configuration utility.

If ClientConfig=0, you must also specify a value for the ClientConfigFile parameter.

ClientConfigFile

None

Specify the path of a shared configuration file for the client. This path can be local or in a shared folder that has restricted permissions. When you specify this parameter, Setup configures a desktop shortcut to the client that uses the shared configuration file.

ClientLanguage

en-US

Specify the default language that is used for the client the first time that it is started, if the database has not yet been initialized by the administrator.

This parameter is recognized only if the client user interface is being installed.

This parameter is ignored if the database has been initialized.

ClientAosServer

See the description.

Specify the computer that hosts the AOS instance that the client connects to.

This parameter is required if one of the following parameters is used:

  • InstallClientUI

  • InstallNetBusinessConnector

  • InstallOfficeAddins

  • InstallVisualStudioTools

  • InstallAifWebServices

  • InstallSyncService

  • InstallSynchronizationProxy

  • InstallManagementUtilities

  • ConfigureAnalysisServices

  • InstallReportingServicesExtensions

  • InstallHelpServer

  • InstallSearch

  • InstallEnterprisePortal

If an AOS instance has been specified for a component that is already installed on the computer, the registry settings that contain this information already exist. Therefore, this parameter is ignored.

If InstallAos=1, the name of the current computer is used.

If you use this parameter, you must also specify a value for AosPort and AosWsdlPort. You can optionally specify a value for AosInstance.

ClientInstallType

0

Specify the type of client that is installed.

  • 0 – Install the business user client.

  • 1 – Install the developer client.

  • 2 – Install the administrator client.

CreateClientDesktopShortcut

0

Specify whether a shortcut to the client is created on the desktop.

  • 0 – Do not create a client shortcut on the desktop.

  • 1 – Create a client shortcut on the desktop.

RemoveClientUI

0

Specify whether components for the client user interface are removed.

  • 0 – Do not remove components for the client user interface.

  • 1 – Remove components for the client user interface.

The following table lists the parameters that control how Setup installs and removes the Microsoft Office add-ins.

Parameter

Default value

Description

InstallOfficeAddins

0

Specify whether the Office add-ins are installed.

  • 0 – Do not install the Office add-ins.

  • 1 – Install the Office add-ins.

If InstallOfficeAddins=1, the components for the Remote Desktop Services integration are also installed automatically.

RemoveOfficeAddins

0

Specify whether the Office add-ins are removed.

  • 0 – Do not remove the Office add-ins.

  • 1 – Remove the Office add-ins.

The following table lists the parameters that control how Setup installs and removes the Remote Desktop Services integration.

Parameter

Default value

Description

InstallRemoteDesktopServicesIntegration

0

Specify whether the Remote Desktop Services integration is installed.

  • 0 – Do not install the Remote Desktop Services integration.

  • 1 – Install the Remote Desktop Services integration.

If InstallOfficeAddins=1, the components for the Remote Desktop Services integration are installed automatically.

RemoveRemoteDesktopServicesIntegration

0

Specify whether the Remote Desktop Services integration is removed.

  • 0 – Do not remove the Remote Desktop Services integration.

  • 1 – Remove the Remote Desktop Services integration.

The following table lists the parameters that control how Setup installs and removes Report Designer for Management Reporter.

NoteNote

Report Designer is available through Setup starting with cumulative update 7 for Microsoft Dynamics AX 2012 R2.

Parameter

Default value

Description

InstallReportDesigner

0

Specify whether Report Designer is installed.

  • 0 – Do not install Report Designer

  • 1 – Install Report Designer.

ManagementReporterServer

None

Specify the name of the server where Management Reporter is installed. This parameter is required only if InstallReportDesigner = 1.

If you specify a value for this parameter, you must also specify a value for ManagementReporterServerPort.

RemoveReportDesigner

0

Specify whether Report Designer is removed.

  • 0 – Do not remove Report Designer.

  • 1 – Remove Report Designer.

The following table lists the parameters that control how Setup installs and removes the Microsoft Dynamics AX debugger.

Parameter

Default value

Description

InstallDebugger

0

Specify whether the debugger is installed.

  • 0 – Do not install the debugger.

  • 1 – Install the debugger.

The debugger can be installed only one time.

RemoveDebugger

0

Specify whether the debugger is removed.

  • 0 – Do not remove the debugger.

  • 1 – Remove the debugger.

The following table lists the parameters that control how Setup installs and removes the Visual Studio Tools.

Parameter

Default value

Description

InstallVisualStudioTools

0

Specify whether Visual Studio Tools are installed.

  • 0 – Do not install Visual Studio Tools.

  • 1 – Install Visual Studio Tools.

If InstallVisualStudioTools=1, you must also specify a value for ClientAosServer, AosPort, and AosWsdlPort. You can optionally specify a value for AosInstance.

RemoveVisualStudioTools

0

Specify whether Visual Studio Tools are removed.

  • 0 – Do not remove Visual Studio Tools.

  • 1 – Remove Visual Studio Tools.

The following table lists the parameters that control how Setup installs and removes Trace Parser.

Parameter

Default value

Description

InstallTraceParser

0

Specify whether Trace Parser is installed.

  • 0 – Do not install Trace Parser.

  • 1 – Install Trace Parser.

RemoveTraceParser

0

Specify whether Trace Parser is removed.

  • 0 – Do not remove Trace Parser.

  • 1 – Remove Trace Parser.

The following table lists the parameters that control how Setup installs and removes web services on Internet Information Services (IIS).

Parameter

Default value

Description

InstallAifWebServices

0

Specify whether web services are installed on IIS.

  • 0 – Do not install web services on IIS.

  • 1 – Install web services on IIS.

Web services on IIS can be installed only one time.

AifWebServicesWebSite

None

Specify the website where Setup creates the virtual directory for web services on IIS.

AifWebServicesApplicationPool

MicrosoftDynamicsAXAif60

Specify the name of the application pool that is created. The name cannot include the following characters: asterisks (*), backslashes (\), pipes (|), question marks (?), or slashes (/).

AifWebServicesVirtualDirectory

MicrosoftDynamicsAXAif60

Specify the name of the virtual directory that is created. The name cannot include the following characters: asterisks (*), backslashes (\), pipes (|), question marks (?), or slashes (/).

AifWebServicesAosAccounts

See the description.

Specify the AOS service accounts that are added to the shared directory. If an AOS instance is already installed on this computer, the default account is the service account of the AOS instance that was most recently installed.

Enter the value in the format Domain\account or account. If you do not specify a domain, the domain that the local computer belongs to is used. If you specify a local account, use the name of the local computer as the domain. For example, use ComputerName\LocalAccount or NT AUTHORITY\NETWORK SERVICE.

To include multiple service accounts, separate the values by using a semicolon (;).

NoteNote

The spelling of built-in accounts must match the spelling that is used by the language version of the operating system.

RemoveAifWebServices

0

Specify whether web services on IIS are removed.

  • 0 – Do not remove web services on IIS.

  • 1 – Remove web services on IIS.

The following table lists the parameters that control how Setup installs and removes components for .NET Business Connector.

Parameter

Default value

Description

InstallNetBusinessConnector

0

Specify whether .NET Business Connector is installed.

  • 0 – Do not install .NET Business Connector.

  • 1 – Install .NET Business Connector.

.NET Business Connector can be installed only one time.

BusinessConnectorProxyAccount

None

Specify the account that is used as the .NET Business Connector proxy.

This parameter is required if InstallTraceParser=1.

BusinessConnectorProxyAccountPassword

None

Specify the password that is associated with the account for the .NET Business Connector proxy.

If you use a standard domain account, this parameter is required if the BusinessConnectorProxyAccount parameter is required. If a value is specified for this parameter, the value cannot be blank.

RemoveNetBusinessConnector

0

Specify whether .NET Business Connector is removed.

  • 0 – Do not remove .NET Business Connector.

  • 1 – Remove .NET Business Connector.

The following table lists the parameters that control how Setup installs and removes the synchronization service and synchronization proxy for Microsoft Project Server.

Parameter

Default value

Description

InstallSynchronizationService

0

Specify whether the synchronization service is installed.

  • 0 – Do not install the synchronization service.

  • 1 – Install the synchronization service, and create a new message queue.

  • 2 – Install the synchronization service, and use an existing message queue.

The synchronization service can be installed only one time.

SynchronizationServiceMSMQAddress

None

Specify the address of the message queue that is used together with the synchronization service. This parameter is valid only if InstallSynchronizationService=2.

SynchronizationServiceMSMQType

0

Specify the type of message queue that is created.

  • 0 – Create a private queue.

  • 1 – Create a public queue.

SynchronizationServiceAccount

None

Specify the account that the synchronization service runs as.

The synchronization service uses this account to connect to Microsoft Dynamics AX and to access the Project Server database.

Enter the account in the format domain\account.

This parameter is optional when you install the synchronization service, because Setup can retrieve the value from the database. The parameter is required when you install the synchronization proxy.

SynchronizationServiceAccountPassword

None

Specify the password that is associated with the account for the synchronization service.

If you use a standard domain account, this parameter is required if InstallSynchronizationService is set to 1 or 2.

SynchronizationServiceMsmqAccounts

None

Specify the accounts to which permissions for the message queues are granted. You must specify two types of accounts:

  • The account that is used by the Project Server event service

  • The service accounts for all AOS instances that you want to use for synchronization

Enter the value in the format domain\account or account. If you do not specify a domain, the domain that the local computer belongs to is used. If you specify a local account, use the name of the local computer as the domain. For example, use ComputerName\LocalAccount or NT AUTHORITY\NETWORK SERVICE.

To include multiple service accounts, separate the values by using a semicolon (;).

NoteNote

The spelling of built-in accounts must match the spelling that is used by the language version of the operating system.

InstallSynchronizationProxy

0

Specify whether the synchronization proxy is installed.

  • 0 – Do not install the synchronization proxy.

  • 1 – Install the synchronization proxy.

The synchronization proxy can be installed only one time.

SynchronizationProxySqlServer

None

Specify the SQL Server instance that Project Server uses for reporting. This parameter is required if InstallSynchronizationProxy=1.

SynchronizationProxySqlDatabaseName

ProjectServer_Reporting, if the database exists on the SQL Server instance and HideUI=1. Otherwise, there is no default value.

Specify the SQL Server database that the Project Server uses for reporting. This parameter is required if InstallSynchronizationProxy=1.

SynchronizationProxyUrl

None

Specify the URL for Project Web access. This parameter is required if InstallSynchronizationProxy=1.

RemoveSynchronizationService

0

Specify whether an installed instance of the synchronization service is removed.

  • 0 – Do not remove the synchronization service.

  • 1 – Remove the synchronization service.

RemoveSynchronizationProxy

0

Specify whether an installed instance of the synchronization proxy is removed.

  • 0 – Do not remove the synchronization proxy.

  • 1 – Remove the synchronization proxy.

The following table lists the parameters that control how Setup installs and removes Connector for Microsoft Dynamics.

NoteNote

Connector is available through Setup starting with cumulative update 7 for Microsoft Dynamics AX 2012 R2.

Parameter

Default value

Description

InstallConnector

0

Specify whether Connector is installed.

  • 0 – Do not install Connector.

  • 1 – Install Connector.

ConnectorAosName

None

Specify the name of the server that hosts the AOS instance that Connector will connect to.

ConnectorAosPort

None

Specify the port number on which the AOS instance that is used by Connector receives TCP/IP requests.

This parameter must be set to a numeric value between 1 and 65535.

IntegrationUserAccount

None

Specify the account that is used to run integrations between Microsoft Dynamics CRM and Microsoft Dynamics AX.

If you specify an account, the value must be in the format domain\account.

IntegrationUserPassword

None

Specify the password that is associated with the Connector integration account.

You must specify a value for this parameter if you specify a value for the IntegrationUserAccount parameter.

IntegrationUserId

AXIntUsr

Enter the Microsoft Dynamics AX user ID of the integration user.

UseExistingAccount

0

Specify whether the integration user account already exists in Microsoft Dynamics AX.

  • 0 – Do not use an existing account.

  • 1 – Use an existing account.

ConnectorServerName

None

Specify the name of the database server that will host the Microsoft Dynamics Integration (MSDI) database.

NoteNote

The MSDI database is not required to be on the same computer as Connector for Microsoft Dynamics.

RemoveConnector

0

Specify whether Connector is removed.

  • 0 – Do not remove Connector.

  • 1 – Remove Connector.

The following table lists the parameters that control how Setup installs and removes the management utilities.

Parameter

Default value

Description

InstallManagementUtilities

0

Specify whether the management utilities are installed.

  • 0 – Do not install the management utilities.

  • 1 – Install the management utilities.

RemoveManagementUtilities

0

Specify whether the management utilities are removed.

  • 0 – Do not remove the management utilities.

  • 1 – Remove the management utilities.

The following table lists the parameters that control how Setup installs and removes Retail Headquarters.

Parameter

Default value

Description

InstallRetailHQ

0

Specify whetherRetail Headquarters is installed.

  • 0 – Do not install Retail Headquarters.

  • 1 – Install Retail Headquarters.

UninstallRetailHQ

0

Specify whether Retail Headquarters is removed.

  • 0 – Do not remove Retail Headquarters.

  • 1 – Remove Retail Headquarters.

The following table lists the parameters that control how Setup installs and removes Retail POS (point of sale).

Parameter

Default value

Description

InstallRetailPOS

0

Specify whether Retail POS is installed.

  • 0 – Do not install Retail POS.

  • 1 – Install Retail POS.

UninstallRetailPOS

0

Specify whether Retail POS is removed.

  • 0 – Do not remove Retail POS.

  • 1 – Remove Retail POS.

The following table lists the parameters that control how Setup installs and removes Retail Store Connect.

These parameters apply only to Retail Store Connect in Microsoft Dynamics AX 2012 Feature Pack. In Microsoft Dynamics AX 2012 R2, Retail Store Connect is called Commerce Data Exchange: Synch Service, and the parameter names are different. For more information, see Commerce Data Exchange: Synch Service parameters.

Parameter

Default value

Description

InstallRetailSC

0

Specify whether Retail Store Connect is installed.

  • 0 – Do not install Retail Store Connect.

  • 1 – Install Retail Store Connect.

UninstallRetailSC

0

Specify whether Retail Store Connect is removed.

  • 0 – Do not remove Retail Store Connect.

  • 1 – Remove Retail Store Connect.

The following table lists the parameters that control how Setup installs and removes Synch Service.

These parameters apply only to Synch Service in Microsoft Dynamics AX 2012 R2. In Microsoft Dynamics AX 2012 Feature Pack, Synch Service is called Retail Store Connect, and the parameter names are different. For more information, see Retail Store Connect parameters.

Parameter

Default value

Description

InstallCDESS

0

Specify whether Synch Service is installed.

  • 0 – Do not install Synch Service.

  • 1 – Install Synch Service.

CDESSDBServerName

None

Specify the name of the server where the message database for Synch Service will be created.

CDESSDatabaseName

None

Specify the name of the SQL Server database to create for Synch Service messages.

CDESSUsername

None

Specify the account that the Windows service for Synch Service runs as.

If you specify a value for this parameter, you must also specify a value for the CDESSPassword parameter.

CDESSPassword

None

Specify the password that is associated with the account that runs the Windows service for Synch Service.

This parameter is required if you specify a value for the CDESSUsername parameter.

RemoveCDESS

0

Specify whether Synch Service is removed.

  • 0 – Do not remove Synch Service.

  • 1 – Remove Synch Service.

The following table lists the parameters that control how Setup installs and removes Retail Transaction Service.

These parameters apply only to Retail Transaction Service in Microsoft Dynamics AX 2012 Feature Pack. In Microsoft Dynamics AX 2012 R2, Retail Transaction Service is called Commerce Data Exchange: Real-time Service, and the parameter names are different. For more information, see Commerce Data Exchange: Real-time Service parameters.

Parameter

Default value

Description

InstallRetailTS

0

Specify whether Retail Transaction Service is installed.

  • 0 – Do not install Retail Transaction Service.

  • 1 – Install Retail Transaction Service.

UninstallRetailTS

0

Specify whether Retail Transaction Service is removed.

  • 0 – Do not remove Retail Transaction Service.

  • 1 – Remove Retail Transaction Service.

The following table lists the parameters that control how Setup installs and removes Real-time Service.

These parameters apply only to Real-time Service in Microsoft Dynamics AX 2012 R2. In Microsoft Dynamics AX 2012 Feature Pack, Real-time Service is called Retail Transaction Service, and the parameter names are different. For more information, see Retail Transaction Service parameters.

Parameter

Default value

Description

InstallCDERS

0

Specify whether Real-time Service is installed.

  • 0 – Do not install Real-time Service.

  • 1 – Install Real-time Service.

RemoveCDERS

0

Specify whether Real-time Service is removed.

  • 0 – Do not remove Real-time Service.

  • 1 – Remove Real-time Service.

The following table lists the parameters that control how Setup installs and removes the Retail Store Database Utility.

Parameter

Default value

Description

InstallRetailStoreDBUtil

0

Specify whether the Retail Store Database Utility is installed.

  • 0 – Do not install the Retail Store Database Utility.

  • 1 – Install the Retail Store Database Utility.

UninstallRetailStoreDBUtil

0

Specify whether the Retail Store Database Utility is removed.

  • 0 – Do not remove the Retail Store Database Utility.

  • 1 – Remove the Retail Store Database Utility.

The following table lists the parameters that control how Setup installs and removes VSS writer.

NoteNote

The VSS writer is available through Setup starting with cumulative update 7 for Microsoft Dynamics AX 2012 R2.

Parameter

Default value

Description

InstallVss

0

Specify whether VSS writer is installed.

  • 0 – Do not install VSS writer.

  • 1 – Install VSS writer.

DpmServer

None

Specify the server where System Center Data Protection Manager (DPM) is installed.

TempBackupPath

None

Specify the location where temporary backups will be stored.

VssServiceAccount

None

Specify the account that the Windows service for the VSS writer runs as.

If you specify an account, the value must be in the format domain\account. The account must be a domain account. You cannot specify your own account or a local computer account.

VssServicePassword

None

Specify the password that is associated with the VSS writer service account.

If you use a standard domain account, you must specify a value for this parameter if you specify a value for the VssServiceAccount parameter.

ProtectAos

0

Specify whether to protect an AOS instance with VSS writer.

  • 0 – Do not protect an AOS instance.

  • 1 – Protect an AOS instance.

VssAosInstanceNumber

None

Specify the instance number of the AOS instance to protect.

This parameter is required if ProtectAos=1.

ProtectSsas

0

Specify whether to protect an instance of Analysis Services with VSS writer.

  • 0 – Do not protect an instance of Analysis Services.

  • 1 – Protect an instance of Analysis Services.

VssAnalysisInstance

None

Specify the instance of Analysis Services to protect.

This parameter is required if ProtectSsas=1.

ProtectSsrs

0

Specify whether to protect an instance of Reporting Services with VSS writer.

  • 0 – Do not protect an instance of Reporting Services.

  • 1 – Protect an instance of Reporting Services.

VssReportingDbName

None

Specify the reporting database to protect.

VssReportingInstance

None

Specify the instance of Reporting Services to protect.

This parameter is required if ProtectSsrs=1.

VssReportingInstanceRemote

None

Specify the SQL Server instance that hosts the Reporting Services database.

This parameter is required if ProtectSsrs=1.

VssReportingMachine

None

Specify the computer that hosts the Reporting Services database.

This parameter is required if ProtectSsrs=1.

ProtectDb

0

Specify whether to protect the Microsoft Dynamics AX database with VSS writer.

  • 0 – Do not protect the Microsoft Dynamics AX database.

  • 1 – Protect the Microsoft Dynamics AX database.

VssDbName

None

Specify the name of the Microsoft Dynamics AX database to protect.

This parameter is required only if ProtectDb=1.

VssDbInstance

None

Specify the SQL Server instance that hosts the Microsoft Dynamics AX database.

This parameter is required only if ProtectDb=1.

RemoveVss

0

Specify whether VSS writer is removed.

  • 0 – Do not remove VSS writer.

  • 1 – Remove VSS writer.


Announcements: To see known issues and recent fixes, use Issue search in Microsoft Dynamics Lifecycle Services (LCS).
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.