Understand AmplaUtil parameters
- Last UpdatedMar 24, 2025
- 2 minute read
When you run AmplaUtil without parameters, a message displays that includes these instructions on the use of parameters:
Usage 1:
---------
AmplaUtil <operation> [<options>] /databasename:<databasename> [/sqlservername:<sqlservername>] [/sqlserverinstancename:<sqlserverinstancename>] <filename>
Exports/imports/backs-up/restores the database name to/from the file name.
Note:
-
The 'sqlservername' option can only be specified when using the 'Export' operation.
-
The 'sqlserverinstancename' option must be a local instance unless used with the 'sqlservername' option.
-
When the 'sqlservername' option is not specified the default SQL Server instance is used.
Operations:
/export Export the project in the database to the file name. (Short format: /e)
/import Import the project in the file name to the database. (Short format: /i)
/backup Backup the project in the database to the file name. (Short format: /b)
/restore Restore the project in the file name to the database. (Short format: /r)
Options:
/preservepersistentruntimeproperties
Keep the values of persistent runtime properties from the project being overwritten. (Short format: /p)
/upgradeparam:
Pass in upgrade parameters to the project being imported or upgraded. (Short format: /u:LegacyCulture=en-US;Parameter2Name=Parameter2Value)
Usage 2:
-----------
AmplaUtil /help Displays help. (Short format /?)
Usage 3:
-----------
AmplaUtil /serviceaccount:serviceAccountName
Updates the AVEVA Production Management service account. (Short format: /s:serviceAccountName)
After all the prerequisite checks, you will be prompted to enter the Ampla service account password.
Usage 4:
-----------
AmplaUtil /rabbitmqcredentialupdate /rabbitmqusername:<username>
Updates the AVEVA Production Management RabbitMQ credentials. (Short format: /q /rabbitmqusername:<username>)
You will be prompted to enter the user account credential for RabbitMQ and Ampla service account.
Usage 5:
-----------
AmplaUtil /wcfPort:<port number>
Updates the port number configured for WCF service.
Usage 6:
-----------
AmplaUtil /paWcfPort:<port number>
Updates the port number configured for PA WCF service.
