Übersicht

node.js etabliert sich immer weiter als Plattform für Server- und Netzwerkanwendungen. Die Verwendung von JavaScript als Syntax sowie die Unzahl an Modulen ermöglichen die Erstellung komplexer, echtzeitfähiger Anwendungen in kürzester Zeit. Das Starten von node.js Skripten setzte bisher einen frei konfigurierbaren Server voraus, auf dem Softwarepakete nach belieben installiert und ausgeführt werden können. hostdream bietet die Möglichkeit node.js Anwendungen direkt im Webspace auszuführen und eine node.js Installation in einer eingeschränkten Umgebung durchzuführen.

Installation

Vorbereitung

Vor der Installation muss der node.js-Manager in den Webspace eingebunden werden. Das muss manuell durch Entpacken der Zip-Datei und anschließendem Upload per FTP in den Webspace geschehen.

Durchführen der node.js Installation

Zum Durchführen der Installation der notwendigen Basispakete öffnen Sie die URL http://<ihre-domain>/nodejs-manager/install.php und füllen Sie alle Felder aus. In der Regel reicht es, die schwach hinterlegten Parameter zu übernehmen. Nach einem Klick auf "Speichern und Weiter" wird die konfigurierte Version von node.js heruntergeladen.

Parameter

Basis-Verzeichnis für node.js: Installationsverzeichnis für nodejs. Hat keinen Einfluss auf die Bedienung oder Hinzufügen von Anwendungen.
node.js Architektur: Die Systemarchitektur.hostdream nutzt eine linux-x64 Distribution.
node.js Version: Die node.js Version, welche installiert werden soll.
Installationsverzeichnis für node.js Skripte: Verzeichniss, in dem später die Anwendungen hinterlegt werden.

Dass bei dem Download alles ohne Probleme ablief, wird durch ein grünes Informationsfeld gekennzeichnet. Danach können Sie einfach auf "Weiter" klicken, um die Installation abzuschließen.

Nach Entpacken und Anpassen der Verzeichnisse (der Erfolg wird wiederum durch drei grüne Informationsfelder gekennzeichnet), gelangen Sie durch Klick auf die Schaltfläche "Zur Verwaltung" zur eigentlichen Oberfläche des Managers.

Registrieren von Anwendungen

Vorbereitung

Während der Installation haben Sie ein "Installationsverzeichnis für node.js Skripte" angegeben. Laden Sie Ihre node.js Anwendung in einen Unterordner dieses Verzeichnisses hoch.

Hinzufügen der Anwendung

In der Oberfläche des node.js-Managers klicken Sie auf "Skript hinzufügen". In der erscheinenden Eingabemaske geben Sie unter "Skript-Verzeichnis" den Namen des Ordners an, in dem sich Ihre Anwendung befindet. Mit "Skript-Pfad" teilen Sie der Oberfläche mit, wo die eigentliche node.js Anwendung im Anwendungsordner zu finden ist. Abschließend gelangen Sie durch einen Klick auf "Skript hinzufügen" zurück zur Übersicht, wo Ihre Anwendung als Teil der Tabelle auftauchen sollte.

Beispiel

Sie haben ein node.js Projekt, welches folgende Ordnerhirarchie aufweist:

	hello-world
	hello-world/package.json
	hello-world/client
	hello-world/client/index.html
	hello-world/server
	hello-world/server/main.js

Während der Installation haben Sie die Standard-Einstellung für das Anwendungsverzeichnis übernommen: nodes
Sie laden Ihr Projekt hello-world in das Verzeichnis nodes hoch.
In der "Skript hinzufügen"-Maske geben Sie für "Skript-Verzeichnis" hello-world an.
In der "Skript hinzufügen"-Maske geben Sie für "Skript-Pfad" server/main.js an.

Steuern registrierter Anwendungen

Nachdem eine Anwendung korrekt in die Anwendungsliste eingetragen wurde, können Sie zusätzliche Module installieren, einen Server starten oder stoppen. Falls Sie eine Anwendung vom Server gelöscht haben, müssen Sie den entsprechenden Eintrag manuell aus der Anwendungsliste durch einen Klick auf "-" entfernen.

Module installieren

Falls Ihre Anwendung zusätzliche Pakete benötigt, müssen diese vor einem Start installiert werden. Da keinerlei Rechte auf dem Server verfügbar sind, werden etwaige Module durch den Einsatz von npm in einem Unterverzeichnis gespeichert. Achten Sie darum darauf, dass bei Ihren node.js Projekten immer eine package.json-Datei beiliegt. Durch Klicken des Zahnrades in der Anwendungsliste, wird der Paketmanager im Projektverzeichnis gestartet und wertet die Informationen aus package.json aus. Nachdem der Prozess beendet ist, wird der Erfolg durch eine grüne Informationsanzeige terminiert. Nun ist Ihre Anwendung einsatzbereit.

Anwendungen starten/stoppen

Anwendungen können nur einmal gestartet werden, weiteres Klicken auf die "Starten"-Schaltfläche führt lediglich zu dem Hinweis, dass die Anwendung bereits ausgeführt wird. Wird eine Anwendung tatsächlich ausgeführt, wird dies durch einen Haken in der Anwendungsliste gekennzeichnet. Zusätzlich wird die Schaltfläche "Beenden" eingeblendet, die den entsprechenden Prozess abschaltet. Hinweis: Es wird keinerlei Ausgabe der Anwendung weiter geleitet. Sollte es zu Fehlern kommen, schaltet sich das node.js Skript in den meisten Fällen einfach aus. Sie sollten darum sicher stellen, dass Ihr Projekt den Produktionsstand erreicht hat.

Anwendungen entfernen

Wenn Sie eine Anwendung entfernen wollen, nutzen Sie die "Entfernen"-Schaltfläche in der Anwendungsübersicht, um das Projekt aus der Manager-Software zu entfernen. Anschließend löschen Sie den Projektordner mit Hilfe einer FTP-Software vom Server. Es werden keine zusätzlichen Dateien angelegt, die das System "verschmutzen"