Installation, updates & backup
Installing EasyUC and selecting modules
Install EasyUC in the Manager, define the modules and complete the initial setup of the admin interface.
In EasyUC: Manager → EasyUC-Update → Erstinstallation; Manager → Übersicht → EasyUC card → Module
What it is for
After the appliance has been initialised, only the EasyUC Manager runs. You install the application itself in the Manager on the EasyUC-Update page: drop the package easyuc-<version>-amd64.eucpkg from the customer portal, choose the modules and confirm the Erstinstallation (initial installation). The Manager then sets up MariaDB, RabbitMQ and Elasticsearch, initialises a new, empty database and starts the services of the selected modules.
The modules determine which services run in the cluster and which workspaces the admin interface shows. You can change the selection later with Module.
After the installation you log in to the admin interface. The first time, EasyUC takes you through two steps: creating the CUCM connection and installing the licence.
Prerequisites
- An initialised appliance and a login to the Manager.
- The current application package
easyuc-4.9.49-amd64.eucpkgfrom the customer portal (Downloads → Current version), checked by SHA-256 after downloading, and the Manager password for confirmation. - A licence that covers the selected modules. A freshly installed appliance starts with a time-limited demo licence.
- For the initial setup of the admin interface: the owner account. You set its password on the console under Manage K3s → Set EasyUC owner password.
- With the CUCM module: address and AXL access of the CUCM publisher.
Step by step: install EasyUC (initial installation)
Step by step: change modules later
Step by step: initial setup in the admin interface
Fields and options
| Field / action | Meaning and use |
|---|---|
| CUCM | Cisco UC suite only, without Teams and ACD. |
| CUCM + Teams | Cisco UC suite plus Microsoft Teams Direct Routing. |
| CUCM + ACD | Cisco UC suite plus ACD with IVR flows. |
| Teams + ACD | Without CUCM: Microsoft Teams Direct Routing with ACD. |
| CUCM + Teams + ACD | All modules: Cisco UC suite, Teams Direct Routing and ACD. |
| Presence Sync | Presence between Teams and Cisco without an SBC trunk. The Jabber call state additionally needs CUCM. |
| Bestandsmodus | Older installations without defined modules. The admin interface then shows all functions. Saving a selection fixes it; "CUCM + Teams + ACD" is recommended in that case so that no function is lost. |
| Health / Components | Overall state and number of ready components of the installation. |
| Reconcile cluster | Button with a circular arrow on the card. Triggers a new reconciliation of the installation. |
| Update (YAML) | The former route via a YAML file. Installation and updates run through EasyUC-Update. A new installation via YAML is blocked, and while an EasyUC update is running the YAML update is blocked as well. |
Check the result and troubleshoot
- The EasyUC card shows the status
Ready, and under Components all components are ready. - The admin interface is reachable at
/admin, the end-user portal at/enduser, the agent workplace at/agent. - "Paket abgelehnt – es wird nicht installiert." (package rejected): signature or content do not match. Download the file again from the customer portal and check the SHA-256 checksum. "Erstinstallation nicht abgeschlossen." (initial installation not completed): the created installation is kept for diagnosis; contact EasyUC support.
- "Module nicht gespeichert": the error text names the cause, for example an invalid combination. CUCM must be active, or Teams and ACD together.
- A module shows "nicht installiert" and Aktivieren: the module is not part of the current selection.
- The licence is installed in the admin interface, not in the Manager. Later you find it under Administration → System & Operations → License.