DBFree V3 NSR Getting Started

DBFree V3 NSR
Getting Started
Premessa
DBFree V3 NSR (No Skill Required) è indirizzato ad utenti esperti nell'uso di Windows ma non
necessariamente programmatori o specialisti del web.
Anche se non è necessario essere specialisti un minimo di cognizioni su come fuonziona il web
sono necessarie per operare in tranquillità. Queste cognizioni esulano dagli scopi di questa guida e
ne verrà dato solo un breve accenno quando necessario.
Gli utenti sono invitati ad informarsi per proprio conto in merito alle problematiche tecniche, legali
e di sicurezza inerenti la gestione di un sito web.
Riepilogo
DBFree V3 NSR permette di trasformare in pochi minuti un personal computer in un completo
server web da connettere ad internet o alla propria rete aziendale per fornire servizi web tramite
applicazioni sviluppate in proprio e che utilizzano database.
A differenza di quasi tutti i sistemi simili sul mercato DBFree è stato sviluppato specificatamente
per funzionare con risorse (tecniche ed economiche) limitate all'osso e per permettere ad un singolo
individuo di operare in completa autonomia sia all'interno di una organizzazione aziendale che da
casa propria.
DBFree funziona praticamente ovunque e con opportuni accorgimenti (che non forniremo qui) può
permettere di operare in modo da essere difficilmente rintracciabile e operare in relativo anonimato.
Altre soluzioni offrono le stesse possibilità, ma nessuna è così leggera, robusta e interattiva come
DBFree.
Ambiti di utilizzo
DBFree V3 NSR può essere utilizzato in tutte quelle situazioni in cui si vogliano fornire semplici
servizi via internet pur non disponendo delle risorse tecniche, amministrative ed economiche
normalmente necessarie.
Ad esempio è possibile attivare un servizio di raccolta e condivisione di dati strutturati (come ordini
di acquisto, richieste di intervento, prenotazioni o iscrizioni ad attività) su una rete aziendale o
scolastica senza dover richiedere l'intervento di tecnici specialisti, a patto ovviamente di disporre
delle necessarie autorizzazioni (se non si è intestatari della linea ADSL utilizzata).
Requisiti software
DBFree V3 NSR necessita di Microsoft Windows: tutte le versioni sono supportate, da Windows
2000 Professional sino al recente Windows 8 e Windows Server 2012.
Questa versione dispone già di un proprio server web (Xitami) ed è quindi preferibile installarla su
versioni di Windows che non dispongono già di un server preinatallato (come IIS): se avete già un
altro server montato sul computer questa versione di DBFree non fa per voi e vi conviene usarne
un'altra.
E' comunque possibile adattarla al funzionamento in coesistenza con altri server web, ma se
disponete di queste competenze avete decisamente sbagliato versione: DBFree-DEV è la versione
che fa invece al caso vostro.
Siccome il compito di DBFree è quello di realizzare un server web, la prima cosa di cui avrete
DBFree V3 NSR - Getting started - Page 1/14 - Rev. 1.1
bisogno è una connessione internet permanente e di un dominio con cui raggiungere il vostro server.
Se disponete di una connessione ADSL del tipo “flat” (cioè che non si paga a tempo) siete già a
posto. Le connessioni possono essere condivise con altri computer, non c'è bisogno di dedicarla al
vostro server; questo però richiede che siate in grado di mettere le mani sul router ADSL che usate.
Il dominio (che in pratica è il nome che digitate per raggiungere un sito) può essere reperito
gratuitamente o a pagamento dagli specialisti che offrono questo servizio.
Questo vi verrà spiegato a parte nell'appendice relativa al vostro paese.
Requisiti Hardware
Tutto dipende da cosa volete fare, cioè dalle funzioni che volete offrire ai vostri utenti e dal loro
numero, e quindi dallo sforzo per il server e dal traffico internet che verrà generato.
Generalmente un qualunque vecchio PC con Windows XP sarà più che sufficiente per la maggior
parte delle applicazioni. Se non dovesse bastare significa che i vostri servizi web sconfinano già
nell' ambito professionale ed è ora di passare ad una versione di DBFree più evoluta.
Avrete ovviamente bisogno di una connessione di rete e di una connessione dati.
Questa ormai viene universalmente fornita tramite modem-routers ADSL connessi alla linea
telefonica da una parte e alla porta ethernet del vostro PC dall'altra.
Potete usare anche il vostro personal computer (un laptop ad esempio, o anche un netbook) come
server, e lavorarci contemporaneamente.
Naturalmente quando spegnete il vostro PC il sito che ospita non sarà più visibile, quindi questa
soluzione va bene solo in certi casi.
Più avanti vi verranno proposti alcuni scenari tipici, per cui non ci dilungheremo oltre su questo
aspetto.
Verificare che tutto funzioni.
Durante il processo di installazione DBFree V3 NSR effettua queste operazioni:
1. crea una cartella per se stesso e tutti i suoi files: normalmente questa è c:\dbfree (e vi
consigliamo di non cambiarla). Tutti i files (o quasi) di DBFree sono contenuti in questa
cartella, che a sua volta contiene molte sottocartelle.
2. Assegna a queste cartelle i necessari diritti di lettura/scrittura
3. Installa il server web Xitami e il relativo Windows Service
4. Apre le porte del firewall di Windows necessarie al suo funzionamento
5. Modifica il file locale dei nomi di dominio aggiungendo i nomi di dominio wai.local e
web1.public che corrispondono rispettivamente alla web app interna di gestione e a quella
visibile al pubblico.
Notate che per le verifiche non è necessario che il computer su cui è installato DBFree sia collegato
ad internet e neppure connesso alla vostra LAN (ammesso che ne abbiate una).
Per verificare che tutto funzioni correttamente la prima cosa da fare è aprire un browser e digitare
l'indirizzo http://localhost oppure http://127.0.0.1
Se ottenete un messaggio di errore (del tipo HTTP ERROR 404, 501 o simili) potete smettere di
leggere e passate invece al documento DBFree V3 NSR Troubleshooting).
A questo punto verifichiamo che sia correttamente installata l'interfaccia web di gestion WAI (Web
Administration Interface), digitando l'indirizzo http://wai.local
Questa rappresenta il modo più pratico di interagire con DBFree ed è una Web App sviluppata
usando il linguaggio di programmazione su cui si basa DBFree, lo stesso che potete usare voi per
sviluppare la vostra applicazione o il vostro portale web.
DBFree V3 NSR - Getting started - Page 2/14 - Rev. 1.1
Questa applicazione è visibile inizialmente tramite l'indirizzo http://web1.public, ma esclusivamente
dal vostro computer (quello su cui è installato DBFree).
In questa fase non siete ancora raggiungibili e visibili dal mondo esterno.
Alcuni controlli da effettuare
Prima di procedere oltre è consigliabile acquisire alcune informazioni sulla vostra nuova
installazione:
1. configurazione di rete della macchina
2. stato del firewall
3. permessi di accesso per i files di DBFree e degli archivi
1 – Scheda di rete e indirizzo IP
Il metodo per controllare la vostra configurazione di rete dipende largamente dalla versione di
Windows che state usando. Un metodo che funzione su (quasi) tutte le versioni è quello di aprire
una finestra DOS (un “command prompt” o CMD) e digitare il comando ipconfig.
Il dato che ci interessa è l'indirizzo IP (v4) della scheda di rete del vostro computer: questo appare
come 192.168.1.2 o qualcosa di simile (nel nostro esempio è 192.168.56.1). Prendete nota di questo
indirizzo: se volete usare DBFree solo all'interno della vostra rete locale è già l'indirizzo che potete
comunicare ai vostri colleghi di lavoro per raggiungere il vostro nuovo server.
Infatti digitando questo indirizzo da qualunque computer in rete locale (incluso il vostro) apparirà la
pagina predefinita del sito vuoto fornito con DBFree V3 NSR 1.0.10
In seguito vederemo come sostituire questo sito (che altro non è che una “web application”) con
DBFree V3 NSR - Getting started - Page 3/14 - Rev. 1.1
uno di quelli disponibili per DBFree o con uno realizzato eventualmente direttamente da voi.
Prima di procedere però dovreste anche verificare che l'indirizzo IP che avete appena ottenuto non
sia un IP dinamico ovvero che cambia ogni volta che riavviate il vostro computer e lo connette alla
rete. Anche questo varia da una versione all'altra di Windows.
Questa videata (riferita a Windows 7) può esservi d'aiuto:
Invece di “Ottieni automaticamente un indirizzo IP” occorre selezionare “Utilizza il seguente
indirizzo IP” (prendendo nota e rimettendo gli stessi numeri, se necessari).
Questa operazione è indispensabile perchè garantisce che d'ora in poi il vostro computer (e quindi il
server che è diventato) avrà sempre questo indirizzo, che potrete comunicare ai vosti utenti.
Controlliamo il firewall
Come al solito anche questa operazione dipende dalla vostra versione di Windows: qui vi dovete
arrangiare da soli. In Windows Vista, 7 e 8 basta digitare “firewall” nella casella di ricerca del menu
start.
Le porte da lasciare aperte sono la 80 ed eventualmente la 88 e la 888, sia in entrata che in uscita.
Per la maggior parte di casi basta la porta 80.
Controlliamo i permessi di accesso al disco
Le versioni più recenti di Windows hanno introdotto dei controlli (UAC o “User Access Control”)
che impediscono ai programmi installati di fare quello che vogliono senza specifica autorizzazione.
Durante l'installazione DBFree cerca di ottenere le necessarie autorizzazioni ma è comunque
consigliabile effettuare un controllo.
Il metodo più pratico è di aggiungere il gruppo EVERYONE e accordargli le autorizzazioni di
DBFree V3 NSR - Getting started - Page 4/14 - Rev. 1.1
controllo completo, come mostrato qui sotto.
Quasi sicuramente nella lista utenti e gruppi non apparirà il gruppo EVERYONE: cliccate su
modifica e aggiungetelo voi, scegliendo modifica, poi aggiungi, e scrivendo il nome everyone
manualmente, come mostrato in questo esempio:
DBFree V3 NSR - Getting started - Page 5/14 - Rev. 1.1
DBFree V3 NSR - Getting started - Page 6/14 - Rev. 1.1
DBFree V3 NSR - Getting started - Page 7/14 - Rev. 1.1
La presenza sul web
Se avete scelto DBFree è molto probabile che vogliate predisporre un sito visibile e raggiungibile
da internet. Per raggiungere questo obbiettivo dovete necessariamente disporre di una connessione
ADSL attiva, di un router e di un nome univoco e universalmente riconosciuto da assegnare al
vostro sito (ovvero un nome di dominio).
Connessione ADSL
Esistono vari tipi di connessioni ADSL : da rete fissa, mobile o tramikte hot-spot wi-fi (tipicamente
in luoghi pubblici).
Sebbene sia teoricamente possibile usarne una qualsiasi in pratica per i nostri scopi è necessaria
quella da rete fissa fornita a pagamento dai vari gestori telefonici o da provider indipendenti.
Questo tipo di connessione vine detta ADSL a tariffa flat e necessita di un telefono fisso (e dei
relativi cavi a cui agganciarsi).
La tecnologia ADSL sfrutta i cavi telefonici per far passare le informazioni digitali senza interferire
con le comunicazioni vocali. Per questo utilizzano frequenze particolari che il nostro orecchio
percepisce come un fruscìo di fondo e che necessitano di un filtro specifico (fornito col router) per
essere eliminate.
Questi dati che viaggiano sulla linea vengono chiamati pacchetti IP e contengono ognuno l'indirizzo
del destinatario: per questo è importante configurare correttamente l'indirizzo IP del vostro PC (e
del vostro router).
Dispositivi ADSL
Il router (o più correttamente il modem-router) che viene di solito fornito dal gestore telefonico ma
che volendo potete sostituire con uno vostro, è l'elemento chiave di tutto il sistema e si colloca fra la
linea telefonica e il vostro PC (e tutti quelli della vostra rete): intercetta il fruscio (la modulazione di
frequenze) e lo trasforma in dati (e viceversa). Questa operazione prende nome di modulazionedemodulazione (da cui il nome modem).
Dovete pensare al vostro router come ad un piccolo PC senza tastiera né monitor, ma completo di
un modem, una o più schede di rete (i quattro attacchi a volte presenti sul retro), una scheda senza
fili (wireless) e un modem ADSL. Il tutto è gestito da un proprio sistema operativo (di solito
derivato dal Linux) ospitato su una piccola scheda SD interna.
Il compito principale di qualunque router è di intercettare le richieste di dati che arrivano su una
delle sue tante porte logiche e girarle (ruotarle) al destinatario, da cui il nome router.
Se comprate un vostro router al posto di quello fornito dal provider fate attenzione che incorpori il
modem ADSL (cioè che sulla scatola sia specificato chiaramente che è un Modem-router)
Nomi di dominio
I nomi di dominio vengono invece assegnati da enti specializzati tramite rivenditori (detti
mantainer) come vederemo più tardi.
Preparare il server per internet
Se il vostro server deve essere esposto su internet saranno necessarie altre due operazioni
aggiuntive, ma che non riguardano strettamente i vostro PC, ma due elementi esterni:
• a) - configurare il router ADSL
DBFree V3 NSR - Getting started - Page 8/14 - Rev. 1.1
•
b) - ottenere un nome di dominio a vostro uso e consumo
Configurare il router
Da qui in poi diamo per scontato che abbiate il diritto di manipolare e avere completo accesso al
router ADSL della vostra rete (e quindi abbiate la password per entrarci)
Praticamente tutti i router oggi in uso dispongono di una interfaccia web di gestione (in modo non
dissimile dalla WAI di DBFree).
Il router si gestisce tramite un browser, digitando il suo indirizzo IP nella barra degli indirizzi.
L'indirizzo normalmente è lo stesso del vostro PC salvo che l'ultimo numero è il più basso possibile
rispetto al vostro PC: nel nostro esempio l'indirizzo del router sarebbe 192.168.56.0.
(Nel caso tipico di un router ADSL telecomitalia l'indirizzo è 192.168.1.1 mentre alcuni router
usano 192.168.1.0)
Quale che sia il vostro router dovete cercare la sezione che vi permette di configurare un server
virtuale (a volte lo trovate sotto la voce LAN, altre sotto NAT o PORT MAPPING).
Questo è un esempio di quello che potreste vedere con un router Telecomitalia (Alice):
Prima di tutto effettuiamo un controllo sulla topologia della rete cliccando su il pulsante LAN:
DBFree V3 NSR - Getting started - Page 9/14 - Rev. 1.1
E quindi sotto Configura LAN dove si apre una maschera come questa:
Come si vede il router ha indirizzo 192.168.1.1 e il PC collegato (via cavo) al router ha indirizzo
192.168.1.2. Questo PC farà da server e risponderà a tutte le richieste provenienti da internet,
tramite la configurazione di un server virtuale, che si può impostare cliccando sul pulsante PORT
MAPPING della colonna di destra (arancione) e che darà accesso ad una pagina simile a questa:
Scegliete Virtual Server per protocolli Internet e fornite i dati necessari (l'indirizzo IP del PC che fa
da server):
Cliccate sul pulsante ATTIVA e il router è configurato.
Cosa avete fatto in parole semplici
Praticamente avete ordinato al vostro router che tutte le comunicazioni in arrivo sulla porta esterna
80 devono essere dirottate alla porta 80 del vostro PC (usando il suo indirizzo IP per indicargli
qual'è).
DBFree V3 NSR - Getting started - Page 10/14 - Rev. 1.1
La porta esterna viene definita porta WAN e il suo indirizzo IP viene stabilito dal gestore del
servizio (Telecomitalia ma la storia è identica per Wind, Vodafone ecc.) e non lo potete cambiare
quindi tutto quello che dovete mettere è la porta WAN (80), l'indirizzo IP LAN (nel nostro esempio
era 192.168.1.2) e la porta LAN (80) interne.
Così facendo tutte le richieste web effettuate dai browser (che per convenzione utilizzano la porta
80) e dirette verso il vostro router verranno passate al vostro PC, intercettate da DBFree e
soddisfatte tramite la logica della web application che avrete installato in web1.public.
Come rendere il vostro router raggiungibile
Come abbiamo detto l'indirizzo IP del vostro router lo stabilisce il gestore del servizio ADSL.
Naturalmente voi lo potete vedere, utilizzando il software di gestione del router stesso (di solito è
in bella vista nella Home Page o nella pagina di riepilogo sullo stato del servizio come in questo
esempio).
Il problema è che tranne rari casi questo indirizzo (qui è 87.19.24.211) non rimane sempre lo stesso
ma può cambiare (e viene per questo chiamato IP dinamico).
Questo comportamento varia fra gestore e gestore, per cui alcuni cambiano spesso l'indirizzo
durante la giornata, mentre altri solo in caso di spegnimento e riaccensione del router.
In ogni caso l'indirizzo del vostro router non è una cosa garantita (a meno che abbiate un costoso
contratto ad IP Statico, che non tutti offrono) e quindi non si può comunicare ai vostri utenti perchè
lo usino per connettersi al vostro server.
Inoltre è scontato che invece di una sequenza di numeri e di punti (come l'indirizzo IP) vorrete
fornire ai vostri utenti un nome facile da ricordare, ovvero un nome di dominio internet che abbia un
qualche significato, come www.dbfree.org
Il nome non è altro che un collegamento all'indirizzo IP: quando acquisite un nome di dominio
questo viene associato all'indirizzo IP che voi specificate. Ovvio che se questo cambia il nome finirà
per indirizzare ad un router inesistente o peggio al sito di qualcun altro.
Quindi bisogna procurarsi un nome di dominio e un modo per aggiornarlo costantemente
all'indirizzo che il vostro router assume di volta in volta.
Le due cose si combinano insieme ricorrendo ad un servizio esterno come www.no-ip.com o
www.tzo.org. Entrambi offrono un servizio gratuito, oltre a quelli a pagamento, che vi permette di
attivare quasi immediatamente il vostro server.
DBFree V3 NSR - Getting started - Page 11/14 - Rev. 1.1
Per esempio, una volta registrati al servizio di NO-IP.com, è sufficiente cliccare su Add a Host
L' host sarebbe il nome di dominio che volete associare ad un indirizzo IP.
Sono a disposizione gratuitamente diversi nomi, ma che finiscono tutti per noip.org, zapto.org o
simili.
In pratica potete scegliere solo la prima parte del nome (si chiama in realtà dominio di secondo
livello) tipo ilmiosito.noip.org. Se volete un nome tutto vostro dovete pagare circa 25 dollari l'anno.
Questa è solo la prima parte: il secondo passaggio è di scaricare un piccolo software da installare
sul PC che usate come server, e che girando in background si occupa di controllare ogni pochi
DBFree V3 NSR - Getting started - Page 12/14 - Rev. 1.1
minuti l'indirizzo del vostro router e se per caso sia cambiato rispetto a quello che avete registrato
su No-Ip.com.
Se questo dovesse essere stato cambiato, il software, in maniera assolutamente trasparente,
provvede ad aggiornare l'account, per cui non importa quante volte il vostro gestore cambia
l'indirizzo del vostro router, al nome di dominio che gli avete assegnato corrisponderà sempre
l'indirizzo attualmente in uso e quindi il sito sarà comunque raggiungibile.
Siccome il software e le opzioni di questi servizi variano nel tempo in conseguenza degli
aggiornamenti effettuati dai gestori queste informazioni vanno intese solo come di indirizzo
generale - fate riferimento alle istruzioni specifiche dei produttori per la configurazione e le
caratteristiche dei servizi offerti.
Sostituire l'applicazione predefinita
Come abbiamo accennato DBFree installa una applicazione predefinita che altro non è che un web
vuoto, collocato fisicamente nella posizione c:\dbfree\webpages\public\web1
Una web application per DBFree, a differenza di altre soluzioni, in effetti non differisce in niente da
un comune sito web statico. Semplicemente oltre alle pagine statiche offre anche pagine dinamiche,
ovvero che contengono istruzioni di programmazione che vengono eseguite dal server prima di
inviarle ai browser che le hanno richieste.
Una web application può essere costituita da un misto di pagine statiche e dinamiche oppure da sole
pagine dinamiche. Queste possono essere poche o molte, o anche una sola.
L'importante è che tutte le pagine coinvolte nel processo risiedano nella stessa cartella (e relative
sottocartelle).
Ne consegue che per cambiare l'applicazione predefinita è sufficiente cancellare tutto il contenuto
della cartella e sostituirlo. Potete anche semplicemente cambiare nome alla cartella e crearne una
nuova vuota in cui copiare i files della nuova applicazione.
Copiare i files di una diversa applicazione nella cartella di una precedentemente esistente
sovrascrivendoli generalmente non è una buona idea.
Applicazioni per DBFree V3
Chiunque può, con un po' di impegno, sviluppare Web Apps per DBFree.
La cosa più semplice però è scaricare una applicazione già funzionante dal sito
http://apps.maxscript.org e procedere a modificarla ( o semplicemente a personalizzarla ed
utilizzarla così com'è).
La maggior parte delle applicazioni DBFree V3 viene distribuita nel formato compresso RAR.
Per gestire questo formato avrete bisogno di installare sul vostro PC il programma WinRar.
Una volta scaricato il file RAR basterà aprirlo ed estrarre la cartella contenuta: questa cartella è la
vostra nuova applicazione web.
Come installare manualmente
1. Scaricate il file RAR della nuova applicazione dal sito DBFree.org ed estraete la cartella che
contiene sul desktop.
2. Aprite la cartella c:\dbfree\webpages
3. Spostateci la cartella appena estratta
4. Cambiate nome alla esistente cartella web1 (ad esempio chiamandola web2)
5. Cambiate nome alla cartella che avete spostato e chiamatela web1
DBFree V3 NSR - Getting started - Page 13/14 - Rev. 1.1
Installazione automatica
Alcune applicazioni dispongono di un proprio installer.
In questi casi seguite le istruzioni fornite dallo sviluppatore.
Differenze fra le applicazioni
Le applicazioni sviluppate per le versioni precedenti di DBFree sono generalmente compatibili
anche con DBFree V3 (ma non sempre è vero il contrario).
Fanno eccezione le i-Apps di DBFree 2.x, che sono concepite per essere sub-application di una
applicazione principale.
Non seguite la procedura indicata sin qui con le i-Apps in quanto non è garantito che
funzionerebbero (altre informazioni sono reperibili sul sito).
Domande frequenti
Dove trovo le applicazioni per DBFree V3 NSR?
L'indirizzo è http://apps.maxscript.org
altre applicazioni possono essere disponibili su www.dbfree.org/apps
Devo pagare per usare DBFree V3?
No. L'utilizzo è completamente gratuito. Per i particolari consultate le condizioni di licenza incluse
nel pacchetto o quelle presenti sul sito. DBFree è software libero (freeware), ma non software con
sorgenti di pubblico dominio (open source). I diritti sul marchio sono riservati.
Devo pagare per usare le applicazioni per DBFree V3 che scarico dal sito?
Generalmente no, ma dipende dallo sviluppatore che le mette a disposizione. In alcuni casi può
essere richiesto un contributo per la documentazione, in altri una vera e prorpia licenza d'uso.
Le applicazioni fornite come esempi di programmazione o come demo direttamente da DBFree.org
sono sempre gratuite.
Posso installare DBFree su un server preso a noleggio da un provider esterno?
Solo se il provider vi offre il completo controllo della macchina (il cosiddetto Server Virtuale) e
quindi la possibilità di installare vostri programmi. Le soluzioni di Hosting Virtuale normalmente
non lo permettono.
Posso installare applicazioni e usare DBFree direttamente da una macchina virtuale?
Certo. DBFree era stato pensato inizialmente proprio per realizzare virtual appliances.
Come posso limitare l'accesso al mio server ad utenti da me scelti?
L'accesso alle applicazioni (e quindi al sito che le ospita) è determinato dalle applicazioni stesse.
Se la applicazione che stai usando non prevede una gestione utenti l'unica strada è modificarla
partendo dai sorgenti, o sceglierne una che la preveda.
Come posso ottenere assistenza?
L'assistenza viene fornita via mail tramite sistema di ticket prepagati. Occorre preventivamente
registrarsi come clienti ed otenere un codice cliente da usare nelle richieste.
Visitate il sito www.winix.it per maggiori informazioni.
DBFree V3 NSR - Getting started - Page 14/14 - Rev. 1.1