Installation MacOS

Die Installation unter MacOS hängt etwas von Eurer Installation ab. Ab besten wäre die Installation über das „Brew“ System. Da dies aber auf vielen System – wenn Ihr nicht gerade Entwickler seid – nicht der Fall ist, muss eine andere Methode gewählt werden.

Zunächst einmal müsst Ihr Euch das Installations-Script laden. Gebt im Browser die Adresse  https://fg.nanninga.me/$/4hOOf ein. Dann wird die Datei ‚“install_macos.sh“ geladen und landet meist in Eurem Download Verzeichnis.

Kurzanleitung: Wie starte ich das Script „install_macos.sh“:

  1. Lade install_macos.sh herunter wie oben beschrieben

  2. Öffne die App „Terminal“ (Einfach oben rechts auf die Lupe/Spotlight klicken und „Terminal“ eintippen).

  3. Tippe im Terminal das Wort bash ein, mach ein Leerzeichen, ziehe die heruntergeladene Datei install_macos.sh einfach in das Terminal-Fenster hinein und drücke Enter.

Folgende Schritte werden dann durchgeführt:

  • Download und Entpacken der eigentlichen Anwendung von meinem Server.
  • Nachladen von benötigten Modulen aus dem Internet
  • Anweisungen an den User die .env Datei zu editieren und wie das Programm danach gestartet werden soll

Das Script wird dann – sofern nicht vorhanden – zunächst Node.js installieren.

Das Script prüft, ob brew vorhanden ist. Wenn nicht, öffnet das Skript automatisch den Browser (über den Mac-Befehl open „https://nodejs.org/“), leitet den Benutzer auf die Node.js-Seite für den manuellen Download weiter und gibt im Terminal einen Hinweis aus, dass er das Installationsskript nach der Node-Installation einfach noch einmal ausführen soll. Das heißt also, im Zweifelsfall müsst Ihr das Node.js Paket selbst downloaden und installieren.

Danach startet Ihr das Installationsscipt erneut wie oben beschrieben.

Zunächst werdet Ihr gefragt, wo ihr das Program installieren möchtet. Vorbesetzt ist „/media/ctbonline“ . Ihr könnt aber jedes mögliche Verzeichnis vorgegen, also auch einen Ordner auf einer anderen Platte oder auf einem USB -Stick.

Die Installation nudelt dann eine Weile und danach ist das Programm fast einsatzfähig. Eventuell müsst Ihr dann noch einmal Eurer Administrator-Passwort eingeben, da Administratorrechte benötigt werden.

Ihr müsst allerdings nun noch die .env Datei editieren (siehe dazu extra Seite für alle Betriebssysteme). Die Anweisungen dazu seht ihr im Terminal-Fenster (also cd , editieren .env usw)

Das Programm startet Ihr dann regelmäßig mit „start_macos.sh“. Ihr könnt es wieder so starten wie oben für das Install-Script beschrieben.

Start_macos.sh bietet Euch dann eine Auswahl: 0-4:

  1. Startet das Programm im Vordergrund, d.h. das Terminal-Fenster muss geöffnet bleiben, damit der Browser funktionieren kann. Diese Version eignet sich zum ersten Testen. es werden auch diverse Hilfsinformationen angezeigt, mit denen Ihr sehen könnt, ob Eure .env Konfiguration auch korrekt ist.
  2. Startet das Programm im Hintergrund und das Terminal-Fenster kann geschlossen werden. Das Programm bleibt bis zum nächsten Neustart aktiv
  3. Könnt Ihr benutzen, wenn ihr ohne Neustart das Programm beenden möchtet
  4. Hier könnt Ihr Informationen über den Background Prozess bekommen
  5. =0 beendet das Terminal-Fenster.

Im Browser gebt Ihr dann „localhost:3000“ ein (oder den Port den ihr in der .env gesetzt habt. Ihr könnt das Programm auch auf einem anderen Rechner im Netzwerk aufrufen indem Ihr die IP-Adresse des PC/Laptops verwendet – also etwa http://192.168.178.77:3000″. Dies funktioniert auch von einem Handy oder einem Tablet.