Overview

Aggiornare una free app

Questa pagina porta un'installazione binaria di una free app 1.7.28 (zip -iis- del sito, IIS, SQL Server) alla 1.8.0 tenendo i dati e le personalizzazioni. Vale per le tre free app; dove qualcosa cambia da un'app all'altra lo dice la tabella qui sotto. Chi ha installato i sorgenti (zip -src-) non usa questa pagina.

Free appNome ($Name)Prefisso dei pacchetti
Fatturazione elettronicaFatturazioneElettronicafe
CRMCrmAppcrm
Flotta mezziFlottaMezziflotta

Serve:

  • lo zip <Nome>-iis-v1.8.0-with-dbs.zip della tua app dalla pagina Download del sito;
  • un utente Windows amministratore della macchina che possa fare backup e ripristino dei due database (l'utente che ha installato SQL Server Express lo e');
  • un superamministratore dell'applicazione (per esempio admin).

Durante l'aggiornamento l'applicazione e' ferma. Non estrarre lo zip nuovo sopra la cartella dell'applicazione e non ripristinare i suoi db\*.bak: sono per un'installazione nuova e sostituirebbero i tuoi dati.

Cosa c'e' nella cartella upgrade

Lo zip 1.8.0 ha una cartella upgrade\:

FileA cosa serve
Upgrade-Database.ps1backup, script del DB dati e ripristino dei due database. Funziona con Windows PowerShell 5.1, senza sqlcmd ne' SSMS: legge le stringhe di connessione da appsettings.json dell'applicazione
db-data\*.sqlgli script del DB dati dalla 1.7.28 alla 1.8.0, nell'ordine in cui vanno eseguiti. Si possono eseguire di nuovo
<prefisso>-1.7.28.wuicpkgpacchetto dei metadati della 1.7.28 come pubblicata: la base del confronto
<prefisso>-1.8.0.wuicpkgpacchetto dei metadati della 1.8.0
removed-files.txti file del programma della 1.7.28 che la 1.8.0 non ha piu' (si tolgono al passo 6)
upgrade.jsonelenco e ordine degli script, nomi dei pacchetti

Cosa si sostituisce e cosa si conserva

CosaCome
programma (DLL, wwwroot, web.config)sostituito dai file dello zip nuovo; i file della 1.7.28 che la 1.8.0 non ha piu' si tolgono. Se avevi modificato web.config, rifai la modifica dopo
appsettings.jsonconservato: stringhe di connessione e impostazioni restano le tue, tranne uploadFolder (passo 2)
Upload, Conservazione, logs, App_Dataconservati
Reports (report .mrt)conservati dalla copia dei file; li aggiorna l'applicazione dei metadati (passo 6)
DB datiaggiornato dagli script di upgrade\db-data
DB metadatiaggiornato dal ciclo di vita con il pacchetto <prefisso>-1.8.0.wuicpkg, a 3 vie con la base 1.7.28

I metadati e i report si confrontano a 3 vie: la base (la 1.7.28 come pubblicata), la sorgente (la 1.8.0) e il target (la tua installazione). Quello che hai cambiato tu e il fornitore no resta tuo; quello che ha cambiato il fornitore e tu no prende la versione nuova; quello che avete cambiato entrambi e' un conflitto che scegli tu. Un report .mrt si confronta come file intero.

Prima di iniziare

Apri Windows PowerShell come amministratore, scrivi in $Name il nome della tua app (tabella sopra) e imposta i percorsi della tua installazione (quelli qui sotto sono quelli di INSTALL.md). Tutti i blocchi della pagina usano queste variabili: eseguili nella stessa finestra.

Snippet 1PowerShell
$Name = 'FatturazioneElettronica'
$App  = "C:\inetpub\wwwroot\$Name"
$Site = $Name
$Pool = "${Name}Pool"
$Zip  = "$env:USERPROFILE\Downloads\$Name-iis-v1.8.0-with-dbs.zip"
$New  = "C:\$Name-1.8.0"
$Copy = "C:\$Name-1.7.28-copia"

1. Fermare l'applicazione e fare i backup

Ferma sito e pool, aspetta che il processo del pool sia uscito, estrai lo zip nuovo in una cartella a parte, fai il backup dei due database e la copia della cartella dell'applicazione:

Snippet 2PowerShell
& $appcmd stop site "/site.name:$Site"
& $appcmd stop apppool "/apppool.name:$Pool"
while (Get-CimInstance Win32_Process -Filter "Name='w3wp.exe'" | Where-Object { $_.CommandLine -match [regex]::Escape($Pool) }) { Start-Sleep -Seconds 2 }
Unblock-File -Path $Zip
Expand-Archive -Path $Zip -DestinationPath $New
powershell -ExecutionPolicy Bypass -File "$New\upgrade\Upgrade-Database.ps1" -Action Backup -AppDir $App
robocopy $App $Copy /MIR /NFL /NDL /NP

-Action Backup scrive <database>_before-1.8.0.bak nella cartella dei backup dell'istanza SQL Server e stampa il percorso di ogni file. Tieni backup e copia finche' non hai controllato l'applicazione aggiornata: servono per tornare indietro (capitolo Tornare alla 1.7.28).

2. Sostituire i file dell'applicazione

Snippet 3PowerShell
robocopy $New $App /E /XF appsettings.json /XD "$New\upgrade" "$New\db" "$New\Reports" "$New\Upload" "$New\Conservazione" "$New\logs" "$New\App_Data" /NFL /NDL /NP

robocopy finisce con un codice da 0 a 7 quando la copia e' riuscita; da 8 in su c'e' un errore.

Poi la cartella dei file caricati. Nell'appsettings.json della 1.7.28 uploadFolder vale C:\\src\\Wuic\\<Nome>\\Upload, una cartella della macchina del fornitore: i file caricati (per esempio il logo nella scheda dell'utente) finiscono in C:\src\Wuic\<Nome>\Upload, che l'applicazione crea. Questo blocco copia quei file nella cartella Upload dell'applicazione e svuota il valore, cosi' i file caricati da qui in poi vanno in <cartella dell'applicazione>\Upload.

Snippet 4PowerShell
$Old = "C:\src\Wuic\$Name\Upload"
if (Test-Path $Old) { robocopy $Old "$App\Upload" /E /NFL /NDL /NP }
$cfg = "$App\appsettings.json"
[IO.File]::WriteAllText($cfg, [IO.File]::ReadAllText($cfg).Replace("C:\\src\\Wuic\\$Name\\Upload", ''))

La cartella C:\src\Wuic\<Nome>\Upload resta: la 1.7.28 la usa di nuovo se torni indietro.

3. Aggiornare il DB dati

Snippet 5PowerShell
powershell -ExecutionPolicy Bypass -File "$New\upgrade\Upgrade-Database.ps1" -Action Scripts -AppDir $App

Lo script esegue gli script di upgrade\db-data nell'ordine di upgrade.json e si ferma al primo errore, dicendo quale script e quale blocco sono falliti. Gli script si possono eseguire di nuovo: corretta la causa, rilancia lo stesso comando.

4. Riavviare l'applicazione

Snippet 6PowerShell
& $appcmd start apppool "/apppool.name:$Pool"
& $appcmd start site "/site.name:$Site"

Al primo avvio il framework 1.8 aggiorna da solo lo schema del DB metadati. Apri l'applicazione nel browser ed entra con il superamministratore: i metadati sono ancora quelli della 1.7.28 finche' non fai i passi 5 e 6.

5. Adottare la base (solo la prima volta, dalla 1.7.28)

La 1.7.28 non registrava la propria versione nel DB metadati: la registri tu, senza cambiare niente.

1. Apri Amministrazione → Ciclo di vita app, scheda Pacchetti.

2. Carica pacchetto e scegli upgrade\<prefisso>-1.7.28.wuicpkg della cartella estratta (C:\<Nome>-1.8.0). Se il browser e' su un altro computer, copia prima i due .wuicpkg su quel computer.

3. Calcola il piano, con Rimuovi gli elementi assenti dal pacchetto non spuntato.

4. Se il piano mostra conflitti (sono le tue personalizzazioni): Mantieni tutto il target.

5. Applica.

Il piano tiene la tua installazione com'e' e registra la release <prefisso>-1.7.28, che da qui in poi e' la base del confronto.

6. Applicare la versione nuova

1. Sempre nella scheda Pacchetti: Carica pacchetto e scegli upgrade\<prefisso>-1.8.0.wuicpkg.

2. Calcola il piano, con Rimuovi gli elementi assenti dal pacchetto non spuntato. Sopra l'elenco dei conflitti, Release base deve essere <prefisso>-1.7.28: senza base ogni differenza sarebbe un conflitto.

3. Per ogni elemento in conflitto, Risolvi e scegli: Tutto il target tiene la tua versione, Tutto dalla sorgente prende quella della 1.8.0, Scelta per proprietà decide proprieta' per proprieta'. Poi Applica le scelte e ricalcola il piano.

4. Quando non ci sono piu' conflitti, Applica.

Poi togli i file della 1.7.28 che la 1.8.0 non ha piu' (librerie e file del client vecchi che l'applicazione potrebbe ancora caricare o servire). Si tolgono solo i file elencati in upgrade\removed-files.txt: i tuoi file nella cartella dell'applicazione restano. Si fa qui e non al passo 2 perche' l'adozione della base (passo 5) li rimetterebbe.

Snippet 7PowerShell
Get-Content "$New\upgrade\removed-files.txt" | Where-Object { $_ } | ForEach-Object { $f = Join-Path $App $_; if (Test-Path -LiteralPath $f) { Remove-Item -LiteralPath $f -Force } }

Esempio con FatturazioneElettronica: se avevi cambiato le etichette del dizionario della colonna stato_sdi di fatture_inviate, che la 1.8.0 cambia anche lei, il conflitto e' su quella sola proprieta': con Scelta per proprietà e Target tieni le tue etichette e prendi il resto della route nuova. Un report che avevi modificato e che il fornitore non ha toccato non compare fra i conflitti e resta il tuo; uno modificato da entrambi e' un conflitto sul file intero.

7. Controllare

  • Le liste e i form dell'applicazione si aprono (per esempio, in FatturazioneElettronica, Fatture inviate e una fattura).
  • Le tue personalizzazioni ci sono ancora.
  • Calcola il piano di nuovo con <prefisso>-1.8.0.wuicpkg: non c'e' piu' niente da applicare.

Quando sei soddisfatto puoi cancellare la cartella estratta, la copia e i backup.

Se qualcosa va storto

  • Uno script del DB dati si ferma: il messaggio dice script e blocco. Corretta la causa, rilancia il passo 3; oppure torna alla 1.7.28.
  • L'applicazione dei metadati risponde con un errore: leggi l'esito nella scheda Pacchetti; la pagina Ciclo di vita dei metadati spiega gli esiti dell'apply.
  • Annullare solo i metadati: nella scheda Pacchetti, sulla riga della promozione con stato applicata · <prefisso>-1.8.0, Ripristina riporta i metadati a prima del passo 6. Programma e DB dati restano della 1.8.0.

Tornare alla 1.7.28

Programma, DB dati e DB metadati tornano com'erano al passo 1: tutto cio' che e' stato inserito o cambiato dopo (per esempio fatture ed esiti SDI in FatturazioneElettronica) si perde.

Snippet 8PowerShell
& $appcmd stop site "/site.name:$Site"
& $appcmd stop apppool "/apppool.name:$Pool"
while (Get-CimInstance Win32_Process -Filter "Name='w3wp.exe'" | Where-Object { $_.CommandLine -match [regex]::Escape($Pool) }) { Start-Sleep -Seconds 2 }
robocopy $Copy $App /MIR /NFL /NDL /NP
powershell -ExecutionPolicy Bypass -File "$New\upgrade\Upgrade-Database.ps1" -Action Restore -AppDir $App
& $appcmd start apppool "/apppool.name:$Pool"
& $appcmd start site "/site.name:$Site"

-Action Restore chiude le connessioni aperte e ripristina i due database dai file di -Action Backup.