Data ultimo aggiornamento: 04/03/2014

Aggiornamenti su Business

In Business NET nel programma d'installazione degli aggiornamenti (BUSAGG) sono stati apportati miglioramenti per semplificarne l'utilizzo e per gestire in modo migliore il Controllo Account Utente (UAC). Fino alle versioni precedenti infatti non era possibile attivare l'installazione automatica degli aggiornamenti quando l'account di Windows,con cui si accede a Business NET, non aveva i privilegi di amministratore ed era attivo l'UAC.

Sono stati apportati significativi miglioramenti per quanto riguarda la sicurezza: ora l'installazione degli aggiornamenti lanciata nella modalità "server" (vedere più avanti) richiede che vengano fornite delle credenziali amministrative di Business NET (ossia l'indicazione di un utente appartenente al gruppo/ruolo "Amministratori").

Ora il programma d'installazione degli aggiornamenti, rappresentato dal file Busagg.exe, non viene più installato localmente ma risiede unicamente nella cartella di distribuzione degli aggiornamenti, rappresentata, ad esempio, della cartella C:\Bus\Agg sul server, vista dai cliente come \\Busserver\BusinessDir\Agg. Per ogni installazione quindi esiste un unico programma d'installazione degli aggiornamenti il quale viene automaticamente aggiornato, in base alle necessità di NTS Informatica, da qualsiasi pacchetto di aggiornamento (Hot Update, Cumulative Update e Service Release); tale programma è stato realizzato con InnoSetup. Questo programma, al contrario di quello distribuito con le versioni precedenti, va ad aggiornare le direttive di disinstallazione (nel Pannello di Controllo, Programmi e funzionalità) di Windows per evitare, ad esempio, che nuovi componenti rilasciati in una service release non vengano rimossi da una eventuale disinstallazione di Business NET.

Il programma d'installazione degli aggiornamenti può essere avviato in 3 modalità distinte:

1. automatica, nella modalità client, all'avvio di Business NET, quando impostata l'installazione automatica degli aggiornamenti all'avvio, e se ci sono aggiornamenti nella cartella degli aggiornamenti sul server da installare;
2. manuale, nella modalità server o client, eseguendo manualmente il file Busagg.exe oppure all'interno di Business NET, nel menu Programmi, accedendo alla voce Verifica/installa aggiornamenti.
3. integrata nei pacchetti d'installazione, nella modalità server, quando si eseguono i pacchetti d'installazione delle Hot Update, Cumulative Update e Service Release (ad esempio i file BusNet2014Sr1.exe, BusNet2014_hu_<aaammgg>_<oommss>.exe, BusNet2014_cu1.exe, ...); rispetto alle versioni precedenti non è poi necessario copiare il pacchetto nella cartella temporanea, ad esempio C:\BusTmp, o scompattarne il contenuto nella cartella di distribuzione aggiornamenti sul server, ad esempio C:\Bus\Agg, basta eseguire (doppio click) sul pacchetto da qualsiasi posizione sul disco.
4. integrata nei pacchetti d'installazione per la distribuzione dei dati, nella modalità server, allo scopo di distribuiti i dati nell'archivio procedura come ad esempio i codici ABI/CAB e i codici Intrastat (nomenclature combinate dei beni TARIC e servizi CPA). Questi pacchetti sostituiscono i vecchi Bustaric.exe e Busabi.exe

Il programma d'installazione degli aggiornamenti può accettare i seguenti parametri di avvio:

/FILEPROFILO="c:\program files\bus\business.cfg": rappresenta il file di configurazione del profilo, completo di percorso, su cui installare gli aggiornamenti; questo rappresenta il profilo corrente che verrà mostrato nella finestra;

/BUSNET: ad uso interno di NTS Informatica, serve per chiamare il programma di installazione nella modalità automatica all'avvio di Business NET quando ci sono aggiornamenti da installare "pendenti" nella cartella di distribuzione sul server; in questo caso viene fornito obbligatoriamente il parametro /FILEPROFILO.

/CLIENT e /SERVER: serve per impostare la modalità di installazione aggiornamenti da avviare sia lanciando il programma Busagg.exe che i pacchetti di hotfix, postfix o service release. Obbligatorio nelle installazioni /SILENT e /VERYSILENT.

/SILENT: opzionale, avvia l'installazione dell'aggiornamento senza intervento dell'operatore. Vanno specificati obbligatoriamente altri parametri come più avanti viene riportato.

/VERYSILENT: opzionale, avvia l'installazione come indicato nel parametro /SILENT in aggiunta viene anche rimossa la finestra con l'avanzamento del processo d'installazione.

/SUPPRESSMSGBOXES:opzionale, se indicato tutti i messaggi informativi non vengono mostrati a video ma salvati nel file di log. Ha effetto solo se viene utilizzato in combinazione con il parametro /SILENT o /VERYSILENT.

/UTENTEAMMINISTRATORE: opzionale, rappresenta il nome operatore di Business NET, con i privilegi di amministratore, per avviare l'installazione degli aggiornamenti nella modalità server. Obbligatorio nelle installazioni /SILENT e /VERYSILENT specificando il parametro /SERVER.

/PASSWORDAMMINISTRATORE: opzionale, serve per preimpostare la password dell'operatore indicato in /UTENTEAMMINISTRATORE.

/ATTENDIADMINTOOLS: opzionale, se indicato, qualora vi sia la necessità da parte del programma d'installazione degli aggiornamenti di avviare la conversione degli archivi, l'avvio del Busadmintools.exe avviene con la conferma da parte dell'operatore. Questo consente, eventualmente, di escludere uno o più database dalla conversione. Ha priorità rispetto alla direttiva ADMNTOOL_WAIT=S eventualmente presente nel RILASCIO.TXT.

Il programma d'installazione aggiornamenti di Business NET (Busagg.exe) crea un file di log durante tutto il processo di installazione; tale file è presente nella root del disco di avvio di Windows (ad es. C:\) qualora l'installazione non venga portata a termine correttamente oppure nella Cartella dei file/archivi di Business NET (ad es. C:\Bus) qualora il setup termini correttamente. Il file possiede il seguente nome: "BusAggSetup Log <anno>-<mese>-<giorno> #<contatore>.txt (ad es. "BusAggSetup Log 2013-01-10 #001.txt).

Il programma d'installazione degli aggiornamenti richiede i requisiti di amministratore dell'account di Windows che lo manda in esecuzione: qualora sia abilitato il Controllo Account Utente (UAC) viene richiesta l'elevazione ad amministratore.

Quando il programma d'installazione viene lanciato nella modalità automatica parte immediatamente il processo d'installazione, negli altri casi appare la finestra sottostante.

Profilo installato

Questo campo elenca i profili installati di Business NET che il programma ha rilevato sulla macchina corrente. Per ogni profilo rilevato riporta la Cartella installazione (locale) rappresentata dalla cartella dove è stato individuato il file di configurazione del profilo (nell'esempio "C:\Program Files\Bus\Test\Test.cfg"), la versione di Business NET individuata (determinata dalla versione del file Busnet.exe), la Cartella aggiornamenti ossia la cartella sulla rete che provvede alla distribuzione degli aggiornamenti (rilevata dall'archivio procedura, tabella REGEDIT, proprietà Busagg\BusAggDir), il N° aggiornamento server rappresenta il numeratore contenuto nel file AGGNUMBER.TXT nella cartella aggiornamenti sul server, il N° aggiornamento locale rappresenta il numeratore nell'installazione corrente di Business NET (rilevatodall'archivio procedura, tabella REGEDIT, proprietà Busagg\AggNumber). Quando il N° aggiornamento locale è inferiore al N° aggiornamento server significa che nella cartella aggiornamenti sono presentidei file aggiornati non ancora installati sul profilo di Business NET locale.

Quando un profilo di Business NET presente sulla macchina non viene rilevato (vedere più avanti la tecnica utilizzata per rilevare i profili) è possibile scegliere da questo campo la voce (seleziona file di configurazione) allo scopo di selezionare in modo manuale il file <profilo>.cfg dal disco. Una volta che il file scelto viene validato il profilo viene elencato nel combo e reso corrente.

Modalità aggiornamento, client

Avviato con questa opzione, qualora ci siano aggiornamenti da installare presenti nella cartella aggiornamenti (ossia il N° aggiornamento locale è inferiore al N° aggiornamento server ) il programma provvede ad installarli nel profilo locale di Business NET e ad allineare il N° aggiornamento (AggNumber) locale con quello del server. L'installazione client non è ammessa quando il programma viene lanciato nella modalità integrata coi pacchetti d'installazione hotfix, postfix e service release.

Modalità aggiornamento, server

Avviato con questa opzione vengono dapprima verificati i requisiti d'installazione, quindi, se avviato nella modalità integrata, estratti i file aggiornati dal pacchetto nella cartella aggiornamenti sul server , quindi vengono installati sia i componenti server (file di report, file di Office) che i componenti client nella installazione locale di Business NET. Al termine qualora nelle direttive di installazione è indicato di procedere alla conversione degli archivi, provvede a lanciare il programma Strumento di amministrazione (Busadmintools.exe)in modalità automatica per convertire l'archivio procedura e/o tutti i database azienda.

Utente Business NET, Password

Prima di avviare un aggiornamento in modalità server è necessario fornire le credenziali di Business NET di tipo amministrativo, ossia un operatore appartenente al gruppo/ruolo "Amministratori".

Operazioni eseguite nella modalità aggiornamento Client

• Controlli preliminari:
  • controlla la presenza di Business NET sulla macchina corrente;
  • rileva il N° aggiornamento server (contenuto nel file AGGNUMBER.TXT nella cartella di distribuzione aggiornamenti sul server, Busagg\BusAggDir) e il N° aggiornamento locale dal registro di Business NET del profilo locale (archivio procedura, tabella REGEDIT);
  • l'elaborazione è ammessa solo se il N° aggiornamento locale è inferiore al N° aggiornamento server;
  • controlla che non siano presenti i modelli di database personalizzati (*.MODXP, *.MODXV e *.MODXV1) nella cartella di distribuzione degli aggiornamenti (possono essere presenti solo nella sottocartella \Pers);
  • verifica che la versione dell'archivio procedura ARCPROC equivalga alla versione di Business NET (versione del file Busnet.exe);
  • controlla che il programma d'installazione (Busagg.exe) sia della medesima versione di Business NET che si sta aggiornando;
  • rileva la presenza del file BUSAGGSERVER.TXT nella cartella di distribuzione aggiornamenti sul server;
• vengono copiati dalla cartella di distribuzione aggiornamenti del server (ad esempio \\Busserver\BusinessDir\Agg) alla cartella locale d'installazione di Business NET (ad esempio C:\Program Files\Bus) i seguenti componenti, se presenti:
  • file .EXE (Busnet.exe, Busadmintools.exe, Busserv.exe e Buschat.exe, inclusi i relativi file .MANIFEST e .CONFIG);
  • file .DLL e relativi file .PDB;
  • modelli di database standard (file .MODX);
  • risorse grafiche di Business NET (file .GIF, .JPG, .PNG, .ICO e .WAV) sono copiare nella sottocartella \Bnimages;
• vengono copiati dalla sottocartella \Pers della cartella di distribuzione aggiornamenti del server, contente le personalizzazioni (ad esempio \\Busserver\BusinessDir\Agg\Pers) alla cartella locale d'installazione di Business NET (ad esempio C:\Program Files\Bus) i seguenti componenti, se presenti:
  • file .DLL personalizzare e relativi file .PDB;
  • modelli di database personalizzati/verticalizzati (file PROVA.MODXP, PROVA.MODXV, PROVA.MODXV1, ARCPROC.MODXP, ARCPROC.MODXV e ARCPROC.MODXV1);
  • risorse grafiche dei programmi personalizzati (file .GIF, .JPG, .PNG, .ICO e .WAV) sono copiare nella sottocartella \Bnimages;
  • file della guida in linea dei programmi personalizzati (file .HTM, HELP_*.GIF, HELP_*.JPG e HELP_*.PNG). Qualora nella cartella di destinazione i file siano già esistenti saranno sovrascritti;
• qualora nella cartella di destinazione i file siano già esistenti, se non sono dotati di versione (.HTM, .JPG, ...) vengono sovrascritti, gli altri (EXE e DLL) vengono sovrascritti solo se di versione inferiore;
• quando la differenza tra il N° aggiornamento locale e N° aggiornamento server differisce di più di una unità, anche i file dotati di versione (.EXE e .DLL) verranno copiati sui client sovrascrivendo i componenti già esistente senza alcun controllo di versione (questo sistema può essere utile anche per forzare un downgrade di componenti/DLL personalizzate);
• vengono copiati gli eventuali file della guida in linea standard (file .HTM, .HCC, .CSS, .GIF, .JPG e .PNG) dalla sottocartella \Help della cartella di distribuzione aggiornamenti del server (ad esempio \\Busserver\BusinessDir\Agg\Help) alla cartella locale d'installazione di Business NET (ad esempio C:\Program Files\Bus\Help). Qualora nella cartella di destinazione i file siano già esistenti saranno sovrascritti;
• prima di uscire allinea il N° aggiornamento locale (dell'archivio procedura, tabella REGEDIT, proprietà Busagg\AggNumber) al N° aggiornamento server (del file AGGNUMBER.TXT sul server).

Operazioni eseguite nella modalità aggiornamento Server

• Controlli preliminari:
  • controlla la presenza di Business NET sulla macchina corrente;
  • rileva il N° aggiornamento server (contenuto nel file AGGNUMBER.TXT nella cartella di distribuzione aggiornamenti sul server, Busagg\BusAggDir) e il N° aggiornamento locale dal registro di Business NET del profilo locale (archivio procedura, tabella REGEDIT);
  • l'elaborazione è ammessa solo se il N° aggiornamento locale è inferiore al N° aggiornamento server;
  • controlla che non siano presenti i modelli di database personalizzati (*.MODXP, *.MODXV e *.MODXV1) nella cartella di distribuzione degli aggiornamenti (possono essere presenti solo nella sottocartella \Pers);
  • verifica che la versione dell'archivio procedura ARCPROC equivalga alla versione di Business NET (versione del file Busnet.exe);
  • controlla che il programma d'installazione (Busagg.exe) o il pacchetto hotfix, postfix o service release sia della medesima versione di Business NET che si sta aggiornando;
  • valida l'utente e la password indicata e controlla che appartenga al ruolo "Amministratori";
  • individua il file con le direttive di installazione server (RILASCIO.TXT) che deve essere presente nella cartella aggiornamenti nelle installazioni manuali, incorporato nel pacchetto nelle installazioni dei pacchetti hotfix, postfix e service release;
  • legge dal file BUSAGGSERVER.TXT, sempre presente nella cartella degli aggiornamenti sul server, l'ID di versione correntemente installata dalla proprietà FRAM (ad esempio 19001 rappresenta "Business NET 2013", 19003 rappresenta "Business NET 2013 SR1", ...)
  • dal file RILASCIO.TXT rileva la l'ID di versione minima, dalla proprietà REQUIRED_FRAM, necessaria per procede con l'aggiornamento nella modalità server;
  • dal file RILASCIO.TXT rileva le proprietà PRC_AGGSTRUCT (forza aggiornamento della struttura dell'archivio procedura), PRC_AGG_STPRO (forza aggiornamento delle stored procedures dell'archivio procedura), PRC_AGG__ZOOM (forza aggiornamento dell'elenco proprietà del registro Business NET), PRC_AGG__MENU (forza aggiornamento delle voci di menu standard) che se valorizzate a "S" fanno partire, al termine del processo d'installazione degli aggiornamenti , la conversione dell'archivio procedura mediante il Busadmintolols.exe. Tipicamente nei pacchetti di installazione hotfix, postfix e service release sono tutte impostate a "S" quando viene distribuito anche il file ARCPROC.MODX;
  • da file RILASCIO.TXT rileva le proprietà AZI_AGGSTRUCT (forza aggiornamento della struttura dei database azienda) e AZI_AGG_STPRO (forza aggiornamento delle stored procedures dei database azienda)che se valorizzate a "S" fanno partire, al termine del processo d'installazione degli aggiornamenti , la conversione di tutti i database azienda mediante il Busadmintolols.exe. Tipicamente nei pacchetti di installazione hotfix, postfix e service release sono tutte impostate a "S" quando viene distribuito anche il file PROVA.MODX;
  • dal file RILASCIO.TXT rileva la proprietà AGG_AGGNUMBER (che può assumere i valori S=Sì, N=No o C=Chiedi) che determina come incrementare il N° aggiornamento server (AggNumber) nel file AGGNUMBER.TXT contenuto nella cartella aggiornamenti sul server;
  • se l'aggiornamento prevede la conversione dei database azienda controlla che tutti siano di versione (tabella RELEASE) uguale alla versione di Business NET (versione del file Busnet.exe);
  • se l'aggiornamento prevede la conversione dei database azienda e nella cartella d'installazione sono presenti delle personalizzazioni/customizzazioni alla struttura dei database (presenza dei file PROVA.MODXP e/o PROVA.MODXV e PROVA.MODXV1) chiede conferma all'operatore prima di procedere;
• se il programma d'installazione aggiornamenti è avviato da un pacchetto di Hot Update, Cumulative Update o Service Release (modalità di avvio 3. sopra indicato), estrae i file dal pacchetto e li copia nella cartella di distribuzione degli aggiornamenti sul server (ad esempio C:\Bus\Agg se questa operazione viene compiuta dal server oppure \\Busserver\BusinessDir\Agg se questa operazione viene compiuta da un client). Qualora nella cartella di destinazione i file siano già esistenti, se non sono dotati di versione (.HTM, .RPT, ...) vengono sovrascritti, gli altri (EXE e DLL) vengono sovrascritti solo se di versione inferiore o uguale;
• vengono copiati dalla cartella di distribuzione aggiornamenti del server (ad esempio C:\Bus\Agg se questa operazione viene compiuta dal server oppure \\Busserver\BusinessDir\Agg se questa operazione viene compiuta da un client) alla cartella locale d'installazione di Business NET (ad esempio C:\Program Files\Bus) i seguenti componenti, se presenti:
  • file .EXE (Busnet.exe, Busadmintools.exe, Busserv.exe e Buschat.exe, inclusi i relativi file .MANIFEST e .CONFIG);
  • file .DLL e relativi file .PDB;
  • modelli di database standard (file .MODX);
  • risorse grafiche di Business NET (file .GIF, .JPG, .PNG, .ICO e .WAV) sono copiare nella sottocartella \Bnimages;
• vengono copiati dalla sottocartella \Pers della cartella di distribuzione aggiornamenti del server, contente le personalizzazioni (ad esempio C:\Bus\Agg\Pers se questa operazione viene compiuta dal server oppure \\Busserver\BusinessDir\Agg\Pers) alla cartella locale d'installazione di Business NET (ad esempio C:\Program Files\Bus) i seguenti componenti, se presenti:
  • file .DLL personalizzare e relativi file .PDB;
  • modelli di database personalizzati/verticalizzati (file PROVA.MODXP, PROVA.MODXV, PROVA.MODXV1, ARCPROC.MODXP, ARCPROC.MODXV e ARCPROC.MODXV1);
  • risorse grafiche dei programmi personalizzati (file .GIF, .JPG, .PNG, .ICO e .WAV) sono copiare nella sottocartella \Bnimages;
  • file della guida in linea dei programmi personalizzati (file .HTM, HELP_*.GIF, HELP_*.JPG e HELP_*.PNG). Qualora nella cartella di destinazione i file siano già esistenti saranno sovrascritti;
  • vengono copiati i file dei report personalizzati ( .RPT, .PDF) e i file di Office (.DOT, .DOTX, .OTT, .OXT) nelle rispettive cartelle sul server, sovrascrivendo i file esistenti;
  • vengono copiati gli script delle personalizzazioni (.NTS) e il file DLLMAP.INI nella cartella \Script a pari livello della \Rpt sempre sul server;
• qualora nella cartella di destinazione i file siano già esistenti, se non sono dotati di versione (.HTM, .JPG, ...) vengono sovrascritti, gli altri (EXE e DLL) vengono sovrascritti solo se di versione inferiore;
• quando la differenza tra il N° aggiornamento locale e N° aggiornamento server differisce di più di una unità, anche i file dotati di versione (.EXE e .DLL) verranno copiati sui client sovrascrivendo i componenti già esistenti senza alcun controllo di versione (questo sistema può essere utile anche per forzare un downgrade di componenti/DLL personalizzate);
• vengono copiati gli eventuali file della guida in linea (file .HTM, .HCC, .CSS, .GIF, .JPG e .PNG) dalla sottocartella \Help della cartella di distribuzione aggiornamenti del server (ad esempio \\Busserver\BusinessDir\Agg\Help) alla cartella locale d'installazione di Business NET (ad esempio C:\Program Files\Bus\Help). Qualora nella cartella di destinazione i file siano già esistenti saranno sovrascritti;
• vengono copiati i file dei report ( .RPT, .PDF) e i file di Office (.DOT, .DOTX, .XLS, .XLSX, .OTT, .OXT) nelle rispettive cartelle sul server, sovrascrivendo i file esistenti;
• se nelle direttive di installazione server, indicate nel RILASCIO.TXT, sono presenti le direttive PRC_AGGSTRUCT, PRC_AGG_STPRO, PRC_AGG__ZOOM e PRC_AGG__MENU valorizzate a "S" viene fatto partire il Busadmintools.exe per convertire automaticamente l'archivio procedura. A partire da questa versione di Business NET sono ammesse variazioni alla struttura dei database (tabelle, campi) anche con la distribuzione di service release. Questa procedura di conversione archivi non prevede la possibilità di aggiornare: le stampe parametriche predefinite, i profili import/export standard, i codici abi/cab e i cod. di nomenclatura combinata Taric;
• se nelle direttive di installazione server, indicate nel RILASCIO.TXT, sono presenti le direttive AZI_AGGSTRUCT e AZI_AGG_STPRO valorizzate a "S" viene fatto partire il Busadmintools.exe per convertire automaticamente tutti i database azienda (rilevati nella tabella AZIENDE dell'archivio procedura). A partire da questa versione di Business NET sono ammesse variazioni alla struttura dei database (tabelle, campi) anche con la distribuzione di service release;
• sulla base di come è valorizzata la direttiva AGG_AGGNUMBER del RILASCIO.TXT il programma provvede a:
  • N: non incrementare il N° aggiornamento server nel file AGGNUMBER.TXT, questo fa si che non venga fatta partire l'installazione automatica sul client al riavvio di Business NET;
  • S: incrementare il N° aggiornamento server nel file AGGNUMBER.TXT;
  • C: chiedere all'operatore se incrementare o meno il N° aggiornamento server nel file AGGNUMBER.TXT;
• al termine dell'elaborazione viene rimosso il file RILASCIO.TXT per evitare che successive elaborazioni server "riciclino" le direttive d'installazione nel file;
• prima di uscire allinea il N° aggiornamento locale (dell'archivio procedura, tabella REGEDIT, proprietà Busagg\AggNumber) al N° aggiornamento server (del file AGGNUMBER.TXT sul server).

Nella modalità di avvio 4. sopra definita (integrata nei pacchetti d'installazione per la distribuzione dei dati) i soli file che vengono installati sono i seguenti file: ARCPROC.MODX, Busadmintools.*, Bn__sqlb.* e i report Par*.rpt.

Come si installano i pacchetti di Hot Update, Cumulative Update e Service Release

Questi pacchetti vengono distribuiti con file EXE al cui interno è presente il programma d'installazione. Per l'installazione procedere nel modo sotto indicato:

1. posizionarsi su una qualsiasi macchina in cui è installato Business NET, su un account Windows di tipo amministratore;
2. chiudere il programma Business NET;
3. copiare il file BusNet*.exe in una qualsiasi cartella sul disco o sul desktop;
4. eseguire il file facendo doppio click;
5. nella finestra Configurazione dell'aggiornamento a Business NET scegliere il profilo da aggiornare e, se non elencato, utilizzare la voce (seleziona file di configurazione) per selezionare il file di configurazione (<profilo>.cfg);
6. inserire l'Utente di Business NET, di tipo amministratore, e la relativa Password;
7. premere Installa e attendere la fine del processo;
8. qualora nel pacchetto siano inclusi i modelli di database (Prova.modx e/o Arcproc.modx) il programma procede alla conversione automatica di tutti i database;
9. su tutte le altre macchine:
   • se durante l'installazione è stata impostata l'opzione Installa automaticamente gli aggiornamenti all'avvio di Business NET, basta rientrare in Business NET per far partire l'installazione degli aggiornamenti;
   • se non è impostato l'aggiornamento automatico, all'interno di Business NET, nel menu Programmi accedere alla voce Verifica/installa aggiornamenti. Business NET verrà chiuso e partirà il programma Installazione aggiornamenti di Business NET, controllare che la Modalità aggiornamento sia impostata su Client, quindi premere Installa attendere la fine del processo.

Come il programma d'installazione degli aggiornamenti rileva i profili installati sulla macchina corrente

Il programma d'installazione degli aggiornamenti (Busagg.exe) rileva la lista dei profili installati dall'elenco dei programmi installati in Windows dal Pannello di controllo, Programmi e funzionalità. Tecnicamente opera in questo modo:

1. apre il ramo del registro di windows HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\
2. individua le chiavi relative alle installazioni di Business NET (nomi "NTSInformaticaBusNetn_is1") create dal programma d'installazione;
   • per ognuna legge la proprietà InstallLocation contenente la cartella d'installazione (ad esempio C:\Program Files\Bus);
   • individua tutti i file *.CFG contenuti;
   • il nome di tale file rappresentano il profilo.
   • sempre in questa cartella individua la versione (major) del file Busnet.exe per individuarne la versione di Business NET installata;

A questo punto il programma mostra come profilo selezionato (nel combo Profili installati) quello denominato Business (Business.cfg) nella cartella predefinita (C:\Program Files\Bus), se esiste e di versione uguale alla versione del Busagg.exe, altrimenti il primo profilo rilevato.

Come installare manualmente le personalizzazioni o aggiornamenti alle personalizzazioni

Quando si realizza una personalizzazione ai programmi (creazione di DLL) o alla base dati (creazione del PROVA.MODXP) queste devono essere installate presso l'installazione dell'utilizzatore. A partire da questa versione di Business NET, i file delle personalizzazioni vengono tenuti isolati dai componenti standard presenti nella cartella di distribuzione degli aggiornamenti, risiedono nella sottocartella \Pers (ad esempio C:\Bus\Agg\Pers) e non vengono di conseguenza rimossi nell'installazioni di major release con programma di installazione. Per installare le personalizzazioni si può procedere così come nelle versioni precedenti in modo manuale. Si consiglia di procedere in uno dei due modo indicati:

Metodo 1

1. da una qualsiasi macchina sulle rete, in cui è installato Business NET, copiare nella sottocartella \PERS della cartella di distribuzione degli aggiornamenti sul server (ad esempio C:\Bus\Agg\Pers o \\Server\BusinessDir\Agg\Pers) le DLL personalizzate ed eventualmente le personalizzazione alla base dati inserite nel PROVA.MODXP;
2. creare manualmente, ad esempio con il Blocco Note/Notepad o altri editor di testo, il file RILASCIO.TXT nella medesima cartella, come nell'esempio sotto indicato:
   
   [Rilascio]
REQUIRED_FRAM=20000
INSTALL_DATE=40331
PRC_AGGSTRUCT=N
PRC_AGG_STPRO=N
PRC_AGG__ZOOM=N
PRC_AGG__MENU=N
AZI_AGGSTRUCT=S
AZI_AGG_STPRO=S
AGG_AGGNUMBER=S
   
   indicando in REQUIRED_FRAM l'ID di versione correntemente installata (vedere la proprietà FRAM contenuta nel file BUSAGGSERVER.TXT), qualora sia necessario forzare la conversione dei database azienda, per la presenza del PROVA.MODXP, porre a "S" le proprietà AZI_AGGSTRUCT e AZI_AGG_STPRO. Nella proprietà AGG_AGGNUMBER indicare "S" per far in modo che l'installazione di tale aggiornamento vada ad incrementare automaticamente il N° aggiornamento server (AGGNUMBER.TXT) per far in modo che tutti gli altri client si aggiornino automaticamente all'avvio di Business NET.
3. lanciare il programma Installazione aggiornamenti di Business NET (Busagg.exe) dalla cartella di distribuzione degli aggiornamenti e avviarlo modalità Server.
4. durante questa fase, se indicato, verrà lanciata la conversione degli archivi (Busadmintools.exe) per andare ad inserire i campi/tabelle indicati nel PROVA.MODXP, se non presenti, nei database azienda. Questa operazione interesserà tutti i database azienda e può avvenire solo se i database sono di versione corrente (non è ammesso, ad esempio, l'installazione di aggiornamento relativo alla 2013 -vers. 19- quando il database è in versione 2012 -vers. 18-).

Occorre comunque tenere presente che, come indicato sopra, durante l'installazione dei componenti nella installazione locale (della modalità server o client) sono coinvolti tutti i componenti presenti nella cartella aggiornamenti sul server (BusAggDir).

Metodo 2

1. da una qualsiasi macchina sulle rete, in cui è installato Business NET, copiare nella sottocartella \PERS della cartella di distribuzione degli aggiornamenti sul server (ad esempio C:\Bus\Agg\Pers o \\Server\BusinessDir\Agg\Pers) le DLL personalizzate ed eventualmente le personalizzazione alla base dati inserite nel PROVA.MODXP;
2. copiare le DLL personalizzate, ed eventualmente il PROVA.MODXP, anche nella cartella locale dell'installazione di Business NET (ad esempio C:\Program Files\Bus)
3. In presenza di personalizzazioni alla base dati lanciare il programma Strumento di amministrazione (Busadmintools.exe) per convertire i database azienda.
4. nella cartella aggiornamenti sul server incrementare il N° aggiornamento server, presente nel file AGGNUMBER.TXT, per far in modo che tutti gli altri client si aggiornino automaticamente all'avvio di Business NET, e le personalizzazioni vengano distribuite su tutte le macchine.

Se l'installazione di una personalizzazione deve avvenire contemporaneamente all'installazione di un pacchetto di aggiornamenti rilasciato da NTS Informatica, ad esempio una service release, è possibile procedere nel seguente modo:

1. copiare nella sottocartella \PERS della cartella di distribuzione degli aggiornamenti sul server (ad esempio C:\Bus\Agg\Pers o \\Server\BusinessDir\Agg\Pers) le DLL personalizzate ed eventualmente le personalizzazione alla base dati inserite nel PROVA.MODXP;
2. lanciare l'installazione del pacchetto, come sopra indicato. Se il pacchetto distribuito da NTS Informatica includeva il PROVA.MODX verrà lanciata la conversione archivi che terrà conto anche della presenza del PROVA.MODXP con le customizzazioni alla base dati; se non presente e si ha la necessita di convertire il database si lancia, successivamente il Busadmintools.exe.

Se si sta facendo un porting di una personalizzazione realizzata su una versione precedente di Business NET (2012 o precedenti) si consiglia di:

• eseguire il porting della personalizzazione alla versione corrente (dalla tecnologia VB6 a quella NET, ad esempio) e testare le la personalizzazione operi con la nuova versione che si sta installando;
• in presenza di database personalizzati, su versioni precedenti alla 2013, creare il PROVA.MODXP (vedi Note per installatori e programmatori nel capitolo Note di versione -Leggimi.htm- della guida in linea);
• Installare la nuova versione di Business NET (la versione completa mediante Bussetup) sul server;
• copiare nella sottocartella \PERS della cartella di distribuzione degli aggiornamenti (ad esempio C:\Bus\Agg\Pers) le DLL personalizzate ed eventualmente il file PROVA.MODXP;
• nella stessa cartella incrementare il N° aggiornamento server, presente nel file AGGNUMBER.TXT;
• Lanciare lo Strumento di amministrazione (Busadmintools.exe) per convertire i database dalla versione precedente a quella corrente personalizzata;
• Installare la nuova versione di Business NET sui client, impostando il flag relativo alla installazione automatica degli aggiornamenti;
• Al primo avvio di Business NET, su tali client, verranno installate localmente le personalizzazioni.

NB: quando si installa una personalizzazione è necessario copiare tutti i componenti personalizzati dentro la cartella personalizzata degli aggiornamenti di Business (la cartella \Agg\Pers) compreso il PROVA.MODXP. E' molto importante che venga copiato il PROVA.MODXP in quanto con gli aggiornamenti infrarelease è possibile che sia un client ad avviare la conversione del database, e senza il PROVA.MODXP nella \Agg\Pers potrebbe capitare che la conversione venga eseguita senza per personalizzazioni del cliente!

Esempio file di direttive installazione aggiornamenti (RILASCIO.TXT)

Il file con le direttive d'installazione degli aggiornamenti RILASCIO.TXT, utilizzato nelle installazione server, ha le seguenti caratteristiche:

[Rilascio]
REQUIRED_FRAM=20000
INSTALL__FRAM=20004
INSTALL__DESC=Business NET 2014 SR1
INSTALL_DATE=20140331
PRC_AGGSTRUCT=S
PRC_AGG_STPRO=S
PRC_AGG__ZOOM=S
PRC_AGG__MENU=S
AZI_AGGSTRUCT=S
AZI_AGG_STPRO=S
AGG_AGGNUMBER=S

REQUIRED_FRAM rappresenta l'ID di versione minima richiesta (controllata nel BUSAGGSERVER.TXT) per poter installare gli aggiornamenti nella modalità server

INSTALL__FRAM rappresenta il nuovo ID di versione da installare con questo pacchetto, ad esclusivo uso di NTS Informatica, per la distribuzione di service release

INSTALL__DESC rappresenta il nome della versione da installare con questo pacchetto, ad esclusivo uso di NTS Informatica, per la distribuzione di service release

INSTALL_DATE rappresenta la data, nel formato aaaammgg, in cui è stato creato il pacchetto; questo valore è utilizzabile per alimentare la proprietà DATE conservata nel file BUSAGGSERVER.TXT nella cartella di distribuzione aggiornamenti sul server

PRC_AGGSTRUCT, valori ammessi S o N, se a S procede alla conversione dell'archivio procedura; PRC_AGG_STPRO, valori ammessi S o N, se a S procede alla conversione dell'archivio procedura per aggiornare unicamente le stored procedure;

PRC_AGG__ZOOM, valori ammessi S o N, se a S procede alla conversione dell'archivio procedura solo per aggiornare la lista delle opzioni di registro ammesse;

PRC_AGG__MENU, valori ammessi S o N, se a S procede alla conversione dell'archivio procedura solo per aggiornare le voci del menu;

AZI_AGGSTRUCT, valori ammessi S o N, se a S procede alla conversione di tutti gli archivi azienda;

AZI_AGG_STPRO, valori ammessi S o N, se a S procede alla conversione di tutti gli archivi azienda per aggiornare unicamente le stored procedure;

PRC_AGG__DATI, opzionale, valori ammessi S o N (se mancante vale N, se valorizzato a S PRC_AGGSTRUCT deve essere valorizzato a N): se a S nel pacchetto è presente ARCPROC.MODX per la distribuzione di dati, nessun aggiornamento della struttura avviene. Utilizzata per creare i pacchetti di distribuzione di soli dati nell'archivio procedura;

PRC_AGG__COSA, opzionale (obbligatorio se PRC_AGG__DATI vale S): indica che tipo di dati aggiornare ABI=cod. abi/cab, TAR=codici taric, IMP=import/export, PAR=stampe parametriche query;

PRC_AGG_DESCR, opzionale (da valorizzare solo se PRC_AGG__DATI valeS): rappresenta la descrizione dell'aggiornamento, esempio "PRC_AGG_DESCR=Aggiornamento codici Abi/Cab (febbraio 2013)";

ADMNTOOL_WAIT, opzionale, valori ammessi S o N (se mancante vale N): indica che, qualora vi sia la necessità da parte del programma d'installazione degli aggiornamenti di avviare la conversione degli archivi, l'avvio del Busadmintools.exe avviene con la conferma da parte dell'operatore. Questo consente, eventualmente, di escludere uno o più database dalla conversione;

PRC_AGG__ABIC, PRC_AGG__TARI, PRC_AGG__IMEX, PRC _AGG__SPAR, opzionali, valori ammessi S o N (se mancante vale N): indica la necessità, in sede di conversione archivi con Busadmintools, di aggiornare i dati dell'archivio procedura relativi, rispettivamente, ai codici abi/cab, nomenclature combinate, profili import/export standard, stampe parametriche. Possono essere utilizzate anche quando PRC_AGGSTRUCT vale S. Incompatibile con la direttiva PRC_AGG__DATI.

Come estrarre il contenuto di un pacchetto di aggiornamento hotfix, postfix o service release

Questi pacchetti, rappresentati da file eseguibili, sono realizzati con programma InnoSetup e possono essere decompressi con il programma InnoExtractor presente nella cartella \Tools\Unpacker del DVD-ROM di Business NET.