Utility

1. Adresář „Backup“

Podrobnější informace o aplikacích uvedených níže jsou popsány v samostatné příručce Zálohování.

1.1. BackupServerService.exe

Služba instalovaná na klientské stanici, určená pro pravidelné stahování záloh provedených na serveru programem „BackupServer.exe“.

1.2. BackupServer.exe

Program spouštěný na serveru ručně nebo naplánovanou úlohou, určený pro zálohování:

• nastavení serveru IIS,
• nastavení naplánovaných úloh,
• databází Firebird a MSSQL a
• adresářů.

Plná záloha (soubor s příponou „-x.zip“) vzniká vždy po uplynutí nastaveného intervalu ve dnech, při nevyplněném intervalu jednou za měsíc; je-li poslední plná záloha větší než 10 GB, vzniká až o víkendu. Mezi plnými zálohami vznikají rozdílové zálohy. Zálohy starší než 8 dnů se mažou při vytvoření plné zálohy, rozdílové zálohy starší než poslední plná záloha i mezi nimi. Před zálohou každé databáze program smaže záznamy statistik používání starší než jeden měsíc.

1.3. FileBackup.exe

Program spouštěný na serveru ručně nebo naplánovanou úlohou, určený pro zálohování:

• nastavení serveru IIS,
• systémových souborů NET Genia a
• souborových příloh.

S přepínačem „/restore“ zálohované soubory také obnovuje a vytváří „log“ soubor v aktuálním pracovním adresáři se seznamem souborů, které byly obnoveny, a které ne. Obnova nikdy nepřepíše soubor, který už na disku existuje.

• Použití: „FileBackup.exe backupdir [/noiis] [/no0zip]“, „FileBackup.exe backupdir /restore“, „FileBackup.exe /iisonly“
• Adresář pro zálohu „backupdir“ je povinný; bez něj program vypíše nápovědu a skončí s návratovým kódem 1.

1.4. SqlBackup.exe

Program pro zálohování a obnovu databází Firebird a MSSQL a pro provádění řady servisních operací s použitím přepínačů.

• Servisní operace jsou vždy prováděny v aktuální databázi definované v souboru „ConnectionString.txt“.
• Zálohování a obnovu databáze popisuje samostatná příručka Zálohování a obnovení zálohy databáze.
• Většina servisních operací zapisuje svůj průběh do textového souboru s příponou „.log“; umístění souboru je uvedeno u jednotlivých přepínačů. Některé soubory jsou s každým spuštěním rozšiřovány, jiné (například „Run.log“, „UnusedFiles.log“ a „UnusedQueries.log“) jsou přepisovány.
• V případě, že je program spuštěn a nejsou mu k příslušnému přepínači specifikovány parametry, které vyžaduje, bude na tyto parametry uživatel dotázán.
• Na velikosti písmen v názvech přepínačů nezáleží. Hodnoty parametrů (například hledaný řetězec u přepínače „/find“) se porovnávají s rozlišením malých a velkých písmen.
• Na dotaz programu zakončený „(Y/N)“ se za souhlas považuje jakákoliv odpověď kromě odpovědi začínající písmenem „N“, tedy i samotné stisknutí klávesy „enter“.

• Přepínače je možné zadat i při spuštění programu „SqlBackup.exe“ bez parametru. Po zobrazení následující obrazovky je potřeba zadat text přepínače, a potvrdit stisknutím klávesy „enter“.

• Do „log“ souborů jsou ukládány informace o zpracovaných záznamech.
• Příklad informace v souboru „log“:

TABLE susers RECORD ID 1
* loginname: Administrator

Znamená, že byl zpracován záznam v tabulce „susers“, který má v této tabulce ID 1. Zpracovávaná hodnota je „Administrator“ ve sloupci „loginname“.

1.4.1. /bandwidth

Program „SqlBackup.exe“ spouštěný s parametrem „/bandwidth“ načte všechny soubory typu „log“ vytvořené protokolováním službou IIS a změří, jak dané NET Genium zatěžuje interní počítačovou síť, ve které je server s NET Geniem umístěn.

• Výsledkem příkazu je výpočet množství dat, které proteče daným NET Geniem po určité době.
• Pro spuštění příkazu „SqlBackup.exe /bandwidth“ je nutné mít zkopírovaný soubor „SqlBackup.exe“ v adresáři, kde se nachází soubory protokolu vytvořené službou IIS.
• Vedle souboru „Bandwidth.txt“, který je po spuštění příkazu vytvořen, je v příkazovém řádku zobrazena sumarizace výsledků.
• Ze sumarizace je možné zjistit například celkový počet bajtů, počet dní a hodin nebo počet bajtů za 24 hodin.
• Pro každé datum je uveden čas, kdy bylo převedeno nejvíce bajtů, kolik bajtů bylo převedeno ve špičce (peak time) a jaká byla šířka pásma ve špičce (bandwidth).

• Použití: „SqlBackup.exe /bandwidth“
  Vytváří soubor „Bandwidth.txt“ umístěný v aktuálním pracovním adresáři

Pro vytváření souborů typu „log“ v IIS je nutné povolit a nastavit „Protokolování“.

Postup zapnutí protokolování v IIS

• Otevřete funkci „Protokolování“
  • „Protokolování“ lze nastavit jak pro celé IIS, tak i pro jednotlivé aplikace běžící v IIS. Funkce „Protokolování“ se otevře v obou zmíněných případech ve střední části okna „Správce internetové informační služby“ v sekci „IIS“ pod tlačítkem „Protokolování“.

• Klikněte na tlačítko „Povolit“
  • Stisknutím tlačítka „Povolit“ se zajistí, že bude podle nastavení docházet k zápisům do souboru protokolu.

Nastavení protokolování

• 1 – nastavte platnost protokolování pro „Web“ jako pro vybranou aplikaci z IIS
• 2 – nastavte formát souboru protokolu. Pro příkaz „SqlBackup.exe /bandwidth“ je nutné vybrat možnost „W3C“. Další možnosti:
  • „IIS“
  • „NCSA“
  • „Vlastní“
• 3 – stiskněte tlačítko „Vybrat pole“. Pouze vybrání možnosti „W3C“ umožní vybrat pole do souboru protokolu. Pro funkčnost příkazu „SqlBackup.exe /bandwidth“ je zapotřebí vybrat pole „Datum (date)“, „Čas (time)“, „Odeslané bajty (sc-bytes)“, „Přijaté bajty (cs-bytes)“.

• 4 – nastavte cestu uložení souboru protokolu. Defaultně je přednastavena cesta „%SystemDrive%\inetpub\logs\LogFiles“
• 5 – nastavte kódování souboru protokolu. Možnosti:
  • UTF – 8
  • ANSI
• 6 – nastavte cílové umístění zapisování událostí protokolu
  • Vedle definovaného souboru protokolu je také možné zapisovat „Protokolování“ do události „Trasování událostí pro Windows“. Pro analýzu spuštěnou příkazem „SqlBackup.exe /bandwidth“ je ovšem nutné vybrat možnost „Pouze soubor protokolu“
• 7 – nastavte metodu, jak bude IIS zapisovat do souboru protokolu. Vybrat možnost „Plán“, u které je možné vybrat z následujících možností:
  • „Hodinově“
  • „Denně“
  • „Týdně“
  • „Měsíčně“

1.4.2. /br

Program „SqlBackup.exe“ spouštěný s parametrem „/br“ provede zazálohování a opětovné obnovení databáze definované v souboru „ConnectionString.txt“. Důvodem této operace je reorganizace databázového souboru, uvolnění nevyužitého prostoru (shrink) a znovuvytvoření všech indexů. Operace je určena pouze pro databáze Firebird; u databází MSSQL program skončí hlášením.

• Po dobu operace je NET Genium deaktivováno souborem „UnderConstruction.txt“ v adresáři „Config“ a před obnovou jsou od databáze odpojeni všichni připojení klienti.
• Pokud operace skončí chybou, soubor „UnderConstruction.txt“ zůstane v adresáři „Config“ a NET Genium zůstane deaktivované, dokud soubor nesmaže správce (například programem „Activate.exe“).
• Soubor se zálohou („.fbk“) zůstává v aktuálním pracovním adresáři.

1.4.3. /datagridsettings

Program „SqlBackup.exe“ spouštěný s parametrem „/datagridsettings“ přepíše nastavení datagridů všech uživatelů portálu podle nastavení datagridů vybraného uživatele. Po spuštění aplikace s příkazem „/datagridsettings“ musí uživatel vyplnit přihlašovací jméno uživatele, podle jehož nastavení datagridu bude přepsáno nastavení datagridu ostatním uživatelům.

Dále si uživatel může vybrat ze dvou druhů profilů, které určují datagridy, u nichž bude nastavení přepsáno:

• „All datagrids“ – bude přepsáno nastavení všech datagridů v portálu
• „Type datagrid ID“ – bude přepsáno nastavení pouze vybraného datagridu

Poté je již uživateli zobrazena zpráva, zda přepsání nastavení datagridů bylo úspěšné. Při přepsání nastavení jednotlivých datagridů jednotlivým uživatelům je vždy přepsáno i výchozí nastavení daného datagridu. Individuální nastavení dotčených datagridů všech uživatelů, včetně filtrů a řazení, je přitom smazáno. Po dokončení program restartuje webovou aplikaci NET Genia.

• Použití: „SqlBackup.exe /datagridsettings [loginname] [dgid]“

1.4.4. /deletedata

Program „SqlBackup.exe“ spouštěný s parametrem „/deletedata“ vymaže obsah všech tabulek editačních formulářů v databázi včetně tabulek historie změn, kromě obsahu tabulek „susers“, „susergroups“, „srightsgroups“, „slayout“ a „sholiday“. Soubory příloh na disku zůstávají.

• Použití: „SqlBackup.exe /deletedata“

1.4.5. /deletelogs

Program „SqlBackup.exe“ spouštěný s parametrem „/deletelogs“ vymaže obsah logovacích tabulek „stables_stats“, „sviewpages_stats“, „squerybuilder_stats“, „sngef_stats“ a „sngscript_stats“, a dále smaže logové soubory na disku – soubory v adresáři „Logs“ pojmenované podle data (například „2026-10-06.log“) a obsah datumových podadresářů „Logs\...\yyyy-mm-dd“.

• Bez parametru „createdbeforeindays“ program obsah logovacích tabulek smaže celý příkazem „TRUNCATE TABLE“, a z disku smaže logové soubory starší než 7 dnů.
• S parametrem „createdbeforeindays“ program smaže z logovacích tabulek záznamy starší než zadaný počet dnů, a z disku smaže logové soubory starší než zadaný počet dnů. Hodnota 0 se chová stejně jako vynechaný parametr.
• Pravidelný úklid logů se nastavuje jako naplánovaná úloha Windows spouštěná jednou denně, například „SqlBackup.exe /deletelogs 42“. Detailní popis naplánovaných úloh je uveden v samostatné příručce Naplánované úlohy.
• Jednorázový úklid databáze, ve které se logy hromadily řadu měsíců, je vhodné provést nejdříve bez parametru – „TRUNCATE TABLE“ na rozdíl od mazání po dnech nezatěžuje transakční log databáze. Teprve poté má smysl nastavit pravidelnou úlohu s parametrem, která pak maže malé denní přírůstky.
• Průběh mazání program zapisuje do souboru „Backup\DeleteLogs.log“.

• Použití: „SqlBackup.exe /deletelogs [createdbeforeindays]“

1.4.6. /dirstats

Program „SqlBackup.exe“ spouštěný s parametrem „/dirstats“ určí celkovou velikost a počet souborů, které vznikly k dnešnímu dni v daném adresáři. Pokud bude příkaz spouštěn bez parametru, tak se velikost a počet souborů vypočte pro aktuální adresář. V případě zadání parametru (cesta do požadovaného adresáře) se velikost a počet souborů spočítá pro zadaný adresář. Samotný report zobrazí vypočtené údaje nejdříve pro celý adresář a poté pro soubory, které vznikly v posledním měsíci.

• Použití: „SqlBackup.exe /dirstats [directory]“

1.4.7. /exportchanges

Program „SqlBackup.exe“ spouštěný s parametrem „/exportchanges“ vyexportuje seznam všech rozdílů v datech mezi aktuální databází definovanou souborem „ConnectionString.txt“ v adresáři „Config“, a mezi druhou databází, jejíž „connection string“ se zadá po spuštění programu „SqlBackup.exe“ s parametrem „/exportchanges“.

1.4.8. /exporttable

Program „SqlBackup.exe“ spouštěný s parametrem „/exporttable“ vyexportuje databázovou strukturu vybrané tabulky a všechna data uložená ve vybrané tabulce. Exportovanou tabulku lze definovat následujícími způsoby:

Vybráním ze seznamu tabulek, které program „SqlBackup.exe“ nalezne v databázi NET Genia (seznam obsahuje i systémové tabulky)

Vložením databázového identifikátoru tabulky

Vložením SQL dotazu

Volbou „All tables“ – vyexportovány jsou všechny tabulky.

U druhé a třetí možnosti je nutné uvést správné identifikátory tabulek, jinak bude při exportu tabulky vrácena chyba. U první, druhé a čtvrté možnosti jsou vyexportovány všechny sloupce a data. U třetí možnosti je možné omezit počet exportovaných sloupců z databázové struktury tabulky i počet exportovaných dat (podmínka SQL dotazu).

• Použití: „SqlBackup.exe /exporttable [name]“
  Vytváří XML soubor v adresáři „Backup“ instalace NET Genia, v jehož názvu je uvedeno datum exportu tabulky a název tabulky (např. „2016-10-31-ng_akce“)

1.4.9. /find

Program „SqlBackup.exe“ spouštěný s parametrem „/find“ vyhledá ve všech textových sloupcích všech uživatelských tabulek řetězec zadaný parametrem. Vyhledávána je přesná shoda hodnoty v daném sloupci se zadaným parametrem, nikoliv podřetězec.

• Použití: „SqlBackup.exe /find value“
  Vytváří soubor „Find.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.10. /findattachment

Program „SqlBackup.exe“ spouštěný s parametrem „/findattachment“ vyhledá použití souborové přílohy zadané parametrem – jejím ID. Příkaz vrátí všechny výskyty (tabulky), ve kterých se hledaná souborová příloha nachází. Vyhledávání je prováděno na následujících místech:

• Sloupec „image“ v tabulce „sappgroups“
• Sloupec „def“ v tabulce „sviewfields“ u ovládacích prvků typu „RichText“
• Sloupec „val“ v tabulce „scolumns“ u ovládacích prvků typu „RichText“
• Sloupec „value“ v tabulce „schat“
• Ve všech uživatelských tabulkách ve sloupcích typu „File“ nebo „Image“, případně ve sloupcích typu „RichTextBox“ pokud uživatel potvrdí, že se má v těchto sloupcích hledat
• Použití: „SqlBackup.exe /findattachment value“
  Vytváří soubor „FindAttachment.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.11. /findselects

Program „SqlBackup.exe“ spouštěný s parametrem „/findselects“ vyhledá SQL dotazy začínající klauzulí „SELECT“ v logových souborech typu „log“ (logování NET Genia na disk) a ve starších souborech typu „csv“ v adresáři zadaném parametrem „directory“ a ve všech jeho podadresářích. Bez parametru prohledává adresář s logy instalace NET Genia, včetně jeho přesměrování.

• Použití: „SqlBackup.exe /findselects [directory]“
  Vytváří soubor „FindSelects.sql“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.12. /findunsafetags

Program „SqlBackup.exe“ spouštěný s parametrem „/findunsafetags“ vyhledá v databázi všechny nebezpečné tagy, které mohly vzniknout napadením databáze například pomocí SQL Injection. Samotné NET Genium je proti SQL Injection zabezpečené, slabým místem ale mohou být webové aplikace napojené na databázi NET Genia.

• Použití: „SqlBackup.exe /findunsafetags“
  Vytváří soubor „FindUnsafeTags.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“ a soubor „FindUnsafeTags_Trash.txt“ v aktuálním pracovním adresáři, kde jsou vypsané všechny nebezpečné tagy

1.4.13. /importtable

Program „SqlBackup.exe“ spouštěný s parametrem „/importtable“ naimportuje do NET Genia obsah databázové tabulky. Importovaná tabulka je vybrána ze seznamu XML souborů, které program „SqlBackup.exe“ nalezne v adresáři „Backup“.

Aplikace „SqlBackup.exe“ dále uživateli zobrazí nabídku, ze které si uživatel vybere, jestli chce vybranou tabulkou rovnou naimportovat nebo nejdříve provést test importu vybrané tabulky. Výsledkem testu je soubor s příponou „.sql“ a se stejným názvem jako název importovaného souboru, který obsahuje seznam všech SQL dotazů nutných pro import obsahu databázové tabulky.

Po vybrání profilu importu se program „SqlBackup.exe“ uživatele dotáže:

• jestli mají být nejdříve smazány všechny záznamy, které jsou nalezeny v databázi v tabulce odpovídající identifikátoru importované tabulky, a pokud ne, tak
  • jestli bude součástí importu alespoň 1 dotaz „INSERT“,
  • jestli bude součástí importu alespoň 1 dotaz „UPDATE“,
  • a pokud bude součástí importu alespoň 1 dotaz „INSERT“, jestli mají být smazány záznamy se stejným ID jako záznamy obsažené v importním XML souboru („DELETE“),
• a jestli mají být před spuštěním importu zakázány všechny indexy umístěné v importované tabulce.

• Použití: „SqlBackup.exe /importtable“++ Vytváří soubor „ImportTable.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.14. /movegroups

Program „SqlBackup.exe“ spouštěný s parametrem „/movegroups“ přečísluje všechny uživatelské skupiny kromě uživatelských skupin „Administrators“ (ID 1) a „Users“ (ID 2). Příkaz přičte k ID uživatelské skupiny číslo zadané v parametru. Do parametru je možné vkládat i záporné hodnoty – přečíslování směrem dolů. Pokud uživatelská skupina má nově vypočtené ID menší nebo rovno 2, příkaz vrátí přerušení a přečíslování není provedeno. Příkaz projde také všechny tabulky s právy, seznam povolených IP adres, seznam veřejných externích funkcí, javascripty (funkce „jsUserInGroup“) a skripty (funkce „USERSINGROUP“, „TEFUIG“ a „TESUIG“), a nastaví v nich nová ID uživatelských skupin. Celé přečíslování probíhá v jedné transakci – pokud skončí chybou, neprovede se žádná změna.

• Použití: „SqlBackup.exe /movegroups number“
  Vytváří soubor „MoveGroups.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.15. /moveyear

Program „SqlBackup.exe“ spouštěný s parametrem „/moveyear“ posune rok ve všech datumových sloupcích všech uživatelských tabulek a dále ve všech textových sloupcích všech uživatelských tabulek, kde je nalezen výskyt datumu. Změna je provedena i v tabulkách historie změn. Změna nebude provedena u tabulek „sholiday“, „sinvalidlogins“, „sstatistics“ a „ssynchro“. Příkaz přičte ke každému datumu počet roků, který je uveden jako parametr. Do parametru je možné vkládat i záporné hodnoty – přečíslování směrem dolů.

• Použití: „SqlBackup.exe /moveyear numberofyears“
  Vytváří soubor „MoveYear.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.16. /readdbffiles

Program „SqlBackup.exe“ spuštěný s parametrem „/readdbffiles“ provede analýzu všech „dbf“ souborů v adresáři, ve kterém je program spuštěn, a pro každý „dbf“ soubor vytvoří detailní report s obsahem „dbf“ souboru.

• Použití: „SqlBackup.exe /readdbffiles [directory]“

1.4.17. /reademlfiles

Program „SqlBackup.exe“ spuštěný s parametrem „/reademlfiles“ provede analýzu všech „eml“ souborů v adresáři, ve kterém je program spuštěn, a pro každý „eml“ soubor vytvoří detailní report s obsahem „eml“ souboru.

• Použití: „SqlBackup.exe /reademlfiles [directory]“

1.4.18. /rebuildindexes

Program „SqlBackup.exe“ spouštěný s parametrem „/rebuildindexes“ defragmentuje všechny indexy, jejichž fragmentace v procentech je vyšší nebo rovna hodnotě parametru „fragmentationthreshold“. Rebuild indexů se doporučuje v případech, kdy je fragmentace indexu vyšší než 30%. U databáze Firebird se parametr „fragmentationthreshold“ neuplatní – program deaktivuje a znovu aktivuje všechny indexy kromě indexů cizích klíčů, a přepínače „/rebuildindexes“ a „/reorganizeindexes“ se proto chovají stejně.

• Použití: „SqlBackup.exe /rebuildindexes fragmentationthreshold“
  Vytváří soubor „RebuildIndexes.log“ v adresáři „Backup“ instalace NET Genia

1.4.19. /remove

Program „SqlBackup.exe“ spouštěný s parametrem „/remove“ vyhledá ve všech textových sloupcích všech uživatelských tabulek řetězec zadaný parametrem, a nahradí ho prázdným řetězcem. K nalezení řetězce není nutná přesná shoda hodnoty v daném sloupci se zadaným parametrem, může se jednat i o podřetězec. Změna je provedena i v tabulkách historie změn, včetně sloupce s přihlašovacím jménem autora změny. Program změnu provede bez dalšího potvrzení.

• Použití: „SqlBackup.exe /remove value“
  Vytváří soubor „Remove.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.20. /removeunsafetags

Program „SqlBackup.exe“ spouštěný s parametrem „/removeunsafetags“ odstraní z databáze všechny nebezpečné tagy, které mohly vzniknout napadením databáze například pomocí SQL Injection. Samotné NET Genium je proti SQL Injection zabezpečené, slabým místem ale mohou být webové aplikace napojené na databázi NET Genia.

• Použití: „SqlBackup.exe /removeunsafetags“
  Vytváří soubor „RemoveUnsafeTags.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.21. /reorganizeindexes

Program „SqlBackup.exe“ spouštěný s parametrem „/reorganizeindexes“ defragmentuje všechny indexy, jejichž fragmentace v procentech je vyšší nebo rovna hodnotě parametru „fragmentationthreshold“. Reorganizace indexů se doporučuje v případech, kdy je fragmentace indexu nižší než 30%. Chování u databáze Firebird je popsáno u přepínače „/rebuildindexes“.

• Použití: „SqlBackup.exe /reorganizeindexes fragmentationthreshold“
  Vytváří soubor „ReorganizeIndexes.log“ v adresáři „Backup“ instalace NET Genia

1.4.22. /replace

Program „SqlBackup.exe“ spouštěný s parametrem „/replace“ vyhledá ve všech textových sloupcích všech uživatelských tabulek řetězec zadaný prvním parametrem, a nahradí ho řetězcem zadaným druhým parametrem. Vyhledávána je přesná shoda hodnoty v daném sloupci se zadaným parametrem. Změna je provedena i v tabulkách historie změn, včetně sloupce s přihlašovacím jménem autora změny. Program změnu provede bez dalšího potvrzení.

• Použití: „SqlBackup.exe /replace oldvalue newvalue“
  Vytváří soubor „Replace.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.23. /resetdatepickers

Program „SqlBackup.exe“ spouštěný s parametrem „/resetdatepickers“ vymaže u všech uživatelů zapamatovanou hodnotu „Od“ filtru časového úseku ve všech datagridech, grafech a dalších ovládacích prvcích, takže se při jejich dalším zobrazení použije výchozí hodnota.

• Použití: „SqlBackup.exe /resetdatepickers“

1.4.24. /rightsgroups

Program „SqlBackup.exe“ spouštěný s parametrem „/rightsgroups“ se pokusí ke každému uživateli v systému na základě jeho definovaných uživatelských skupin přiřadit již existující záznam skupiny oprávnění. Pokud se aplikaci nepodaří nalézt odpovídající záznam skupiny oprávnění, aplikace vytvoří nový záznam skupiny oprávnění. Tato nově vytvořená skupina oprávnění bude mít stejný název a stejné uživatelské skupiny, jako má daný uživatel.

• Použití: „SqlBackup.exe /rightsgroups“

1.4.25. /run

Program „SqlBackup.exe“ spouštěný s parametrem „/run“ provede všechny příkazy uvedené v souboru, který je zadán jako parametr „file“. Typicky se využívá ve spojení s „/unusedfiles“ a „/unusedqueries“ – jako parametr je mu zadán název příslušného souboru.

• Každý řádek souboru je samostatný příkaz; příkazy se provádějí postupně bez transakce, takže příkazy provedené před případnou chybou zůstávají v platnosti.
• Prázdné řádky, řádky začínající znaky „//“ a řádky „GO“ a „COMMIT;“ jsou přeskočeny.
• Řádek ve tvaru „DELETE FILE cesta“ smaže soubor na disku.
• Pokud SQL příkaz skončí chybou, program se zeptá, zda má příkaz zopakovat.

• Použití: „SqlBackup.exe /run file“
  Vytváří soubor „Run.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“; soubor je s každým spuštěním přepsán

Parametr „file“ může být i logový soubor, ve kterém jsou uvedeny příkazy „SELECT“. Všechny tyto příkazy budou opětovně spuštěny, a do výstupního souboru „Run.log“ bude zaznamenán jak řádek z původního souboru, tak výsledek lokálního spuštění dotazu – čas vyhodnocení SQL dotazu a počet vrácených záznamů.

• Parametr „file“ může být zadán jako:
• Samotný název souboru (umístěný ve stejném adresáři jako program „SqlBackup.exe“)
• Relativní cesta k souboru na disku (relativní vzhledem k adresáři programu „SqlBackup.exe“, nikoliv k aktuálnímu pracovnímu adresáři)
• Absolutní cesta k souboru na disku

1.4.26. /sysfind

Program „SqlBackup.exe“ spouštěný s parametrem „/sysfind“ vyhledá ve všech textových sloupcích všech systémových i uživatelských tabulek řetězec zadaný parametrem. K nalezení řetězce není nutná přesná shoda hodnoty v daném sloupci se zadaným parametrem, může se jednat i o podřetězec.

• Použití: „SqlBackup.exe /sysfind value“
  Vytváří soubor „SysFind.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.27. /sysreplace

Program „SqlBackup.exe“ spouštěný s parametrem „/sysreplace“ vyhledá ve všech textových sloupcích všech systémových i uživatelských tabulek řetězec zadaný prvním parametrem, a nahradí ho řetězcem zadaným druhým parametrem. K nalezení řetězce není nutná přesná shoda hodnoty v daném sloupci se zadaným parametrem, může se jednat i o podřetězec.

• Použití: „SqlBackup.exe /sysreplace oldvalue newvalue“
  Vytváří soubor „SysReplace.log“ umístěný ve stejném adresáři jako program „SqlBackup.exe“

1.4.28. /unusedfiles

Program „SqlBackup.exe“ spouštěný s parametrem „/unusedfiles“ vyhledá:

• Osamocené soubory ve složce „Files“, na které neexistuje odkaz v databázové tabulce „sfiles“ – sekce STANDALONE UNUSED FILES.
• Databázové záznamy v tabulce „sfiles“ a k nim příslušné soubory ve složce „Files“, na které neodkazuje žádné z kontrolovaných míst – sekce UNUSED FILES. Kontrolují se ovládací prvky typu „File“, „Image“ a „RichTextBox“, obrázky vložené do prvků „RichText“, obrázky na pozadí aplikačních skupin, interní zprávy a rozpracované nahrávání souborů. Odkazy z jiných míst (například z externích funkcí nebo z tiskových šablon) program nezná.
• Neplatné reference v uživatelských tabulkách, které se odkazují na neexistující databázové záznamy v tabulce „sfiles“ – sekce MISSING ENTRIES IN 'SFILES' TABLE.
• Databázové záznamy v tabulce „sfiles“, jejichž soubory na disku fyzicky neexistují – sekce MISSING FILES IN 'NETGENIUM/FILES' DIRECTORY.

Výstupní soubor „UnusedFiles.log“ je návrh ke kontrole, nikoli hotový skript ke spuštění naslepo. Řádky uvozené znaky „//“ jsou zakomentované – příkaz „SqlBackup.exe /run UnusedFiles.log“ je přeskočí a provede pouze odkomentované řádky. Administrátor si tak výstup projde a odkomentuje jen to, co opravdu chce provést. Zakomentování má dva důvody:

• Ochrana posledních přibližně 1000 příloh (sekce UNUSED FILES) – databázové záznamy tabulky „sfiles“ s nejvyšším ID (posledních cca 1000 podle hodnoty „MAX(ID)“ uvedené v hlavičce sekce) se vypisují zakomentované. Přílohu totiž mohla právě vytvářet služba nebo externí funkce: soubor je již nahraný a záznam v tabulce „sfiles“ existuje, ale nadřazený záznam, který se na přílohu odkazuje, se do databáze ještě neuložil. Kdyby analýza běžela právě v tomto okamžiku, vyhodnotila by takovou přílohu jako nepoužitou a její smazání by nedokončenému procesu přílohu „uříznulo“. Nejnovější přílohy se proto nikdy nemažou automaticky – pouze se nabídnou k ruční kontrole.
• Neplatné reference v živých tabulkách (sekce MISSING ENTRIES IN 'SFILES' TABLE a MISSING FILES IN 'NETGENIUM/FILES' DIRECTORY) – příkaz „UPDATE“, který vyprázdní neplatný odkaz na neexistující přílohu, je u běžných (živých) tabulek zakomentovaný, protože jde o zásah do produkčních dat, který je nutné posoudit ručně. Aktivní (odkomentovaný) je pouze u historických tabulek s příponou „_history“.

Kromě logového souboru může program „SqlBackup.exe“ (spouštěný s parametrem „/unusedfiles“) také vytvořit v adresáři „Backup“ adresář „UnusedFiles“, kde se budou ukládat kopie nalezených souborů ze sekcí STANDALONE UNUSED FILES a UNUSED FILES. Pro spuštění této funkce je třeba uvést volitelný parametr „copyfiles“ („SqlBackup.exe /unusedfiles /copyfiles“).

• Použití: „SqlBackup.exe /unusedfiles“ a následně „SqlBackup.exe /run UnusedFiles.log“
  Vytváří soubor „UnusedFiles.log“ v adresáři „Backup“ instalace NET Genia; soubor je s každým spuštěním přepsán
• Ochrana nejnovějších příloh se týká jen sekce UNUSED FILES. Příkazy „DELETE FILE“ v sekci STANDALONE UNUSED FILES jsou aktivní vždy.
• Příklad obsahu:

// STANDALONE UNUSED FILES

DELETE FILE 0.zip


// UNUSED FILES

// mail-ico-facebook.gif
DELETE FROM sfiles WHERE id = 19596
DELETE FILE 19596.gif


// MISSING ENTRIES IN 'SFILES' TABLE

// SELECT ng_komentar FROM ng_ukol WHERE id = 2831


// MISSING FILES IN 'NETGENIUM/FILES' DIRECTORY

// SELECT ng_priloha1 FROM ng_crmdokument_history WHERE id = 499 // 22-7 Nabídka

1.4.29. /unusedqueries

Program „SqlBackup.exe“ spouštěný s parametrem „/unusedqueries“ vyhledá všechny nepoužívané SQL dotazy uložené v tabulce „squerybuilder“ a pro každý z nich vygeneruje příkazy, které smažou dotaz i jeho podmínky, spojení, sloupce, záhlaví a barvy. Pro smazání nepoužívaných SQL dotazů je nutné zavolat příkaz „SqlBackup.exe /run file“, kde jako parametr bude vložen vytvořený logový soubor „UnusedQueries.log“.

• Za používaný se považuje dotaz navázaný na ovládací prvek editačního formuláře nebo nahlížecí stránky, na výběrový dialog nebo na krok skriptu, dále vnořený dotaz podmínky „IN“ v libovolné hloubce, dotaz podmínky ovládacího prvku a dotaz uložený jako šablona dotazu.
• Výstupní soubor je návrh ke kontrole – před spuštěním příkazem „/run“ je vhodné ho projít.

• Použití: „SqlBackup.exe /unusedqueries“ a následně „SqlBackup.exe /run UnusedQueries.log“
  Vytváří soubor „UnusedQueries.log“ v adresáři „Backup“ instalace NET Genia; soubor je s každým spuštěním přepsán

1.4.30. /unusedscripts

Program „SqlBackup.exe“ spouštěný s parametrem „/unusedscripts“ smaže z tabulky „sngscript“ všechny kroky skriptů, které nepatří žádnému editačnímu formuláři ani tlačítku. Mazání proběhne okamžitě, bez dalšího potvrzení a bez logového souboru.

• Použití: „SqlBackup.exe /unusedscripts“

1.4.31. /export

Program „SqlBackup.exe“ spouštěný s parametrem „/export“ (zkráceně „/e“) vyexportuje aktuální databázi do archivu ZIP v adresáři „Backup“. Exportují se systémové tabulky a tabulky všech editačních formulářů včetně tabulek historie změn. Po spuštění program nabídne profil exportu:

• „1) Database“ – data všech tabulek.
• „2) Database and file attachments“ – data všech tabulek a celý adresář „Files“ se souborovými přílohami.
• „1b)“ a „2b)“ – stejné jako profily 1 a 2, ale tabulky s více než 10 000 záznamy se místo do archivu uloží do samostatných XML souborů vedle archivu.
• „3) Database structure (merge)“ – struktura aplikací určená ke sloučení s jinou instalací NET Genia parametrem „/import“. Systémové tabulky (model portálu, uživatelská nastavení) se exportují i s daty, tabulky editačních formulářů jen jako prázdná struktura. Ze souborových příloh se přibalí jen soubory vložené do prvků „RichText“. Tabulky s nastavením instance a provozními daty (nastavení NET Genia, povolené IP adresy, MCP tokeny, přihlášení uživatelé, členství v uživatelských skupinách, statistiky používání a nastavení synchronizace) se neexportují.
• Profil 3 před exportem trvale smaže z tabulek „scolumns_history“, „sviewfields_history“ a „sngscript_history“ nadbytečné záznamy – z po sobě jdoucích změn téhož prvku, resp. skriptu provedených jedním uživatelem v jeden den zůstane jen poslední.
• Liší-li se u profilu 3 verze databáze od verze NET Genia, program se dotáže, zda má pokračovat.
• Součástí archivu je vždy adresář „Templates“. Archiv se stejným názvem se přepíše.
• Soubory větší než 1 GB se do archivu nevkládají – přílohy nad 1 GB se přeskočí a soubor s daty této velikosti zůstane v adresáři „Backup“ vedle archivu.

• Použití: „SqlBackup.exe /export [profil]“
  Vytváří soubor „yyyy-mm-dd-název_databáze.zip“ v adresáři „Backup“. Je-li profil (1, 2 nebo 3) zadán parametrem, nabídka se nezobrazí, název souboru neobsahuje datum a program po dokončení nečeká na stisknutí klávesy „enter“

1.4.32. /import

Program „SqlBackup.exe“ spouštěný s parametrem „/import“ (zkráceně „/i“) naimportuje do aktuální databáze archiv vytvořený parametrem „/export“. Archiv se vybírá ze seznamu souborů ZIP v adresáři „Backup“; XML soubory velkých tabulek uložené vedle archivu se načtou automaticky. Program nabídne profil importu:

• „Database“ – smaže v aktuální databázi všechny tabulky NET Genia a vytvoří je znovu s daty z archivu. Souborové přílohy se nepřenášejí.
• „Database and file attachments“ – navíc smaže všechny soubory v adresáři „Files“ a nahradí je přílohami z archivu.
• „Database structure (merge)“ – převezme z archivu strukturu aplikací (model portálu) a zachová data aktuální databáze. Tabulky editačních formulářů, které existují v obou verzích, zůstanou i s daty a jen se jim upraví struktura; tabulky, které archiv neobsahuje, se smažou (jejich data se předtím uloží do adresáře „Temp“). Beze změny zůstane nastavení NET Genia, povolené IP adresy, MCP tokeny, členství v uživatelských skupinách a statistiky používání; nastavení synchronizace se zachová z aktuální databáze.
• „Database structure (merge test)“ – zkušební sloučení: příkazy měnící databázi se neprovedou, ale zapíšou se do souboru „Backup\SqlBackup.sql“; rozdíly ve struktuře tabulek se vypíšou do souboru „Backup\SqlBackup.htm“.

Při sloučení se program dále dotáže, co s uživatelskými nastaveními (portlety, oblíbené položky, nastavení nahlížecích tabulek, filtry):

• „User settings from old version“ – zachovají se nastavení z aktuální databáze; předpokladem je, že všechny ovládací prvky existují v archivu se stejným ID.
• „User settings from new version“ – převezmou se nastavení z archivu; předpokladem je, že všichni uživatelé existují v aktuální databázi se stejným ID.
• „Delete user settings“ – nastavení se smažou. Zachovají se jen portlety, oblíbené položky a nastavení hlavní stránky uživatelů s ID 1 a 2 a šablony filtrů uživatele Administrator (ID 1), a to ve verzi z archivu.

Další chování:

• Obsahuje-li adresář „Templates“ tiskové šablony, program se dotáže, zda ponechat šablony aktuální instalace („Templates from old version“), nebo převzít šablony z archivu („Templates from new version“).
• Liší-li se při sloučení verze NET Genia v archivu a v aktuální databázi, program se dotáže, zda má pokračovat.
• Je-li při sloučení v adresáři „Backup“ soubor „ngef.dll“, spustí se před sloučením externí funkce „NETGenium.MergeDatabase“.
• Po dobu importu je NET Genium deaktivováno souborem „UnderConstruction.txt“ v adresáři „Config“; po úspěšném dokončení se program dotáže na jeho smazání. Na závěr importu se webová aplikace restartuje.

• Použití: „SqlBackup.exe /import“
  Vytváří soubor „SqlBackup.log“ v adresáři „Backup“

1.4.33. /import2

Program „SqlBackup.exe“ spouštěný s parametrem „/import2“ (zkráceně „/i2“) sloučí strukturu aplikací z archivu v adresáři „Backup“ do vzdálené instalace NET Genia, ke které se připojí přes webové služby na adrese „url“ pod účtem „loginname“ s heslem „password“.

• Nabízí jen profily „Database structure (merge)“ a „Database structure (merge test)“ a stejné volby uživatelských nastavení jako parametr „/import“.
• Struktura systémových tabulek vzdálené instalace musí odpovídat verzi programu „SqlBackup.exe“; jinak import skončí chybou „Different version of NET Genium on the remote server!“ a je nutné nejdříve aktualizovat NET Genium na vzdáleném serveru.
• Na rozdíl od parametru „/import“ se nepřenášejí tiskové šablony, nespouští se externí funkce „NETGenium.MergeDatabase“ a vzdálené NET Genium se nedeaktivuje ani nerestartuje. Po dokončení se vymaže cache vzdálené instalace.
• Připojení přes webové služby čerpá licenci a vyžaduje uživatele s administrátorským oprávněním.
• Bez parametrů „url“ a „loginname“ program skončí bez hlášení; z nabídky příkazů ho proto použít nelze.

• Použití: „SqlBackup.exe /import2 url loginname password“
  Vytváří soubor „SqlBackup.log“ v adresáři „Backup“

1.4.34. /importtasks

Program „SqlBackup.exe“ spouštěný s parametrem „/importtasks“ naimportuje do Plánovače úloh Windows naplánované úlohy NET Genia ze souboru XML, který vzniká při zálohování serveru.

• Importují se jen úlohy ve složce „NETGenium“ nebo „NET Genium“ Plánovače úloh (včetně jejích podsložek); ostatní úlohy se přeskočí.
• Každá úloha se nastaví ke spouštění pod účtem „SYSTEM“ s nejvyššími oprávněními bez ohledu na účet uvedený v souboru.
• Existující úloha se stejným názvem se přepíše.
• Na závěr program vypíše počet naimportovaných, přeskočených a chybných úloh.

• Použití: „SqlBackup.exe /importtasks [scheduledtasks.xml]“
  Není-li soubor zadán, použije se soubor „scheduledtasks.xml“ v aktuálním pracovním adresáři

1.4.35. /importxml

Program „SqlBackup.exe“ spouštěný s parametrem „/importxml“ naimportuje do existující tabulky aktuální databáze záznamy z XML souboru zadaného parametrem „file“, který musí ležet v adresáři „Backup“. Typicky ho spouští parametr „/import“ pro velké tabulky.

• Identifikátor tabulky se odvodí z názvu souboru; obsahuje-li název pomlčky (např. „2026-10-06-databaze-ng_tabulka.xml“), použije se část za poslední pomlčkou.
• Záznamy se do tabulky jen vkládají; existující záznamy se nemažou.
• Průběh se ukládá do souboru s příponou „.ini“ vedle XML souboru; přerušený import po opětovném spuštění pokračuje za naposledy naimportovaným záznamem.
• Po úspěšném importu se XML soubor smaže, ale jen tehdy, když jeho název neobsahuje pomlčku.
• Příkaz není v nabídce příkazů a lze ho spustit jen s parametrem.

• Použití: „SqlBackup.exe /importxml file“

1.4.36. /loginstats

Program „SqlBackup.exe“ spouštěný s parametrem „/loginstats“ projde soubory v adresáři zadaném parametrem „directory“ (typicky adresář „Logs“) a vypíše z nich řádky o přihlášení uživatelů. Program nabídne dva profily:

• „Valid logins with username and password“ – úspěšná přihlášení jménem a heslem.
• „Invalid logins“ – neúspěšné pokusy o přihlášení.
• Není-li adresář zadán, prohledá se aktuální pracovní adresář. Je-li jím adresář „Backup“ a vedle něj existuje adresář „Logs“, program nabídne výběr mezi nimi.
• Prohledávají se všechny soubory v adresáři bez ohledu na příponu, bez podadresářů.

• Použití: „SqlBackup.exe /loginstats [directory]“
  Vytváří soubor „loginstats.log“ v aktuálním pracovním adresáři; soubor je s každým spuštěním přepsán

1.4.37. /updatearchive

Program „SqlBackup.exe“ spouštěný s parametrem „/updatearchive“ archivuje vybrané záznamy a souborové přílohy do adresáře „Archive“ instalace NET Genia (jiné umístění lze zadat cestou uloženou v souboru „Archive\Archive“). Které záznamy se archivují, určuje soubor „Config\UpdateArchive.txt“:

• Řádek ve tvaru „SELECT * FROM tabulka [WHERE ...]“ určuje archivované záznamy jedné tabulky. Dotaz s podmínkou „WHERE“ záznamy přesouvá (MOVE), dotaz bez ní je kopíruje (COPY); režim lze určit i předponou „COPY:“ nebo „MOVE:“. Ostatní řádky definují cizí klíče, řádky začínající „//“ jsou komentáře.
• Související tabulky (rodičovské, odkazující a stromové vazby) program dohledá sám a z výběru opakovaně vyřazuje záznamy, jejichž vazba vede na záznam mimo výběr.

Program nabídne profily:

• „Analyze tables“ a „Analyze tables and file attachments“ – jen analýza: počty záznamů, případně velikost příloh, se vypíšou do logu.
• „Copy tables to ...“ – uloží data tabulek včetně historie změn do XML souborů v adresáři „Archive“, včetně seznamu příloh; databáze ani soubory příloh se nemění.
• „Move tables and file attachments to ...“ – uloží tabulky jako předchozí profil a zkopíruje přílohy do adresáře „Archive\Files“. Záznamy v režimu MOVE pak smaže z tabulek, z jejich historie i z tabulky „sfiles“ a jejich přílohy smaže z adresáře příloh. Příkazy „DELETE“ lze provést hned, nebo je zapsat do souboru „Backup\UpdateArchive.sql“ a spustit později parametrem „/run“.
• „Import tables from ...“ – naimportuje do aktuální databáze všechny XML soubory z adresáře „Archive“ a úspěšně naimportované soubory smaže. Tabulky „susers“, „susers_rights“, „susergroups“, „srightsgroups“ a „srightsgroups_rights“ se před importem celé vyprázdní, v ostatních tabulkách se přepíší záznamy se stejným ID.
• „Move file attachments from ... to ...“ – přesune přílohy z adresáře „Archive\Files“ zpět do adresáře příloh. Soubor, který v cíli už existuje, se nepřepíše.
• „Track record“ – analýza se sledováním jednoho záznamu zadané tabulky; do logu vypíše, proč byl záznam do výběru zahrnut, nebo z něj vyřazen.
• Profily kopírování a přesunu vyžadují, aby adresář „Archive“ neobsahoval žádné soubory.

• Použití: „SqlBackup.exe /updatearchive“
  Vytváří soubor „UpdateArchive.log“ v adresáři „Backup“

2. Adresář „bin“

2.1. ApplicationManager.exe

Program určený pro provedení importu a exportu aplikací a aplikačních skupin z a do NET Genia. Export je prováděn do šifrovaného souboru „nga“ (aplikace) nebo „ngg“ (aplikační skupiny), který může nabývat velkých rozměrů (i několik GB) v závislosti na velikosti aplikace a množství uživatelských dat. „ApplicationManager.exe“ slouží k provedení exportu nebo importu právě těchto velkých aplikací – kdyby byl export nebo import prováděn z webového rozhraní NET Genia, mohlo by se stát, že webový server IIS takový soubor nedokáže přijmout (uploadovat), případně následně zpracovat resp aplikaci naimportovat. Z tohoto důvodu je mnohem efektivnější využít aplikaci „ApplicationManager.exe“.

• Program nabízí stejné volby jako import a export v NET Geniu – data, přílohy, vlastnictví dat, historii záznamů, práva a vazby na jiné aplikace. Detailní popis je uveden v samostatné příručce Import a export aplikací.
• Program se k databázi připojuje přímo, bez přihlášení, a pracuje s oprávněními uživatele Administrator (ID 1). Spouštět ho proto smí jen správce serveru.

2.2. FileUpload.exe

Program je umístěný v adresáři „Config\Tools“ a program „FinishUpdate.exe“ ho při každé aktualizaci kopíruje do systémového adresáře Windows.

Program určený pro pravidelné nahrávání jednotlivých souborů nebo celých adresářů na vzdálený server, na kterém je nainstalováno NET Genium s aplikací „FileUpload“. Tato aplikace se skládá z rozhraní pro přenos souborů (toto rozhraní je standardní součástí každého NET Genia), a dále z editačního formuláře „Dokument FileUpload“ a nahlížecí stránky „Dokumenty FileUpload“. Editační formulář ani nahlížecí stránka nejsou standardní součástí NET Genia, a proto je potřeba je nejdříve naimportovat. K tomuto účelu je v adresáři „Install“ připraven soubor „FileUpload.nga“, který je možné naimportovat do libovolné aplikační skupiny jako běžnou aplikaci.

Každý jednotlivý soubor nebo celý adresář nahrávaný na server musí mít vytvořen samostatný profil v NET Geniu – záznam v tabulce „Dokument FileUpload“. Součástí tohoto profilu je název přenášeného souboru a heslo k jeho přenosu. Celé adresáře na server přenášíme tím způsobem, že je nejdříve zabalíme do „zip“ archivu, a ten následně přeneseme na server – samozřejmě pokud má vytvořen příslušný profil, a je u tohoto profilu zvoleno že má být soubor po přenosu na server rozbalen.

Spustíme-li program „FileUpload.exe“ v libovolném adresáři na disku, dojde k porovnání obsahu aktuálního adresáře se všemi profily definovanými v tabulce „Dokument FileUpload“, a následně budeme vyzváni k potvrzení přenosu těch souborů, které mají podle svého názvu vytvořen příslušný profil v NET Geniu.

Program „FileUpload.exe“ vyžaduje při každém spuštění URL vzdáleného NET Genia a heslo pro přenos souborů.

Tyto dva parametry je možné programu předat třemi způsoby:

• voláním programu „FileUpload.exe“ se dvěma parametry „URL“ a „Password“, které jsou mezi sebou odděleny mezerou (i heslo samotné může obsahovat mezery),
  např. „FileUpload.exe https://www.netgenium.com/netgenium heslo pro přenos“
• vytvořením textového souboru „FileUpload.ini“ v kořenovém adresáři některého z disků „C:“ až „Z:“, který na první řádce obsahuje URL vzdáleného NET Genia, a na druhé řádce heslo pro přenos (použije se první nalezený soubor v abecedním pořadí disků),
• ručním zadáním URL a hesla pro přenos přímo ve spuštěném programu „FileUpload.exe“ (což je při častém spuštění programu velmi nepraktické).

Program „FileUpload.exe“ umí zabalit celý adresář do „zip“ archivu pomocí parametru „-Z“, za kterým následuje název archivu bez mezery za „-Z“ a také bez přípony „.zip“ na konci. Program „FileUpload.exe“ podle aktuálního pracovního adresáře zabalí jeden z následujících adresářů:

• celý nadřazený adresář, pokud se nacházíme v adresáři „bin“ nebo
• pouze adresář, ve kterém se nacházíme, pokud se nejedná o adresář „bin“.

Program „FileUpload.exe“ umí také automaticky smazat všechny soubory, které se úspěšně nahrály na server.

Pro zapnutí této funkce je třeba zvolit parametr „/D“. V kombinaci s parametrem „-Z“ program smaže všechny zdrojové soubory, které byly do archivu zabaleny.

• Příklady:

FileUpload.exe https://www.netgenium.com/netgenium heslo pro přenos
FileUpload.exe/Znazevarchivu https://www.netgenium.com/netgenium heslo pro přenos
FileUpload.exe/Znazevarchivu

2.3. LogService.exe

Program určený pro logování úspěšně provedených programů/služeb do databázové tabulky „ng_sluzbawindows“. Program má využití převážně při naplánovaném spouštění dávkových souborů pomocí naplánovaných úloh systému Windows. Název služby je definován parametrem „ServiceName“ – pod tímto názvem se služba zaloguje do databáze. Výchozí interval, po jehož uplynutí by se měla služba opět spustit je nastavena parametrem „IntervalInMinutes“. Do volitelného parametru „ErrorLevel“ je možné předat textový řetězec „%errorlevel%“, což je proměnná dostupná v libovolném „bat“ souboru, a která vrací aktuální chybový kód. Pokud „LogService.exe“ zjistí, že tento kód je cokoliv jiného než 0, službu nezaloguje.

• Použití:

LogService.exe ServiceName IntervalInMinutes [ErrorLevel]

• Příklad „bat“ souboru:

xcopy /D /H /E "D:\inetpub\wwwroot\netgenium" \\NAS-NETGenium\Files
LogService.exe BackupFiles 1440 %errorlevel%

2.4. OnlineUsers.exe

Program určený pro vyhodnocení počtu přihlášených uživatelů ve všech databázích NET Genia na daném serveru (ve všech databázích Firebird a ve všech instancích MSSQL). U každé databáze vypíše počet přihlášení, která čerpají licenci, a čas poslední aktivity.

• Vytváří soubor „OnlineUsers.log“ v adresáři „Logs“, pokud je program spuštěn z adresáře „bin“, jinak v aktuálním pracovním adresáři, a zároveň tento soubor otevírá

2.5. PrintPdf.exe

Program určený pro tisk záznamu do tiskové šablony PDF. Program přijímá parametry „Button ID“ (ID tlačítka umístěného v editačním formuláři) a „Record ID“ (ID záznamu v databázi).

• Program zpracuje pouze tiskové šablony ve formátu „pdf“; šablonu vyplní externí funkcí „NETGenium.OnAfterPrint“.
• Výsledný soubor „PrintPdf.pdf“ vytvoří v aktuálním pracovním adresáři a rovnou ho otevře.
• Program práva k záznamu nevyhodnocuje.

2.6. ResendEmlFiles.exe

Program určený pro vyhledání všech „eml“ souborů v adresáři „SMTP“, a jejich následné odeslání pomocí SMTP serveru. E-maily se do tohoto adresáře ukládají automaticky, pokud byl zaznamenán jakýkoliv problém s jejich odesláním z prostředí NET Genia např. z důvodu velkého vytížení SMTP serveru nebo špatné konektivitě.

• Po úspěšném odeslání e-mailu je příslušný „eml“ soubor z adresáře „SMTP“ vymazán.
• Pokud se e-mail(y) opět nepodaří programem „ResendEmlFiles.exe“ odeslat, zůstanou nezměněné nadále v adresáři „SMTP“, a správci portálu je zaslán e-mail se seznamem souborů, které se v daném běhu nepodařilo odeslat. E-mail odchází při každém běhu programu, a to jen tehdy, je-li v nastavení NET Genia vyplněná platná e-mailová adresa správce; zprávy bez odesílatele nebo bez příjemců ani zprávy, jejichž odesílání už program vzdal, se do něj neuvádějí.
• Zprávu program odesílá beze změny obsahu, jen z ní vypustí hlavičky obálky „X-Sender“ a „X-Receiver“; příjemce bere z hlavičky „X-Receiver“, protože jen ta nese i adresy ze skryté kopie.
• Každá zpráva se odesílá nejdříve přes SMTP server 1 a při jeho selhání přes SMTP server 2. Není-li nastavený žádný SMTP server, program zprávy neodesílá.
• Odeslání jedné zprávy se zkouší nejvýše 48krát bez ohledu na to, jakou chybou jednotlivé pokusy skončí; u trvalých chyb (například neplatný příjemce) jen jednou. Evidence pokusů je v souboru „ResendEmlFiles.errors“ v adresáři „SMTP“.
• Neodeslané zprávy z uplynulých let program zabalí do archivů ZIP v adresáři „SMTP“ (zvlášť zprávy s chybou, bez odesílatele, bez příjemců a příliš velké) a původní soubory smaže. Balí jen zprávy, jejichž odesílání už vzdal, a zprávy bez odesílatele nebo příjemců, a to až za rok, který skončil před více než měsícem; existuje-li archiv daného roku už, soubory ponechá.

Program „ResendEmlFiles.exe“ je běžné spouštět jako naplánovanou úlohu systému Windows. Naplánovanou úlohu je možné vytvořit buď ručně, nebo automaticky pomocí programu „Setup.exe“, případně spuštěním programu „ResendEmlFiles.exe“ s parametrem „-task“.

Program „ResendEmlFiles.exe“ umožňuje také vyhledat a odeslat všechny „eml“ soubory ze všech NET Genií, které se nacházejí na daném serveru. V rámci opětovného odeslání emailových zpráv je možné poslat „eml“ soubory ze všech NET Genií najednou nebo pouze z vybraných NET Genií. Definice, z kterých NET Genií budou znovu odeslány „eml“ soubory, je uvedena v konfiguračním souboru „ResendEmlFiles.exe.config“, který je umístěn ve stejném adresáři jako „ResendEmlFiles.exe“.

<configuration>
 <appSettings>

   <add key="ngdirs" value="D:\inetpub\wwwroot"/>
   <add key="ngdir" value="E:\inetpub\wwwroot\netgenium1" />
   <add key="ngdir" value="E:\inetpub\wwwroot\netgenium2" />

  </appSettings>
</configuration>

Parametr „ngdirs“ specifikuje adresář na disku, ve kterém je uloženo více NET Genií. Program „ResendEmlFiles.exe“ najde v tomto adresáři všechna NET Genia, a z nich se pokusí znovu odeslat všechny „eml“ soubory z adresáře „SMTP“. Vyjma těch, která mají v adresáři „Config“ umístěný soubor „SkipResendEmlFiles.txt“ (na jeho obsahu nezáleží).

Parametr „ngdir“ specifikuje adresář na disku, ve kterém je uloženo jedno konkrétní NET Genium, z jehož adresáře „SMTP“ se program „ResendEmlFiles.exe“ pokusí znovu odeslat všechny emailové zprávy.

Program „ResendEmlFiles.exe“ je potřeba spolu s dalšími vyžadovanými soubory umístit do samostatného adresáře na disku, např. do adresáře „D:\ResendEmlFiles“. Nutnou součástí adresáře „ResendEmlFiles“ pro správnou funkčnost opětovného odeslání „eml“ souborů z více NET Genií jsou následující soubory:

• „ResendEmlFiles.exe“,
• „ResendEmlFiles.exe.config“ a
• „NETGeniumConnection.dll“.

Program v tomto režimu spustí u každého nalezeného NET Genia jeho vlastní program „bin\ResendEmlFiles.exe“ a do denního logového souboru v adresáři „Logs“ vedle programu zapíše seznam všech zpracovaných NET Genií.

• Pokud program daného NET Genia doběhl, je v logovém souboru u cesty k danému NET Geniu uvedeno „OK“. Výsledek odeslání jednotlivých zpráv je v logu daného NET Genia.
• Pokud bylo dané NET Genium vyhledáno díky parametru „ngdirs“ a zároveň obsahuje v adresáři „Config“ soubor „SkipResendEmlFiles.txt“, je v logovém souboru u cesty k danému NET Geniu uvedeno „SKIP“.

2.7. Restart.exe

Program určený pro restart NET Genia. Toho je docíleno vytvořením nebo smazáním souboru „Restart.txt“ v adresáři „bin“ – je využíváno vlastnosti služby IIS, že jakákoliv změna obsahu adresáře „bin“ má za následek restart webové aplikace.

• Program pracuje se souborem „Restart.txt“ v aktuálním pracovním adresáři. Musí se proto spouštět z adresáře „bin“; v naplánované úloze je nutné vyplnit pole „Spustit v (volitelné)“ cestou k adresáři „bin“.
• S parametrem „/J“ program po dokončení nečeká na stisknutí klávesy.

2.8. RunningQueries.exe

Program určený pro vyhodnocení seznamu aktuálně zpracovávaných databázových dotazů ve všech databázích NET Genia na daném serveru. Vypíše běžící databázové dotazy, běžící skripty, aktivní připojení k databázi a navržené příkazy pro ukončení dlouho běžících dotazů; sám žádný dotaz neukončuje.

• Vytváří soubor „RunningQueries.htm“ v adresáři „Logs“, pokud je program umístěn v adresáři „bin“, jinak ve svém adresáři, a zároveň tento soubor otevírá

2.9. RunScript.exe

Program určený pro spuštění skriptu zadaného pomocí ID ovládacího prvku – tlačítka umístěného výhradně na nahlížecí stránce. Volitelný parametr „UserID“ představuje ID uživatele, pod jehož přihlašovacím jménem bude skript spuštěn. Pokud volitelný parametr není uveden, bude skript spuštěn pod anonymním uživatelem a práva se nevyhodnocují. Celý skript běží v jedné transakci. Program vrací návratový kód 0 při úspěchu a 1 při chybě, včetně neexistujícího nebo prázdného skriptu. Návratový kód 1 vrací bez spuštění skriptu i tehdy, je-li NET Genium deaktivované (soubor „UnderConstruction.txt“) nebo právě probíhá jeho aktualizace.

• Použití: „RunScript.exe <ID> [<UserID>]“

Program „RunScript.exe“ má využití převážně v naplánovaných úlohách. Naplánovanou úlohu je možné vytvořit buď ručně, nebo pomocí programu „Setup.exe“, který na základě zadaného ID ovládacího prvku automaticky vytvoří naplánovanou úlohu s následujícími parametry:

• ve složce „NET Genium“,
• s názvem naplánované úlohy, který je odvozen z názvu tlačítka,
• ve stanovený čas – výchozí čas je nastaven na „06:00“,
• volitelně s nastaveným opakováním 2x za hodinu – v intervalu 30 minut po dobu 18 hodin.
• Při ručním vytváření naplánované úlohy musí obsahovat v poli „Program či skript“ celou cestu k programu „RunScript.exe“ na disku počítače, v poli „Přidat argumenty (volitelné)“ ID ovládacího prvku a volitelně mezeru a ID uživatele. Pole „Spustit v (volitelné)“ není nutné vyplňovat.

2.10. Setup.exe

Program určený pro instalaci NET Genia, který umožňuje:

• Vytvořit virtuální adresář
• Autorizovat identitu aplikačního fondu (případně účet NetworkService) pro zápis do adresáře NET Genium
• Vytvořit databázi
  • Firebird
  • MSSQL
• Autorizovat identitu aplikačního fondu (případně účet NetworkService) pro přístup do databáze MSSQL – identita přitom dostane roli „sysadmin“
• Vytvořit naplánovanou úlohu pro BackupServer.exe (záloha serveru)
• Vytvořit naplánovanou úlohu pro SqlBackup.exe (záloha databáze)
• Vytvořit naplánovanou úlohu pro FileBackup.exe (záloha příloh) – úloha vzniká bez povinného parametru s cílovým adresářem zálohy, který je nutné doplnit v „Task Scheduleru“ do pole „Přidat argumenty (volitelné)“
• Vytvořit naplánovanou úlohu pro Update.exe (aktualizace)
• Vytvořit naplánovanou úlohu pro ResendEmlFiles.exe
• Vytvořit naplánovanou úlohu pro RunScript.exe
  • „Setup.exe“ je doporučovaný způsob pro vytváření naplánovaných úloh spojených se spouštěním skriptů tlačítek umístěných na nahlížecích stránkách. ID tlačítka editačního formuláře program odmítne.
  • V dialogu programu „Setup.exe“ jsou k dispozici zadávací pole pro
    • ID tlačítka,
    • čas spuštění naplánované úlohy,
    • a zaškrtávací pole „2x/h“, které definuje, že bude naplánovaná úloha spouštěná periodicky 2x za hodinu po dobu 18 hodin.

Naplánované úlohy vytvořené programem „Setup.exe“ je možné dále ručně nakonfigurovat přímo v „Task Scheduleru“:

• Všechny naplánované úlohy jsou vytvářeny ve složce „NET Genium“, která již buď existuje, nebo jí „Setup.exe“ vytvoří
• Naplánované úlohy jsou nastaveny tak, aby byly spouštěny v kontextu uživatelského účtu „SYSTEM“ s nejvyššími oprávněními

2.11. StartSynchro.exe

Program určený pro odeslání fronty synchronizace databázových tabulek do propojených instalací NET Genia. Program frontu odesílá jen tehdy, je-li v adresáři „Config“ soubor „DenyStartSynchro.txt“ – jinak frontu odesílá webová aplikace sama a program jen vypíše hlášení. Je-li v adresáři „Config“ soubor „DenySynchro.txt“, program neodešle nic. Typicky se spouští naplánovanou úlohou.

• Před odesláním program uvolní zámek synchronizace starší než 2 hodiny; s parametrem „/reset“ uvolní zámek bez ohledu na jeho stáří.
• Program vrací návratový kód 0 při úspěchu a 1 při chybě. Návratový kód 1 vrací bez odeslání i tehdy, je-li NET Genium deaktivované (soubor „UnderConstruction.txt“) nebo právě probíhá jeho aktualizace.
• Použití: „StartSynchro.exe [/reset]“''

Detailní popis synchronizace je uveden v samostatné příručce Nastavení NET Genia.

2.12. Update.exe a FinishUpdate.exe

Program „Update.exe“ je určený pro aktualizaci NET Genia na jeho nejnovější verzi. Automaticky se aktualizuje na:

• poslední plnou verzi nebo
• poslední testerskou verzi, pokud je v adresáři „Config“ přítomný soubor „Tester.txt“ (na jeho obsahu nezáleží),
• poslední vývojářskou verzi, pokud je v adresáři „Config“ přítomný soubor „Developer.txt“ a není přítomný soubor „Tester.txt“.

Soubor s nejnovější verzí NET Genia je vždy nejdříve hledán v adresáři „Update“ – „netgenium4.zip“ pro plnou verzi, „netgenium4t.zip“ pro testerskou verzi a „netgenium4d.zip“ pro vývojářskou verzi. Pokud tento soubor v adresáři „Update“ existuje, považuje se za dostupnou aktualizaci bez porovnání verzí a po použití je smazán. Pokud v adresáři „Update“ neexistuje, bude automaticky stažen z webového serveru společnosti NetGenium.

Program „Update.exe“ je možné spouštět i jako naplánovanou úlohu systému Windows, a zajistit tak pravidelnou každodenní aktualizaci NET Genia, prováděnou typicky v nočních hodinách. „Update.exe“ je ale nutné spouštět plánovačem úloh s parametrem „-j“ – jde o plně automatizovanou aktualizaci nevyžadující potvrzení uživatelem. Naplánovanou úlohu je možné vytvořit buď ručně, nebo automaticky pomocí programu „Setup.exe“, případně spuštěním programu „Update.exe“ s parametrem „-task“.

rem Spuštění automatizované aktualizace nevyžadující potvrzení uživatelem
Update.exe -j
rem Automatické vytvoření naplánované úlohy
Update.exe -task

Po skončení aktualizace je automaticky spuštěn program „FinishUpdate.exe“, který:

• aktualizuje soubor „Web.config“ v kořenovém adresáři NET Genia podle různých nastavení umístěných v konfiguračních souborech,
• zkopíruje program „FileUpload.exe“ do systémového adresáře systému Windows – tím je zajištěno, aby mohl tento program být spouštěn z příkazové řádky bez nutnosti k němu specifikovat cestu,
• smaže starý „Update.exe“ a knihovnu „NETGeniumConnection.dll“, a nahradí je novými verzemi umístěnými pod provizorními názvy „Update.new“ a „NETGeniumConnection.new“,
• nasadí do adresáře „bin“ knihovny „ngef.dll“, „ERP.dll“ a „OCR.dll“, pokud jsou připravené v adresáři „Update“.

Druhou oblastí, kde lze využít program „Update.exe“, je hromadná aktualizace NET Genií, které se nacházejí na daném serveru. V rámci hromadné aktualizace je možné aktualizovat všechna NET Genia najednou nebo pouze vybraná NET Genia. Definice, která NET Genia budou aktualizována, je uvedena v konfiguračním souboru „Update.exe.config“, který je umístěn ve stejném adresáři jako „Update.exe“.

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
 <appSettings>
 
   <add key="dir" value="D:\inetpub\wwwroot\www.netgenium.com\Download" />
 
   <add key="ngdirs" value="D:\inetpub\wwwroot" />
   <add key="ngdir" value="E:\inetpub\wwwroot\netgenium1" />
   <add key="ngdir" value="E:\inetpub\wwwroot\netgenium2" />
 
   <add key="nointernet" value="false" />
 
  </appSettings>
</configuration>

• Parametr „dir“ značí cestu k adresáři s nejnovějšími verzemi NET Genia – k adresáři se soubory „netgenium4.zip“ a „netgenium4t.zip“. Parametr „dir“ je možné používat pouze na provozním serveru společnosti NetGenium, kam se archivy s novými verzemi distribuují.
• Parametr „ngdirs“ specifikuje adresář na disku, ve kterém je uloženo více NET Genií. Program „Update.exe“ najde v tomto adresáři všechna NET Genia, a ta zaktualizuje. Vyjma těch, která mají v adresáři „Config“ umístěný soubor „SkipUpdate.txt“ (na jeho obsahu nezáleží).
• Parametr „ngdir“ specifikuje adresář na disku, ve kterém je uloženo jedno konkrétní NET Genium, které program „Update.exe“ zaktualizuje.
• Parametr „nointernet“ značí, že na serveru není k dispozici internet, a že budou aktualizace prováděny vždy ze souborů „netgenium4.zip“ a „netgenium4t.zip“ uložených v aktuálním adresáři spolu s programem „Update.exe“.

Program „Update.exe“ je potřeba spolu s dalšími vyžadovanými soubory umístit do samostatného adresáře na disku, např. do adresáře „D:\Update“. Nutnou součástí adresáře „Update“ pro správnou funkčnost hromadné aktualizace jsou následující soubory:

• „FinishUpdate.exe“,
• „NETGeniumConnection.dll“,
• „Update.exe.config“ a
• „Update.exe“.

Při spuštění hromadné aktualizace je do denního logového souboru v adresáři „Logs“ vedle programu „Update.exe“ (například „Logs\2026-10-06.log“) zapsán seznam všech NET Genií, které byly uvedené v konfiguračním souboru „Update.exe.config“.

• Pokud je dané NET Genium úspěšně aktualizováno, je v logovém souboru u cesty k danému NET Geniu uvedeno „OK“.
• Pokud je dané NET Genium v době prováděné aktualizace již aktuální, je v logovém souboru u cesty k danému NET Geniu uvedeno „Up-to-date“.

Pokud bylo dané NET Genium vyhledáno díky parametru „ngdirs“ nebo „ngdir“ a zároveň obsahuje v adresáři „Config“ soubor „SkipUpdate.txt“, je v logovém souboru u cesty k danému NET Geniu uvedeno „SKIP“.

3. Adresář „Config\Tools“

3.1. Deactivate.exe

Program „Deactivate.exe“ deaktivuje NET Genium – IIS i webová aplikace NET Genia zůstávají spuštěné, ale je zamezeno jakékoliv práci v NET Geniu. Uživatelé jsou při každém požadavku na práci v NET Geniu přesměrováni na webovou stránku „UnderConstruction.aspx“. Deaktivace spočítá ve vytvoření souboru „UnderConstruction.txt“ v adresáři „Config“. Obsah souboru definuje HTML kód, který se uživateli zobrazuje na webové stránce „UnderConstruction.aspx“.

Program nabízí dva profily:

• „Deactivate all users“ – deaktivuje NET Genium pro všechny uživatele (soubor „UnderConstruction.txt“),
• „Deactivate all users except administrator“ – deaktivuje NET Genium pro všechny uživatele kromě administrátorů (soubor „UnderConstruction2.txt“).

3.2. Activate.exe

Program „Activate.exe“ aktivuje NET Genium resp. smaže soubory „UnderConstruction.txt“ a „UnderConstruction2.txt“ z adresáře „Config“.

3.3. MemoryDumps.txt

Soubor „MemoryDumps.txt“ obsahuje postup pro analýzu „memory dumpů“ při řešení problémů s výkonem nebo funkčností aplikací.

1) Download and install Debug Diagnostic Tool v2 Update 2
(https://www.netgenium.com/download/DebugDiagx64.msi)
2) Locate memory dumps (C:\Users\abc\AppData\CrashDumps)
3) Run DebugDiag
4) Default Analysis / CrashHangAnalysis
5) Add Data Files
6) Start Analysis

3.4. TracingRequests.txt

Soubor „TracingRequests.txt“ obsahuje postup pro trasování webových requestů.

1a) Server Manager / Add roles and features
1b) Ovládací panely / Programy / Programy a funkce / Zapnout nebo vypnout funkce systému Windows

2a) Web Server (IIS) / Web Server / Health and Diagnostics / Tracing
2b) Internetová informační služba / Webové služby / Stav a diagnostika / Trasování

3) Run IIS
4) Select top node and click 'Failed request tracing rules' / 'Pravidla pro trasování chybných požadavků'
5) Click Add... / Přidat...
6) All content (*) / Veškerý obsah (*)
7) Status code(s): 401-999 / Stavové kódy: 401-999
8) Select website and click 'Failed request tracing rules' / 'Pravidla pro trasování chybných požadavků'
9) Edit Site Tracking... / Upravit trasování webu...
10) Enable / Povolit

3.5. TuningQueries.sql

Soubor „TuningQueries.sql“ obsahuje ukázkový seznam příkazů, které slouží k ladění databázových dotazů v programu „SQL Server Database Engine Tuning Advisor“.

use netgenium
go	
SELECT ...
SELECT ...

3.6. TuningQueries.txt

Soubor „TuningQueries.txt“ obsahuje postup pro ladění databázových dotazů v programu „SQL Server Database Engine Tuning Advisor“.

1) Run SQL Server Management Studio
2) Right click on the instance name and select 'Reports / Standard Reports / Performance – Top Queries by Total CPU Time'
3) Identify top queries with constants in a condition that can be improved with indexes
4) Right click on the background of the report and select 'Print / Excel'
5) Open printed Excel file
6) Create 'netgenium.sql' file and insert top queries using the following syntax:

use netgenium
go
SELECT ...
SELECT ...

7) Run SQL Server Database Engine Tuning Advisor
8) Click 'Start New Session'
9) Select 'File' as a 'Workload' and browse for 'netgenium.sql'
10) Mark 'netgenium' database
11) Click 'Start Analysis'
12) Analyze 'Recommendations' tab
13) Create new indexes as recommended

3.7. WALTU.exe

Program „WALTU.exe“ slouží k procházení všech odkazů ze zadané URL webové aplikace. Využívá se např. pro zátěžové testy, kde se zadává počet požadavků a volbou „One Thread“ se určuje, zda mají požadavky běžet v jednom vlákně, nebo souběžně, nebo pro zjištění dostupnosti odkazů (mrtvých odkazů, popř. špatně nastavených práv na cílová umístění). Program podporuje pouze adresy s protokolem „http“.

3.8. ResponseHeaders.txt

Soubor „ResponseHeaders.txt“ obsahuje ukázkové hodnoty hlavičky „Content-Security-Policy“ pro webové aplikace, které používají Google reCAPTCHA nebo mapové podklady OpenStreetMap.

3.9. TracingCertificates.txt

Soubor „TracingCertificates.txt“ obsahuje postup pro dohledání neplatných serverových certifikátů v nastavení HTTP.SYS a postup pro nastavení ověřování klientskými certifikáty ve službě IIS.

3.10. WSDL.exe

Program „WSDL.exe“ slouží k vytvoření proxy třídy v jazyce C# pro volání webových služeb podle jejich popisu WSDL.