Installation einer App auf Ihrer Website

The Apps install wizard takes three steps: configure the admin account and site settings, review what is about to happen, then watch the install run and collect your login details.

Die App-Installationsanleitung erfordert drei Schritte: Konfigurieren Sie das Admin-Konto und die Site-Einstellungen, überprüfen Sie, was geschehen wird, und beobachten Sie dann die Installation, um Ihre Anmeldedaten zu sammeln.

Bevor Sie beginnen

Sie benötigen eine Sache: eine aktive Website in Ihrem Konto. Der Assistent installiert auf einer Website, die Sie bereits haben; er erstellt keine neue. Wenn Sie keine haben, teilt Ihnen der Assistent dies mit und verlinkt Sie zum Erstellen einer. Siehe Erstellen Ihrer ersten Website.

Sie benötigen auch die apps:write-Berechtigung, die von Konto-Eigentümern und Administratoren bereitgestellt wird.

Erstellen Sie eine Sicherung, bevor Sie auf einer Website installieren, die bereits Inhalte enthält. Der Assistent hat ein Sicherheitsnetz für eine Website, die bereits eine App enthält, das unten beschrieben wird, aber ein manueller Wiederherstellungspunkt, der gezielt erstellt wird, ist immer mehr wert als einer, der automatisch erstellt wird. Siehe Erstellen einer Sicherung.

Zum Assistenten gelangen

Klicken Sie auf Apps in der KPanel-Seitenleiste.
Klicken Sie auf die gewünschte App.
Klicken Sie im rechten Bereich auf [App] installieren.

Die direkte Adresse ist /apps/<app-slug>/install.

Der App-Installationsassistent in KPanel

Schritt 1: Konfigurieren

Der Assistent zeigt die App und dann vier Feldgruppen. Eine Plan-Upgrade empfohlen-Benachrichtigung wird oben angezeigt, wenn die App ein höheres Plan-Level als Ihres vorschlägt: Dies ist ein Ratschlag, und die Installation wird trotzdem fortgesetzt.

Standort

Auf Site installieren. Wählen Sie aus Ihren aktiven Sites. Hier wird die App installiert.

Admin-Konto

Admin-Benutzername. Standardmäßig admin. Dies ist der Benutzername, mit dem Sie sich anmelden, und Sie können später weitere Benutzer hinzufügen.
Admin-Passwort. Ein starkes 16-stelliges Passwort wird für Sie generiert, sobald die Seite geladen wird. Anzeigen zeigt es an und Generieren erstellt ein neues. Sie können auch Ihr eigenes eingeben; es muss mindestens 8 Zeichen lang sein.
Admin-E-Mail. Optional. Wird für Anmeldung und Passwort-Zurücksetzen verwendet. Falls leer gelassen, wird Ihre Konto-E-Mail verwendet.

Speichern Sie das Admin-Passwort, bevor Sie den Assistenten verlassen. Es wird auf dem Überprüfungsbildschirm und erneut auf dem Erfolgreichbildschirm angezeigt, und dann ist es weg. Kapsule speichert keine Kopie, die Sie später abrufen können, daher bedeutet der Verlust, das Passwort über die App selbst zurückzusetzen.

Site-Einstellungen

Site-Name, wenn die App danach fragt.
Sprache. Die Sprache, in der die App eingerichtet ist, gewählt aus sechzehn Optionen, einschließlich Englisch (USA), Englisch (UK), Te Reo Māori und den wichtigsten europäischen und asiatischen Sprachen. Dies setzt die eigene Inhaltssprache der App, nicht die von KPanel.

Datenbank

Wird nur für Apps angezeigt, die eine benötigen. Der Assistent schlägt einen aus Ihrer Domain abgeleiteten Datenbanknamen vor. Nur Buchstaben und Zahlen, keine Unterstriche oder Bindestriche: Das Feld erzwingt dies während der Eingabe. Ändern Sie es gerne, wenn Sie möchten.

Apps, die eine Datenbank benötigen, haben diese automatisch als Teil der Installation bereitgestellt.

Einige Apps fügen darunter ihre eigenen zusätzlichen Felder hinzu, die von der App selbst definiert sind, mit Hilfetexten, sofern zutreffend. Erforderliche Felder sind mit einem Sternchen gekennzeichnet, und Fortfahren bleibt deaktiviert, bis alle ausgefüllt sind.

Am unteren Rand zeigt der Assistent die Ressourcenzusammenfassung für diese App: erwartete Installationszeit, minimales RAM und ob eine Datenbank hinzugefügt wird.

Klicken Sie auf Fortfahren.

Schritt 2: Überprüfen und bestätigen

Der Überprüfungsbildschirm wiederholt die Entscheidungen in einer Liste: App, Website, Site-Name, Admin-Benutzername, Admin-Passwort (mit Ein-/Aus-Schalter), Admin-E-Mail, Sprache und Datenbankname. Der Untertitel macht es deutlich: Nichts wird installiert, bis Sie bestätigen.

Bearbeiten geht zurück, um etwas zu ändern.
Bestätigen und installieren startet den Job.

Verwenden Sie den Überprüfungsbildschirm für die eine Kontrolle, die am wichtigsten ist: die Website-Zeile. Die Installation auf der falschen Site ist der häufigste Installationsfehler, und er ist derjenige, für den der unten beschriebene Überschreibungsschutz existiert.

Schritt 3: Installieren

Der Assistent wechselt zu einer Fortschrittsansicht. Sie sehen in Reihenfolge:

In der Warteschlange: Warten auf Worker. Ihr Job ist in der Warteschlange und wird in Kürze gestartet.
Installiere [App], mit verstrichenen Sekunden gegenüber der typischen Installationszeit und einem Fortschrittsbalken.

Lassen Sie die Seite offen. Die Installation wird im Hintergrund fortgesetzt, wenn Sie fortfahren, aber Sie verlieren die Live-Ansicht und die Zusammenfassung der Anmeldedaten am Ende.

Wenn die Installation auf ein Problem stößt, wird sie automatisch erneut versucht, wobei Neuversuch der Installation mit der Versuchsnummer angezeigt wird. Wenn es deutlich länger als die erwartete Zeit dauert, wird eine Notiz angezeigt, die anbietet zu warten oder abzubrechen.

Abbrechen

Installation abbrechen stoppt den Job. Der Ergebnisbildschirm bestätigt dies: Die Installation wurde gestoppt. Auf Ihrer Site wurde nichts geändert.

Wenn die Site bereits eine App hat

Wenn das Zielverzeichnis der Site bereits eine Site enthält, stoppt die Installation mit einer Warnung, die benennt, was sie gefunden hat:

Dieses Verzeichnis enthält bereits [App]. Das Installieren von [neuer App] wird es ÜBERSCHREIBEN und kann nicht rückgängig gemacht werden. Eine vollständige Sicherung Ihrer aktuellen Site wird zuerst erstellt, damit Sie sie wiederherstellen können.

Zwei Möglichkeiten: Abbrechen oder Sichern und überschreiben. Wenn Sie zustimmen, erstellt der Job eine vollständige Sicherung der vorhandenen Site, bevor etwas geschrieben wird, daher gibt es einen Wiederherstellungspunkt.

Dies ist der Punkt ohne Wiederkehr im Assistenten. Das Überschreiben ersetzt die Dateien der vorhandenen Site. Die automatische Sicherung bedeutet, dass sie wiederhergestellt werden kann, nicht dass sie mit einem Klick rückgängig gemacht werden kann. Wenn Sie nicht sicher sind, dass die Site disposabel ist, brechen Sie ab und installieren Sie stattdessen auf einer anderen Site.

Apps, die unser Team von Hand installiert

Einige Apps haben keinen bewährten automatischen Installer. Für diese überspringt der Assistent den Fortschrittsbalken vollständig und zeigt stattdessen eine warme Bestätigung:

Wir richten [App] für Sie ein. Diese App benötigt eine praktische Einrichtung, daher installiert unser Team sie nach Ihrer Bestellung auf Ihrer Site. Wir werden Sie per E-Mail benachrichtigen, sobald sie live ist; es gibt nichts mehr für Sie zu tun.

Nichts ist fehlgeschlagen und nichts steht bei Ihnen an. Apps sind kostenlos, daher gibt es keinen Aufschlag in beide Richtungen.

Schritt 4: Sie sind live

Bei Erfolg zeigt der Assistent [App] ist live, einen Link zu Ihrer Domain und die Zusammenfassung der Anmeldedaten:

Admin-Benutzername
Admin-Passwort, mit Anzeige oder Ausblenden
Admin-E-Mail
Site-Titel

Er zeigt auch das Installationsprotokoll, Zeile für Zeile, wobei jeder Schritt als erfolgreich, fehlgeschlagen oder übersprungen gekennzeichnet ist. Dieses Protokoll ist einen Blick wert, selbst bei einer sauberen Installation: Es sagt Ihnen genau, was konfiguriert wurde.

Zwei Schaltflächen beenden den Ablauf: [App] öffnen geht direkt zur App, und Zurück zu App kehrt zur Katalogseite zurück.

Was ist, wenn es fehlschlägt

Installation fehlgeschlagen. Der Ergebnisbildschirm zeigt, was passiert ist, und gibt den wichtigen Teil an: Alle teilweisen Änderungen wurden zurückgerollt. Ihre Site ist sauber. Zwei Aktionen werden angeboten, Nochmal versuchen und Support kontaktieren.

Häufige Ursachen und was zu tun ist:

Ressourcenlimits. Wenn das minimale RAM der App über dem liegt, das Ihr Plan bereitstellt, kann die Installation teilweise fehlschlagen. Überprüfen Sie die Min RAM-Zahl auf der App-Seite. Siehe Plan-Upgrade.
Ein abgelehntes Feld. Der Assistent weigert sich, Eingaben mit Shell-unsicheren Zeichen zu akzeptieren, bevor der Job überhaupt in die Warteschlange gestellt wird, und benennt das Feld. Vereinfachen Sie den Wert: einen einfachen Benutzernamen, ein generiertes Passwort, einen Datenbanknamen mit Buchstaben und Zahlen.
Die Site ist nicht aktiv. Nur Sites mit ACTIVE-Status werden in der Site-Dropdown-Liste angezeigt. Eine Site, die noch bereitgestellt wird, wird nicht aufgelistet.

Die Installation war erfolgreich, aber die Site zeigt einen Fehler. Überprüfen Sie das Installationsprotokoll auf einen fehlgeschlagenen Schritt, und überprüfen Sie dann die Dokumentation der App selbst auf die Einrichtung nach der Installation. Community-Apps benötigen insbesondere oft einen letzten Setup-Assistenten, der im Browser ausgeführt wird. Siehe Website wird nicht geladen.

Sie haben das Admin-Passwort verloren. Verwenden Sie das Passwort-Zurücksetzen der App selbst mit der Admin-E-Mail, die Sie festgelegt haben. Speziell für WordPress, siehe Passwort für WordPress zurücksetzen.

Die Installation bleibt bei In der Warteschlange stecken. Die Job-Warteschlange ist beschäftigt. Sie wird gestartet. Wenn sie noch lange nach der erwarteten Installationszeit in der Warteschlange ist, brechen Sie sie ab und versuchen Sie es erneut. Wenn es sich wiederholt, öffnen Sie ein Support-Ticket.