Manuale Packing List

Gamma UpdaterINDICE

1Gamma Updater: note di installazione e utilizzo

1Introduzione

1Gamma Updater Installazione

1Contenuto del pacchetto

1Prerequisiti

1Installazione

4Gamma Updater Configurazione

4Configurazione collegamenti

4Configurazione percorsi

5Configurazione aggiornamento differito

6Gamma Updater Utilizzo

8Auto-Aggiornamento GammaUpdater

10Configurazione Server

10Account servizio GammaUpdater

11Assegnare un account amministrativo al servizio

12Logica di aggiornamento

12Logica di aggiornamento

Gamma Updater: note di installazione e utilizzoIntroduzione

Gamma Updater una nuova soluzione per laggiornamento dei client del proprio gestionale Gamma Enterprise\Sprint.

Gamma Updater consente a qualunque operatore, di aggiornare o installare il proprio gestionale senza dover necessariamente ricorrere ai privilegi amministrativi, che in alcuni scenari potrebbero non essere disponibili. Gli aggiornamenti dovranno essere applicati sullinstallazione server centralizzata.

Le installazioni client, allavvio del gestionale, rilevano automaticamente le modifiche applicate allinstallazione, notificando alloperatore la necessit di procedere allaggiornamento.

Loperazione sar eseguita dal servizio Teamsystem GammaUpdater, installato una tantum con privilegi amministrativi completi lato server e lato client.

Questa nuova archiettura permette di superare le limitazioni eventualmente imposte allutente applicativo correntemente loggato in ambiente Windows.Gamma Updater Installazione Contenuto del pacchetto

Il pacchetto dinstallazione allinterno contiene i seguenti file:

DotnetfxCartella contenente .net framework. Setup.msiFile microsoft installer utilizzato dal setup. Setup.exeFile per lesecuzione del processo dinstallazione.Prerequisiti

Linstallazione del servizio richiede i seguenti prerequisiti .Net framework 2.0 direttamente installabile dal pacchetto dinstallazione di Gamma Updater.

Privilegi amministrativi, necessario che lutente sia amministratore della macchina per installare Gamma Updater.

IMPORTANTE

Se linstallazione del prerequisito .net framework non dovesse andare a buon fine, utilizzare gli strumenti di aggiornamento nativi del sistema operativo. Tutta la documentazione a riguardo per linstallazione manuale del pacchetto .net framework 2.0 disponibile all indirizzo

http://www.microsoft.com/downloads/details.aspx?displaylang=it&FamilyID=0856eacb-4362-4b0d-8edd-aab15c5e04f5

Installazione

Per procedere allinstallazione necessario avere privilegi amministrativi.

1. Posizionarsi nella cartella dinstallazione

2. Eseguire il file setup.exe

3. Lapplicazione richiede linstallazione del .net framework 2.0. Gli utenti che hanno precedentemente installato .net framework 2.0 salteranno direttamente al passo 3. Per gli utenti che non hanno precedentemente installato .net framework 2.0 , procedere con linstallazione di questultimo accettando prima i termini di licenza e poi premendo sul pulsante Installa.

4. Selezionare il percorso dinstallazione del programma. Epossibile installare lapplicazione in qualunque percorso valido (purch lutente abbia tutti i privilegi necessari su quel percorso) consigliabile comunque installare lapplicazione nel percorso proposto dal programma X:\TeamSystem Software\Gamma Updater\

5. Proseguire linstallazione utilizzando il pulsante Avanti.6. Il servizio richiede obbligatoriamente la definizione di un account AMMINISTRATIVO con il quale il servizio sar messo in esecuzione. Vedere paragrafo Configurazione server per maggiori dettagli.

IMPORTANTE

Lutente di sistema localsystem, non ha credenziali amministrative di rete. Si sconsiglia lutilizzo di queste credenziali. Specificare un account amministrativo di dominio o comunque amministrativo allinterno della rete.

Il nome utente deve essere specificato nel formato Dominio\Utente. Nel caso in cui lutente non fosse riconosciuto, sar possibile proseguire con linstallazione se non come utente local system. Dopo aver specificato lutente specificare la relativa password. Per vincoli dovuti alla sicurezza linstallatore non in grado di validare la password associata allutente. Se la password non valida il setup non sar in grado di avviare il servizio mostrando il seguente messaggio:

In tal caso sar necessario configurare il servizio manualmente come specificato nel paragrafo Configurazione server.

Se si sceglie annulla verr linstallazione prosegue assegnando al servizio laccount di local system.7. Terminare linstallazione con il pulsante Chiudi.Al termine dellinstallazione, nel percorso dinstallazione si troveranno i seguenti file: GammaUpdaterService.exe: servizio per laggiornamento di Gamma

GammaUpdater.exe: interfaccia utente del servizio.

Configurazione.exe: avvia il programma di configurazione

GammaUpdaterService.exe.config file xml per la memorizzazione delle impostazioni

Proxy.dll e Updater.dll librerie proprietarie del prodottoGamma Updater ConfigurazioneConfigurazione collegamenti

Al termine dellinstallazione, sia sul desktop che nel men avvio -> programmi ci sar il collegamento a Gamma Updater chiamato Gamma Enterprise o Gamma Sprint. Questo deve sostituire il collegamento originale che dovr quindi essere rimosso.

l nuovo collegamento include il controllo degli aggiornamenti !Configurazione percorsi

La prima volta che si esegue il programma, verr avviata una finestra di configurazione che permetter allutente di specificare quali sono i percorsi (locali e remoti) delle applicazioni Gamma Enterprise client e server.

1) il percorso locale dove risiede linstallazione di Gamma Enterprise client

2) il percorso remoto dove risiede linstallazione di Gamma Enterprise server3) il percorso locale dove risiedono i file CRUFL di crystal report

4) il percorso remoto dove risiedono i file CRUFL di crystal report sulla macchina server5) il percorso dove verr creato il file di log IMPORTANTE

Tutti i percorsi sul server:

2) Il percorso remoto dove risiede linstallazione di Gamma Enterprise Server4) Il percorso remoto dove risiedono i file CRUFL di crystal report sulla macchina serverDevono essere condivisi e accessibili ai client e allutente che esegue laggiornamento.

E necessario quindi verificare i permessi delle cartelle sopraelencate.

Dopo aver specificato correttamente tutti i percorsi necessari, premere il pulsante Registra per memorizzare le impostazioni. IMPORTANTE

Avviando in seguito il programma gestionale, se le impostazioni sono state correttamente memorizzate, lapplicazione non proporr pi la finestra di configurazione che sar comunque richiamabile con il programma Configurazione.exe, presente allinterno della cartella dinstallazione.

Configurazione aggiornamento differito

Per abilitare laggiornamento differenziato necessario specificare in fase di configurazione il flag Consenti aggiornamenti differiti labilitazione di questa opzione far comparire un link sulla maschera di notifica Aggiorna pi tardi che permetter allutente di aggiornare lapplicativo in un secondo momento

Gamma Updater UtilizzoUtilizzo

Allavvio del prodotto gestionale sar interrogato il servizio per verificare la presenza di eventuali aggiornamenti.Se il servizio Gamma Updater rileva degli aggiornamenti sul server, una finestra di notifica informer lutente della disponibilit degli aggiornamenti pubblicati e del numero della versione.

Lutente potr decidere se aggiornare il software o rimandare laggiornamento ad un secondo momento (scelta non consigliata).

Se GammaUpdater dovesse non essere in grado di raggiungere il server a causa di un problema di rete o di una errata configurazione, verr notificato allutente un messaggio di server non raggiungibile invitandolo a verificare i parametri di configurazione inseriti precedentemente o a risolvere eventuali problemi di rete.

Subito dopo il messaggio, verr comunque avviato il prodotto gestionale.

La pressione su Aggiorna ora avvier il processo di aggiornamento e una nuova finestra informer lutente dello stato evidenziando lo stato di avanzamento delloperazione.

Per interrompere il processo di aggiornamento premere Interrompi.

Riavviando il prodotto gestionale sar nuovamente evidenziata la necessit di aggiornare il prodotto.

IMPORTANTE

Interrompere il processo dinstallazione non un operazione consigliata.

Al termine dell aggiornamento premendo sul collegamento Report sar possibile consultare il log dettagliato delle operazioni eseguite.

Al successivo avvio la finestra di notifica non sar pi proposta fino al rilevamento di nuovi aggiornamenti. Sar quindi avviato il prodotto gestionale.Auto-Aggiornamento GammaUpdater

In caso di rilascio di una nuova versione del programma Gamma Updater, sar possibile reinstallare questultimo automaticamente e senza necessitare di privilegi amministrativi.E necessario che lamministratore definisca tramite il programma Configurazione.exe il percorso dove risiedono gli aggiornamenti di GammaUpdater sul server.Premendo sul pulsante Avanzate si accede ad una nuova maschera di configurazioni avanzate.

Nella maschera di configurazione avanzate nella sezione Assembly specificare il percorso e poi confermare con il pulsante OK

Confermare le impostazioni utilizzando il pulsante registra.

Una volta registrate tutte le impostazioni, il programma al prossimo riavvio se le impostazioni sono corrette proporr una maschera che baster confermare per avere il programma Gamma Updater aggiornato.

Al successivo riavvio il programma non proporr pi la maschera sopracitata.

Configurazione ServerAccount servizio GammaUpdater

Larchitettura GammaUpdater costituita da due programmi:

1) GammaUpdater: programma che si occupa di verificare se esistono nuovi aggiornamenti.

2) TeamSystem GammaUpdaterService: servizio locale che effettua laggiornamento, necessitando quindi di opportuni privilegi. Per visualizzare il servizio possibile utilizzare il programma Service managment console ragiungibile dal pannello di controllo ( strumendi damministrazione ( Servizi.Il servizio GammaUpdaterService verr avviato con i privilegi dellaccount specificato in sede dinstallazione. GammaUpdater deve aver accesso completo a tutte le risorse della macchina locale (anche in caso di utilizzo del programma da un utente con restrizioni). Laccount deve inoltre avere accesso completo almeno alle cartelle dinstallazione del gestionale poste sul server.

IMPORTANTE

Se il server situato allinterno di un dominio, necessario assegnare al servizio un account che abbia gli opprtuni privilegi nel dominio, consigliato quindi unaccount di amministratore di dominio.

Se durante lnstallazione non viene specificato un account per il servizio Gamma Updater, sr comunque possibile modificare laccount del servizio al termine dellinstallazioene.

Nel paragrafo successivo riportata la procedura per la modifica dellaccount utente del servizio.Assegnare un account amministrativo al servizio

Dalla console di gestione dei servizi di windows cliccare sulla voce propriet del men contestuale che viene visualizzato con il tasto destro sul nome del servizio TeamSystem GammaUpdaterService.

Sulla finestra di selezione dell utente, scheda Connessione, specificare il nome dellaccount con privilegi amministrativi lato client e lato server (consigliato amministratore di dominio) e premere ok.Logica di aggiornamentoLogica di aggiornamento

Di seguito riportiamo schematicamente le logiche con cui lapplicativo effettua verifiche e controlli:

1) Verifica aggiornamenti Gamma updater

a. Se presente una versione pi recente viene prelevata dalla cartella server ed installata

b. Se non presente prosegue

2) Verifica aggiornamenti gestionale Gamma

a. Se presente una versione pi recente vengono aggiornati i moduli standard e personalizzati

b. Se non presente viene avviato Gamma

i. Se Gamma presente viene avviato

ii. Se Gamma non presente viene avviata linstallazione

Note tecniche

2