Zálohování a obnovení zálohy souborů

1. Zálohování souborů

• Pro zálohování souborů NET Genia je určen program „FileBackup.exe“, který se nachází v adresáři „Backup“ každé instalace NET Genium.
• Záloha souborů se skládá z následujících částí:
  • zálohování nastavení serveru IIS,
  • zálohování adresáře NET Genia,
  • zálohování souborových příloh.
• Zatímco adresář NET Genia a případný archiv s dalšími soubory jsou zálohovány vždy celé, zálohování souborových příloh probíhá přírůstkově – zálohovány jsou pouze nové nebo změněné soubory.

Použití:

FileBackup.exe [cíl]

• Parametr cíl určuje adresář nebo síťové umístění, do kterého bude záloha provedena.

• Program podporuje také následující nepovinné přepínače:
  • /iisonly – zazálohuje se pouze nastavení serveru IIS; v tomto případě není nutné zadávat parametr cíl (případně je ignorován),
  • /noiis – zazálohuje se pouze adresář NET Genia a souborové přílohy, bez nastavení serveru IIS.

• Speciální režimy spuštění:
  • file.ini – zazálohují se pouze souborové přílohy, jejichž ID je větší než hodnota uvedená v konfiguračním souboru „file.ini“.

• Pokud je potřeba spolu se zálohou adresáře NET Genia a souborových příloh zálohovat také jiné soubory nebo adresáře umístěné mimo adresář NET Genia, lze použít konfigurační soubor „FileBackup.exe.config“. Pokud program „FileBackup.exe“ před zahájením zálohy nalezne v adresáři „Backup“ tento konfigurační soubor, vytvoří ve stejném adresáři archiv „FileBackup.zip“, který bude obsahovat soubory a adresáře definované v konfiguraci. Tento archiv se následně stane součástí zálohy adresáře NET Genia.

Příklad konfiguračního souboru:

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <appSettings>

    <add key="directory" value="C:\Services" />
    <add key="excludedirectory" value="C:\Services\CRMService\POP3Downloads" />
    <add key="excludefile" value="C:\Services\CRMService\*.log" />

  </appSettings>
</configuration>

V konfiguračním souboru lze specifikovat:

• adresáře, které se budou zálohovat – parametry „directory“ nebo „includedirectory“,
• adresáře, které se zálohovat nebudou – parametr „excludedirectory“,
• soubory, které se zálohovat nebudou – parametr „excludefile“.
  • U parametru „excludefile“ je možné používat konstrukci „*.přípona“, která zajistí vyloučení všech souborů s danou příponou.
• Jednotlivé parametry „directory“, „includedirectory“, „excludedirectory“ a „excludefile“ lze v konfiguraci uvést opakovaně.

1.1. Zálohování souborových příloh pomocí konfiguračního souboru „file.ini“

• Pro přírůstkové zálohování souborových příloh NET Genia je určen program „FileBackup.exe“ spuštěný s názvem konfiguračního souboru „file.ini“ jako jediným parametrem.
• Pokud program „FileBackup.exe“ nalezne v adresáři „Backup“ soubor „file.ini“, provede zálohování pouze těch souborových příloh, jejichž ID je větší než hodnota uložená v tomto souboru.
• Pokud soubor „file.ini“ neexistuje, program jej vytvoří a vyzve uživatele k zadání cílového adresáře nebo síťového umístění a počátečního ID souborové přílohy, od kterého má být zálohování zahájeno.
• Po úspěšném dokončení zálohy je hodnota v souboru „file.ini“ aktualizována tak, aby při dalším spuštění byly zálohovány pouze nově vzniklé přílohy.

1.2. Naplánování zálohy souborů

• Pro automatické zálohování souborů je doporučeno vytvořit dávkový soubor, například „BackupFiles.bat“, a uložit jej do adresáře s instalací NET Genia.
• V Plánovači úloh systému Windows je nutné naplánované úloze nastavit pole „Spustit v (volitelné)“ na adresář „…\Backup“, aby program správně nalezl všechny potřebné konfigurační soubory a knihovny.
• Pokud je úloha spouštěna s nejvyššími oprávněními, doporučuje se v dávkovém souboru explicitně nastavit pracovní adresář pomocí příkazu „cd /d“.

Varianta 1: Záloha na mapovaný síťový disk

cd /d C:\inetpub\wwwroot\NETGenium\Backup
if exist Z: goto Z_OK
net use Z: \\NAS-NETGenium\Files PASSWORD /USER:LOGIN
:Z_OK
chcp 1250
FileBackup.exe Z:

• Dávkový soubor nejprve ověří, zda je namapován síťový disk „Z“. Pokud není, provede jeho namapování pomocí příkazu „net use“.
• Pokud je pro přístup do síťového umístění vyžadováno uživatelské jméno a heslo, uvede se místo „LOGIN“ a „PASSWORD“. Pokud autentizace není vyžadována, parametr „/USER“ se neuvádí.

Varianta 2: Přímá záloha do síťového umístění

FileBackup.exe \\NAS-NETGenium\Files

• Při tomto způsobu zálohování se staré soubory nepřepisují – kopírovány jsou pouze nově vytvořené soubory.
• Soubor „0.zip“, který obsahuje archiv adresáře NET Genia, je přepisován při každém spuštění.
• Souborové přílohy, které byly změněny funkcí „REDUCEATTACHMENT“, jsou zálohovány znovu.
• Program „FileBackup.exe“ lze v tomto případě spouštět přímo z Plánovače úloh bez použití dávkového souboru.
• Zálohování souborových příloh je řízeno databázovou tabulkou „sfiles“ a sloupcem „backupdir“, ve kterém je uložena cesta k již provedené záloze. Pokud se cesta zadaná při spuštění shoduje s hodnotou v databázi, záloha daného souboru se neprovede. Tím je zajištěno přírůstkové zálohování pouze nových nebo změněných příloh.
• Po úspěšném provedení zálohy je do databázové tabulky „ng_sluzbawindows“ zalogována služba s názvem „BackupFiles“ s intervalem 1 den.

2. Obnovení zálohy souborů

• Nejprve vytvořte prázdný adresář, do kterého má být NET Genium obnoveno (například „C:\inetpub\wwwroot\NETGenium“).
• Do tohoto adresáře uložte program FileBackup.exe.
• Program spusťte s parametrem určujícím cestu k záloze, například:

FileBackup.exe \\NAS-NETGenium\Files /restore

• Program obnovuje soubory do adresáře, ze kterého je spuštěn.
• Při obnově nedochází k přepisování již existujících souborů v adresáři NET Genia, což umožňuje doplnění chybějících souborů bez ztráty novějších dat.

2.1. Obnovení všech souborů (Restore all files)

• Tato volba obnoví kompletní adresářovou strukturu NET Genia ze zvolené zálohy.
• Po úspěšném obnovení je možné program „FileBackup.exe“ z původně prázdného adresáře smazat a pro případné další obnovy používat program umístěný v adresáři „Backup“.

2.2. Obnovení všech souborů kromě souborových příloh (Restore all files except file attachments)

• Obnova celé struktury včetně souborových příloh může být časově náročná. V krizových situacích je proto možné obnovu rozdělit do dvou fází:
  • v první fázi obnovit adresářovou strukturu NET Genia bez adresáře „Files“, aby bylo možné zprovoznit aplikaci a služby,
  • ve druhé fázi následně obnovit samotné souborové přílohy.
• Po dokončení první fáze platí stejné doporučení jako v kapitole 2.1.

2.3. Obnovení souborových příloh (Restore file attachments only)

• Samostatná obnova souborových příloh je určena zejména pro druhou fázi obnovy po zprovoznění aplikace.

Restore all file attachments

• Program obnoví všechny souborové přílohy ze zálohy, které dosud nebyly obnoveny do adresáře „Files“.

Restore file attachments read from database

• Pro tuto volbu musí být v adresáři „Backup“ k dispozici knihovna „NETGeniumConnection.dll“. Pokud zde není, lze ji zkopírovat z adresáře „bin“.
• Program vyzve uživatele k zadání seznamu databázových tabulek oddělených středníkem. V těchto tabulkách budou vyhledány sloupce typu „File“, „Image“ nebo „RichTextBox“ a souborové přílohy budou obnoveny na základě dotazu „SELECT *“.
• Vzhledem k tomuto způsobu načítání může být obnova z rozsáhlých tabulek časově náročná.

Pokud nastane některá z následujících situací, program zobrazí chybovou hlášku a vyzve uživatele k opětovnému zadání vstupu:

• není nalezena knihovna „NETGeniumConnection.dll“,
• není nalezen soubor „ConnectionString.txt“,
• není nalezena databáze definovaná v souboru „ConnectionString.txt“,
• selže připojení k databázi,
• není nalezena zadaná tabulka,
• tabulka neobsahuje žádný sloupec typu „File“, „Image“ nebo „RichTextBox“,
• v tabulce nejsou nalezeny žádné souborové přílohy.

Po dokončení obnovy je zobrazena statistika počtu nalezených, obnovených a přeskočených souborových příloh.

Restore file attachments [<fromDate>] [<toDate>]

• Uživatel zadá časové rozpětí vytvoření souborových příloh. Obnoveny budou pouze přílohy, které dosud nebyly obnoveny a jejichž datum vytvoření spadá do zadaného rozsahu.
• Položky „fromDate“ a „toDate“ nejsou povinné a lze je kombinovat podle potřeby.
• Do datumových vstupů je možné zadávat také proměnné a funkce NET Genia (např. „ADDDAYS(#today#, -2)“). Pro tento režim je nutná přítomnost knihovny „NETGeniumConnection.dll“ v adresáři „Backup“.

Po dokončení obnovy je zobrazena statistika počtu nalezených, obnovených a přeskočených souborových příloh.

Restore file attachments [<fromId>] [<toId>]

• Uživatel zadá rozsah ID souborových příloh. Obnoveny budou pouze přílohy, které dosud nebyly obnoveny a jejichž ID spadá do zadaného rozsahu.
• Položky „fromId“ a „toId“ nejsou povinné a lze je kombinovat podle potřeby.

Po dokončení obnovy je zobrazena statistika počtu nalezených, obnovených a přeskočených souborových příloh.