Installazione

• bin dove risiedono tutti i programmi eseguibili;
• lib dove risiedono le librerie (solo Unix/Linux);
• inc dove risiedono le gli header files per le compilazioni;
• java dove risiede il driver JDBC e le applicazioni scritte con linguaggio Java.
• doc dove risiede la documentazione.

PicoSQL consiste fondamentalmente in un programma, picosqld, da attivare tramite inetd (o xinetd) oppure picoserv. In tal modo diventa un servizio di rete legato a una porta, cioè a un numero intero compreso tra 1 e 65535; questo numero (per esempio 6789) deve essere sempre specificato sulla linea di comando di picosqld. Per esempio:

picosqld 6789

Per l'attivazione con inetd (o xinetd), si rimanda alla documentazione relativa. picoserv è un semplice programma che sostituisce inetd, principalmente per scopi di test o debugging: il suo uso è il seguente

picoserv [-f] <lineDiComando> <porta>

picoserv "picosqld 6789" 6789

Quando viene fatta una richiesta di connessione picoSQL legge un file di configurazione dove trova le informazioni necessarie. Questo file è un file in formato testo su Unix/Linux mentre su Windows è il registry file di sistema e deve essere modificato con il programma regedit.

• Unix/LunixViene ricercato il file

  $HOME/.picosql.ini

  oppure, in mancanza di questo,

  /etc/picosql.ini

  In questo file possono essere presenti più sezioni, caratterizzate da un nome racchiuso tra parentesi quadre su una singola linea. Ciascuna sezione può contenere più attributi, caratterizzati da un nome (il nome attributo), un segno di uguale (=) e un valore che termina all'interruzione della linea di testo. Le linee che iniziano con il carattere punto e virgola (;) oppure diesis (#) vengono considerati commenti.
  Ciascuna sezione corrisponde a un database e comprende informazioni come utente, password e locazione del DB. Nell'esempio seguente sono dichiarati due database, il primo, chiamato picoSqlTest, accessibile a chiunque mentre il secondo, chiamato rubrica può essere acceduto solo fornendo l'appropriato nome utente e password.

   [picoSqlTest]
   DataDirectory=/home/test.db
   
   [rubrica]
   DataDirectory=/home/rubrica.db
   User=pico
   Password=soft
   PicoOdbcTrace=NO
   SuspensiveLock=YES
   ; for picosql client only
   server=localhost
   port=6789
   

• Windows NT/2000/XP Su Windows la configurazione viene letta dal registry file a partire dalla chiave:

  HKEY_CURRENT_USER\Software\PicoSoft\PicoSQL

  oppure, in mancanza di questa,

  HKEY_LOCAL_MACHINE\Software\PicoSoft\PicoSQL

  Ogni chiave in questa sezione può corrispondere a un database. Sotto la chiave corrispondente al database possono essere definite delle stringhe, ciascuna delle quali corrisponde a un attributo del database, come utente, password e locazione del DB. Nell'esempio seguente sono dichiarati due database, il primo, chiamato picoSqlTest, accessibile a chiunque mentre il secondo, chiamato rubrica può essere acceduto solo fornendo l'appropriato nome utente e password.

   [HKEY_CURRENT_USER\Software\PicoSoft\PicoSQL\picoSqlTest]
   DataDirectory=C:\home\test.db
  
   [HKEY_CURRENT_USER\Software\PicoSoft\PicoSQL\rubrica]
   DataDirectory=C:\home\rubrica.db
   User=pico
   Password=soft
   PicoOdbcTrace=NO
   SuspensiveLock=YES
   server=localhost
   port=6789