Installieren von 3CX unter Debian Linux per ISO-Datei

Einführung

3CX stellt eine ISO-Datei mit dem Betriebssystem Debian Linux und 3CX zur Verfügung. Sie erleichtert sowohl die Installation als auch die Verwaltung des Betriebssystems und der Anlage per 3CX Admin-Konsole. Für 3CX muss eine dedizierte Debian-Linux-Instanz verwendet werden.

• Installieren Sie keine weiteren Software-/Update-Pakete für das Betriebssystem, und ändern Sie keine vorgegebenen Einstellungen.
• Installieren Sie keine Betriebssystem-Updates per Befehlszeile. Entsprechende Updates erfolgen automatisch durch 3CX, nachdem diese zuvor getestet und freigegeben wurden.
• Bei selbst vorgenommenen Änderungen am Betriebssystem kann der 3CX-Support nicht länger in Anspruch genommen werden.

Schritt 1: Ermitteln der individuellen Systemanforderungen

• Ihre Maschine benötigt mindestens 1 dedizierte CPU oder 2 vCPUs sowie 2 GB RAM. Wenn Sie Ihre Maschine selbst hosten und Ihr Hoster eine gemeinsam genutzte CPU verwendet, benötigen Sie zwei Kerne.
• Überprüfen Sie die empfohlenen Hardwarespezifikationen, um zusätzliche CPU-Zeit und RAM-Ressourcen zuzuweisen, basierend auf:

• Anzahl gleichzeitiger Gespräche, die das System verarbeitet.
• Anzahl der aktiven Nutzer – 100 aktive 3CX-Webclient-Sitzungen sind anspruchsvoller als 100 gelegentliche Anrufe über IP-Telefone.
• Verwendung der Anrufaufzeichnung – beansprucht das System für die Audiomischung und Dateispeicherung.

• 3CX kann auf jeder Hardware installiert werden, auf der Debian 12 läuft. Wenn Sie eine Barebone-Installation durchführen möchten, stellen Sie sicher, dass die Hardware mit Debian 12 funktioniert und dass der Hardwarehersteller Sie bei allen Problemen unterstützt. 3CX kann Sie bei Problemen bei der Installation von Debian 10 auf Barebone-Hardware nicht unterstützen.
• Konfigurieren Sie auf dem 3CX-Host kein virtuelles Netzwerk, keine VPN-Schnittstelle oder die TeamViewer VPN-Option.

Schritt 2: Überprüfen der Anforderungen der VM-Plattform

3CX wurde umfassend für den VM-Einsatz getestet. Folgende Hypervisoren werden unterstützt:

• VMware vSphere Hypervisor (ESXi) 6.5u1 und höher mit installierten VMware Tools
• Microsoft Hyper-V Server (6.2) und höher mit Unterstützung von Debian 12. Erforderliche Einstellungen zum Betrieb von 3CX auf Microsoft-Plattformen wie Hyper-V finden Sie hier.
• KVM 2.8 und höher
• Citrix XenServer 7.0 und höher
• Vermeiden Sie den Einsatz der 3CX Anlage auf konvertierten VMs (P2V). Andernfalls treten unter Umständen Probleme mit der Zeitsynchronisierung auf, und das Gast-­Betriebssystem führt keine entsprechende Synchronisierung mit dem Hypervisor durch.

.

Schritt 3: Überprüfen der Netzwerk- und Firewall-Anforderungen

• Bei der Installation in einem lokalen Netzwerk (On-Premise) muss für das LAN eine Konfigurierung für private Netze gemäß RFC 1918 erfüllt sein (mit dem IP-Bereich 172.16.0.0/12, 10.0.0.0/8 oder 192.168.0.0/16).
• 3CX muss eine dedizierte öffentliche IP-Adresse zugewiesen werden.
• Die Konfiguration von Split DNS ist erforderlich, damit der 3CX-FQDN sowohl für das interne als auch externe Netzwerk aufgelöst wird.
• Ist 3CX auf einem Server hinter einer NAT-Firewall installiert, muss eine Port-Weiterleitung erfolgen. Nähere Informationen erhalten Sie in der Anleitung zur Firewall- und Router-Konfiguration.

Schritt 4: Installieren von Debian für 3CX

So installieren Sie Debian für 3CX:

1. Laden Sie die neueste 3CX-ISO herunter. Die V20-ISO finden Sie hier. Die V18-ISO steht hier zum Download bereit.
2. Bei Verwendung eines Hypervisors/virtualisierten Betriebssystems: Wählen Sie als Option zum Starten von CD das Booten per ISO-Image aus, und stellen Sie sicher, dass beim Starten das CD-Laufwerk angesprochen wird. Falls die Installation auf einem Mini-PC erfolgt, erstellen Sie ein bootfähiges Image auf einem USB-Laufwerk und verbinden Sie dieses mit einem der USB-Ports des Mini-PCs. Legen Sie im BIOS das Booten von USB-Laufwerken fest, um die Installation entsprechend zu starten.
3. Starten Sie Ihr System mit Hilfe der ISO-Datei. Wählen Sie im Boot-Startbildschirm die Option "Install" zum Installieren von 3CX aus und drücken Sie die Enter-Taste.
4. Wichtiger Hinweis: Sie müssen dem 3CX-Hostrechner eine statische IP-Adresse zuweisen. Wählen Sie "<Go Back>" (Zurück), oder drücken Sie die Escape-Taste, wenn Sie zur Eingabe des Hostnamens aufgefordert werden, um zuvor die IP-Adresse des Systems anzugeben. Aktive Dienste der Telefonanlage, verbundene 3CX-Apps und IP-Telefone nutzen diese IP-Adresse. Um die IP-Adresse eines laufenden 3CX-Systems zu ändern, müssen Sie den zugehörigen Server neu starten. Anschließend ist es erforderlich, verbundene Apps sowie IP-Telefone neu bereitzustellen. Falls Sie keine statische IP-Adresse festlegen möchten, fahren Sie mit Schritt 6 fort.

5. Um die statische IP-Adresse von 3CX festzulegen, wählen Sie die Option "Configure Network Manually" und drücken Sie die Enter-Taste. Wählen Sie "<Continue>", um fortzufahren. Geben Sie die Netzmaske des Netzwerks ein und wählen Sie "<Continue>", um fortzufahren. Geben Sie die IP-Adresse des Standard-Gateways des Netzwerks ein, und wählen Sie "<Continue>", um fortzufahren. Geben Sie abschließend die IP-Adresse(n) des/der Nameserver(s) ein und wählen Sie "<Continue>", um fortzufahren.
6. Geben Sie den Hostnamen des Computers an, um ihn im Netzwerk leichter identifizieren zu können. Verwenden Sie für den Namen nur die Zeichen "a" bis "z", "0" bis "9" und den Bindestrich (-).
7. Geben Sie den Dömanennamen ein. Verwenden Sie dieselbe Domäne wie bei allen anderen Computern im Netzwerk, zum Beispiel
   mycompany.com
   . Wählen Sie nach der Eingabe "Continue >", um fortzufahren.
8. Wählen Sie die gewünschte standardmäßige Systemsprache aus und drücken Sie die Enter-Taste, um fortzufahren.
9. Wählen Sie Ihren aktuellen Standort aus und drücken Sie die Enter-Taste, um fortzufahren.
10. Legen Sie das Passwort des
    root
    -Kontos des Computers fest. Wählen Sie "<Continue>". Anschließend werden Sie dazu aufgefordert, das Passwort zur Bestätigung ein zweites Mal anzugeben. Wählen Sie "<Continue>", um fortzufahren.
    Wichtiger Hinweis: Legen Sie für das
    Root
    -Konto ein sicheres Passwort fest, da für dieses Konto keine Beschränkungen gelten.
11. Wählen Sie die Zeitzone des Systems aus und drücken Sie die Enter-Taste, um fortzufahren.

12. Partitionieren Sie die zur Installation verwendete Festplatte. Wählen Sie "Guided - use entire disk", um die gesamte Festplatte zu verwenden. Drücken Sie die Enter-Taste, um fortzufahren.
13. Bestätigen Sie die Auswahl der Festplatte, indem Sie die Enter-Taste drücken.
    Wichtiger Hinweis: Falls die Installation auf einem Computer ohne bereits vorhandenes Betriebssystem erfolgt, beachten Sie, dass sämtliche auf der Festplatte gespeicherten Daten gelöscht werden.
14. Wählen Sie die Option "All files in one partition", um alle Dateien in einer Partition zu speichern. Drücken Sie die Enter-Taste, um fortzufahren.
15. Wählen Sie "Finish partitioning and write changes to disk" und drücken Sie die Enter-Taste, um die Partitionierung durchzuführen und mit der Installation von Debian für 3CX fortzufahren.
16. Bestätigen Sie die Frage "Write the changes to disks?" mit "Yes", und drücken Sie die Enter-Taste, um die Änderungen durchzuführen. Der Installationsvorgang nimmt je nach verwendeter Hardware 5 bis 20 Minuten in Anspruch. Nach Abschluss der Debian-Installation erfolgt ein Neustart des Computers. Anschließend wird das 3CX-Installationsprogramm automatisch gestartet.
17. Wählen Sie die Option "3CX Version XX" zum Installieren aus, und klicken Sie auf "<OK>". Stimmen Sie den Bedingungen der 3CX-Lizenzvereinbarung zu.

Schritt 5: Hochladen der 3CX-Konfigurationsdatei

Nach Abschluss der 3CX Debian-Installation und dem Neustart des Servers muss die 3CX-Konfigurationsdatei hochgeladen werden, um die Installation abzuschließen:

1. Falls Sie noch nicht über die 3CX-Konfigurationsdatei verfügen, rufen Sie in Ihrem Webbrowser folgende Seite auf: www.3cx.de/install/
2. Melden Sie sich mit den Zugangsdaten Ihres Kundenkontos an, und wählen Sie aus, dass 3CX als On-Premise-/selbstverwaltetes System eingerichtet werden soll. Nach Abschluss dieses Vorgangs erhalten Sie einen Link zur Konfigurationsdatei. Kopieren Sie diesen Link zur weiteren Verwendung oder laden Sie die Konfigurationsdatei direkt herunter. Weiterführende Informationen hierzu finden Sie unter Installieren und Einrichten von 3CX.
3. Wählen Sie unter den folgenden Installationsoptionen aus:

1. Wählen Sie Option 1, um den Installationsassistenten per Webbrowser zu starten. Geben Sie hierfür in Ihrem Webbrowser folgende URL ein: http://<IP-Adresse des 3CX-Computers>:5015
2. Wählen Sie ggf. Option 2 für eine Konfiguration per Befehlszeilen-Tool.

4. Nach Abschluss der Installation müssen Sie Ihr Passwort festlegen. Melden Sie sich mit Hilfe der E-Mail-Adresse, die Sie zur Registrierung verwendet haben, bei 3CX an.

Schritt 6: Konfigurieren von Split DNS

Sie müssen den 3CX FQDN so konfigurieren, dass er sowohl intern in Ihrem lokalen Netzwerk als auch extern außerhalb Ihres Netzwerks unterstützt wird. Informieren Sie sich, wie Sie Split DNS konfigurieren.

Schritt 7:  Konfigurieren der Firewall

Um einen SIP-Trunk zu konfigurieren oder unternehmensexterne Telefone anzubinden, müssen Sie Ihre Firewall so konfigurieren, dass der Sprachverkehr in und aus Ihrem Netzwerk zugelassen wird. Details hierzu finden Sie im Leitfaden zur Firewall-Konfiguration.

Siehe auch

• Erstellen und Konvertieren von OpenSSH-Schlüsseln
• Installieren der 3CX Telefonanlage unter Microsoft Windows

Letztes Update

Dieses Dokument wurde zuletzt am 11. März 2024 aktualisiert.

https://www.3cx.de/docs/adminhandbuch/debian-linux-telefonanlage-installieren/