Installation DE

Voraussetzungen

• Betriebssystem Ubuntu 12.04 oder 14.04
• Git zum Auschecken dieses Repositories
• Ruby (wir empfehlen die Installation per RVM)
• Suchmaschine Elasticsearch
  • Installationsanleitung Elasticsearch DE
• Datenbank MySQL
• Bildverarbeitung Imagemagick
• Palava Machine Stun/Turnserver : Sie können uns durch Öffnen eines Issue kontaktieren, falls Sie unseren Stun/Turnserver probeweise mitverwenden wollen.
• Faye PubsubServer : Sie können uns durch Öffnen eines Issue kontaktieren, falls Sie unseren PubsubServer probeweise mitverwenden wollen.
• Zugang zu einem SMTP Server für den E-Mail Versand (für Versandbestätigungen und Benachrichtigungen von Vertrieb und Service)

Installationsvorgang

In Folge führen wir die Installation eines Entwicklungssystem durch. Die Installation für ein Produktionssystem hängt zu sehr von der Umgebung ab, in der Mercator installiert werden soll, als dass sie hier beschrieben werden könnte.

• Wir klonen das Repository
  git clone https://github.com/informatom/mercator

• Nun wechseln wir in das Unterverzeichnis vendor und klonen in dieses das Template für die systemspezifischen Mercator-Einstellungen
  git clone https://github.com/informatom/mercator_customer
• Das dabei entstehende Verzeichnis mercator-customer ist umzubenennen (oder bei Wunsch zu kopieren) in customer:
  mv mercator-customer customer
• Die enthaltenen Dateien müssen wir nun an die lokalen Gegebenheiten anpassen. Wenigstens 3 Dateien müssen angepasst werden:
  • database.yml mit den Einstellungen der Datenbank
  • application.yml mit den EInstellungen zu Systemname, Domains und Initialisierungsschlüssel der Serverkomponenten
  • views/confirmation-html.erb die Bestellbestätigung

• Wir benötigen drei Gems in der jeweils aktuellsten Version, die wir nun auschecken:
  • hobo_bootstrap in Branch Bootstrap 3 stellt das Twitter Bootstrap Framework in Version 3 in Hobo zur Verfügung
  • hobo_bootstrap_ui in Branch Bootstrap 3 stellt das Twitter Bootstrap Framework in Version 3 für weiter UI Komponenten in Hobo zur Verfügung
  • hobo_w2ui integriert die Assets des Javascript-Frameworks W2UI in Hobo

cd gems
git clone https://github.com/informatom/hobo_bootstrap 
cd hobo_bootstrap 
git checkout bootstrap3
cd ..
git clone https://github.com/informatom/hobo_bootstrap_ui
cd hobo_bootstrap_ui
git checkout bootstrap3
cd ..
git clone https://github.com/informatom/hobo_w2ui
cd ..

• Nun installieren wir alle benötigten Gems
  bundle install
• Wir legen die Datenbank an
  rake db:create

Anmerkungen

• Sie können die Datenbank aber natürlich auch mit einem anderen Werkzeug anlegen, falls der Datenbankuser diese Berechtigung nicht besitzt. Denken Sie dabei daran, dem Datenbankuser die Zugriffsberechtigung auf die eben erstelle Datenbank zu geben.
• Sollten Sie ein System anlegen, das nicht ein development-System ist, sondern zum Beispiel ein production -System lautet die Syntax
  rake db:create RAILS_ENV=production

Konfiguration

• Wir laden das Datenbankschema
  rake db:schema:load
• Wir legen die Standarduser an
  rake FIXME
  Dies erzeugt einen Administrationsuser mit dem Accout: Benuztername: FIXME Passwort: FIXME
• Wir legen die Konstanten in der Datenbank an
  rake FIXME

Die Konfiguration ist nun abgeschlossen.

Start

• Wir starten den Webserver
  rails s
• In einem Webbrowser können wir nun Mercator unter http://localhost:3000 verwenden, testen, weiterentwickeln,…
• Achten Sie bezüglich ihrer Firewall- und Proxyeinstellungen darauf, dass Ihr Rechner Zugang zum Messaging Server und zum STUN/TURN Server hat, andernfalls funktionieren das Beratungsmodul bzw. Audio- und Videochat nicht.