INSTALLAZIONE ProFORMA 3_5 EURO

INSTALLAZIONE ProFORMA 3_5 EURO Indice INDICE... 1 OPERAZIONI PRELIMINARI... 2 INSTALLAZIONE... 5 SERVER DEDICATO:... 5 INSTALLAZIONE MONOUTENZA (SERVER E CLIENT INSIEME):... 9 INSTALLAZIONE CLIENT:... 15 SPIEGAZIONE TECNICA FILE CONFIGURAZIONE PROFORMA... 22 FILE DI AVVIO... 22 FILE CONFIGURAZIONE SERVER... 24 INDICAZIONE PER LA SOSTITUZIONE DEL SERVER DI PROFORMA... 25 1

Operazioni preliminari A) Tutte le installazioni, cioè sia client che server DEVONO ESSERE EFFETTUATE COME UTENTE AMMINISTRATORE o del pc o del dominio (consigliato per non incorrere in problemi di rete). NON DEVONO ESSERE AFFETTUATE DA UTENTI NON AMMINISTATORI od utilizzando la funzione INSTALLA COME. Questo è dovuto al fatto che durante l installazione vengono lanciati diversi processi e anche un altro SETUP (installazione del DBE) da noi non controllato. B) Verificare che sul sistema operativo ospite del server di ProFORMA non ci sia già la presenza di Firebird. Nel caso sia presente l installazione verrà interrotta visualizzando la seguente immagine: contattare un tecnico di Ingenia Fig. 1 C) Se sul computer Server è installato un sistema Firewall allora si deve tener conto di aprire la porta logica : numero: 11050 nome: FDS_DB ambito: TCP come indicato nel file di sistema services. D) Nel caso sul computer client sia installato un software di controllo esecuzione programmi deve essere configurato in modo che tutti i programmi eseguiti dal RunTime di Paradox, i programmi di Firebind e tutti i programmi che hanno come cartella di partenza <disco di sistema>:\apps32 siano autorizzati sia a partire che a far partire altri programmi. 2

E) Nel caso sul computer client durante l installazione di ProFORMA, sezione BDE (Borland Databse Engine) compaia il messaggio riportato nella seguente finestra Fig. 2 allora dobbiamo fare le seguenti considerazioni e domande. Su questo pc era una vecchia versione di ProFORMA? Se si allora procedere tranquillamente rispondendo di SI nel caso contrario fermarsi e chiamare un tecnico di Ingenia. Informarsi nel frattempo anche quali sono i programmi che utilizzano il DBE per facilitare la comprensione del problema al tecnico incaricato da Ingenia per la sua risoluzione in fase di Installazione. F) Operazioni da effettuare manualmente se l utente utilizzatore del computer non ne è anche amministratore e siamo in un dominio: - Diritti su cartella temporanea di ProFORMA. Durante l installazione viene creata una cartella sul disco di sistema per l appoggio di tutti i file temporanei di ProFORMA e i suoi file di configurazione. A questa cartella, individuata come <disco sistema>:\apps32 dovranno essere dati i diritti controllo completo a tutti gli utenti o gruppi che devono lavorare con ProFORMA. Su tale cartella può essere dato tranquillamente il diritto controllo completo anche a everyone senza rischiare nulla. - Gestione Stampanti. Paradox ha delle forti limitazioni (come altri programmi che vogliono mantenere compatibilità con anche i più storici sistemi operativi) sulla gestioni delle stampe. Per evitare blocchi durante la fase di stampa o di selezione di stampanti diverse da quella di default dobbiamo evitare nomi di stampanti che superino i 24 caratteri e dare all utente everyone tutti i diritti sulla stampante. Per fare ciò selezioniamo una alla volta le stampanti dell utente e ne chiediamo le proprietà. Nella sezione Protezione selezione everyone e abilitare consenti stampa, consenti gestioni stampanti, consenti gestioni documenti. G) Se siamo in una situazione di rete in cui il computer Server dovrà condividere ProFORMA con dei client dobbiamo far creare una cartella nella posizione ritenuta più corretta da parte del sistemista del cliente denominata INGENIA oppure PROFORMA che dovrà essere condivisa. La cartella dovrà avere le seguenti caratteristiche: 3

- Protezione: i gruppi / utenti Amministratori,System, utenti che dovranno usare ProFORMA, Gruppo degli utenti che dovranno usare ProFORMA dovranno avere tutti il CONTROLLO COMPLETO. La mancanza di tale protezione può causare un non corretto funzionamento di ProFORMA. - Condivisione: i gruppi / utenti Amministratori, utenti che dovranno usare ProFORMA, Gruppo degli utenti che dovranno usare ProFORMA dovranno avere tutti il CONTROLLO COMPLETO. La mancanza di tale protezione può causare un non corretto funzionamento di ProFORMA. 4

INSTALLAZIONE Server Dedicato: Installazione tipicamente da fare su un computer con strutture da server presente in rete. Eseguire il setup di installazione di ProFORMA 3_5 in vostro possesso Premere Avanti per iniziare l installazione. Fig. 1 Fig. 2 Qui viene indicata la cartella del Motore SQL di FIREBIRD. Nel caso si decidesse di cambiarla si ricorda che la cartella dovrà essere obbligatoriamente creata sul disco di sistema (opzione fortemente sconsigliata). Premere Avanti per continuare l installazione. 5

Fig. 3 Da questa Finestra verrà effettuata la scelta della tipologia di Installazione di ProFORMA. L opzione da selezionare dall elenco per questa tipologia di installazione che stiamo descrivendo in questo paragrafo è : SERVER (vedi immagine seguente). Premere Avanti per continuare l installazione. Fig. 4 6 Fig. 5 Selezionare, se già creata, o indicare la cartella in cui dovrà essere installato applicativo ProFORMA (si ricorda che nel caso venga indicata una cartella non ancora esistente questa dovrà essere condivisa secondo i parametri sopra indicati).

Premere Avanti per continuare l installazione. Fig. 6 Premere Avanti per continuare l installazione. Fig. 7 Riepilogo dei componenti da installare. Premere Installa per ultimare la configurazione per l installazione. Fig. 8 Attendere la Fine della decompressione/installazione dei componenti. 7

Fig. 9 Il riavvio del sistema Operativo sul server è obbligatorio per permettere il caricamento delle nuove impostazioni per il corretto funzionamento di ProFORMA. 8

Installazione Monoutenza (Server e client insieme): Tale installazione può essere fatta anche in situazioni di reti ridotte dove non esiste un vero server e che quindi un computer acquisisca le funzioni di server di ProFORMA. Eseguire il setup di installazione di ProFORMA 3_5 in vostro possesso Premere Avanti per iniziare l installazione. Fig. 1 Fig. 2 Qui viene indicata la cartella del Motore SQL di FIREBIRD. Nel caso si decidesse di cambiarla si ricorda che la cartella dovrà essere obbligatoriamente creata sul disco di sistema (opzione fortemente sconsigliata). Premere Avanti per continuare l installazione. 9

Fig. 3 Da questa Finestra verrà effettuata la scelta della tipologia di Installazione di ProFORMA. L opzione da selezionare dall elenco per questa tipologia di installazione che stiamo descrivendo in questo paragrafo è : Monoutenza. Premere Avanti per continuare l installazione. Fig. 4 Selezionare, se già creata, o indicare la cartella in cui dovrà essere installato applicativo ProFORMA (si ricorda che nel caso venga indicata una cartella non ancora esistente questa dovrà essere condivisa secondo i parametri sopra indicati). Premere Avanti per continuare l installazione. Fig. 5 10

Premere Avanti per continuare l installazione. Fig. 6 Indicazioni installazione componenti RunTime di Paradox 10. Lasciare le spunte come già impostate. Premere Avanti per continuare l installazione. Fig. 7 Segnalazione che l istallazione sarà completata al prossimo riavvio del sistema da farsi obbligatoriamente come utente che ha iniziato l installazione (diritti di amministratore). Premere OK per continuare l installazione. 11 Fig. 8

Riepilogo dei componenti da installare. Premere Installa per ultimare la configurazione per l installazione. Fig. 9 Attendere la fine della decompressione/installazione dei componenti. Fig. 10 Primo passo per l installazione del DBE (Borland Database Engine) 12 Fig. 11

Premere Next per continuare l installazione. Fig. 12 Premere Next per continuare l installazione. Premere Finish per terminare l installazione del BDE. Fig. 13 Fig. 14 13

Selezionare dalla finestra ClientDir (può verificarsi che durante l installazione tale finestra rimanga inconizzata nella barra delle applicazioni Windows) la cartella in cui è stato installato ProFORMA e sfogliando le cartelle andare nella cartella apps32\pf_3_5\db e selezionare il file proforma_3_5.fdb. Attenzione l errore di selezione del file compromette il corretto funzionamento di ProFORMA e il salvataggio dei dati. Fig. 15 Il riavvio del sistema Operativo sul computer è obbligatorio per permettere il caricamento delle nuove impostazioni per il corretto funzionamento di ProFORMA e per ultimare l installazione di runtime di Paradox 10. Si ricorda di riavviare il sistema con il medesimo utente che ha iniziato l installazione (diritti di amministratore). Dopo il riavvio e atteso che si siano concluse le procedure di installazione del Runtime di Paradox 10 avviare ProFORMA 3_5 sempre come utente con diritti di amministratore. Il programma apporterà delle modifiche alla variabile di ambiente PATH e farà tutti i controlli dovuti. Operazioni da effettuare manualmente se l utente utilizzatore del computer non ne è anche amministratore e siamo in un dominio: - Diritti su cartella temporanea di ProFORMA. Durante l installazione viene creata una cartella sul disco di sistema per l appoggio di tutti i file temporanei di ProFORMA e i suoi file di configurazione. A questa cartella, individuata come <disco sistema>:\apps32 dovranno essere dati i diritti controllo completo a tutti gli utenti o gruppi che devono lavorare con ProFORMA. Su tale cartella può essere dato tranquillamente il diritto controllo completo anche a everyone senza rischiare nulla. - Gestione Stampanti. Paradox ha delle forti limitazioni (come altri programmi che vogliono mantenere compatibilità con anche i più storici sistemi operativi) sulla gestioni delle stampe. Per evitare blocchi durante la fase di stampa o di selezione di stampanti diverse da quella di default dobbiamo evitare di usare nomi di stampanti che superino i 24 caratteri e dare all utente everyone tutti i diritti sulla stampante. Per fare ciò selezioniamo una alla volta le stampanti dell utente e ne chiediamo le proprietà. Nella sezione Protezione selezione everyone e abilitare consenti stampa, consenti gestioni stampanti, consenti gestioni documenti. 14

Installazione Client: Tale installazione tipica dei client di ProFORMA. Eseguire il setup di installazione di ProFORMA 3_5 in vostro possesso Premere Avanti per iniziare l installazione. Fig. 1 Fig. 2 Qui viene indicata la cartella del Motore SQL di FIREBIRD. Nel caso si decidesse di cambiarla si ricorda che la cartella dovrà essere obbligatoriamente creata sul disco di sistema (opzione fortemente sconsigliata). Premere Avanti per continuare l installazione. 15

Fig. 3 Da questa Finestra verrà effettuata la scelta della tipologia di Installazione di ProFORMA. L opzione da selezionare dall elenco per questa tipologia di installazione che stiamo descrivendo in questo paragrafo è : Client. Premere Avanti per continuare l installazione. Fig. 4 Premere Avanti per continuare l installazione. Fig. 5 16

Fig. 6 Indicazioni installazione componenti RunTime di Paradox 10. Lasciare le spunte come già impostate. Premere Avanti per continuare l installazione. Fig. 7 Segnalazione che l installazione sarà completata al prossimo riavvio del sistema da farsi obbligatoriamente con il medesimo utente che ha iniziato l installazione (diritti di amministratore). Premere OK per continuare l installazione. 17 Fig. 8 Riepilogo dei componenti da installare. Premere Installa per ultimare la configurazione per l installazione.

Fig. 9 Primo passo per l installazione del DBE (Borland Database Engine) Premere Next per continuare l installazione. Fig.10 Premere Next per continuare l installazione. Fig. 11 18

Fig. 12 Premere Finish per terminare l installazione del BDE. Fig. 13 Selezionare dalla finestra ClientDir (può verificarsi che durante l installazione tale finestra rimanga inconizzata nella barra delle applicazioni Windows) nella parte sinistra l unità disco del server che contiene l installazione di ProFORMA. Nel caso non fosse già mappata la cartella condivisa dal server si può usare le proprietà fornite con il tasto RETE con segue. Fig. 14 19

Fig. 15 Selezionare la cartella nell unità disco corretta in cui è stato installato ProFORMA e sfogliando le cartelle andare nella cartella apps32\pf_3_5\db e selezionare il file proforma_3_5.fdb. Attenzione l errore di selezione del file compromette il corretto funzionamento di ProFORMA e il salvataggio dei dati. Fig. 13 Il riavvio del sistema Operativo sul client è obbligatorio per permettere il caricamento delle nuove impostazioni per il corretto funzionamento di ProFORMA e per ultimare l installazione di runtime di Paradox 10. Si ricorda di riavviare il sistema con il medesimo utente che ha iniziato l installazione (diritti di amministratore). Dopo il riavvio e atteso che si siano concluse le procedure di installazione di Runtime di Paradox 10 avviare ProFORMA 3_5 sempre come utente con diritti di amministratore. Il programma apporterà delle modifiche alla variabile di ambiente PATH e farà tutti i controlli dovuti. Operazioni da effettuare manualmente se l utente utilizzatore del computer non ne è anche amministratore e siamo in un dominio: - Diritti su cartella temporanea di ProFORMA. Durante l installazione viene creata una cartella sul disco di sistema per l appoggio di tutti i file temporanei di ProFORMA e i suoi file di configurazione. A questa cartella, individuata come <disco sistema>:\apps32 dovranno essere dati i diritti controllo completo a tutti gli utenti o gruppi che devono lavorare con ProFORMA. Su tale cartella può essere dato 20

tranquillamente il diritto controllo completo anche a everyone senza rischiare nulla. - Gestione Stampanti. Paradox ha delle forti limitazioni (come altri programmi che vogliono mantenere compatibilità con anche i più storici sistemi operativi) sulla gestioni delle stampe. Per evitare blocchi durante la fase di stampa o di selezione di stampanti diverse da quella di default dobbiamo evitare nomi di stampanti che superino i 24 caratteri e dare all utente everyone tutti i diritti sulla stampante. Per fare ciò selezioniamo una alla volta le stampanti dell utente e ne chiediamo le proprietà. Nella sezione Protezione selezione everyone e abilitare consenti stampa, consenti gestioni stampanti, consenti gestioni documenti. 21

Spiegazione tecnica File configurazione ProFORMA File di Avvio Il programma ProFORMA in avvio sfrutta un programma sviluppato in Delphi (StartClient.exe) che controlla la partenza del vero e proprio programma ProFORMA che è sviluppato in Paradox 10. Questo programma come si vede dal link dell icona di partenza di ProFORMA 3_5 è installato in locale su ogni computer nella cartella <disco di sistema>:\apps32\pf_3_5\lap ma si auto aggiorna rispetto a un file corrispondente sul server qualora quest ultimo fosse coinvolto in un aggiornamento gestito da Ingenia. Questo applicativo si appoggia ad un file di configurazione che ne consente il perfetto funzionamento. Questo file di configurazione è nella stessa cartella dell eseguibile e si chiama Start.ini. Vediamo punto per punto il suo significato: *************** spiegazione file di configurazione ProFORMA 3.5 *************** [CONFIG] PERCCFGSERVER=percorso del file FBIorig.xml senza la lettera del disco. esempio: \apps32\pf_3_5\tools\bde\fbiorig.xml PERCCFGCLIENT=percorso e nome del file *.CFG che deve essere creato per il corretto funzionamento di Proforma. esempio: C:\APPS32\PF_3_5\FBICL.CFG -esempio per TS: C:\APPS32\PF_3_5\FBICL_[USERNAME].CFG APPDIR= percorso della radice di tutte le cartelle di ProFORMA senza la lettera del disco. esempio : \apps32\pf_3_5 PATHCOM=cartella da attribuire all'alias PF3COM. esempio : com PATHLAST=cartella da attribuire all'alias PF3LAST. esempio :last PATHLCLDB=cartella da attribuire all'alias PF3LCLDB. esempio :lcldb SERVERPATH=il nome del file che contiene le specifiche del database. Esempio : serverpath.txt NOMEDB=percorso e nome del file del database. Esempio :db\proforma_3_5.fdb NETDIR=lasciare vuota PRIVDIR=percorso della cartella privata di ProFORMA su cui tutti gli utenti devono avere controllo completo. Esempio: C:\apps32\pf_3_5\lcl - esempio per TS: C:\apps32\pf_3_5\lcl_[USERNAME] WORKDIR=cartella contenente tutti i file principali di ProFORMA.esempio :APP SHAREDFOLDSERVER=percorso di rete della condivisione del disco del server. esempio : \\server01\ingenia - lasciare vuoto se è una monoutenza o è sia server che client 22

SHAREDDRIVESERVER=lettere di connessione di rete o lettere del disco locale. esempio : H oppure C PERCDLLSERVER=percorso sul server della dll di avvio di ProFORMA senza la lettera del disco. Esempio : apps32\storedlls\initpf.dll PERCDLLCLIENT=percorso sul client della dll di avvio di ProFORMA C:\apps32\dlls\initPF.dll APPSCRIPT=nome dello script da eseguire per l esecuzione di ProFORMA. Esempio : PF.SDL TIPOMOTORE=tipo di motore di Paradox da eseguire per la partenza di ProFORMA. Esempio : RUNTIME PORTAIP=nome o numero della porta ip di connessione tra client e server Firebird. Esempio : fds_db STDEB=stato di debug del lancio di ProFORMA. Esempio: S -> Per il debug totale cioe ogni operazione viene descritta con dei messaggi. I -> Visualizza solo i parametri di lancio ProFORMA per Paradox. C -> Crea l'icona di lancio di ProFORMA nella Cartella privata. N -> Nessun Debug EXEAGGCLIENT= si può indicare un percorso di un eseguibile che deve essere lanciato prima di ProFORMA. Esempio C:\WINDOWS\SYSTEM32\calc.exe ALIASAGGCLIENT= nome di alias separati da virgola configurati in modo corretto nel cfg di default da caricare nel cfg di riferimento per ProFORMA [COPIADLL] CLIENT=Percorso della cartella sul cliente DLLS, questa cartella verrà registrata nel path del pc client.(nasce dalla scomposizione del parametro PERCDLLCLIENT) Esempio C:\apps32\dlls SERVER=percorso sul server della cartella Storedlls di ProFORMA senza la lettera del disco. Cartella da cui copiare tutte le dll di ProFORMA.(Nasce dalla scomposizione del parametro PERCDLLSERVER) Esempio :sviluppo\apps32\storedlls TYPEF=Tipo di file da copiare dalla cartella StroreDLLS del server. Esempio *.dll ********************************************************************* Tali spiegazioni sono anche riportate nel file start_help.ini della cartella sul server di proforma:\apps32\pf_3_5\lap 23

File Configurazione Server Il file di configurazione per il collegamento al motore Firebird installato sul server nella cartella di ProFORMA. Nel dettaglio in \apps32\pf_3_5\ e si chiama serverpath.txt. In questo file viene memorizzato durante l installazione del server il nome e il percorso della cartella di riferimento di ProFORMA. Questo percorso sarà utilizzato da tutti i client per la connessione tra client-firebird e Server- Firebird ed è e deve essere un percorso assoluto visto dal server. Esempio: SERVER02:D:\applicazioni\apps32\PF_3_5 24

Indicazione per la sostituzione del Server di Proforma Per la sostituzione del server si consigliano i seguenti passi: a) Installare sul nuovo server il pacchetto server del programma ProFORMA 3_5 senza prestare attenzione alla versione in possesso al cliente ed installata sul vecchio server. b) Una volta terminata l installazione server e controllato che tutte le configurazioni siano completate e corrette rinominare la cartella apps32, cartella creata durante l installazione (cartella figlia della cartella da condividere), in apps32inst. c) Copiare tutta la cartella apps32 e le sue sottocartelle dal vecchio server e inserirla nella stessa posizione della cartella apps32inst. d) Recuperate dalla cartella apps32inst\pf_3_5\ il file serverpath.txt e copiatelo nella cartella corretta apps32\pf_3_5\ sostituendo il file di configurazione del vecchio server. e) Se i client della rete hanno un script di configurazione per la mappatura delle unità di rete cambiando alla lettera collegata alla cartella di ProFORMA del vecchio server con la cartella del nuovo server appena l utente fa partire il programma ProFORMA 3_5 questo si accorge della differenza di mappatura per la lettera di riferimento e chiede all utente della veridicità del dato. Se l utente conferma il programma stesso resetta tutti i parametri in modo che il programma, se esistono le cartelle e i file giusti, possa ripartire senza obbligare nessun tipo di configurazione. f) Nel caso non esista lo script per la mappatura delle unità di rete si deve intervenire su ogni client cambiando la mappatura dell unità di riferimento di ProFORMA in modo che si abbiano le stesse condizioni del punto e). g) Se tutto funziona si consiglia la cancellazione della cartella apps32inst che ci è servita solo per il file di configurazione e per riserva in caso di non funzionamento. h) Si consiglia di o rimuovere dalla rete il vecchio server oppure di rinominare la cartella apps32 del vecchio server in apps32old e fermare i servizi di Firebird (il guardiano e il server) evitando che questi ripartano al riavvio del sistema. Si fa notare che la sola eliminazione della condivisione non è sufficiente in quanto il client di Firebird non usa la condivisione per arrivare ai dati ma usa la porta logica fds_db (11050) che il server apre in ascolto tramite i servizi di Firebird. 25