In der StageWare® Dokumentation findest du eine Erklärung jedes einzelnen Konfigurationsfeldes und jeder einzelnen Funktion.
Über diese Dokumentation hinaus, gibt es auch noch zahlreiche Anleitungen und Video-Tutorials.
All diese Anleitungen sind Bestandteil der StageWare® Utilities, die du als StageWare®-Nutzer kostenfrei anfordern kannst.
Falls du Probleme oder Fragen hast, schaue zunächst einmal kurz in die häufigen Fragen und/oder häufigen Fehler.
Hier wirst du sehr wahrscheinlich sofort eine Lösung für dein Anliegen finden.
Ansonsten stehen wir dir unter team@zwei.gmbh jederzeit zur Verfügung.
Um die Voraussetzungen zum Anlegen einer Testumgebung zu prüfen, sollten du im StageWare® Manager in den Tab Systemprüfung wechseln. Hier siehst du neben einer Auflistung der serverseitigen Mindestempfehlung die aktuellen Werte.
Die eingesetzte PHP-Version ist maßgeblich für die Verfügbarkeit gewisser Funktionen und vor allem die Performance deines Shops und unser Plugins. Aus Performance-Gründen solltest du mindestens PHP 7.0 einsetzen. Sollte es zu Unklarheiten über oder zu Problemen bei der PHP-Version kommen, so sind sowohl dein Webhoster als auch dein technischer Dienstleister für deine Shop-Installation die richtigen Ansprechpartner. Kontaktiere am besten beide, bevor du eine Entscheidung triffst.
Das PHP memory_limit ist der maximal nutzbare Arbeitsspeicher, der jedem einzelnen Scriptaufruf zur Verfügung gestellt wird. Das Kopieren und Anlegen einer Testumgebung ist ein relativ anspruchsvoller Vorgang, aber wir haben StageWare® so weit optimiert, dass 256MB memory_limit in der Regel ausreichend sind. Sollte es dennoch zu Engpässen oder Problemen bei diesem Wert kommen, so ist dein Webhoster oder technischer Dienstleister der richtige Ansprechpartner. Bitte ihn darum, das PHP memory_limit zu erhöhen.
Die PHP max_execution_time begrenzt die maximale Ausführungszeit für ein Script. Der angegebene Wert versteht sich in Sekunden. Das Kopieren und Anlegen einer Testumgebung ist ein relativ anspruchsvoller Vorgang und dauert oft entsprechend lange. Wir haben für die Arbeitsschritte in StageWare® eine Stapelverarbeitung implementiert, sodass 60 Sekunden max_execution in der Regel ausreichend sind. Sollte es dennoch zu Engpässen oder Problemen bei diesem Wert kommen, so ist dein Webhoster oder technischer Dienstleister der richtige Ansprechpartner. Bitte ihn darum, die PHP max_execution_time zu erhöhen.
Um eine Testumgebung oder ein Backup anzulegen, ist freier Speicherplatz auf deinem Server notwendig. Der verbrauchte Speicherplatz darf niemals das Limit erreichen, weil dann die Funktionsfähigkeit deines Live-Shops nicht mehr garantiert werden kann. Achte dauer darauf, dass immer ausreichend freier Speicherplatz zur Verfügung steht. Sprich mit deinem Hoster, falls du mehr Speicherplatz benötigst.
Achtung: Nicht auf allen Systemen kann der Speicherplatz von StageWare® richtig ermittelt werden. Dies ist oft bei Shared Hosting Paketen der Fall. Hier siehst du den gesamten Speicherplatz des Servers, aber nicht das, was dir davon maximal zur Verfügung steht. Prüfe daher dann auch den Speicherverbrauch in der Verwaltungsoberfläche deines Hosters.
Diese Funktion muss aktiv sein, damit PHP-Fehlermeldungen überhaupt geloggt werden. Wir empfehlen dringend, dass diese Funktion aktiviert werden soll. Nur so können auftretende Fehler erkannt, nachvollzogen und schnell gelöst werden. Am besten kontaktierst du deinen Hoster und bittest um die Aktivierung des PHP Errorlogs (Pfad in error_log festlegen und log_errors aktivieren).
Dieser Wert definiert den Pfad, wo die Errorlog-Datei gespeichert ist. Wir empfehlen dringend, dass der Errorlog definiert werden soll. Nur so können auftretende Fehler erkannt, nachvollzogen und schnell gelöst werden. Am besten kontaktierst du deinen Hoster und bittest um die Aktivierung des PHP Errorlogs (Pfad in error_log festlegen und log_errors aktivieren).
Um StageWare® zu nutzen, musst du den StageWare® Manager öffnen. Diesen findest du in deinem Shopware Backend unter dem Menü-Punkt Einstellungen.
Profile beinhalten alle Einstellungen, die für die Erstellung von Testumgebungen oder Backups notwendig sind. Es ist also eine Art Steckbrief, über den StageWare® weiß, wo Daten herkommen und wo diese hin sollen.
Dukannst so viele Profile anlegen.
Eine Besonderheit ist das Live-Profil. Dieses entspricht deinem Live-Shop und kann nicht verändert werden.
Rechts oben kannst du auf "Neu" klicken, um ein neues Profil anzulegen. Hierbei kann ein bestehendes kopiert werden, damit du nicht alle Einstellungen neu setzen musst. Bei einer Kopie werden der Name sowieso der Pfad automatisch angepasst, können von dir aber jederzeit wieder verändert werden.
Um ein Profil zu bearbeiten, musst du es einfach anklicken, die gewünschten Änderungen vornehmen und dann unten rechts auf Speichern klicken.
Nachfolgend werden die einzelnen Profil-Einstellungen erklärt.
Der Name des Profils dient dir zu Erkennung und Unterscheidung deiner verschiedenen Testumgebungen. Er sollte einmalig sein und deine Testumgebung eindeutig beschreiben. Der Name wird übrigens (automatisch reduziert auf erlaubte Zeichen), auch in Dateinamen von Backups verwendet.
Jedes Profil hat ein Quell-Profil, aus dem die Daten für die spätere Testumgebung heraus kopiert werden. Dies wird in den meisten Fällen das Live-Profil sein. Du kannst aber jederzeit Testumgebungen von anderen Testumgebungen erstellen.
Dies ist der Ordnername, in dem die jeweilige Testumgebung innerhalb des Shopware-Ordners angelegt wird. Es es ist möglich mehrere Testumgebungen in einem gemeinsamen Unterordner zu gruppieren. Nachfolgend findest du einige Beispiele.
Direkt im Shopware-Ordner: /stagingl
Gruppiert in Unterordner: /testumgebung/stagingl
Hiermit können komplette Ordner oder einzelne Dateien ausgeschlossen werden. Du kannst in den Plugin-Einstellungen konfigurieren, welche Ausschlüsse (Quelle, Ziel oder beide) bei der Einrichtung einer Testumgebung ignoriert werden sollen.
Ausschlüsse müssen als relativer Pfad angegeben werden und werden intelligent im jeweiligen Kontext verwendet. Es können beliebig viele Ausschlüsse per Zeilenumbruch, Komma (,) oder Semikolon (;) getrennt angegeben werden. Andere Testumgebungen, der Cache-Ordner und der stage_ware_data-Ordner werden immer automatisch ausgeschlossen.
Nachfolgendfindest du einige Beispiele:
Jede Testumgebung benötigt eine eigene, leere Datenbank. Diese kannst du in der Regel selber mit wenigen Klicks im Backend deines Servers anlegen.
Hinterlege hier alle abgefragten Datenbank-Einstellungen. Falls du nicht weißt, wie du eine Datenbank anlegst, ist dein Hoster der richtige Ansprechpartner.
Du kannst hier bei Bedarf Datenbank-Tabellen ausschließen, sodass diese nur als Struktur (ohne Inhalt) in die Testumgebung kopiert oder in ein Backup übernommen werden.
Eine Testumgebung ist eine Kopie deines Live-Shops, die völlig autark und unabhängig vom Live-Shop läuft. Jede Testumgebung basiert auf einem Profil, in dem alle nötige Einstellungen (wie z.B. das Quell-System sowie das Ziel, wo die Testumgebung installiert werden soll) vorgenommen werden. Jegliche Änderungen in der Testumgebung wirken sich dadurch nicht auf deinen Live-Shop aus. Du kannst beliebig viele Testumgebungen anlegen und bestehende Testumgebungen beliebig oft neu einrichten. In der Regel wird eine Testumgebung aus einem Live-Shop erstellt, du kannst aber auch Testumgebungen aus anderen Testumgebungen heraus anlegen.
Im Bereich Testumgebungen erhältst du einen Überblick über alle verfügbaren Testumgebungen, deren Status und Konfiguration. Vor allem aber, kannst du deine Testumgebungen hier steuern.
Hier kannst du deine Testumgebung steuern, also diese einrichten und löschen. Du kannst zusätzlich die Konfiguration einsehen, mit der die Testumgebungen jeweils eingerichtet worden sind (Button Eingerichtete Konfiguration).
1-Klick-Aktion
Die Einrichtung führt alle notwendigen Schritte durch, damit eine lauffähige Testumgebung erstellt wird. Eventuell vorhandene Dateien in dem Zielpfad sowie Daten in der Datenbank werden vorher automatisch entfernt. Daher kannst du eine Testumgebung einfach überschreiben, ohne diese vorher löschen zu müssen. Solltest du die Testumgebung einfach nur löschen wollen, dann kannst du dies über den Button Löschen machen.
Hiermit kannst du einfach das Frontend oder das Backend deiner Testumgebung öffnen.
Hier siehst du einen kurzen Überblick der Einstellungen, die in deinem Quell-Profil hinterlegt sind. Falls du die Einstellungen dieses Profils ändern willst, wechsle bitte in den Bereich Profile.
Hier siehst du einen kurzen Überblick der Einstellungen, die in deinem Ziel-Profil (also im Profil dieser Testumgebung) hinterlegt sind. Falls du die Einstellungen dieses Profils ändern willst, wechsle bitte in den Bereich Profile.
Hier siehst du die Ausschlüsse, also die Ordner, die beim Einrichten der Dateien nicht mit in die Testumgebung übertragen werden. Je nach Einstellung in der Plugin-Konfiguration werden die Ausschlüsse des Quell- oder Ziel-Profils oder sogar beide berücksichtigt. Wenn du die Ausschlüsse ändern willst, wechsle bitte in den Bereich Profile. Einige Ausschlüsse (wie z.B. andere Testumgebungen oder Cache-Ordner) werden automatisch als ausgeschlossene Ordner definiert.
Hier erstellst du Backups deiner Systeme. Die Besonderheit ist, dass du neben vollständigen Backups auch gezielt nur Backups der Dateien oder der Datenbank erstellen kannst. Bei Erstellung werden die Ausschlüsse des zugehörigen Profils berücksichtigt und außerdem die bei der Einrichtung der Testumgebung modifizierten Daten (Shop-Pfad, Cronjobs, E-Mail Adresse, etc.) wieder in den ursprünglichen Zustand versetzt. Andere Testumgebungen, der Cache-Ordner und der stage_ware_data-Ordner werden immer automatisch ausgeschlossen.
In der Übersicht siehst du alle Profile, den jeweiligen Backup-Pfad, mögliche Aktionen sowie Datum und Uhrzeit der letzten Backups. Du kannst selber festlegen, ob du ein Vollständigen Backup oder nur eines mit Dateien oder der Datenbank anlegen kannst.
Hier siehst du eine Übersicht alle Profil und darin eine Liste aller verfügbaren Backups. Diese kannst du hier Downloaden oder vom Server löschen.