This utility is designed for use within an installer that deploys EasyUA based UA clients.
It creates the necessary configuration settings and certificates for the UA client to work on an unprepared machine.
It includes support to set up a UA test server that may be included in the client distribution.
The utility is designed to be used in command line mode in the application installer. It must run in an administrator account and performs based on:
- The command line arguments
- The definitions in the server UA configuration file
- For server certificates, the definitions in the server UA configuration file
- Operator entered installation specific user accounts
The utility runs hidden, without operator interaction unless:
- command line argument c) is specified without account names, for the definition of installation specific accounts
- command line argument d) specified, requiring a private key password
- an error happened
Supported command line arguments are listed below. Each argument is optional and can be specified with a leading '/' or '-'.
Arguments with a file name need to be enclosed in " if the name contains a space character.
a) ConfigFile=path
The default is the first *.UA.config.xml file in the utility directory.
Certificates are created/imported according the name/location settings in the configuration file.
b) createClientCertificate
A self-signed certificate is created for the client application.
c) userAccounts[=name[=name]…]
Creates certificate read permissions and Http reservation for the defined account(s).
Permissions must be added for the UA server to run in a non-administrator user.
If no name is specified then a dialog is shown for the operator to enter installation specific account names
d) importClientCertificate=certFilePath
The certificate private key password has to be entered in a dialog.
e) importServerCertificate=certFilePath
The certificate is imported from the specified file with only the public key.
f) createServerCertificate=clientConfigFilePath
Create certificate for a e.g. a test client included in the server distribution
g) firewall
Adds the application and the configured ports to the firewall exception list.
h) CertificateKeyLen=xxx
The key length of the created certificates. Valid values are 1024, 2048, 4096. The default value is 2048.
i) CertificateAlgorithm=xxx
The key length of the created certificates. Valid values are SHA1 or SHA256. The default is SHA256.
Usage Sample:
UaClientPrepare createClientCertificate "createServerCertificate=tools\DA3TestClientUaNet4.Ua.Config.Xml" /userAccounts=opc /firewall