Installazione D i s k i

Transcript

1 Guida di riferimento per l installazione del back-end e del front-end. Versione 2009.a

2 Sommario Sommario... 2 Novità... 3 Installazione Diski... 4 Requisiti Software e Hardware... 5 [front-end] Installazione di Diski su Windows... 7 [back-end] Installazione di PostgreSQL su Windows [back-end] Installazione di PostgreSQL su sistemi Unix [back-end] Installazione di Diski su Windows e Unix [front-end] Aggiornamento di Diski su Windows [back-end] Aggiornamento di PostgreSQL [back-end] Aggiornamento di Diski Installare più versioni di Diski in un singolo calcolatore [back-end] Ottimizzazione di PostgreSQL Barcode Commenti finali

3 Novità La procedura di installazione comprende la documentazione aggiornata alla release attuale. La procedura di installazione comprende i tool per aggiornare il back-end dalla versione 2008.d alla 2009.a. Correzioni alle anomalie riportate dagli utenti di Diski. Numero di ubicazioni illimitate, il limite ora è posto da PostgreSQL: le ubicazioni codificabili vanno ora da a Riduzione dei tempi di risposta nella ricerca per barcode. 3

4 Installazione Diski L installazione di Diski è composta di due parti: il back-end e il front-end. Il motore back-end è il database relazionale orientato agli oggetti PostgreSQL. PostgreSQL è disponibile per diverse piattaforme e potete utilizzare quelle che preferite. Il front-end è realizzato in Microsoft Access e potete anche usare in alternativa la versione runtime. Potete installare back-end e front-end sullo stesso computer, nel caso utilizziate un sistema Windows ed eventualmente provvedere ad un architettura più complessa solo in seguito utilizzando come back-end un qualsiasi sistema operativo supportato da PostgreSQL. Supportiamo anche ogni sistema di virtualizzazione come VirtualBox, ecc. Potete anche migrare da una piattaforma all altra per il vostro backend. In questo documento si vuole descrivere la nuova procedura di installazione che sarà l unica supportata. Le procedure delle precedenti versioni di Diski non sono supportate per la versione attuale e successive. PostgreSQL è completamente gratuito e open-source mentre Microsoft Access richiede una regolare licenza rilasciata da Microsoft, nel caso non abbiate licenza di Microsoft Access è comunque possibile installare il runtime di Access 2007 che è diventato gratuito proprio da questa versione con l unica accortezza che è possibile installarlo solo su Windows XP SP2 e versioni successive. Tutte le versioni precedenti alla 2007 del runtime di Microsoft Access richiedono licenza d uso. In sostanza, per avere un sistema Diski funzionante si deve procedere a: Installare PostgreSQL su una delle piattaforme supportate Installare Microsoft Access o il runtime Installare il front-end di Diski Installare il back-end di Diski in PostgreSQL Nel documento vedremo di dare dettagliata spiegazione di ogni fase. 4

5 Requisiti Software e Hardware Tabella di riferimento con i sistemi operativi supportati. Nessun limite nel utilizzare applicazioni di virtualizzazione, come ad esempio VirtualBox, purché supportate da ogni componente. back-end front-end Windows 98 SE X Windows ME X Windows 2000 SP3 X X Windows XP X X Windows 2003 X X Windows Vista X X Windows 2008 X Linux * X Solaris * X FreeBSD * X OpenBSD * X NetBSD * X MacOS X * X Aix * X HPUX * X IRIX* X SCO* X Per l installazione, partendo dai sorgenti, nei sistemi operativi indicati con * è necessario disporre almeno del software riportato nella tabella seguente. requisiti software sui sistemi Unix GNU make o superiore compilatore C ISO/ANSI (consigliato gcc) tar e gzip per decomprimere i sorgenti libreria GNU readline (in alternativa libedit per i BSD) libreria GNU zlib assembler e include del sistema operativo Altro software può essere richiesto in funzione delle funzionalità attivate durante la compilazione, riferirsi alla documentazione di PostgreSQL per i dettagli. Raccomandiamo sempre di usare l ultimo livello di patch o service pack per il sistema operativo scelto, sia per il back-end che per il front-end. La stessa raccomandazione anche per Microsoft Access, nel caso abbiate Microsoft Office installato vi suggeriamo di aggiornare anche l intera suite all ultimo service pack disponibile per la vostra versione. Versioni di Microsoft Access supportate, compresi i runtime: versione di Microsoft Access versione di Diski Access 97 Dalla solo ANSI Access 2000 Dalla ANSI e UNICODE Access XP Dalla ANSI e UNICODE Access 2003 Dalla ANSI e UNICODE Access 2007 Dalla 2007.a ANSI e UNICODE 5

6 Dato che a partire dalla versione 2008.b l encoding predefinito è lo Unicode consigliamo di usare Access 2000 (o il runtime) o superiore in quando Access 97 non supporta lo Unicode. Versioni di PostgreSQL supportate, indipendentemente dalla piattaforma: versione di PostgreSQL Versione di Diski PostgreSQL 7.X.X Dalla alla PostgreSQL 8.0.X Dalla alla PostgreSQL 8.1.X Dalla alla 2008.a PostgreSQL 8.2.X Dalla 2007.a PostgreSQL 8.3.X Dalla 2008.b La precedente generazione di Diski (denominata da ora date-version) era identificata con codici che corrispondevano alla data di rilascio. Queste sono tutte quelle che vanno dalla versione alla Tutte le versioni precedenti alla (compresa) non sono più supportate. La generazione attuale di Diski (denominata letter-version) è identificata dall anno di pubblicazione e da una lettera consecutiva ad ogni rilascio. A partire dalla versione 2007.a è sempre possibile passare all ultima versione disponibile. Le differenze tra date-version e letter-version sono sostanziali e concettuali, in letter-version sono state estese molte funzionalità già presenti in date-version, inoltre sono notevoli le novità aggiunte tanto da richiedere caratteristiche che solo le recenti versioni di PostgreSQL potevano garantire. In sostanza il layout del database è profondamente differente. Per usare il front-end è necessario disporre di almeno un processore a 200 Mhz, 32 MB di memoria RAM, di almeno 20 MB sul disco in cui verrà installato Diski e di almeno 1 MB sul disco in cui è installato Windows. Per quanto riguarda il back-end stimiamo un occupazione di circa 5 MB per l archivio modello e altri 5 MB per l archivio predefinito a cui deve essere aggiunto lo spazio per ogni altro archivio che si andrà a creare. Indicativamente, servono circa 20 MB per un archivio che gestisce 500 titoli originali e 250 copie con tutte le funzionalità attivate. Da queste indicazioni sono ovviamente esclusi i requisiti che riguardano Microsoft Access e PostgreSQL. Per tali informazioni riferitevi alle rispettive guide ufficiali. Diski è stato sviluppato in un contesto di risorse limitate per tanto non riteniamo critico il dimensionamento hardware dei sistemi che ospiteranno Diski, nemmeno in contesti di multiutenza. Configurazione obbligatoria è quella di disporre di una risoluzione video pari o superiore a 800X600 senza la quale l applicazione frontend non viene avviata. Il sistema di sviluppo di Diski è composto per il back-end da una SPARCclassic (microsparc 50 Mhz, 48 MB di ram e 1 GB di HD) con Solaris 2.6 e PostgreSQL 8.3.3, per il front-end da un PC (Pentium 200 Mhz, 32 MD di ram e 3 GB di HD) con Windows 98 SE e Access 97. Il sistema di test di Diski è composto per il back-end da una workstation UltraSPARC 5 (UltraSPARC a 270 Mhz, 128 MB di ram e 4 GB di HD) con Solaris 9 e PostgreSQL e da una RS/ (processore a 100 Mhz, 160 MB di ram, 1 GB di HD) con AIX e PostgreSQL 8.2.5; per il front-end da un PC (Centrino Duo 2,4 Ghz, 2 GB di ram e 160 GB di HD) con Windows Vista e Access A questi si devono aggiungere vari altri sistemi virtuali realizzati con VirtualBox in cui vengono testate altre combinazioni software. 6

7 [front-end] Installazione di Diski su Windows Installazione D i s k i Per installare il front-end dovete procedere per prima cosa a scaricarlo dal sito di Diski. Sono disponibili due distribuzioni distinte che differiscono per il fatto che nella diski_inst_max.exe sono compresi anche i kit di installazione di PostgreSQL per Windows, i sorgenti di PostgreSQL per sistemi Unix e il runtime di Access La distribuzione diski_inst.exe non contiene le opzioni citate. Il pacchetto diski_inst_max.exe è adatto per chi deve realizzare una nuova installazione e non dispone del software necessario, mentre diski_inst.exe è adatto a chi già possiede il software di base (PostgreSQL e Access) o vuole aggiungere una nuova stazione front-end da collegare ad un back-end esistente. Le dimensioni dei due pacchetti sono differenti: diski_inst_max.exe è circa 110 MB mentre diski_inst.exe è circa 10 MB. Per prima cosa procedete ad installare, se già non lo avete fatto, Microsoft Access in una delle versioni supportate, vi ricordo che in alcune edizioni di Microsoft Office (ad esempio la Profesional ) trovate Access. Nel caso non disponiate di licenza per Microsoft Access ma disponete di Windows XP con SP2 (o superiore) potete utilizzare il runtime di Access per eseguire Diski, con la distribuzione diski_inst_max.exe di Diski trovate anche il runtime di Access 2007 che proprio da questa versione è gratuito. Nel caso optiate per il runtime proseguite oltre nelle lettura. Per quanto riguarda l installazione di Access vi prego di fare attenzione, selezionate il controllo calendario. Il runtime già contiene tale opzione. Se disponete anche di un service pack per Microsoft Office è opportuno installarlo. Ora è necessario avviare il programma di installazione del front -end. Fate doppio click sul file diski_inst_max.exe (o in alternativa sul file diski_inst.exe ). Immediatamente viene individuata la versione di Microsoft Access installato sulla vostra stazione, nel caso non venga trovato potete comunque confermare il messaggio e proseguire l installazione. Di seguito alcuni esempi nei quali viene rilevato Access: Proseguite premendo il pulsante OK. Seguono alcune immagini dell installazione della versione 2008.b. 7

8 Vi viene chiesto dove installare il front-end di Diski. Questo è il punto in cui le due distribuzioni differiscono. Per diski_inst_max.exe : 8

9 Obbligatoriamente dovete sceglie se installare il front-end per Access 97 oppure per Access 2000 o superiore. Successivamente potete decidere se includere nell installazione i driver ODBC, le utilità per installare e aggiornare il back-end (se è la prima stazione che installate ne avete bisogno), Il runtime di Access 2007, PostgreSQL per Windows, i sorgenti di PostgreSQL (utili per chi intende usare uno Unix supportato come back-end) e il Windows Installer (serve per installare i driver ODBC di PostgreSQL su Windows 98SE, Windows ME e Windows 2000 se non opportunamente aggiornati). Di seguito la stessa maschera con diski_inst.exe : 9

10 Successivamente le due installazioni proseguono allo stesso modo: riepilogo delle opzioni scelte e conferma. 10

11 Completata l installazione vi troverete con queste nuove voci nel menù programmi: In alcuni casi può essere comodo ripete l installazione del motore front-end (Microsoft Access 2007 runtime) o dei driver back-end (driver ODBC di PostgreSQL). L installazione del motore front-end è presente nella sola distribuzione max. Potete ripetere l installazione Microsoft Access 2007 runtime, se non è andata a buon fine o se volete installarlo nuovamente, da Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Cartella installazione -> AccessRT.msi, confermando sempre le impostazioni predefinite del programma di installazione. 11

12 Non aspettatevi di vedere una nuova voce nel menu Start al termine dell installazione, il runtime rimane nascosto. Il runtime di Access 2007 è valido solo per Windows XP SP2 e Windows Vista o superiori. Potete ripetere l installazione i driver back-end da Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Cartella installazione -> psqlodbc.msi e confermate le impostazioni predefinite. Nel caso abbiate già i driver ODBC installati ma di versione precedente vi consiglio di aggiornarli rimuovendo la versione precedente prima di avviare l installazione di Diski. Se avete altre applicazioni che usano i driver ODBC di PostgreSQL verificate se queste sono compatibili con la versione fornita con Diski dei driver ODBC per PostgreSQL. In generale le nuove versioni dei driver ODBC per PostgreSQL sono compatibili con i server PostgreSQL delle versioni precedenti. 12

13 Se l installazione dei driver ODBC vi avverte che non avete una versione di Windows Installer corretta potete aggiornarla da Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Cartella installazione -> InstMsiA.exe per Windows 98SE o ME oppure WindowsInstaller-KB v2-x86.exe per Windows 2000 SP3. A questo punto avviate il front-end per verificare la corretta installazione, potete eseguire il front-end di Diski da Start -> Programmi -> Diski 200X.Y -> D i s k i Ora dovete procedere ad installare PostgreSQL, il motore back-end, come descritto in seguito a questo documento. 13

14 [back-end] Installazione di PostgreSQL su Windows Se avete scaricato la distribuzione completa dell installazione di Diski ( diski_inst_max ) potete trovare il pacchetto di installazione dell ultima versione testata con Diski di PostgreSQL nella cartella <INSTDIR>\install nel percorso in cui avete installato il front-end (oppure dal menu Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Cartella installazione). Solitamente ha un nome simile a postgresql- X.X.X.zip dove le X identificano la versione. Io stesso file con estensione.tar.gz è il pacchetto con i sorgenti, adatto per i sistemi Unix. In questo momento la versione è l ultima testata per Diski a disposizione ma ce ne saranno sicuramente altre nel futuro. Il file è di circa 26 MB, per cui se avete deciso di scaricarlo e non avete una connessione veloce considerate che servirà parecchio tempo. Consigliamo vivamente di utilizzare sempre l ultima versione di PostgreSQL testata per Diski, come quelle che trovate nel pacchetto diski_inst_max.exe. Fate login come Administrator (o come utente con pari diritti) sulla vostra stazione Windows. Se la stazione appartiene ad un dominio accedete con un account con diritti amministrativi nel dominio. Decomprimete il file postgresql-x.x.x.zip (in questo esempio abbiamo utilizzato la versione 8.3.3) in una cartella temporanea. Vi trovate all interno i seguenti file: Fate doppio click sil file con nome SETUP.bat e seguite l installazione come segue. 14

15 Fate click su Start e confermate le schermate successive con il pulsante Next fino alla selezione dei componenti: 15

16 Lasciate pure le impostazioni predefinite. 16

17 Nel campo Account domain troverete il nome del vostro PC, se il vostro computer è in rete con un dominio, il nome del dominio. Nel campo Account password scrivete postgres e confermatela in Verify password. Vi viene chiesta conferma per la creazione dell utente postgres, fate click su Yes. Venite avvisati che la password impostata è troppo semplice, fate click su No, per una password più sicura provvederete in seguito. 17

18 Impostate come in figura la schermata che vi comparirà, Inserite come password postgres in entrambi i campi. Il fatto che scegliate UTF8 come enconding non pregiudicherà il fatto di poter creare e usare archivi con altre codifiche. Confermate facendo click su OK, l installazione vi avverte che abilitando il flag Accept connection on all consentite ad altri host di accedere agli archivi, ovviamente questi devono conoscere un utente e relativa password. 18

19 Fate click su Next. Impostate come in figura. 19

20 Confermate con Next, attendete il temine dell installazione. 20

21 Fate click su finish. Ora PostgreSQL è installato sul vostro sistema. E opportuno impostare la cartella in cui gli eseguibili di PostgreSQL si trovano nel path di sistema in modo da averli sempre a disposizione in qualsiasi directory vi troviate. Per farlo seguite questi istruzioni. Per prima cosa identificate il percorso in cui PostgreSQL è installato, solitamente si trova in C:\Programmi\PostgreSQL o in C:\Program Files\PostgreSQL se usate il sistema Windows in lingua inglese. All interno di questa cartella ne troverete una corrispondente alla versione di PostgreSQL ed al suo interno altre cartelle e file. 21

22 La cartella che contiene gli eseguibili è la bin che sta per binary. Il percorso completo in questo caso è: C:\Programmi\PostgreSQL\8.3\bin Per impostarlo nel path di sistema aprite il pannello di controllo di Windows e fate doppio click sull icona Sistema. Quando vi si aprirà la maschera con le proprietà del vostro sistema fate click sulla scheda Avanzate. Fate click sul pulsante per l impostazione delle variabili con nome Variabili d ambiente... Tra le variabili di sistema troverete Path, Fate doppio click su Path. 22

23 Scorrete l elenco del valore della variabile fino in fondo, prestate attenzione al fatto che ogni percorso è separato dal carattere ;. Ora potete aggiungere il percorso che abbiamo identificato in precedenza in cui PostgreSQL è installato. Confermate premendo sempre OK fino ad uscire dalla finestra delle proprietà di sistema. Per verificare che il path di sistema sia stato modificato correttamente potete aprire una sessione DOS e digitare il comando psql U postgres e premere il pulsante invio (prestate attenzione al maiuscolo/minuscolo). Se tutto è impostato a dovere comparirà una schermata come la seguente, per uscire digitate semplicemente \q. Diversamente rivedete ogni passo descritto in questo documento. Leggete con attenzione il capitolo [backend] Ottimizzazione di PostgreSQL prima di proseguire con le operazioni. 23

24 [back-end] Installazione di PostgreSQL su sistemi Unix Solitamente, per i sistemi Unix vengono impiegati i sorgenti di PostgreSQL da compilare direttamente nel vostro sistema. Questa è una scelta che consigliamo in quanto consente di ottenere delle prestazioni migliori. Se avete scaricato la distribuzione completa dell installazione di Diski ( diski_inst_max.exe ) potete trovare il pacchetto di installazione dell ultima versione testata con Diski di PostgreSQL nella cartella <INSTDIR>\install del front-end. Solitamente ha un nome simile a postgresql-x.x.x.tar.gz dove le X identificano la versione. In alternativa potete scaricare i sorgenti di PostgreSQL dal seguente link: Consigliamo comunque di utilizzare l ultima versione testata con Diski che potrebbe non necessariamente corrispondere con l ultima versione di PostgreSQL disponibile. Molte distribuzioni Linux prevedono l installazione di PostgreSQL, prestate attenzione al fatto che sia una versione che sia supportata dalla versione di Diski che intendete utilizzare. Potete rifarvi al documento INSTALL contenuto nel file postgresql-x.x.x.tar.gz con tutte le istruzioni dettagliate per generare il codice binario eseguibile per il vostro sistema. Nel nostro laboratorio abbiamo compilato varie versioni di PostgreSQL 8.2.X e 8.3.X su NetBSD, Linux, AIX, MacOS e Solaris senza particolari difficoltà. Molti siti di software free/open mettono a disposizione PostgreSQL già compilato e pronto per l installazione, ad esempio per Solaris. Solitamente non ci sono problemi e questo evita il tempo della compilazione che in sistemi datati diventa molto lungo. Tutti i parametri di compilazione supportati dallo script configure di PostgreSQL sono supportati da Diski. Se avete installato PostgreSQL su un sistema Unix, intendete sicuramente installare il front-end di Diski su un altra stazione Windows (o in una macchina virtuale), quindi dovete necessariamente mettere mano al file di configurazione pg_hba.conf che contiene l elenco degli host e delle reti a cui è concesso l accesso. Questo file si trova nella directory data, il path completo solitamente è: /usr/local/pgsql/data. Riferitevi alla documentazione di PostgreSQL o successivamente in questo documento. Vi consigliamo di aggiungere nel path di sistema, o per lo meno nel path dell utente postgres, il percorso con i binari di PostgreSQL. Leggete con attenzione il capitolo [back-end] Ottimizzazione di PostgreSQL prima di proseguire con le operazioni. 24

25 [back-end] Installazione di Diski su Windows e Unix. A questo punto si deve procedere con la creazione del back-end che è composto da due ruoli utente (il proprietario dell archivio dati e l utente predefinito che sono rispettivamente diski e utente ), da un ruolo di gruppo (il gruppo diski_grp ), da due database (uno è l archivio modello ed il secondo l archivio predefinito che sono rispettivamente diski_tmplt e diski ) e da tutti gli oggetti di cui è composta la versione all interno dello schema di database diski_sh. Ogni nuovo vostro archivio verrà creato partendo dall archivio modello. Avvenuta la creazione del back-end potrete passare alla lettura della documentazione utente per immergevi nelle funzionalità di Diski. L installazione del back-end è cumulativa, questo significa che ogni nuova installazione contiene già tutti gli aggiornamenti apportati fino alla versione corrente. Per eseguire la procedura oggetto di questo capitolo dovrete conoscere la password dell utente postgres che, se avete seguito le istruzioni date in precedenza in questo documento, è semplicemente postgres. Se il vostro back-end è installato su un sistema Windows, dal menu Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Riga comando digitate pginst.bat Seguite le istruzioni fornite ad ogni passo. 25

26 Per l installazione nei sistemi Unix (Solaris, HP-UX, Linux, FreeBSD, OpenBSD, NetBSD, MacOS X, ecc.) e per maggiori dettagli potete riferivi al file leggimi.txt dentro la cartella <INSTDIR>\install, in breve: copiare nel sistema Unix l'intera cartella install e assicurarsi che l'utente postgres abbia diritti di lettura su tutti i file contenuti nella cartella. Accedere al sistema come utente postgres, entrare nel percorso in cui avete copiato gli script e digitate il comando: psql -U postgres -f owner.sql Se vi viene chiesta la password ricordate di fornire quella dell'utente postgres. Terminato eseguite questo: psql -d postgres -U diski -f dbusr.sql Se vi viene chiesta la password ricordate di fornire quella dell'utente diski che è semplicemente "diski". Anche se la procedura di installazione ha un meccanismo di protezione, per nessuna ragione eseguite gli script di installazione in un sistema in cui è già installata una versione del back-end di Diski. Per passare ad una versione del back-end di Diski ad una successiva si deve seguire la procedura di aggiornamento descritta in un capitolo successivo. 26

27 [front-end] Aggiornamento di Diski su Windows Installazione D i s k i L aggiornamento del front-end è molto semplice, è sufficiente rimuovere la versione precedente dal pannello di controllo di Windows ed eseguire l installazione della nuova versione su ogni stazione utente. Riferitevi al capitolo "[front-end] Installazione di Diski su Windows" per i dettagli della procedura. Se avete apportato delle personalizzazioni al front-end queste verranno irrimediabilmente perse se non avrete provveduto a salvarle prima delle rimozione. Se volte avere le vostre personalizzazioni anche nella nuova versione dovrete procedere ad un backup e ad una applicazione sulla nuova versione. E necessario che verifichiate con attenzione se le vostre modifiche non entrino in conflitto con le modifiche della nuova versione. L aggiornamento del front-end è cumulativo, quindi ogni nuova versione contiene già tutte le correzioni delle versioni precedenti. Questa cosa non è valida per il back-end come vedremo in seguito. Se con la versione precedente di Diski avevate installato un versione ora obsoleta dei driver ODBC, potete procedere all aggiornamento dei driver ODBC eseguendo la procedura upgradeodbc.bat che trovate nella <INSTDIR>\install e seguendo le indicazioni. Anche per l aggiornamento, se richiesto, dovrete procedere all installazione del Windows Installer da Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Cartella installazione -> InstMsiA.exe per Windows 98SE o ME oppure WindowsInstaller-KB v2- x86.exe per Windows 2000SP3. Rimuovere la versione precedente e procedere con una nuova installazione dei driver ODBC è comunque supportato. Ricordate che dopo aver eseguito l aggiornamento ad una nuova versione, il front-end avrà le impostazioni predefinite, quindi dovrete eseguire la procedura di connessione, consultate la documentazione utente per i dettagli. 27

28 [back-end] Aggiornamento di PostgreSQL La procedura che consigliamo consiste nel eseguire un dump completo (dump_all, riferitevi alla documentazione di PostgreSQL o alla sezione FAQ del sito di Diski per maggiori chiarimenti), rimozione o disinstallazione della precedente versione di PostgreSQL, installazione della nuova versione di PostgreSQL e ripristino del dump eseguito in precedenza. Vi consigliamo anche di salvare i file di configurazione della vostra installazione di PostgreSQL per un confronto con quelli delle nuova versione. I file importanti per la versione 8.X.X sono: pg_hba.conf e postgresql.conf. Questi file li trovate, per esempio, nel path C:\Program Files\PostgreSQL\8.3\data per i sistemi Windows e nel path /usr/local/pgsql/data per i sistemi Unix. In alternativa, e solo per aggiornamenti minori (ad esempio per passare dalla alla 8.2.4, ma non certo per passare dalla 8.2.X alla 8.3.X che è da considerare un aggiornamento maggiore) potete procedere ad eseguire direttamente l installazione della nuova versione nel path in cui era installata la versione precedente. Riferitevi alle indicazioni precedenti per i dettagli sulla procedura di installazione. 28

29 [back-end] Aggiornamento di Diski Una volta installata la nuova versione del front-end avrete a disposizione lo script per procedere all aggiornamento del back-end di Diski. Diversamente dal front-end l aggiornamento del back-end non è cumulativo, è quindi necessario procedere ad eseguire gli script di ogni versione intermedia. Ad esempio, se volete aggiornare la versione 2007.a alla versione 2007.d e tra le due versione ne sono state rilasciate altre due (2007.b e 2007.c) dovrete procedere ad applicare con ordine lo script che aggiorna la versione 2007.a alla versione 2007.b, quindi quello per aggiornare la versione 2007.b alla 2007.c e quindi quello per aggiornare la versione 2007.c alla 2007.d. Verificate con attenzione di applicare ogni versione intermedia, la procedura non effettua controlli e non iniziate l attività, per nessun motivo, senza aver prima eseguito un backup degli archivi. Consultate la guida di PostgreSQL o la sezione delle FAQ del sito di Diski per avere informazioni su come realizzare un backup consistente. Inoltre durante la procedura di aggiornamento è necessario che nessun utente sia connesso ed è indispensabile conoscere la password attuale dell utente diski. Solitamente gli utenti di Diski aggiornano il proprio sistema ad ogni nuova versione rilasciata per beneficiare delle correzioni, dei miglioramenti e delle nuove funzionalità che ogni nuova versione mette a disposizione. Solo chi ha applicato personalizzazioni deve valutare con attenzione l aggiornamento del proprio back-end in quanto le modifiche apportate in autonomia possono entrare in conflitto con i nuovi sviluppi di Diski. Nel caso di dubbi siamo a disposizione per valutare l impatto delle vostre personalizzazioni sulla nuova versione di Diski. I passi dettagliati per eseguire l aggiornamento li trovate nel file leggimi.txt dentro la cartella <INSTDIR>\install. E possibile che ogni versione richieda passi specifici come l esecuzione di un front-end specifico per l aggiornamento o uno script aggiuntivo. Il file leggimi.txt ha come presupposto che il sistema da aggiornare sia alla versione immediatamente precedente a quella del front-end installato. Anche se la procedura ha un meccanismo di protezione, per nessuna ragione eseguite la procedura di aggiornamento sulla stessa versione, potreste generare inconsistenza negli archivi. Per i back-end installati su sistemi Windows basta eseguire la procedura pgupg.bat e seguire le istruzioni. Questa procedura provvede ad aggiornare l archivio modello e l archivio predefinito, terminata vi verranno date istruzioni su come aggiornare ogni vostro archivio. Sarà sufficiente apri una sessione di riga comandi da Start -> Programmi -> Diski 200X.Y -> Strumenti installazione -> Riga comando ed eseguire: arcupg.bat <NOMEARCHIVIO> Dove <NOMEARCHIVIO> è il nome di uno dei vostri archivi che potete aggiornare, gli archivi che potete aggiornare sono elencati al termine dell esecuzione della procedura pgupg.bat. Per sicurezza, arcupg.bat, prima di procedere vi riporta la versione attuale dell archivio, prestate attenzione che sia la versione precedete a quella attuale. Per nessuna ragione proseguite la procedura se si tratta di una versione uguale, successiva o inferiore alla precedente. 29

30 Aggiornamento dell archivio con nome demo alla versione 2008.b Viene rilevato che l archivio demo è a versione 2008.a ed è quindi possibile procedere all aggiornamento. Per l aggiornamento sui sistemi Unix (Solaris, HP-UX, Linux, FreeBSD, OpenBSD, NetBSD, MacOS X, ecc.) e per maggiori dettagli potete riferivi al file leggimi.txt dentro la cartella <INSTDIR>\install, in breve: copiare nel sistema Unix l'intera cartella install e assicurarsi che l'utente postgres abbia diritti di lettura su tutti i file contenuti nella cartella. Accedere al sistema come utente postgres, entrare nel percorso in cui avete copiato gli script e digitate il comando: psql -d diski_tmplt -U diski -f upg.sql e successivamente: psql -U diski -f upg.sql Se vi viene chiesta la password ricordate di fornire quella dell'utente postgres. 30

31 Terminati dovete aggiornare ogni archivio che avete creato, ad esempio se uno dei vostri archivi ha nome "test" dovete eseguire il comando: psql -d test -U diski -f upg.sql Eseguitolo per ogni archivio che intendete aggiornare. 31

32 Installare più versioni di Diski in un singolo calcolatore BACK-END: la convivenza di archivi con differenti versioni di Diski è sempre stato consentito, l unica accortezza e suggerimento che teniamo a darvi è quello di tenere l archivio modello e l archivio predefinito alla versione più recente tra quelle che userete. Ci sono utenti che conservano sempre una copia dell archivio prima dell aggiornamento ad ogni versione, altri conservano l archivio alla versione date-version nello stesso back-end in cui ora eseguono l ultima versione di letter-version. Questo per storico, backup, studio, ecc. Con questa configurazione, in cui in un solo motore back-end ci sono più archivi di differenti versioni, i nuovi archivi che creerete saranno della versione del archivio modello. Potrete in ogni caso copiare un archivio in un altro indipendentemente dalla versione. Esiste la possibilità di eseguire più istanze del motore back-end sui sistemi Unix: PostgreSQL consente di personalizzare la porta TCP (porta back-end) in questo modo potrete eseguire più server PostgreSQL usando porte TCP differenti sullo stesso calcolatore. Con questa soluzione avrete un supporto completo per ciascuna versione che vi interessa in quanto potrete avere l archivio modello (e quello predefinito) per ogni versione. In pratica durante la compilazione di PostgreSQL allo script configure potete passare un path differente per ogni istanza che intendete eseguire. Altra alternativa è installare PostgreSQL in diverse macchine virtuali. Logicamente per accedere ad un archivio tramite il front-end di Diski dovrete usare un front-end della stessa versione del back-end. FRONT-END: a partire dalla versione 2007.e è stato introdotto il supporto completo alla versioni multiple. Potrete avere più installazioni di Diski di diverse versioni. Il kit di installazione crea nel menu programmi un gruppo con nome D i s k i <VER> e come <INSTDIR> C:\Programmi\Diski <VER>\. La <INSTDIR> è comunque modificabile nella fase di installazione. Nel caso eseguite più volte l installazione della stessa versione di Diski, anche specificando <INSTDIR> differenti, solo l ultima sarà associata al menu programmi di Windows. 32

33 [back-end] Ottimizzazione di PostgreSQL Solitamente le impostazioni predefinite di PostgreSQL consentono un buon funzionamento del sistema, nella versione 8.3 PostgreSQL è particolarmente ottimizzato per essere eseguito in contesti multiutenza (30 utenti indicativamente) in una calcolatore dedicato, situazione poco comune agli utenti di Diski per i quali la configurazione più comune è il singolo calcolatore monoutente usato anche per altre applicazioni o situazioni di multiutenza con non più di 5-6 front-end collegati. Le impostazioni di PostgreSQL pertinenti a Diski sono contenute in due file di configurazione: pg_hba.conf (autenticazione e connessione) e postgresql.conf (con le impostazioni dell istanza). Gli utenti di Windows possono raggiungere comodamente questi file da Start -> PostgreSQL 8.X -> Configuration file Gli utenti Unix possono trovare questi file nella $PGDATA, che solitamente trovate nel percorso /usr/local/pgsql/data. Nel file pg_hda.conf assicuratevi di avere questa riga, eventualmente modificatela: host all all /32 trust Questo significa che consentite l accesso all host locale un modalità trust, cioè senza la richiesta di password, comodo per eseguire gli script di installazione o aggiornamento. Se userete Diski in un contesto multiutente è necessario aggiungere un ulteriore riga: host all all /24 password Questo consente a tutti gli host della rete X/ di raggiungere il back-end tramite autenticazione con utente e password. Leggendo la documentazione di PostgreSQL potrete attivare ulteriori restrizioni: ad esempio consentire l accesso ad un solo archivio da un determinato host della vostra rete. Per evitare un eccessivo consumo di risorse e mantenere buone prestazioni controllate questi parametri con i relativi valori consigliati nel file postgresql.conf, queste indicazioni non sono da ritenersi assolute, sono delle indicazioni dettate dall esperienza, ogni installazione è una storia assestante con le proprie particolarità e necessità, queste indicazioni sono valide per un ambiente PostgreSQL dedicato esclusivamente a Diski in modalità monoutente o multiutente per 5 stazioni front-end. In condizioni differenti la parametrizzazione è da valutare attentamente. Ricordate che i valori testuali devono essere chiusi tra apici, ad esempio csvlog. 33

34 parametro valore note max_connections 10 Per più di 5 stazioni front-end potete impostare questo parametro uguale al numero delle stazioni front-end moltiplicato per 2. shared_buffers 1MB Minimo 1MB oppure max_connections moltiplicato per 16kB. temp_buffers 1MB 2MB per 10 stazioni front-end. max_prepared_transactions 0 work_mem 1MB Minimo 1MB oppure 1MB ogni 5 stazioni front-end. maintenance_work_mem 1MB Minimo 1MB oppure 1MB ogni 5 stazioni front-end. max_stack_depth 200kB Minimo 200kB oppure 200kB ogni 5 stazioni front-end. max_fsm_pages max_fsm_relations 100 max_files_per_process 50 checkpoint_segments 1 archive_mode on Se non intendete attivare il WAL e conservare lo storico delle transazione per effettuare un point-in-time-recovry, impostate a off questo parametro. archive_command cp "%p" /archivedir/"%f" Indicare un qualsiasi path, attenzione allo spazio libero. archive_timeout 0 log_destination csvlog Opportuno per l analisi dei problemi e per statistiche. logging_collector on log_directory /var/log Può essere un path assoluto o relativo alla $PGDATA. log_filename pg-%d-%m-%y_%h%m%s.log log_rotation_age 1d log_rotation_size 10MB log_min_duration_statement 0 autovacuum_max_workers 1 datestyle iso, dmy Per i dettagli su ogni singolo parametro riferitevi alla documentazione di PostgreSQL. 34

35 Barcode Sono supportati tutti i lettori barcode che funzionano in emulazione tastiera, siano AT, PS/2 o USB. Abbiamo ottenuto buoni risultati con i DATALOGIC della serie TOUCH, quelli provati erano PS/2 e USB. A partire dalla versione 2008.b il barcode è generato tramite un font true-type di Windows per avere maggiore flessibilità ed una resa perfetta in stampa su carta e lettura del barcode con i lettori. In Windows Vista abbiamo riscontrato una certa difficoltà ad installare i font da parte del programma di installazione, per ovviare alla cosa, basta copiare il file con "EAN-13HH.TTF" che trovate nella <INST_DIR>\install nella cartella dei font di Windows. Temiamo che questo comportamento si verifichi in Windows Al momento questa anomalia non è stata riscontata in altre versione di Windows. 35

36 Commenti finali Il gruppo di sviluppo di Diski è sempre a disposizione per chiarimenti compatibilmente con i proprio impegni. Diski è un applicazione gratuita e le persone che ci lavorano lo fanno solo per piacere personale e non ci ricavano alcun guadagno. Diffidate da chiede denaro per installarlo sul vostro computer, Diski è gratuito e nessuno è autorizzato trarne profitto da esso. Diski non è fornito di alcuna garanzia esplicita o implicita di funzionamento, inoltre il gruppo di sviluppo di Diski non è responsabile in alcun modo dell uso proprio o improprio del prodotto e di eventuali danni, compresa la perdita di dati, dell installazione di Diski sui propri computer. Il sito ufficiale di Diski, da dove potete scaricare l ultima versione, leggere notizie ed altre informazioni utili per l uso e la configurazione di Diski è: Per contattare direttamente il supporto di Diski, scrivete a: newtoolbox@yahoo.com Saranno ben accetti i vostri commenti e i suggerimenti di migliorie che vorrete farci pervenire. Diski in questi anni è stato principalmente realizzato con i contributi dei suoi utenti. 36