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 app | Nome ($Name) | Prefisso dei pacchetti |
|---|---|---|
| Fatturazione elettronica | FatturazioneElettronica | fe |
| CRM | CrmApp | crm |
| Flotta mezzi | FlottaMezzi | flotta |
Serve:
- lo zip
<Nome>-iis-v1.8.0-with-dbs.zipdella 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\:
| File | A cosa serve |
|---|---|
Upgrade-Database.ps1 | backup, 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\*.sql | gli 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.wuicpkg | pacchetto dei metadati della 1.7.28 come pubblicata: la base del confronto |
<prefisso>-1.8.0.wuicpkg | pacchetto dei metadati della 1.8.0 |
removed-files.txt | i file del programma della 1.7.28 che la 1.8.0 non ha piu' (si tolgono al passo 6) |
upgrade.json | elenco e ordine degli script, nomi dei pacchetti |
Cosa si sostituisce e cosa si conserva
| Cosa | Come |
|---|---|
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.json | conservato: stringhe di connessione e impostazioni restano le tue, tranne uploadFolder (passo 2) |
Upload, Conservazione, logs, App_Data | conservati |
Reports (report .mrt) | conservati dalla copia dei file; li aggiorna l'applicazione dei metadati (passo 6) |
| DB dati | aggiornato dagli script di upgrade\db-data |
| DB metadati | aggiornato 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.
$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:
& $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
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 /NProbocopy 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.
$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
powershell -ExecutionPolicy Bypass -File "$New\upgrade\Upgrade-Database.ps1" -Action Scripts -AppDir $AppLo 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
& $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.
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.
& $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.