LaStore-Modul · Benutzeranleitung

Schnellstart — in vier Schritten einsatzbereit

Diese Anleitung führt Dich vom Kauf bis zum laufenden Modul. Sie ist für den Anfang gedacht: Du brauchst kein Vorwissen, und ausser einem Schritt lässt sich alles direkt in Deinem FreeScout erledigen.

Die vier Schritte dauern zusammen etwa zehn Minuten. Danach musst Du Dich um nichts mehr kümmern.

Zuerst: zwei Orte, die Du auseinanderhalten solltest

In dieser Anleitung kommen zwei verschiedene Dinge vor, und beide haben mit LaStore zu tun. Wenn Du sie auseinanderhältst, ist der Rest einfach.

Das Kundenportal ist ein Bereich auf unserer Website, unter https://shop.letsautomate.ch/portal — dort meldest Du Dich mit E-Mail und Passwort an. Es ist Deine Verwaltung: Du siehst, welche Lizenzen Du gekauft hast, bis wann Support und Updates dazu laufen, und Du kannst eine Lizenz auf einen anderen Server umziehen. Lizenzschlüssel trägst Du hier nicht ein.

Das LaStore-Modul läuft dagegen in Deinem eigenen FreeScout, auf Deinem Server. Du findest es dort nach der Installation unter Verwalten → LaStore. Das ist der Ort für alles Praktische: Lizenzschlüssel eintragen, gekaufte Module installieren, Updates holen, Automatikmodus einschalten.

Kurz gesagt: auf unserer Website verwaltest Du, in Deinem FreeScout arbeitest Du.

1. Zugang zum Kundenportal einrichten

Nach dem Kauf bekommst Du von uns eine E-Mail. Darin stehen Deine Lizenzschlüssel, und darin ist auch ein Knopf mit der Aufschrift Zugang zum Kundenportal einrichten. Klicke ihn an und lege ein Passwort fest. Von da an kannst Du Dich jederzeit unter https://shop.letsautomate.ch/portal anmelden.

Deine Lizenzschlüssel findest Du auch im Kundenportal: Bei jeder Lizenz steht der Anfang des Schlüssels, und mit dem Auge-Symbol Schlüssel anzeigen blendest Du ihn ganz ein. Ist die E-Mail verloren gegangen oder im Spam-Ordner gelandet, schickst Du sie Dir im Portal mit Schlüsselmail erneut senden noch einmal. Es entsteht dabei kein neuer Schlüssel, Du bekommst dieselben wie beim Kauf.

2. Das LaStore-Modul in FreeScout installieren

Das LaStore-Modul ist kostenlos und benötigt keinen Schlüssel.

Lade zuerst das Paket von unserer Website herunter: https://shop.letsautomate.ch/shop/lastore.zip

Entpacke die Datei. Darin findest Du einen Ordner mit dem Namen LaStore. Kopiere diesen Ordner in das Verzeichnis Modules Deiner FreeScout-Installation, also dorthin, wo bei Dir schon die übrigen Module liegen — zum Beispiel unter /var/www/freescout/Modules. Wie Du Dateien auf Deinen Webserver bringst, hängt von Deinem Hoster ab: über SFTP, über einen Dateimanager im Kundenbereich oder über die Kommandozeile.

Der Rest passiert in Deinem FreeScout. Öffne dort Verwalten → Module. Die Seite listet alle Module auf, die im Verzeichnis liegen, und LaStore steht darunter, sobald der Ordner am richtigen Platz ist. Ein Klick auf «Aktivieren» genügt.

Ist das erledigt, findest Du LaStore in FreeScout unter Verwalten → LaStore. Das ist die Seite, die in den nächsten beiden Schritten gemeint ist. Auf Deinen Webserver musst Du danach nicht mehr.

3. Gekaufte Module aktivieren, in FreeScout

Öffne in FreeScout Verwalten → LaStore. Du siehst eine Übersicht aller Module, die wir anbieten, mit ihrem jeweiligen Zustand: gekauft, installiert, aktuell.

Wähle das Modul aus, das Du gekauft hast, und trage den Lizenzschlüssel aus der E-Mail ein. Ein Klick genügt. Das Modul prüft daraufhin die Lizenz bei uns, lädt das Paket herunter, kontrolliert dessen Signatur und meldet das neue Modul bei FreeScout an. Es ist damit einsatzbereit.

Je gekauftes Modul gibt es einen eigenen Schlüssel. Alle stehen in derselben E-Mail.

Falls Du ein Modul schon vorher von Hand installiert hattest, findest Du es in dieser Übersicht unter Bereits installiert, noch ohne Lizenz. Trage den Schlüssel dort nach. Die aktuelle Fassung wird dabei gleich mitgeholt.

Zwei Hinweise, die Du kennen solltest, bevor Du einen Schlüssel eintragst:

• Mit dem Aktivieren erlischt das Rückgabe- und Widerrufsrecht. Solange Du nicht aktivierst, kannst Du innerhalb von vierzehn Tagen zurücktreten.
• Eine Lizenz gilt für eine aktive FreeScout-Installation. Möchtest Du ein Modul zuerst in einer Testumgebung ansehen, aktiviere es dort und ziehe die Lizenz später um. Zwei Umzüge sind inklusive.

4. Automatikmodus einschalten, in FreeScout

Öffne in FreeScout wieder Verwalten → LaStore. Oben in der Werkzeugleiste findest Du einen Schalter mit der Aufschrift Autopilot: aus. Ein Klick darauf schaltet ihn ein.

Ist der Autopilot eingeschaltet, sieht das Modul jede Nacht bei uns nach, ob es für Deine Module eine neue Fassung gibt. Wenn ja, lädt es sie herunter, prüft die Signatur und installiert sie. Du musst nichts tun und merkst im Normalfall nichts davon.

Ist der Autopilot ausgeschaltet, erfährst Du auf derselben Seite trotzdem, dass etwas bereitliegt. Du entscheidest dann selbst, wann Du aktualisierst.

Wir empfehlen, den Autopilot einzuschalten. Updates enthalten auch Sicherheitskorrekturen, und ein Modul, das nie aktualisiert wird, bekommt sie nicht.

Wenn etwas nicht wie erwartet läuft

Die folgenden Punkte klären die häufigsten Fälle. Meistens ist die Sache damit in zwei Minuten erledigt.

LaStore erscheint nicht unter Verwalten

Dann liegt der Ordner noch nicht am richtigen Platz, oder das Modul ist noch nicht aktiviert. Prüfe, ob der Ordner LaStore direkt im Verzeichnis Modules liegt und nicht in einem weiteren Unterordner — beim Entpacken entsteht schnell eine Ebene zu viel.

Ich habe in FreeScout geklickt, aber nichts ist passiert

FreeScout zeigt Erfolg und Fehler als kurze Meldung am Bildschirmrand an, und die verschwindet nach wenigen Sekunden von selbst. Wenn Du sie verpasst hast: die Fassungsnummer beim Modul in der Übersicht sagt Dir, ob die Installation durchgelaufen ist.

Der Schlüssel wird nicht angenommen

Achte darauf, dass Du ihn vollständig kopiert hast, ohne Leerzeichen am Anfang oder Ende. Und dass Du ihn beim richtigen Modul einträgst: jeder Schlüssel gehört zu genau einem Modul.

Es geht nichts, und Du weisst nicht warum

Dann liegt es vielleicht an uns. Ob unsere Dienste laufen, siehst Du hier: https://stats.uptimerobot.com/QW0q99IJbo — diese Seite liegt bewusst ausserhalb unserer eigenen Technik, damit sie auch dann erreichbar ist, wenn bei uns etwas ausgefallen ist.

Kommst Du damit nicht weiter, schreibe uns. Hilfreich ist, wenn Du dazuschreibst, um welches Modul es geht, welche FreeScout-Fassung Du benutzt und was Du erwartet hättest. Dann können wir meist gleich antworten, ohne nachfragen zu müssen.

Auf einen anderen Server umziehen

Das machst Du im Kundenportal auf unserer Website, nicht in FreeScout.

Eine Lizenz gilt jeweils für eine aktive FreeScout-Installation. Zwei Umzüge sind bereits enthalten, und Du kannst sie selbst durchführen: gib im Kundenportal den alten Platz frei und trage den Schlüssel anschliessend in FreeScout auf dem neuen Server ein.

Sind die beiden Umzüge aufgebraucht, ist das kein Grund für einen Neukauf. Schreibe uns, dann geben wir die Lizenz frei; das zählt nicht als weiterer Umzug.

Wird ein alter Server einfach nicht mehr benutzt, gibt das System die Lizenz nach neunzig Tagen von selbst wieder frei. Eine abgeschaltete oder gelöschte Installation blockiert Deine Lizenz also nicht dauerhaft.

Server ohne Verbindung ins Internet

Steht Dein Server in einem abgeschlossenen Netz, kann das LaStore-Modul unsere Website nicht erreichen. Für diesen Fall gibt es die Lizenzdatei. Hier arbeitest Du an beiden Orten, deshalb der Reihe nach:

• In FreeScout unter Verwalten → LaStore steht eine Angabe mit der Bezeichnung Kennung dieses Servers. Notiere sie.
• Im Kundenportal trägst Du diese Kennung bei der betreffenden Lizenz ein. Dafür genügt ein beliebiges Gerät, das ins Internet kommt. Das Portal erzeugt daraus eine Lizenzdatei zum Herunterladen.
• Zurück in FreeScout lädst Du diese Datei unter Verwalten → LaStore hoch. Danach ist Dein Modul lizenziert, ohne dass Dein Server jemals nach draussen gesprochen hat.

Eine Einschränkung dabei: die Kennung entsteht, sobald sich Dein Server einmal bei uns gemeldet hat. War er noch nie online, steht in FreeScout noch keine Kennung, und die Seite sagt das auch. Schreibe uns in diesem Fall, dann finden wir einen Weg.

Gut zu wissen

Du brauchst das LaStore-Modul nicht zwingend

Die gekauften Module laufen auch ohne. Wenn Du möchtest, lädst Du jedes Modul im Kundenportal herunter, kopierst den Ordner von Hand nach Modules und aktivierst ihn in FreeScout. Ohne LaStore entfällt allerdings die Installation mit einem Klick, und Du erfährst nicht automatisch von neuen Fassungen.

Ein gekauftes Modul läuft unbefristet

Der Zeitraum, den Du beim Kauf siehst, betrifft Support und Updates, nicht die Nutzung. Läuft er ab, arbeitet Dein Modul unverändert weiter; es kommen nur keine neuen Fassungen mehr. Das Datum steht im Kundenportal bei jeder Lizenz unter Support bis.

Der Lizenzschlüssel gehört nach FreeScout, nicht auf unsere Website

Eingetragen wird er ausschliesslich in Deinem FreeScout, unter Verwalten → LaStore. Im Kundenportal verwaltest Du die Lizenz, den Schlüssel selbst siehst Du dort nicht erneut.

Jedes Paket wird vor dem Einsetzen geprüft

Das LaStore-Modul kontrolliert die Signatur jeder Datei, die es installiert. Passt sie nicht, wird nichts eingesetzt und Deine laufende Installation bleibt unberührt.

Nach einem Update bleibt die vorige Fassung eine Woche liegen

Bei jedem Update legt das LaStore-Modul die bisherige Fassung beiseite. Läuft nach einem Update etwas nicht, gibt es so einen Rückweg. Je Modul bleibt eine solche Sicherung, und nach 7 Tagen wird sie von selbst gelöscht. Unter Verwalten → LaStore siehst Du ganz unten, was gerade liegt, und kannst es auch sofort löschen.

Kommst Du damit nicht weiter? Support