Nodo WebApp op een Synology server

De ontwikkelaars van de Nodo hebben een webserver applicatie gemaakt waarmee je Nodo’s kunt besturen. De NoDoWeb applicatie is als open-source vrijgegeven en kan iedereen die dat wil, het dus thuis op zijn eigen server ‘draaien’.

De Wiki van Nodo is sterk in ontwikkeling, maar ik kwam geen kant-en-klare handleiding tegen voor de Synology. Dus werd het tijd om mijn gevolgde stappen, maar eens in een artikel te plaatsen. Als hulpmiddel heb ik een andere handleiding gevolgd; die van Willem.

Ik ga er van uit dat je inmiddels een webserver hebt draaien op je Synology. Zo niet dan is er genoeg informatie te vinden op internet hoe je dat moet doen.

Allereerst downloaden we TortoiseSVN. TortoiseSVN is een programma dat de verschillende bestanden van Google code kan downloaden. Het programma is beschikbaar via het menu bij een rechter muisklik in de Windows verkenner.

Na installatie maken we in Windows verkenner een map in de web directory van de Synology, ik heb de map webapp genoemd. Vervolgens klik je met de rechtermuis knop en selecteer je [SVN Checkout]. Je voert de volgende informatie in en klikt op [OK]:

• URL: http://arduino-nodo.googlecode.com/svn/Webserver/NoDoWeb
• Checkout directory: \\Diskstation\web\webapp\

Alle bestanden voor de WebApp staan nu na een tijdje in de gewenste directory.

De NoDoWeb applicatie maakt uitvoerig gebruik van de MySQL database dus deze moet worden aangemaakt. Gelukkig hebben de ontwikkelaars van de NoDoWeb applicatie hier een script voor gemaakt dat (na een kleine aanpassing) eenvoudig kan worden uitgevoerd. Het bestand nodo_db.txt bevat alle instructies om een standaard, lege, database voor de Nodo WebApp aan te maken. Helaas staan er ook een hoop instructies in die niet nodig zijn (en veelal ook foutmeldingen veroorzaken). Verwijder vervolgens de onnodige instructies. Open het gekopieerde bestand met je favoriete editor en verwijder alle regels vanaf het begin tot:

CREATE DATABASE "nododom_webappdb" 

(de CREATE DATABASE regel moet dus de eerste regel van het aangepaste bestand worden!).

Log vervolgens in op phpMyAdmin (installeer dit pakket eerst indien je het nog niet hebt) en importeer het zo juist gewijzigde nodo_db.txt bestand. Vervolgens ga je naar het tabblad gebruikers en klik je [Gebruiker toevoegen] aan. Je vult gebruikersnaam, machine; localhost en wachtwoord in. Databank; Geen selecteren en klikken we op Gebruiker toevoegen. Als laatste gaan we de rechten van de net aangemaakte gebruiker wijzigen ([klik op rechten wijzigen[). Bij [Databank-specifieke rechten] selecteren we nododom\_webappdb en klikken we op [Start], vervolgens bij [Databank-specifieke rechten] klikken we op [Selecteer alles] en klikken we nogmaals op [Start]. De rechten voor onze database zijn nu aangepast op de gebruiker.

Nu moet in alle programma files van NoDoWeb de “harde verwijzingen” naar www.nodo-domotica.nl worden veranderd in het IPadres van de webserver (bijvoorbeeld ’192.168.1.101′ of de hostnaam van je server en op sommige plaatsten ‘${WEBAPP_HOST}’). Onderstaande files moeten worden aangepast maar let op!! Als je met TortoiseSVN opnieuw de laatste versie ophaalt, dan moet je deze aanpassingen opnieuw aanbrengen!!! Bij een nieuwe release van NoDoWeb zullen de regelnummers waarschijnlijk ook anders zijn.

signup.php:

regel  moet worden:
150    .. http://${WEBAPP_HOST}/webapp ..enz..
164    $from = "Nodo@<MyDomain>";

nodo.php:

regel  moet worden:
149    $from = "Nodo@<MyDomain>";

lost_password.php:

regel  moet worden:
 71    $from = "Nodo@<MyDomain>";

webservice/admin/json_setup_connection.php:

Hieronder heb ik zelf https://www.fam-oldenburger.nl i.p.v. het <IPadress> ingevuld

regel  moet worden:
185    if ($HTTPHost == "<IPadress>/webapp/nodo.php"
238    if ($HTTPHost == "<IPadress>/webapp/nodo.php"
                                       .. enz ..

.. en tenslotte moet de volgende variabele correct worden gevuld in
include/webapp_settings.php:

regel  moet worden:
 25    $WEBAPP_HOST = "<IPadres>/webapp";

Nu moet je nog aan NoDoWeb aangeven hoe je database heet en welke gebruiker met welk wachtwoord de database mag benaderen (dit hebben we eerder al aangemaakt in phpMyAdmin. Deze gegevens staan in webapp/connections/db_connection.php. Open dit bestand met je favoriete editor:

<?php
$db_hostname = "localhost";
$database = "nododom_webappdb";
$db_username = "NodoUser";
$db_password = "NodoWachtwoord";
$db = mysql_pconnect($db_hostname, $db_username, $db_password) or
trigger_error(mysql_error(),E_USER_ERROR);
?>

Omdat ik op mijn webserver ook gebruik maak van WordPress plaats ik een .htaccess bestand met de volgende inhoud:

Options +FollowSymlinks

# SymLinks
RewriteRule ^(.*)$ $1 [NC]

Ga nu verder met het koppelen van de Nodo aan de WebApp.

Er bleek ook nog een fout in het webservice/forward_http.php bestand te zitten voor de nieuwe Nodo Software versie 3.6:

regel  moet worden:
67    $kaku = "KakuSend%20$homecode$address,"; 
71    $newkaku = "NewkakuSend%20$address,";
80    $send_user_event = "UserEventSend%20";

Bijgewerkt op 25 november 2013