Skip to content
This repository has been archived by the owner on Nov 9, 2020. It is now read-only.

Installation DE

Stefan Haslinger edited this page Jul 6, 2015 · 24 revisions

Voraussetzungen

  • Betriebssystem Ubuntu 12.04 oder 14.04
  • Git zum Auschecken dieses Repositories
  • Ruby (wir empfehlen die Installation per RVM)
  • Suchmaschine Elasticsearch
  • 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)
  • Installation von wkhtmltopdf:
    Momentan ist die aktuellste Fassung von Sourceforge erhältlich.
    Die Installation per
    sudo dpkg -i wkhtmltox-0.12.2.1_linux-precise-amd64.deb
    scheitert zunächst an fehlenden Abhängigkeiten, die sich per
    sudo apt-get -f install
    nachholen lassen. Damit wird auch die Installation von wkhtmltopdf vervollständigt.

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 umfassend werden könnte. Die zu berückichtigenden Umstände finden Sie in Produktivsysteme DE.

  • 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
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
  • Anlage des Verzeichnisses für Vorlagen:
    mkdir app/views/page_templates
  • Initiale Indizierung für Produkte und Kategorien in der Suchmachine Elasticsearch:
    rake products:reindex RAILS_ENV=ENVIRONMENT
    rake categories:reindex RAILS_ENV=ENVIRONMENT

Die Installation ist damit abgeschlossen.

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
  • Pflegen Sie nun ihre Konfigurations in die Datei db/seeds.rb ein.
    Format und Inhalt der Daten ist in der Datei selbst dokumentiert.
    Sie konfigurieren in dieser Datei Standarduser, systemweit gültige Konstanten, Ländereinstellungen,
    Versandkosten, und den Inhalt einer Startseite: Seitenvorlage, Webseite, Inhalt der Seite, Initial-Menü
  • rake db:seed

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.