...
- Determined space requirements
- Installed all prerequisites.
- Downloaded a Universal Controller distribution file.
| Anchor | ||||
|---|---|---|---|---|
|
Installation Procedure
To install Universal Controller:
1 | |
|---|---|
2 | |
3 | |
4 | |
5 | |
6 | |
7 | |
8 |
| Anchor | ||||
|---|---|---|---|---|
|
Unpack the Universal Controller Distribution File
To unpack the Universal Controller distribution file, use the following method appropriate for your platform:
Linux/Unix |
| ||
|---|---|---|---|
Windows | Use an appropriate archiving / unzipping product. |
| Anchor | ||||
|---|---|---|---|---|
|
Install the Controller
To install the Controller, issue the following command that is appropriate for your platform:
...
Linux |
| |||||||
|---|---|---|---|---|---|---|---|---|
Windows |
|
| Anchor | ||||
|---|---|---|---|---|
|
Deploy the Controller
In this procedure, you will start Tomcat, which starts the Controller and builds your database tables. This process takes several minutes. When it is complete, the Controller is started and ready to use.
...
You now have completed the install process and the Controller is running.
| Anchor | ||||
|---|---|---|---|---|
|
Update the Universal Controller Start-up Properties (uc.properties)
For AIX and z/Linux only
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 | Change the following two properties from their default value to the IBM AIX value:
|
|---|---|
Step 2 | Restart Tomcat. |
| Anchor | ||||
|---|---|---|---|---|
|
Verify the Installation
To make sure the Controller is installed, running, and communication with Universal Agent and Universal Message Service (OMS):
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 /wiki/spaces/Staging/pages/5833465.
| Anchor | ||||
|---|---|---|---|---|
|
Apply the License Key
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 Services, select Administrationation > 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. |
%20-%207.2.0.0.png?version=1&modificationDate=1651518559000&cacheVersion=1&api=v2&width=1114)
| Anchor | ||||
|---|---|---|---|---|
|
License Information
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:
- Expiry Date
- Distributed Agents
- z/OS Agents
- Tasks
- Monthly Executions
- Cluster Nodes
- UPPS
- USAP
- Customer
- Environment
| Anchor | ||||
|---|---|---|---|---|
|
Enable LDAP Synchronization
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.
| Anchor | ||||
|---|---|---|---|---|
|
Configure System Notifications
System Notifications are emails sent to one or more Universal Controller system administrators based on either:
- Licensing issues (license violations, expired licenses, invalid licenses)
- Status of a system operation associated with a task instance.
- Data backup / purge operations.
| 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. |
| Anchor | ||||
|---|---|---|---|---|
|
System Notifications for License Violations and Expirations
When you have configured the Controller for system notification, notifications automatically are sent to the specified system administrator(s) for the following license issues:
- License violations
- Expired licenses
- Invalid licenses
| Anchor | ||||
|---|---|---|---|---|
|
License Violations
A system notification is sent for the following license violations:
...
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 55509135 License Information, above).
| Anchor | ||||
|---|---|---|---|---|
|
License Expiration
A system notification is sent at the following times if a license will expire in 7 days or sooner:
...
| Note | ||
|---|---|---|
| ||
A License Expiration message also displays on the Console when you log in to the Controller if the license will expire within the week and when the license already has expired. |
| Anchor | ||||
|---|---|---|---|---|
|
Invalid Licenses
A system notification is sent at the following times if a license is invalid:
...