System requirements and installation
What the appliance needs and how to set up EasyUC from the OVA to the licence.
System requirements
For a single VM, these guideline values apply:
| Resource | Guideline | Recommended |
|---|---|---|
| Memory | 8 GB | 16 GB |
| vCPU | 4 | 8 |
| Disk | 100 GB | SSD preferred |
The image cache alone takes about 24 GB of disk space.
| Area | Requirement |
|---|---|
| Hypervisor | VMware vSphere/ESXi with the OVA. Proxmox, KVM or Hyper-V via the QCOW2 image or the hypervisor's import. |
| CUCM | Version 11.5 or later |
| Microsoft Teams | Teams Phone licences and Direct Routing as required by Microsoft |
| Update to 4.9.49 | EasyUC 4.8.5 or later, EasyUC Manager 2.0.4 or later, K3s 1.34.0 or later, all nodes amd64 |
| Internet access | not needed for installation |
Clusters with several nodes
For redundancy we recommend three nodes. How large each node needs to be depends on the number of agents, voice channels and active modules. We size the nodes together with you before you create the VMs.
Note
How a cluster reacts when a node fails and where the limits are is described under Redundancy.
Network and firewall
Which connections to allow between clients, CUCM, Microsoft and the nodes is listed in the Ports and firewall reference. For a cluster, place all nodes in the same network segment.
First installation
New installations use the OVA with EasyUC Manager 2.0.11 (EasyUC-Appliance-Manager-2.0.11-ESXi.ova, in the customer portal under Downloads). The OVA contains only the Manager; you then install EasyUC 4.9.49 in the Manager via EasyUC update → Erstinstallation.
To set up the first node:
-
Import the OVA
Import the OVA in VMware ESXi with "Create a VM from an OVF or OVA file". The VM gets 8 vCPU, 16 GB RAM and a 160 GB disk.
-
Log in on the VM console
Start the VM and log in on the console as user
easyuc. A text menu appears. You can also change the IP address and enter your internal NTP servers there if needed. -
Initialise K3s
Choose Initialize K3s (first node). The installation runs offline and sets up K3s, Traefik, Longhorn, the operators for MariaDB, Elasticsearch and RabbitMQ and EasyUC Manager 2.0.11.
-
Open the Manager
Open
https://<your-host>/managerin the browser and sign in asadminwith the initial password that the console shows once. It is generated randomly for each appliance; the Manager asks for your own password at the first sign-in. Until you activate your own certificate, the web interface uses a self-signed certificate. -
Install EasyUC
In the Manager, drop the package
easyuc-4.9.49-amd64.eucpkgon the EasyUC-Update page, choose Erstinstallation…, select the modules and confirm with Jetzt installieren. Then set the password of the owner account at the console under Manage K3s → Set EasyUC owner password. -
Upload the licence
Upload the licence file in the EasyUC admin interface at
/admin. This is not done in the Manager. -
Extend as needed
Add nodes, set up the web certificate and configure backups with a schedule and remote target, see Next steps.
Tip
After the installation, take a VM snapshot and keep the licence file somewhere separate from the system.
Next steps
- Add nodes for a three-node cluster
- Choose a deployment type: CUCM, CUCM + ACD, Teams + ACD and other combinations
- Set up the web certificate
- Set up backups with a schedule and remote target
- Open the firewall ports
- Install updates