EasyUC
4.9.49

Getting started

Version and prerequisites

Version 4.9.49 with EasyUC Manager 2.0.11: versions, prerequisites and new installations from the OVA.

EasyUC · Version 4.9.49

What it is for

This handbook describes EasyUC 4.9.49 together with EasyUC Manager 2.0.11. The Manager is a separate product with its own version number and is updated separately. New appliances are created from the OVA with Manager 2.0.11; the EasyUC application is then installed in the Manager.

All application services are in a single container image. A release comes as one signed file (easyuc-<version>-amd64.eucpkg) from the customer portal and is applied in the Manager on the EasyUC-Update page, on a new appliance as Erstinstallation (initial installation). After an update the Manager can return to the previous version.

Field and button labels are highlighted in the instructions. The Manager interface is German, some of its dialogs are English, and some Manager pages write umlauts as ae, oe and ue. The manual quotes the labels as the interface shows them.

Prerequisites

  • EasyUC Manager 2.0.4 or later (below 3.0.0) for EasyUC 4.9.49. The current OVA ships with Manager 2.0.11.
  • For the update to 4.9.49: installed EasyUC version 4.8.5 or later. Bring older systems to 4.8.5 first.
  • K3s 1.34.0 or later, all nodes with amd64 architecture.
  • The Manager sets up the data services MariaDB, RabbitMQ and Elasticsearch during the initial installation. An EasyUC update does not change them.
  • CUCM 11.5 or later for the CUCM module.
  • A licence that covers the installed modules. Roles and location rights limit the visible menus and the actions that can be performed.

Step by step: determine the installed version

  1. Open the Manager (https://<your-appliance>/manager) and log in.
  2. Read the Manager version in the navigation below the logo ("Version …").
  3. Open the EasyUC-Update page. The version of the EasyUC application is shown at the top right under Installiert.
  4. Open the Übersicht page. The EasyUC card shows the version, the modules and the state of the components.
  5. Open the System-Updates page. Under Aktuelles Betriebssystem you see operating system, kernel and Kubernetes version per node.

Fields and options

Fields and options
Field / actionMeaning and use
EasyUC 4.9.49Application: administration, end-user portal, background services, CURRI, phone book, JTAPI, ACD media service, Teams SBC, Teams PowerShell service, file service and presence service in one image.
EasyUC Manager 2.0.11Management layer with its own version, included in the current OVA. Manager 2.0.4 is sufficient for 4.9.49. Manager updates come as a signed file easyuc-manager-update-<version>.eucupg.
Packageeasyuc-4.9.49-amd64.eucpkg with embedded signature, about 2.9 GB. A .sha256 file is provided next to it to check the download.
New installationFrom the OVA EasyUC-Appliance-Manager-2.0.11-ESXi.ova in the customer portal. It contains only the Manager; you then install EasyUC 4.9.49 in the Manager under EasyUC-Update → Erstinstallation. A new installation via an installation YAML is blocked.
Retention of versionsThe Manager keeps the images of the last two versions on all nodes.
Calling Features workspaceThe former "ACD AI" workspace has been called Calling Features since 4.8.7.
Self-serviceEnd users can only use their own numbers on line buttons. The number plan search and creating new numbers from the number plan are blocked for end users.

Check the result and troubleshoot

  • If the Manager has no EasyUC-Update page, a very old Manager is running. Update the Manager first.
  • If a described menu is missing in the administration, first check module, connection, user role and location access.
  • Before a change, select the correct workspace and the correct CUCM connection or Teams tenant.
  • Saving, assigning, deleting and updating routes change the connected systems. Check target object and summary before confirming.
  • Replace example values in the manual with the values of your installation. Keep credentials outside the manual in the password management intended for them.
  • Do not take the Manager back to an older version. The Manager-Update page only accepts newer versions.

Related chapters