3 belangrijkste redenen en andere veelvoorkomende problemen waardoor uw upgrade mislukt.

Na het uitbrengen van V20 beta 1 en update 9 zijn er een significant aantal upgrades gedaan. De resultaten zijn interessant. Dit zijn de belangrijkste redenen waarom een upgrade niet start:

Nummer #1 – Onvoldoende cores – minimaal 2 vereist

De voornaamste reden voor een mislukte upgrade is dat de machine niet over 2 of meer cores beschikt. Om 3CX goed te laten draaien, heeft u 2 cores nodig. 3CX is een realtime applicatie die audio en soms zelfs video verwerkt. Deze kan het zich niet veroorloven om de CPU zelfs maar enkele seconden te missen. Dit zal leiden tot audioproblemen, een slechte ervaring bieden en uiteindelijk onze merknaam beïnvloeden. Als de machine niet genoeg cores heeft, zal de upgrade niet mislukken, maar gewoon niet draaien. U moet eerst de machine upgraden naar 2 cores.

Nummer #2 – Bronlijst is bewerkt

De tweede reden dat uw upgrade mislukt is vanwege de installatie van niet-ondersteunde pakketten op de ISO. In dit geval kunnen we de uitkomst van de upgrade niet voorspellen, dus zullen we de upgrade niet uitvoeren. De enige manier om in dit geval te upgraden is door een back-up en restore. Enkele voorbeeldbronlijsten die we hebben gevonden zijn osconfig_managed_7a718e6aad.list, busylight.list, mysql.list, hetzner-mirror.list.

Nummer #3 – Niet genoeg RAM – minimaal 2 GB vereist

Naast realtime verwerking van audio en video, host 3CX ook een webserver met een volledige webclient. Dit neemt wat geheugen in beslag. 1 GB is tegenwoordig niets bijzonders. Om een mission critical communicatiesysteem te draaien, is 2 GB echt een minimum vereiste. Dus u moet uw systeem upgraden om voldoende geheugen te hebben.

Geteste Omgevingen

  • Installatie gebaseerd op de 3CX ISO zonder enige wijzigingen op bare bones en  virtuele omgevingen.
  • Toonaangevende cloud platform providers:
    • Google Cloud (Compute Engine)
    • Amazon AWS (+LightSail)
    • DigitalOcean
    • Microsoft Azure – (Niet aanbevolen)
    • Vultr

Proces

Dus wat gebeurt er wanneer u een upgrade uitvoert? Uw systeem zal upgraden van Debian 10 naar Debian 11 en vervolgens naar 12. Afhankelijk van de specificaties van de machine, de grootte van uw 3CX-installatie, uw internetverbinding en of het systeem up-to-date is, kan de upgrade alles van 10-15 minuten tot een uur of langer duren. Na een succesvolle upgrade zal uw systeem opnieuw opstarten. Er wordt een e-mail verzonden naar de systeembeheerder met het resultaat van de upgrade. De e-mail informeert u of de upgrade is afgebroken, mislukt of succesvol was.

Belangrijk

  • Probeer niet te interacteren met het systeem/de instance tijdens het upgrade proces
  • Maak een volledige back-up van 3CX en bewaar deze buiten de instance
  • Neem indien mogelijk een volledige snapshot van de VM
  • Tijdens de upgrade zal 3CX niet beschikbaar zijn, dus zorg ervoor dat u deze buiten kantooruren plant.

Andere veelvoorkomende problemen

  • Handmatig toegevoegde/verwijderde repositories
  • Handmatig geïnstalleerde pakketten, die afhankelijkheidsproblemen veroorzaken
  • Externe administratie- of monitoring tools die kunnen interfereren met het upgrade proces (bijvoorbeeld APT blokkeren, proberen services te herstarten)
  • Aangepaste lokale of TZdata
  • Gewijzigde/kapotte configuratiebestanden
  • Gemanipuleerde root certificaten
  • Beperkte internettoegang
  • Gebruikers die interacteren met het systeem terwijl de upgrade draait

Wat als de upgrade mislukt

Controleer dan de systeemvereisten als de upgrade mislukt. Los het op en voer de upgrade opnieuw uit. Als het nog steeds mislukt, dient u een volledige back-up te maken en te herstellen naar een nieuw systeem.

Nogmaals de vereisten

  • Minstens 2vCPU, 2GB RAM en 5GB vrije schijfruimte
  • Geen derde partij bronbestanden onder /etc/apt/sources.list.d/ (anders dan 3CX en de provider agents)
  • Geen software van derden geïnstalleerd
  • Ononderbroken connectiviteit met repo.3cx.com en deb.debian.org

Let op: We verzamelen logs uitsluitend voor debugdoeleinden die kort na een voltooide upgrade worden verwijderd. Logs van mislukte upgrades worden beoordeeld door onze ingenieurs om potentiële valkuilen te bepalen en het upgrade proces te verbeteren.

Samenvatting

Het draaien van een dedicated instance vereist het juiste formaat instance. Voor zeer kleine installaties (minder dan 5-10 extensies) overweeg het gebruik van 3CX SMB of 3CX FREE. Als de klant echt een dedicated systeem nodig heeft, dan moeten ze begrijpen dat de specificaties moeten worden afgestemd op de recente en redelijke vereisten. Succes met Upgraden!

Blijf op de hoogte

Laat ons weten wat u ervan vindt via het Forum. Volg ons op X en LinkedIn en blijf op de hoogte van de laatste ontwikkelingen.