Gestionale Open

Per installare Gestionale Open (GO) vanno eseguite le seguenti operazioni: scaricare il file installa_xxxx.zip (xxxx=versione) dalla sezione download del sito scompattare il file in una cartella su disco (meglio non utilizzare il desktop) eseguire il programma istallazione.exe. Deve essere presente, sul computer su cui si esegue l'installazione, il driver C:

L'ambiente di Gestionale Open consiste di tre moduli logici:

Server Database
E' il computer in cui viene installato il database ed in cui risiedono gli archivi. Pu essere un computer con sistema operativo Windows, Linux o Mac. Per l'installazione del database fare riferimento alla sua documentazione specifica.

Server Programmi
E' il computer in cui vengono installati i programmi di GO. Pu essere un computer con sistema operativo Windows, Linux o Mac. Se il sistema operativo Linux o Mac dovr essere installato Wine (applicativo che implementa una logica di compatibilit per le applicazioni Windows, fornendo il collegamento alle API necessarie per il loro funzionamento) o un software di emulazione di Windows; le condivisioni e i permessi andranno gestiti tramite Samba o un gestore di condivisioni per Windows. Questo computer sar quello in cui effettuare gli aggiornamenti di GO.

PC Client
E' il computer da cui viene eseguito GO. Pu un computer con sistema operativo Windows, Linux o Mac. Se il sistema operativo Linux o Mac l'esecuzione andr gestita tramite Wine oppure con un virtualizzatore che abbia installato Windows.

Le interazioni tra i tre moduli sono le seguenti:

Server Database<-->Server Programmi<-->PC Client

I tre moduli possono essere installati, fisicamente, tutti sullo stesso computer (modalit obbligatoria per la versione embedded), ognuno su computer diversi oppure raggruppando sullo stesso computer i seguenti moduli: Server Database e Server Programmi Server Programmi e PC Client. Non ha senso avere sullo stesso computer Server Database e PC Client (anche se in teoria possibile) perch il PC Client deve colloquiare direttamente con il Server Programmi e non con il Server Database.

Server Database
Il database utilizzato da GO MySQL, utilizzabile in due diverse modalit: embedded per le installazioni monoutente

client/server per le installazioni multiutente

I dati possono essere gestiti con pi motori mysql (engine) di archiviazione. I due principali sono MyISAM e INNODB.

MyISAM il motore utilizzato dal database di sistema di MySQL (cartella mysql, posizionata nella locazione specificata dalla variabile datadir) e dai database di sistema e di ordinamento di GO (arc e arc_ordinamento) e non gestisce transazioni e foreign keys. INNODB, motore standard di MySQL, quello che garantisce le funzionalit enterprise dei principali database presenti sul mercato (SQL Server, PostgreSQL, Oracle). Entrambi i motori gestiscono le definizioni del database in tabelle memorizzate nella cartella del database con le seguenti estensioni: frm (struttura della tabella) trg trn (trigger) Le stored procedure sono memorizzate nel database di sistema mysql. Se si spostano gli archivi su un computer diverso le stored procedure vanno ricreate nel nuovo database di sistema con il programma STORED di GO. Gli archivi MYISAM sono memorizzati nella cartella del database con le seguenti estensioni: myd (dati) myi (indici) Gli archivi INNODB sono memorizzzati in uno o pi tablespace (nome standard ibdata1) presenti nella cartella del database di sistema. La versione embedded utilizza il motore MyISAM. La versione client/server utilizza, per i database delle ditte di GO, il motore INNODB. Per modificarlo, utilizzando MyISAM, necessario assegnare il valore MYISAM alla variabile di sistema default_storage_engine intervenendo sul file di configurazione my.ini (my.cnf per linux).

Versione embedded
L'utilizzo della versione embedded non richiede attenzioni particolari. E' sufficiente selezionare il tipo embedded in fase di installazione di GO ed iniziare ad utilizzare il programma. I database contenenti gli archivi sono creati nella cartella archivi e non possono essere spostati in altra locazione. In questa modalit non sempre possibile utilizzare i programmi di amministrazione e quindi le operazioni necessarie alla manutenzione del database (qualora fossero necessarie) vanno eseguite su un computer che abbia installato la versione client/server dopo aver copiato fisicamente le cartelle dei database: arc, arc_XXXX (codice ditta), arc_ordinamento. E' disponibile il programma GO_DB_MANAGER.EXE che consente di effettuare la navigazione diretta sulle tabelle dei database, senza poter per eseguire le operazioni di manutenzione (ottimizzazione, riparazione, ecc.). Volendo mantenere aggiornata la versione di MySQL Embedded, scaricandola dal sito di MySQL, vanno rimpiazzati il file libmysqld.dll nella cartella exe, la cartella mysql (contenente il database di sistema) e la cartella share nella cartella exe. Va quindi eseguito il programma STORED per ogni ditta gestita per ricreare le stored procedure nel nuovo database di sistema mysql.

Versione client/server
Richiede l'installazione di MySQL server utilizzando l'utente e la password desiderati (i default sono root e masterkey). Se si scelgono valori diversi vanno specificati nel file di configurazione go.cfg nella cartella exe. Installare GO selezionando il tipo Server.

Se la versione di MySQL installata diversa dalla 5.5.xx (versione minima utilizzabile con GO) sostituire la dll client (libmysql.dll), presente nell'installazione di MySQL nella cartella bin, a quella presente nella cartella exe di GO. Se il database di sistema mysql stato spostato nella cartella archivi di GO (vedi di seguito) sostituirlo con quello della nuova versione installata nella cartella data di MySQL ed eseguire il programma STORED per ogni ditta utilizzata per aggiornare le stored procedure. Eseguire il programma di aggiornamento dei database:

mysql_upgrade.exe u root p masterkey --force

I database contenenti gli archivi di GO vengono installati nella cartella archivi con i nomi: arc, arc_ordinamento, arc_demo, arc_demo_storico. Sono tutti gestiti con il motore MyISAM e non va modificato. I database delle nuove ditte operative verranno creati in base al valore della variabile default_storage_engine presente nel file di configurazione di MySQL. I database di GO che vengono caricati nella cartella archivi non sono visibili al servizio di MySQL e, per poterli utilizzare, va eseguita una delle due seguenti operazioni, arrestando il servizio di MySQL: 1) copiare i database di GO nella stessa cartella in cui installato il database di sistema di MySQL (mysql), cartella visualizzata nelle variabili di sistema alla voce datadir. 2) copiare il datase di sistema di MySQL nella cartella in cui sono installati i database di GO e modificare la voce datadir del file di configurazione (my.ini o my.cnf). Questa soluzione praticabile solo se MySQL non viene utilizzato da altre procedure. I database delle nuove ditte verranno creati come cartelle (se motore MyISAM) nella locazione dove presente il database di sistema, come cartelle e come tablespace (ibdata1) se il motore INNODB. Prestare attenzione che per il backup fisico degli archivi va indicato il percorso corretto. Successivamenti verificare, con il programma di amministrazione del database, che l'utente root dei server localhost e % abbia tutti i permessi di gestione. Il modo pi sicuro per effettuare il controllo aprire la tabella user del database di sistema mysql e controllare che le colonne xxxxx_priv siano settate a Y. Per le installazioni in cui il database posizionato su una macchina Linux va modificato il file di configurazione my.conf, nella sezione [mysqld], la riga sequente: lower_case_table_names (o lower_case_table_names = 1) verificare comunque la documentazione MySQL per il sistema operativo utilizzato.

Server Programmi
Ricordiamo che GO un programma sviluppato nativamente per Windows e quindi non funziona come programma Linux o Mac. Su questi sistemi operativi possibile eseguirlo utilizzando vari tipi di emulatori di Windows (es. Wine). Le cartelle comuni presenti sul Server Programmi devono essere mappate ai PC Client come fossero cartelle Windows e quindi sul Sever Programmi va installato un software che lo consenta (es. Samba per Linux). Se il tipo di installazione Embedded il database ed i programmi sono un'entit inseparabile, gestita sulla stessa cartella di un unico computer. Se il tipo di installazione Client/Server possibile installare GO anche su un server diverso da quello su cui presente il database. I due server saranno in comunicazione via FTP tramite l'IP del Server Database (localhost o 127.0.0.1 se i due server sono sullo stesso computer) indicato nel file go.cfg.

PC Client
GO vioene eseguito aprendo il file go.exe presente nella cartella exe. Sui PC Client possibile eseguire GO semplicemente con un link al programma installato sul Server Programmi [exe\go.exe] condividendo la cartella di installazione di GO. In questo caso non serve installare il Client di GO e le modifiche indicate di seguito per la configurazione si riferiscono al file go.cfg presente sul Server Programmi. Se il Server Programmi una macchina Linux la cartella exe contenente il programma go.exe deve essere mappata ai Client utilizzando Samba. Volendo utilizzare le funzionalit complete della modalit Client/Server bisogna installare il Client di GO su tutti i PC Client collegati in rete. L'installazione del client va eseguita solo la prima volta. Gli aggiornamenti successivi vanno eseguiti solo sul Server. Il programma sui PC Client aggiorner automaticamente l'installazione sui pc in rete quando trover sul Server Programmi una versione diversa rispetto a quella presente sul PC Client. Le voci principali da assegnare nel file di configurazione del PC Client [go.cfg] presente nella cartella [exe] del Server o nella cartella di installazione del Client sono le seguenti: server = server_porta = utente_database = password_database = IP del server (es. 192.168.1.10) numero porta di accesso se diversa da quella standard del database. Verificare che la porta sia aperta se attivato il firewall utente di sistema assegnato al database se diverso dallo standard (root) password di sistema generata durante l''installazione del database se diversa dallo standard (masterkey). La password pu essere crittografata per evitare che sia visibile a terzi.

I due parametri seguenti vanno indicati solamente sui client se attivato il modulo GO-CLIENT cartella_exe = file_exe = pathname della cartella exe del server da cui il client copia i file per aggiornare automaticamente la versione sul client (es: \\server\go\exe) lista dei file da copiare dal server al client separati dal carattere [;] (punto e virgola). Se il valore non indicato vengono copiati tutti file della cartella exe. I valori minimi sono le librerie di advantage ace32.dll, adsloc32.dll e adslocal.cfg e la libreria client del database. Consigliamo di includere anche il programma di teleassistenza eseguibile dal menu principale di lavoro.

Esempio dei file da tenere aggiornati sul Client: file_exe = ace32.dll;adsloc32.dll;adslocal.cfg;libmysql.dll;ntrsupport.exe Tre cartelle installate sul Server Programmi (bmp, report, documenti_DITTA) contengono file comuni a tutti i Client e quindi vanno condivise e la loro locazione va indicata nel file go.cfg. cartella_bitmap = cartella_report = cartella_documenti = cartella in cui sono presenti le immagini comuni utilizzate da GO (es. c:\go\bmp). cartella in cui sono presenti le cartelle contenenti i layout utilizzati dalle stampe (report e report_DITTA). (es. c:\go). cartella in cui sono presenti le cartelle contenenti i documenti delle varie ditte gestite con GO.

(es. c:\go). Volendo eseguire GO in remoto, via internet, la modalit migliore quella di utilizzare RDP (Remote Desktop Protocol) installando sul Server Programmi le funzionalit di Terminal Server di Microsoft oppure software alternativi (consigliamo XPUnlimited).

Verificare che la porta di connessione utilizzata dai computer su cui sono installati i tre moduli non sia bloccata da Firewall.

Il primo accesso a GO pu avvenire con il codice utente GO e la password GO. Si consiglia di modificare subito la password dell'utente GO per garanzia di sicurezza.