Vultr WHMCS-Modul

• Modulinformationen
• Einführung
• System Anforderungen
• Voraussetzungen
• Einschränkungen
• Umfang
• Modulfunktionen
• API-Schlüssel erstellen
• Installation
• Erstes Setup
• Modulkonfiguration
• Bestellvorgang
• FAQ

Hinweis : Bitte lesen Sie dieses Dokument vollständig durch, bevor Sie das Vultr WHMCS-Modul installieren

Modulinformationen

• Version: 2.0.0 (aktualisiert)
• Erscheinungsdatum: 25. Juni 2019
• Änderungsprotokoll
• Bitte senden Sie alle Problem- / Fehlerberichte an das offizielle Vultr WHMCS Github-Repository

Einführung

Die Vultr-Plattform bietet eine leistungsstarke, funktionsreiche API, mit der Benutzer jeden Aspekt ihres Kontos steuern können. Das Vultr WHMCS-Modul bietet Hosting-Anbietern eine vollautomatische Lösung, mit der sie ihren Kunden zuverlässige Cloud-Server auf der Vultr-Plattform anbieten können.

Hinweis: Die aktuelle Version des Moduls ist eine vollständige Überarbeitung des Originalmoduls, jedoch kompatibel mit vorhandenen Vultr-basierten Produkten in WHMCS.

System Anforderungen

• WHMCS Version 7.2.x oder neuer
• PHP Version 7.1.x oder neuer
• MySQL  5.6 , MariaDB  5.6 , MariaDB  10.0 oder MariaDB  10.1 .
• ionCube Loader.

Voraussetzungen

• Vultr API-Schlüssel
• Ihre WHMCS-Server-IPs werden für den API-Zugriff auf die Whitelist gesetzt

Anmerkungen

• Sie müssen die IPv4- und IPv6-Adressen Ihres WHMCS-Servers für den API-Zugriff auf die Whitelist setzen
  • Wenn Ihr Server über mehrere IPv4-Adressen verfügt, können Sie diese einzeln oder das gesamte Subnetz auf die Whitelist setzen.
  • Wenn Ihr Server über eine IPv6-Adresse verfügt, ist es am besten, das gesamte / 64-Subnetz auf die Whitelist zu setzen
• WHMCS Version 6 wird aufgrund des End-of-Life nicht unterstützt.
• PHP Version 7.0.x wird aufgrund des End-of-Life nicht unterstützt.
• Es ist nicht geplant, ältere Versionen von WHMCS und PHP zu unterstützen.
• Sie müssen die vom Modul generierten konfigurierbaren Optionen für die Produkte verwenden. Das Erstellen eines eigenen wird wahrscheinlich einen Konflikt verursachen.

Einschränkungen

Nachfolgend finden Sie eine Liste der Optionen, die das Modul aufgrund seines Designs nicht enthält.

1. Fügen Sie zusätzliche IPv4-Adressen hinzu.
2. Aktivieren Sie das private Netzwerk, nachdem eine virtuelle Maschine bereitgestellt wurde.
3. Wechseln zwischen Betriebssystem und Apps.
4. Wechsel zwischen Linux und Windows.

Umfang

Dieses Dokument behandelt den Prozess der Installation und Konfiguration des offiziellen Vultr WHMCS-Moduls. Von Websites von Drittanbietern heruntergeladene Module werden von Vultr nicht unterstützt.

Modulfunktionen

• One-Click-Erstellung von VPS-Produkten basierend auf Vultr
  • Sie müssen die Preise für jedes Produkt und jede konfigurierbare Option manuell festlegen.
• Virtuelle Maschinen bereitstellen und aktualisieren
• Ein- / Ausschalt- / Zyklusfunktion
• HTML5 VNC-Konsole
• rDNS-Steuerung
• Privates Netzwerk
• Startskripte
• SSH-Schlüssel
• Schnappschuss-Steuerung
• Stellen Sie VMs aus einer Liste vordefinierter ISOs bereit
• Stellen Sie VMs aus einer Liste vordefinierter Snapshots bereit
• Aktivieren / Deaktivieren bestimmter ISOs und Snapshots für VM-Bereitstellungen
• Bereitstellungsorte aktivieren / deaktivieren
• Vultr DNS-Unterstützung mit Vanity DNS-Unterstützung (Custom Nameserver)

API-Schlüssel erstellen

1. Melden Sie sich im Vultr Client-Bereich an.
2. Klicken Sie auf Konto.
3. Klicken Sie auf API.
4. Klicken Sie auf API aktivieren.
5. Whitelist die IP-Adressen Ihres WHMCS-Servers unter Zugriffskontrolle.

Installation

Der erste Schritt besteht darin, das Vultr WHMCS-Modul hier herunterzuladen

Neue Installation

1. Extrahieren Sie das ZIP-Archiv.
2. Laden Sie die Moduldateien gemäß der unten definierten Verzeichnishierarchie auf Ihren WHMCS-Server hoch

Upgrade von einer älteren Version des Moduls

1. Sichern Sie Ihre Datenbank und Dateien
2. Löschen Sie die Verzeichnisse modules/addons/vultrund vollständig modules/servers/vultr.
3. Extrahieren Sie das neue Modul und laden Sie es hoch.

Verzeichnishierarchie

Archiv heruntergeladen

• Module
  • Addons
    • vultr
  • Server
    • vultr

Erstes Setup

1. Laden Sie das Modul wie oben beschrieben hoch
2. Melden Sie sich bei Ihrem WHMCS Admin Panel an und navigieren Sie zu Setup -> Addon Modules.
3. Vultr ModuleKlicken Sie neben auf die ConfigureSchaltfläche.
4. Aktivieren Sie das Kontrollkästchen neben Hooks Enabled.
5. Geben Sie Ihren API-Schlüssel in das API KeyFeld ein.
6. Setup Access Controlfür Administratorund andere Rollen, für die Sie es aktivieren möchten.
7. Klicken Save Changes
8. Melden Sie sich bei Ihrem WHMCS Admin Panel an und navigieren Sie zu Addons -> Vultr Module, um Ihre Moduloptionen zu konfigurieren, die im nächsten Abschnitt dieses Dokuments aufgeführt sind

Modulkonfiguration

In diesem Abschnitt der Dokumentation werden alle verfügbaren Konfigurationsoptionen für das Modul vorgestellt, ihre Funktionsweise erläutert und ihre Konfiguration erläutert.

Produktersteller

In diesem Abschnitt können Sie ein Vultr-basiertes Produkt in WHMCS erstellen. Es gibt zwei Modi Single Product Creatorund Multiple Product Creator.

In diesem Single Product CreatorModus können Sie ein Produkt basierend auf den verfügbaren Vultr-Paketen erstellen, eine Produktgruppe auswählen und die Preise für das Produkt festlegen, das Sie hinzufügen. Die Preise für konfigurierbare Optionen wie Snapshots, Windows, cPanel-Apps usw. müssen manuell zu den konfigurierbaren Optionen des Produkts hinzugefügt werden.

Der Multi Product CreatorWille Massenerstellung Vultr-basierte VPS - Pakete in Ihrer WHMCS, aber Sie werden die Preise für die einzelnen Pakete manuell Setup sowie Preisinformation für die konfigurierbaren Optionen, ähnlich dem Single Product CreatorModus.

Produkte

In diesem Abschnitt wird eine vollständige Liste aller Ihrer Vultr-basierten Produkte in WHMCS angezeigt, und Sie können schnell zu der Editoder der Configurable Options jeweiligen Seite navigieren . Sie können ein Produkt auch von dieser Seite löschen. Dieser Abschnitt ist sehr nützlich, wenn Sie schnell ein Vultr-Produkt in Ihrem WHMCS-Verwaltungsbereich finden möchten, um es zu ändern, oder wenn Sie die konfigurierbaren Optionen dafür ändern möchten.

DNS

Das Vultr WHMCS-Modul unterstützt Vanity-Nameserver (benutzerdefinierte ns1 und ns2.domain.com). Das Einrichten von Vanity-Nameservern erfordert einen ersten Schritt: Erstellen Sie die benutzerdefinierten Nameserver mit Ihrem Domain-Registrar und verweisen Sie sie auf die IPs ns1.vultr.comund ns2.vultr.comlösen Sie sie auf. Wenn Sie fertig sind, befolgen Sie bitte die folgenden Schritte:

1. Melden Sie sich bei Ihrem WHMCS Admin Panel an.
2. Weiter Addons -> Vultr Module.
3. Klicken Sie auf DNS.
4. Fügen Sie die Werte für Nameserver 1und hinzu Nameserver 2und klicken Sie auf Save Changes.
5. Du bist fertig.

Bitte beachten Sie, dass Vanity-Nameserver auf neu hinzugefügte DNS-Zonen / -Domänen angewendet werden. Bestehende müssen manuell unter https://my.vultr.com geändert werden.

Serverstandort

Sie haben die Möglichkeit, bestimmte Cloud-Standorte zu aktivieren und zu deaktivieren, sodass Ihre Kunden virtuelle Maschinen nur an den von Ihnen ausgewählten Standorten bereitstellen können. Beachten Sie, dass die Auswahl des Cloud-Standorts während des Bestellvorgangs nicht möglich ist, da Standorte dynamisch geladen werden, je nachdem, wo das ausgewählte Paket zum Zeitpunkt der Bereitstellung verfügbar ist.

Führen Sie die folgenden Schritte aus, um auszuwählen, welche Standorte für Ihre Kunden aktiviert werden sollen:

1. Melden Sie sich bei Ihrem WHMCS Admin Panel an.
2. Weiter Addons -> Vultr Module.
3. Klicken Sie auf Server Location.
4. Klicken Sie auf die EnabledSchaltfläche, um die Standorte zu deaktivieren, die Sie deaktivieren möchten (klicken Sie auf die Schaltfläche, wenn Disabledder Standort erneut aktiviert wird).
5. Du bist fertig.

Schnappschüsse

Mit dem Vultr WHMCS-Modul können Sie einen oder mehrere Snapshots in Ihrem Konto erstellen. Dies Publicbedeutet, dass Sie Ihren Kunden erlauben würden, neue virtuelle Maschinen aus diesen Snapshots bereitzustellen, wenn sie dies wünschen. Alle Snapshots in Ihrem Konto sind im Modul Disabled standardmäßig aktiviert und müssen aktiviert werden.

Führen Sie die folgenden Schritte aus, um auszuwählen, welche Snapshots für Ihre Kunden veröffentlicht werden sollen:

1. Melden Sie sich bei Ihrem WHMCS Admin Panel an.
2. Weiter Addons -> Vultr Module.
3. Klicken Sie auf Snapshots.
4. Klicken Sie auf die DisabledSchaltfläche, um die Snapshots zu aktivieren, die Sie veröffentlichen möchten (klicken Sie auf die Schaltfläche, wenn angegeben Enabledwird, dass der Snapshot wieder aktiviert wird).
5. Du bist fertig.

ISO

Ähnlich wie bei der Snapshot-Funktion können Sie eine oder mehrere der benutzerdefinierten hochgeladenen PublicISOs in Ihrem Konto erstellen. Dies bedeutet, dass Sie Ihren Kunden erlauben würden, neue virtuelle Maschinen von diesen ISOs aus bereitzustellen, wenn sie dies wünschen. Alle ISOs in Ihrem Konto sind im Modul Disabled standardmäßig aktiviert und müssen aktiviert werden.

Führen Sie die folgenden Schritte aus, um auszuwählen, welche Snapshots für Ihre Kunden veröffentlicht werden sollen:

1. Melden Sie sich bei Ihrem WHMCS Admin Panel an.
2. Weiter Addons -> Vultr Module.
3. Klicken Sie auf ISO.
4. Klicken Sie auf die DisabledSchaltfläche, um die ISOs zu aktivieren, die Sie veröffentlichen möchten (klicken Sie auf die Schaltfläche, wenn angegeben Enabledwird, dass die ISO wieder aktiviert wird).
5. Du bist fertig.

Bestellvorgang

Die Bestellung von Produkten auf Vultr-Basis in WHMCS erfolgt in drei Schritten.

Schritt 1

Kundenbestellungen im WHMCS-Kundenbereich / Warenkorb: Der Kunde gibt eine Bestellung für eine virtuelle Maschine auf. Sie werden gebeten einzutreten:

• Hostname
• Root-Passwort
• NS1 & NS2

Dies ist das Standard-WHMCS-Bestellformular, über das Vultr keine Kontrolle hat. Sie können gerne Ihre WHMCS-Bestellformularvorlage ändern, um eine dieser Optionen auszublenden. Beachten Sie bitte, dass das ausgewählte Root-Passwort in der Reihenfolge für nicht verwendet wird, da die API von Vultr für jede VM ein zufälliges sicheres Passwort generiert. Wenn ein Client über einen Snapshot bereitgestellt wird, muss er außerdem das Root-Kennwort für den Snapshot vorher kennen, da er sich sonst nicht anmelden kann.

Darüber hinaus wird der Client aufgefordert, auszuwählen, ob automatische Sicherungen, das Snapshot-Limit und der Betriebssystemtyp aktiviert werden sollen.

In Bezug auf den Betriebssystemtyp gibt es 4 Optionen im Dropdown-Menü, die OS Typeim Bestellformular unter angezeigt werden

1. Eine Liste aller verfügbaren Betriebssystemabbilder
2. ISO
3. Schnappschuss
4. Anwendung

Durch Auswahl Applicationwird eine Liste aller verfügbaren One-Click-Apps von Vultr aktiviert. Mit ISO und Snapshot kann der Kunde auswählen, von welchem ​​ISO oder Snapshot die virtuelle Maschine bereitgestellt werden soll.

Schritt 2

Der Administrator würde die Bestellung genehmigen und den Service in WHMCS bereitstellen (oder Sie können festlegen, dass dies ein automatisierter Prozess in der Produktoption in WHMCS ist, wie bei jedem anderen Produkt in WHMCS.

Schritt 3

Der Kunde müsste den Bestellvorgang im Kundenbereich abschließen, indem er eine Tabelle / einen Spitznamen für seinen Server, einen Hostnamen und andere Optionen wie SSH-Schlüssel, IPv6, privates Netzwerk oder Startskript auswählt.

FAQ

Ich habe einen Fehler bezüglich eines Verbindungsfehlers erhalten.

Stellen Sie sicher, dass Ihrem API-Schlüssel kein Leerzeichen vorangestellt oder mit einem Suffix versehen ist und dass die IPv4- und IPv6-Adressen Ihres Servers beide für den API-Zugriff auf die Whitelist gesetzt sind. Sie können Ihre API-Regeln im Mitgliederbereich überprüfen .

Wenn die Schlüssel- und ACL-Regeln korrekt sind, können Sie Ihren Schlüssel weiter testen, indem Sie sich bei Ihrem WHMCS-Server anmelden und direkte API-Aufrufe mit cURL ausführen. cURL-Beispiele finden Sie in unserem API-Beispielabschnitt .

Wie spezifiziere ich ein Standard-Startskript über das Auto-Setup-System?

Wie bereits erwähnt, wird vom Kunden erwartet, dass er die Bereitstellung der virtuellen Maschine im Clientbereich abschließt, nachdem er seine Optionen nach seinen Wünschen angepasst hat. Beachten Sie bitte, dass die Liste der Standorte abhängig von der Verfügbarkeit des ausgewählten Plans in den Cloud-Standorten von Vultr dynamisch ausgefüllt wird - siehe Schritt 3 oben. Derzeit gibt es keine Funktion zum Einrichten eines globalen Startskripts.

Wie aktualisiere ich die Anwendungen in den Konfigurationsoptionen?

Wenn Sie alle verfügbaren Anwendungen auflisten möchten, können Sie diesen API-Befehl verwenden und die gewünschten Anwendungen in den konfigurierbaren Optionen hinzufügen. Die automatische Synchronisation ist im Modul nicht vorhanden.