Push++ Installations Anleitung

  1. Installation des Plugins
    ab EUR 0,00
  2. Per SSH auf den Server anmelden und folgende Commands ausführen
    1. cd /pfad/zum/wcf/acp/pushXX/
    2. chmod +x install.sh
    3. chmod +x uninstall.sh
    4. ./install.sh
  3. Secret Key kopieren und in die Konfiguration einfügen
    1. Ins ACP gehen und in den Optionen/Konfiguration die Kategorie Push++ auswählen und dort den Secret Key suchen und in die zwischen Ablage kopieren
    2. Die Datei /etc/pushxx.conf bearbeiten und den Secret Key einfügen
  4. Anpassung der Pushxx Konfiguration
    Code
    #
    # The IPv4 address the server should listen on.
    # This affects the web socket and the HTTP server.
    # Only listen on your public address if you know what you do. You have been warned!
    #
    bind_address = 127.0.0.1
    Hier euere IP Eintragen auf welche IP der Socket Server hören soll, bitte nur verändern wenn Ihr wisst was Ihr macht.
    Am besten immer auf 127.0.0.1 hören lassen, dann ist der Server nicht von aussen erreichbar sondern nur im Lokalen Netzerwerk.
    Code
    #
    # Log file. Will be created if not existing.
    # Make sure the push user has write permission to this location
    # or you have to pre-create the log file and set permissions accordingly.
    #
    log_path = /var/log/push.log
    Ausgabe des Push-Servers in eine Log Datei. Bitte immer einen Absoluten Pfad angeben.
    Code
    #
    # The port to listen on for web requests from the WSC/WCF plugin.
    # Default: 8082
    #
    server_port = 8082
    Dies ist der Port mit dem sich das WSC/WCF, um Nachrichten die an die Benutzer verteilt werden sollen, verbindent.
    Dieser Port sollte nur im Lokalen Netzwerk erreichbar sein.
    Code
    #
    # The port to listen on for web socket connections.
    # Configure your proxy (Nginx/Apache with mod_wstunnel) to forward connections to this port.
    # Default: 8081
    #
    socket_port = 8081
    Dies ist der Websocket Port, dieser wird für den Revers Proxy benötigt. Und kann hier auf einen freien Port geändert werden.
    Code
    #
    # Enable Verbose logging
    #
    # Set this to true if you want to enable debug logging.
    # This is useful if you are are a plugin developer and want to test your plugin with Push++
    #
    verbose = false
    Hier kann angegeben werden ob ein ausführlicher Log ausgegeben wird, nur für Debugging gedacht.
    Bitte nur folgende Werte Eintragen. true oder false
    Code
    #
    # The secret key to authenticate requests from the WSC/WCF plugin.
    # Open the configuration page of the plugin to get your secret key.
    # The sever process may not start if this value is not set correctly.
    #
    secret_key =
    Hier muss euer Secret Key aus dem ACP eingetragen werden. Sollte keiner hinterlegt wurden sein, startet der Push Server nicht.
  5. Den Reverse Proxy konfigurierenA
    • Apache
      • In dem Ordner gibt es eine apache.example.conf Datei, in dieser steht die Standard Konfiguration für den Apache die in die passenden VirtualHost eingetragen werden muss.
      • Hier eine Beispiel Konfiugration für euren vHost.


    • Nginx
      • In dem Ordner gibt es eine nginx.example.conf Datei, diese muss in dem Server block eingetragen werden für die passende Domain.
        Hier ein Beispiel wie diese Eingetragen werden soll


      • Bitte beachten, sollten Änderungen an der Port Konfiguration vorgenommen wurden bitte ebenfalls dort ändern.
  6. Der Pfad /socket kann Individuell angepasst werden, muss jedoch dann in den Optionen auch so eingetragen werden.
  7. Sobald der Pfad im Webeserver hinterlegt wurde, muss dieser auch in den Optionen im ACP hinterlegt werden. Dafür eurer Domain und dann den gewählten Pfad für die Server Konfiguration eintragen.
    wss://www.eure-domain.de/socket, bittet beachtet das eure Protokoll immer mit wss:// oder ws:// anfängt.
    Und solltet Ihr euren Pfad zum Socket geändert haben, muss hier auch ein andere Eingetragen wurden sein.
  8. Dann noch zum Schluss euren Backend Push Server URL hinterlegen, sollte der Server Lokal sein einfach http://127.0.0.1:8082 oder aber auch http://localhost:8082 davor schreiben, solltet Ihr den Port geändert haben natürlich auch hier den richtigen Port eintragen
  9. Am ende sollte diese Konfiguration im ACP etwa so aussehen2530-bildschirmfoto-2018-02-03-um-15-29-03-png
  10. Den Push++ Service starten mit systemctl start pushxx oderservice pushxx start
  11. Anschließend mit dem Command systemctl status pushxx oderservice pushxx status prüfen ob der Service läuft.
    Dies sollte in etwa so aussehen: