Überblick
Einführung
Das Asteraid-Netinstall-ISO ist ein minimales Installationsabbild für die netzwerkbasierte Bereitstellung des Asteraid-Verwaltungssystems. Es lädt Pakete bei Bedarf herunter, sodass das Basisabbild klein bleibt und stets die neuesten Komponenten installiert werden.
Spezifikationen
Hardware-Anforderungen
| Komponente | Physischer Server | Virtuelle Maschine |
|---|---|---|
| CPU | 1 CPU (Intel/AMD x86_64) | 1 vCPU x86_64 |
| Arbeitsspeicher | mind. 2 GB | mind. 2 GB |
| Speicher (nur Betriebssystem mit Docker-Images und -Containern. Für Benutzerdaten — Backups, Audioaufnahmen, CDRs usw. — separate Datenträger verwenden.) | mind. 16 GB | mind. 16 GB |
| Netzwerk | Ethernet-Adapter mit 1 Gbit/s (WLAN nicht unterstützt) | Ethernet-Adapter im Bridge-Modus (NAT nicht empfohlen) |
| Boot-Modus | BIOS oder UEFI | BIOS-kompatibel |
Hinweis: Dies sind die Mindestanforderungen. Produktivumgebungen benötigen in der Regel mehr Ressourcen. In den meisten Fällen genügen 2 CPU-Kerne und 8 GB RAM.
Konnektivität
Netzwerkanforderungen
Stabile InternetverbindungMindestens 5 Mbit/s empfohlen.
DHCP-NetzwerkAutomatische IP-Konfiguration ist erforderlich.
Firewall-ZugriffHTTP/HTTPS-Zugriff auf die Asteraid-Repositorys muss erlaubt sein.
Proxy-KonfigurationKonfigurieren Sie die Proxy-Einstellungen, falls Sie hinter einem Unternehmens-Proxy sind.
Wählen Sie einen Weg
Installationsmethoden
Importieren Sie ein fertiges VM-Abbild, booten Sie von einem Wechsel- oder Netzwerkmedium oder stellen Sie es direkt mit Docker bereit.
OVA-Abbild importieren
- OVA-Container herunterladen
- Importieren Sie den Container in Ihren Hypervisor. Proxmox 6+ und ESXi 7+ werden unterstützt. Folgen Sie der Dokumentation Ihres Hypervisors, um den Container-Import korrekt durchzuführen.
- Verbinden Sie den Netzwerkadapter mit dem passenden virtuellen Switch. Wenn Sie mehrere virtuelle Maschinen importieren möchten, prüfen Sie sorgfältig die MAC-Adressen der Klone, um Konflikte zu vermeiden.
- Starten Sie das Gastsystem.
- Folgen Sie den Schritten nach der Installation.
Hyper-V-Abbild importieren
- Hyper-V-Archiv herunterladen
- Entpacken Sie es in einen neuen, leeren Ordner. Importieren Sie den Inhalt in Ihren Hypervisor. Hyper-V Manager 10+ wird unterstützt.
- Verbinden Sie den Netzwerkadapter mit dem passenden virtuellen Switch. Wenn Sie mehrere virtuelle Maschinen importieren möchten, prüfen Sie sorgfältig die MAC-Adressen der Klone, um Konflikte zu vermeiden.
- Starten Sie das Gastsystem.
- Folgen Sie den Schritten nach der Installation.
USB-/DVD-Installation
- Asteraid netinstall ISO herunterladen
- Verbinden Sie das ISO bei einer virtuellen Maschine als bootfähiges Gerät.
- Erstellen Sie für die Installation auf Hardware ein bootfähiges Medium mit:
root# dd if=/path/to/your/isofile of=/your/usb/disk bs=8M status=progress - Booten Sie vom Medium und folgen Sie der Installationsanleitung.
PXE-Netzwerk-Boot
- BIOS-PXE-Abbild UEFI-PXE-Abbild
- Beispiel-DHCP-Konfiguration (Dnsmasq):
dhcp-range=192.168.68.129,192.168.68.229,255.255.255.0,72h # BIOS-Boot-Modus als Standard dhcp-boot=ipxe.bios,, # UEFI-Boot für de:ad:be:af:00:00 dhcp-host=de:ad:be:af:00:00,set:efi-x64 dhcp-match=set:efi-x64,option:client-arch,7 dhcp-boot=tag:efi-x64,ipxe.efi,, enable-tftp tftp-root=/opt/tftproot - Legen Sie die Boot-Abbilder in
/opt/tftproot/ab und setzen Sie geeignete Leserechte für den dnsmasq-Daemon. - Booten Sie über das Netzwerk und folgen Sie der Installationsanleitung.
Docker-Images bereitstellen
- Laden Sie die Images herunter, erstellen und starten Sie dann die Docker-Container auf einem vorhandenen Docker-Host:
$ git clone https://gitlab.com/plentystars/asteraid-docker-carrier.git $ cd asteraid-docker-carrier $ sudo docker compose build --progress=plain $ sudo docker compose up -d $ docker ps - Für Debugging, Neuerstellung und Wartung siehe die README.md.
Schritt für Schritt
Installationsablauf
Achtung! Dieser Vorgang löscht alle Daten auf
/dev/sda!
- Wählen Sie Alpine Linux OS im Boot-Menü (oder drücken Sie 1).
- Booten Sie in die Live-OS-Umgebung.
- Melden Sie sich als root an (kein Passwort erforderlich).
- Überprüfen Sie die Installationsskripte:
# ls -1 /root setup-alpine-on-sda-unattended.sh setup-asteraid.sh setup-asterisk.sh - Führen Sie die Basisinstallation aus. Nach Abschluss startet das System automatisch neu:
# sh /root/setup-alpine-on-sda-unattended.sh - Wählen Sie Boot from hard drive im Boot-Menü (oder warten Sie 5 Sekunden).
- Booten Sie in das installierte Betriebssystem.
- Melden Sie sich als root an (kein Passwort erforderlich).
- Installieren Sie Docker und die Asteraid-Container:
# sh /root/setup-asteraid.sh - Stellen Sie sicher, dass die Container laufen:
$ docker ps - (Optional — nur wenn Sie Asterisk auf demselben System betreiben möchten) Installieren Sie die Asterisk-Telefonanlage:
# sh /root/setup-asterisk.sh
Abschluss
Schritte nach der Installation
Legen Sie ein root-Passwort für den SSH-Zugriff fest.
Notieren Sie die auf der Konsole angezeigte zugewiesene IP-Adresse.
Weisen Sie bei Bedarf eine feste IP-Adresse zu, indem Sie
/etc/network/interfaces bearbeiten.Öffnen Sie die Weboberfläche unter
https://[SERVER-IP], um die Konfiguration abzuschließen.