Dokumentation
cPanel und WHM
cPanel ist das Panel, bei dem sich Ihre Kunden anmelden; WHM ist das Panel darüber, und dort bindet sich Provibr an. Es gibt kein Betriebssystem zu installieren und keine Maschine zu starten. Ein Konto wird auf einem bereits laufenden Server angelegt, erhält ein Paket und wird später stillgelegt, in ein anderes Paket verschoben oder entfernt.
Was Sie brauchen
Ein WHM-API-Token, kein Passwort und keine cPanel-Anmeldung. Sie erstellen es in WHM selbst, und es reist als gewöhnlicher Header bei jedem Aufruf des Agenten mit.
- Host: die Adresse von WHM, einschließlich https. Lassen Sie den Port weg, wird 2087 eingesetzt.
- WHM-Benutzer: das Konto, zu dem das Token gehört, in der Regel root.
- API-Token: erstellt unter Manage API Tokens in WHM und Ihnen einmal angezeigt.
- TLS-Fingerabdruck: optional, und auf einem cPanel-Server lassen Sie ihn in der Regel leer. Der Abschnitt unten sagt, warum.
openssl s_client -connect <host>:2087 </dev/null 2>/dev/null | \
openssl x509 -noout -fingerprint -sha256Das Token erstellen
Das Token wird in WHM erstellt, und zwar von dem Benutzer, zu dem es gehören soll. Provibr sieht es danach nie wieder: es wird einmal an Ihren Agenten übergeben und in dessen Tresor versiegelt, und die Plattform behält nur die Feldnamen.
- Melden Sie sich bei WHM als der Benutzer an, zu dem das Token gehören soll, in der Regel root.
- Öffnen Sie Development und danach Manage API Tokens.
- Erstellen Sie ein Token und geben Sie ihm einen Namen, an dem zu erkennen ist, dass es zu Provibr gehört, damit Sie es später wiederfinden, wenn Sie es zurückziehen wollen.
- Kopieren Sie das Token, bevor Sie die Seite verlassen. WHM zeigt es einmal und kann es danach nicht erneut anzeigen; verloren heißt neu erstellen.
Das Zertifikat
Port 2087 ist der verschlüsselte, und ein cPanel-Server trägt in der Regel ein Zertifikat einer öffentlichen Stelle, das das Panel selbst erneuert, etwa alle neunzig Tage. In diesem gewöhnlichen Fall bleibt das Feld für den Fingerabdruck leer, und der Agent prüft das Zertifikat so, wie es ein Browser täte.
Füllen Sie es nur aus, wenn der Server ein Zertifikat vorzeigt, für das keine öffentliche Stelle bürgt, was in der Praxis eine eigene interne Zertifizierungsstelle bedeutet. Nehmen Sie den Fingerabdruck auf dem Agenten-Host ab, damit Sie genau das erfassen, was der Agent zu sehen bekommt, und nehmen Sie ihn erneut ab, sobald dieses Zertifikat ersetzt wird.
Einstellungen
Es gibt keine. Ein WHM entscheidet selbst, auf welcher Maschine ein Konto landet und welche Adresse es bekommt, es bleibt Ihnen also nichts zu wählen. Der Reiter Einstellungen bleibt trotzdem bestehen, denn dort versenden Sie auch die Zugangsdaten erneut.
Hosting-Pakete
Ein WHM-Paket ist die Beschreibung eines Kontos durch das Panel selbst: Speicherkontingent, monatliche Bandbreite, wie viele Subdomains und Postfächer, welche Funktionsliste. Es ist kein Provibr-Plan und kein Betriebssystem. Es ist ein Name, auf den wir verweisen, und sein Inhalt kann sich auf Ihrem Server ändern, ohne dass wir es merken.
Die Integrationsseite kann die Liste der Pakete samt Inhalt abrufen, sodass Sie aus dem wählen, was Ihr Server wirklich hat, statt einen Namen aus dem Gedächtnis zu tippen. Pakete werden in WHM angelegt; Provibr erstellt sie nicht.
Ein Webplan legt ein Paket auf einer Integration fest und gibt ihm einen eigenen Namen. Eine Bestellung mit einem Plan hat Vorrang vor der Auswahl eines losen Pakets, und die lose Auswahl bleibt für die Fälle bestehen, die ein Plan nicht abdeckt.
Ob ein Speicherkontingent überhaupt durchgesetzt wird
Ein cPanel-Server setzt Speicherkontingente nur dann durch, wenn das Dateisystem, auf dem die Konten liegen, Kontingente unterstützt. Ohne das nimmt WHM das Paket an, nimmt die Zahl an und setzt nichts durch.
Der Verbindungstest meldet das. Er liest die Konten auf dem Server und sagt, ob deren Kontingente wirklich durchgesetzt werden, neben der WHM-Version und den Zählungen. Auf einem Server ohne Konten gibt es nichts zu messen, und er sagt das, statt zu raten.
Es ist auch der Grund dafür, dass Provibr die Speichergrenze aus dem Konto liest und nicht aus dem Paket. Was das Konto meldet, ist das, was gilt; die Zahl im Paket ist das, was jemand beabsichtigt hat.
Kontingente einzuschalten ist Arbeit am Server und nicht in Provibr: das Dateisystem muss mit Benutzerkontingenten eingehängt und die Konten müssen neu erfasst werden. Was dafür nötig ist, hängt vom Dateisystem und davon ab, wie die Maschine aufgesetzt wurde; Ihr Hosting-Anbieter oder die cPanel-Dokumentation ist dafür die richtige Stelle.
Wie ein Konto in Provibr aussieht
Ein Hosting-Konto ist eine gewöhnliche Serverzeile vom Typ Webserver. Seine Kennung ist der cPanel-Benutzername, und seine Hauptdomain, das Paket, der Speicherverbrauch und die Bandbreite fahren bei jeder Abfrage mit.
- Ein Konto anzulegen erfordert einen Benutzernamen, eine Hauptdomain, eine Kontaktadresse, ein Paket und ein Passwort.
- Benutzernamen folgen der Regel von WHM selbst: beginnend mit einem Buchstaben, dann Buchstaben und Ziffern, höchstens sechzehn Zeichen. Keine Bindestriche und keine Unterstriche.
- Das Passwort wird nirgends festgehalten. Nur die Tatsache, dass Sie eines angegeben haben; der Wert reist getrennt.
- Danach können Sie stilllegen, fortsetzen, das Paket wechseln und löschen. Es gibt keine Konsole, denn ein Hosting-Konto hat keine.
- Kein Ergebnis wird auf sein eigenes Wort geglaubt. WHM bestätigt eine Änderung mit einer Seite Prozessausgabe statt mit dem neuen Zustand, deshalb endet jede Änderung damit, das Konto erneut auszulesen.
Vorhandene Konten übernehmen
Der Reiter Import zeigt die Konten auf dem Panel und lässt Sie die gewünschten in Provibr übernehmen. Bereits bekannte Konten werden angezeigt, sind aber nicht erneut auswählbar, sodass Sie das ganze Bild sehen und nicht ein gefiltertes.
Auslastung
Speicherverbrauch und Bandbreite fahren bei der regulären Abfrage mit, ein Konto bekommt also ein Auslastungsdiagramm, ohne dass etwas zusätzlich eingeschaltet werden müsste. Die Bandbreite ist eine Monatssumme, die der Server selbst zurücksetzt; sie steht deshalb als Zahl am Konto und nicht als Linie im Diagramm.
Gut zu wissen
- Den Server selbst zu verwalten gibt es nicht. Provibr legt Konten auf einem WHM an, das Sie betreiben, ändert und entfernt sie; die Dienste, DNS-Zonen, das Mail-Routing und die Einstellungen des Panels selbst bleiben, wo sie sind.
- Es gibt keine Konsole. Ein Hosting-Konto ist keine Maschine, es gibt also nichts, woran sich ein Terminal anhängen ließe.
- Postfächer, Datenbanken und DNS innerhalb eines Kontos gehören cPanel. Provibr legt das Konto an und übergibt es; was danach darin geschieht, ist Sache Ihres Kunden und des Panels.
- Reseller-Konten sind nicht abgebildet. Provibr spricht mit WHM als ein einziger Betreiber, und ein Token, das einem Reseller gehört, sieht eine kleinere Welt als root, und dieser Fall wurde nicht gemessen und wird hier nicht beschrieben.