EasyUC
4.9.49

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.

EasyUC · Version 4.9.49

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.eucpkg from 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)

  1. In the Manager, open the EasyUC-Update page. On a new appliance it shows "Keine EasyUC installiert – Erstinstallation" (no EasyUC installed). The Erstinstallation button on the EasyUC card of the Übersicht page also leads here.
  2. Drag easyuc-4.9.49-amd64.eucpkg onto the area EasyUC-Datei für die Erstinstallation hierher ziehen or click to select it. An interrupted upload resumes when you drop the same file again.
  3. Wait until the Manager has checked signature and content (Signatur: gültig) and the servers are prepared ("Alle Server vorbereitet").
  4. Choose Erstinstallation….
  5. Under Module, choose the required combination, for example CUCM + ACD. Allowed are CUCM, CUCM + Teams, CUCM + ACD, Teams + ACD or all three.
  6. Confirm with the Manager password and choose Jetzt installieren (install now).
  7. Follow the run "Erstinstallation von 4.9.49". Depending on the server it takes up to about one hour; the Manager page stays available. At the end the Manager reports "EasyUC 4.9.49 ist installiert, alle Prüfungen sind bestanden."
  8. At the console, set the password of the admin interface owner account under Manage K3s → Set EasyUC owner password. It is shown once.

Step by step: change modules later

  1. On the EasyUC card, select Module or click a module in the module bar.
  2. Select the new combination. With Presence Sync betreiben you add the presence service independently of it.
  3. Read the Vorschau: "Wird installiert", "Wird übernommen" and "Wird entfernt" name the affected components.
  4. If a module is dropped, tick the confirmation "Verstanden: …, die Daten bleiben erhalten."
  5. Select Speichern. The card shows "Module werden angewendet" until the change has been applied.

Step by step: initial setup in the admin interface

  1. Open https://<your-appliance>/admin and log in with the owner account.
  2. With the CUCM module, setup starts with the step CUCM Connections. Select Create and create the connection to CUCM (see the chapter on setting up the CUCM connection).
  3. Select Next Step.
  4. In the License step, select Get License Request and send the file to EasyUC.
  5. Select the licence file you received in the field under Install License and select Verify License.
  6. Check the License Information and select Install License.
  7. Select Next Step. With the CUCM module the provisioning wizard follows; without CUCM the start page opens.

Fields and options

Fields and options
Field / actionMeaning and use
CUCMCisco UC suite only, without Teams and ACD.
CUCM + TeamsCisco UC suite plus Microsoft Teams Direct Routing.
CUCM + ACDCisco UC suite plus ACD with IVR flows.
Teams + ACDWithout CUCM: Microsoft Teams Direct Routing with ACD.
CUCM + Teams + ACDAll modules: Cisco UC suite, Teams Direct Routing and ACD.
Presence SyncPresence between Teams and Cisco without an SBC trunk. The Jabber call state additionally needs CUCM.
BestandsmodusOlder 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 / ComponentsOverall state and number of ready components of the installation.
Reconcile clusterButton 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.

Related chapters