Zum Inhalt springen

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.
shell
openssl s_client -connect <host>:2087 </dev/null 2>/dev/null | \
  openssl x509 -noout -fingerprint -sha256
Befehle und Terminal-Ausgaben sind überall auf Englisch, im Panel und auf diesen Seiten. Ein Text, eine Wahrheit: Was Sie hier lesen, ist wörtlich das, was Ihr Host zurückschreibt.
Die Adresse muss https sein, anders als bei DirectAdmin und Pterodactyl, wo ein unverschlüsseltes Panel mit einer Warnung akzeptiert wird. WHM antwortet auf 2086 ohne Verschlüsselung und auf 2087 mit ihr, und Provibr akzeptiert nur das zweite. Über diese Verbindung reist nicht der Schlüssel eines einzelnen Kontos, sondern ein Token, das jedes Konto auf der Maschine anlegen und löschen darf.

Das 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.

  1. Melden Sie sich bei WHM als der Benutzer an, zu dem das Token gehören soll, in der Regel root.
  2. Öffnen Sie Development und danach Manage API Tokens.
  3. 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.
  4. 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.
Ein Token, in dem alles ausgewählt ist, ist root auf dieser Maschine. Beschränken Sie es auf das, was die Integration tatsächlich aufruft: Version, Konten, Pakete, Bandbreite und Domains lesen sowie Konten anlegen, stilllegen, fortsetzen, das Paket wechseln und entfernen. Ein Aufruf, den das Token nicht ausführen darf, scheitert mit der Begründung, die WHM zurückgibt, und das ist ein besserer Ausgang als ein Token, das alles darf.

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.

Ein Zertifikat anzuheften, das sich alle neunzig Tage erneuert, bedeutet, es alle neunzig Tage erneut anzuheften. Eine Integration, die viermal im Jahr stehen bleibt, ist schlimmer als das Problem, das sie lösen sollte; lassen Sie das Feld also leer, sofern Sie keinen Grund für das Gegenteil haben.

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.

Eine Grenze, die ein Paket weglässt, ist keine Grenze von null, sondern gar keine Grenze. Das Standardpaket, das mit WHM mitkommt, hat weder ein Speicherkontingent noch eine Bandbreitengrenze, und das ist ein unbegrenztes Paket und kein kaputtes.

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.

Das Anzeichen ist still. Verschieben Sie ein Konto in ein Paket mit zwei Gigabyte Kontingent, und das Konto meldet seine Grenze weiterhin als unbegrenzt: nichts ist gescheitert, nichts wurde abgelehnt, und die Zahl in diesem Paket bedeutet auf dieser Maschine nichts.

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.
Auf Großbuchstaben ist zu achten. Tippen Sie MeinKunde, und WHM legt meinkunde an, meldet Erfolg und erwähnt es mit keinem Wort. Eine Kennung, die nicht mehr zum Server passt, würde das Konto bei der nächsten vollständigen Abfrage aus dem Panel verschwinden lassen; Provibr schreibt den Namen deshalb vor dem Senden klein und hält den Namen fest, den der Server zurückgegeben hat.

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.

Importierte Konten zählen genauso zu Ihrer Kapazität wie Konten, die Sie bestellt haben. Importieren Sie mehr, als Sie Platz haben, öffnet sich eine Überschreitung mit der üblichen Nachfrist.

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.

Direkt nach einem Paketwechsel meldet das Konto sein neues Paket sofort und seine neue Bandbreitengrenze einige Minuten später. Der Name ist sofort maßgeblich, und die Zahl holt bei einer späteren Abfrage auf; dass die beiden kurz nicht übereinstimmen, ist kein Fehler.

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.