Upgrade Configurations Using PML Macros and Command Line
- Last UpdatedOct 23, 2024
- 1 minute read
AVEVA™ Gateway for Unified Engineering enables you to upgrade configurations using command line and PML macros.
Manage Configurations Using PML Macros
The gateway provides the IEDConfigurationManager PML object that contains the following methods.
|
Method |
Description |
|---|---|
|
GETAVAILABLE() |
Returns an array of available configurations names |
|
ISSUPPORTED(STRING) |
Returns true if configurations is supported; else, returns false |
|
REQUIRESUPGRADE(STRING) |
Returns true if configuration requires upgrade; else, returns false |
|
UPGRADE(STRING) |
Upgrades a single configuration |
|
UPGRADE(ARRAY) |
Upgrades multiple configurations |
|
UPGRADEALL() |
Upgrades all available configurations |
The following is an example of the IEDConfigurationManager object.
import 'AVEVA.NET.Gateways.IED.PmlExtensions'
using namespace 'AVEVA.NET.Gateways.IED.PmlExtensions'
!manager= object IEDConfigurationManager()
!manager.upgrade(CfgName1)
Manage Configurations Using Command Line
The gateway provides a new command config upgrade for upgrading configurations. The command can be used with the following options.
|
Option |
Description |
|---|---|
|
-select "string" |
Enables you to pass configuration names for upgrade |
|
-selectall "bool" |
Enables you to specify if all available configurations must be upgraded. Overrides anything that was passed with '-select' option. |
Examples:
-
AVEVA.Gateway.UE.Draw.exe config upgrade TokenPath "C:\Token.mac" -selectall true
-
AVEVA.Gateway.UE.Draw.exe config upgrade -TokenPath "C:\Token.mac" -select "CfgName1 CfgName2 CfgName3"
For information on how to upgrade a configuration using the user interface, see Load a Configuration.