...
To install Universal Controller:
1 | Installing Universal Controller#Unpack Unpack the Downloaded Distribution File |
|---|---|
2 | Installing Universal Controller#Install Install the Controller |
3 | Installing Universal Controller#Deploy Deploy the Controller |
4 | Installing Universal Controller#Update Update the Universal Controller Start-up Properties |
5 | Installing Universal Controller#Verify Verify the Installation |
6 | Installing Universal Controller#Apply Apply the License Key |
7 | Installing Universal Controller#Enable Enable LDAP Synchronization |
8 | Installing Universal Controller#Configure Configure System Notifications |
| Anchor | ||||
|---|---|---|---|---|
|
...
The Controller installation process writes the values for some command line switches to the Universal Controller start-up properties file, uc.properties (see the table, below). For any of those command line switches that are not required and, in fact, are not included on the command line, the Controller installation process writes their default value to uc.properties.
...
For command line switches that have their value written to the Universal Controller start-up properties file, uc.properties, the table also identifies the property in that file to which the value is written.
...
Command Line Switch | Description | Default | Required | Controller Property | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| For an Agent-Only deployment If | false | No | ||||||||||||||
| Full path of the Universal Controller war file ( | none | Yes | ||||||||||||||
| Universal Controller database name. | uc | No | uc.db.name | |||||||||||||
| Database user's password. | none | Yes | uc.db.password | |||||||||||||
| JDBC connect URL.
| jdbc:mysql://localhost:3306/ | No | uc.db.url | |||||||||||||
| Database user name. | none | Yes | uc.db.user | |||||||||||||
| Used by the Universal Controller to generate a unique Cluster Node Node Id in the format of hostname:port-dbname.
| 8080 | No | uc.servlet.port | |||||||||||||
| Database type.
| mysql | No * | uc.db.rdbms | |||||||||||||
| Path to the Tomcat installation directory (contains the directories:
| none | Yes |
...
Follow this procedure to change two default values in the Universal Controller start-up properties file, uc.properties, which is read by the Controller.
...
Step 1 | |||
|---|---|---|---|
Step 2 | From your browser, access the Universal Controller user interface.
| ||
Step 3 | Log in with user | ||
Step 4 | Enter a password in the New Password and Confirm New Password fields (the Current Password field should remain empty) and click Change Password. The Universal Controller Home Dashboard displays. | ||
Step 5 | The System Details Widget provides current system information. Check the Release information to verify that the latest version number is displayed, as shown in the following example. | ||
Step 6 | From the Agents and Connections navigation pane, select Agents > All Agents or Agents > <type of Agent>. You will see a list similar to the following example. Make sure the Status of the Agent is Active. | ||
Step 7 | From the Agents and Connections navigation pane, select System > OMS Servers. You will see a list similar to the following example. Make sure the Status of the OMS Servers are Connected. | ||
Step 8 | For more information about these components in the Universal Controller user interface, see: |
To get started using the Controller and become familiar with its features, we recommend you spend some time going through the Tutorials.
...
Although you do not normally need to enter a license key immediately after installation, at some point you will need to follow these steps to enter your key:
Step 1 | From the Administration navigation pane, select Configuration > Properties. The Properties list displays. |
|---|---|
Step 2 | Click the License Key property Value field and enter your encrypted license key. |
Step 3 | Return to the System Details Widget and review the License field to verify that the terms of your license are correct. |
Step 4 | Optionally, configure the Controller so that your system administrator receives notifications regarding license violations and expirations. |
.png?version=1&modificationDate=1635967899000&cacheVersion=1&api=v2&width=1025)
...
The License field in the System Details widget (view the system-defined Home Dashboard or, on the Reporting navigation pane, click Widgets) identifies license information for:
...
In order to log in to the Controller using LDAP credentials, you must set the LDAP Synchronization Enabled Universal Controller System property (Administration > Configuration > Properties in the Controller user interface) to true.
...
| Note | ||
|---|---|---|
| ||
System Notifications are not the same as Email Notifications. Please refer to the following sections for explicitly defining Email Notifications. |
...
Step 1 | Select an email connection on which the notifications will be sent and enable the Use for System Notifications field.
| |||||
|---|---|---|---|---|---|---|
Step 2 | Identify the Universal Controller Administrator(s) that will receive the system notifications by entering one or more valid email addresses for those administrators in the Administrator Email Address Universal Controller system property. | |||||
Step 3 | If you want to identify the source system that is sending the system notifications in the Subject line of the emails, enter a value in the System Identifier Universal Controller system property. |
...
The License field in the System Details widget (view the system-defined Home Dashboard or, on the Reporting navigation pane, click Widgets) identifies these maximum numbers (see Installing Universal Controller#License License Information, above).
| Anchor | ||||
|---|---|---|---|---|
|
...
| Note | ||
|---|---|---|
| ||
A License Expiration message also displays on the Universal Automation Center Console when you log in to the Controller if the license will expire within the week and when the license already has expired. |
...