Instalace NET Genia na lokálním počítači

Příručka ve formátu PDF

1. Postup instalace NET Genia

• Instalace a nastavení IIS
• Stažení a rozbalení NET Genia do cílového adresáře
• Instalace databázového serveru Firebird (případně MS SQL Serveru)
• Instalace NET Genia

2. Instalace IIS

2.1. Instalace IIS v systému Windows 11

• V nabídce „Start” vyhledejte „Ovládací panely”.

• Přepněte zobrazení na „Kategorie” a zvolte možnost „Programy”.

• V kategorii „Programy a funkce” vyberte položku „Zapnout nebo vypnout funkce systému Windows”.

• V nově otevřeném okně vyberte k instalaci:
• Internetová informační služba
  • Nástroje webové správy
    • Kompatibilita správy služby IIS 6
      • Kompatibilita metabáze služby IIS a konfigurace služby IIS 6
      • Konzola pro správu služby IIS 6 (v případě, že budeme instalovat též SMTP Server)
    • Konzola pro správu služby IIS
  • Webové služby
    • Funkce pro vývoj aplikací
      • ASP.NET 4.8
      • Filtry ISAPI
      • Rozšíření ISAPI
      • Rozšiřitelnost rozhraní .NET 4.8
    • Zabezpečení
      • Ověřování systému Windows

• Výběr potvrďte tlačítkem OK

3. Nastavení IIS

3.1. Připnutí IIS na hlavní panel

• Vyhledejte v nabídce start „Správce Internetové informační služby”.

• V dolní liště klikněte pravým tlačítkem myši na IIS a vyberte možnost „Připnout na hlavní panel”.

3.2. Vypnutí protokolování

• Z důvodu prevence neočekávaného zaplnění disku počítače je žádoucí vypnout v IIS protokolování provozu v rámci uzlu vašeho počítače.
• Přejděte do nastavení IIS a vyberte nejvyšší uzel vašeho počítače (například „NELA-PC”), aby se nastavení propsalo i na další podřízené uzly, a v sekci „IIS” vyberte „Protokolování”.

• Na panelu „Akce” na pravé straně okna poté klikněte na „Zakázat”. Tím se vypne logování povozu pro uzel vašeho počítače.

3.3. Nastavení identity

3.3.1. Nastavení identity přes předvolby fondu aplikací

3.3.1.1. Předdefinovaný účet „NetworkService”

• Přejděte na „Fondy aplikací”, a v sekci „Akce” klikněte na „Nastavit předvolby fondu aplikací…”, nebo klikněte pravým tlačítkem na plochu IIS a zvolte možnost „Nastavit předvolby fondu aplikací…”.
• Tímto způsobem měníte výchozí nastavení pro všechny aplikační pooly tak, abyste nemuseli nastavovat každý aplikační pool zvlášť.

• Vyberte položku „Identita” a klikněte na tři tečky vpravo v dialogovém okně.

• Ze seznamu vyberte a nastavte „NetworkService”.

3.3.2. Nastavení identity u jednotlivých aplikačních poolů

• Pokud byla nastavena identita přes předvolby aplikačních poolů v předchozí kapitole, stačí pouze zkontrolovat její nastavení.

3.3.2.1. Předdefinovaný účet „NetworkService”

• Nastavení identity provedete kliknutím pravého tlačítka myši na „DefaultAppPool” a vyberete položku „Upřesnit nastavení…”.

• Vyberte položku „Identita” a klikněte na tři tečky vpravo v dialogovém okně.

• Ze seznamu vyberte a nastavte „NetworkService”.

3.4. Výchozí adresář webu

• Výchozí adresář webu neboli root je adresář na disku, ve kterém je uložena stromová struktura podadresářů a souborů v rámci jednoho webu. V čisté instalaci IIS je standardně vytvořen jeden web s názvem „Default Web Site”, který má jako výchozí adresář webu nastaven „C:\inetpub\wwwroot”. Nastavení výchozího adresáře webu lze měnit, a tudíž záleží na rozhodnutí správce, jaký adresář bude zvolen jako výchozí adresář webu. V IIS může být vytvořeno libovolné množství webů, přičemž každý z webů má svůj vlastní výchozí adresář webu.
• Pokud chcete změnit výchozí adresář webu, postupujte dle návodu níže.
• Otevřete aplikaci „Správce Internetové Informační Služby” a pravým tlačítkem myši klikněte na web s názvem „Default Web Site” a zvolte možnost „Spravovat web” -> „Upřesnit nastavení”.

• Změňte nastavenou fyzickou cestu na vámi vybranou cestu a stiskněte tlačítko „OK”.

3.5. Nastavení oprávnění výchozího adresáře

• Tento krok je důležitý proto, aby vaše NET Genium mohlo zapisovat soubory na disk (například souborové přílohy, kaskádové styly, logové soubory atp.).
• Před samotným nastavením oprávnění je důležité si uvědomit, pod jakým účtem je nakonfigurován aplikační pool viz kapitola „Nastavení identity”, a tedy pro jaký účet budeme oprávnění nastavovat. Zda půjde o předdefinovaný účet „NetworkService”, nebo vlastní technologický účet. Níže uvedený postup popisuje nastavení oprávnění pro účet „NetworkService”. Tímto uvedeným postupem měníme také výchozí oprávnění pro všechny další podadresáře.
• Jděte do umístění vašeho výchozího adresáře webu např. „C:\inetpub”, klikněte pravým tlačítkem na složku „wwwroot” a zvolte možnost „Vlastnosti”.

• Přejděte na záložku „Zabezpečení” a klikněte na tlačítko „Upravit”.

• Klikněte na tlačítko „Přidat…”.

• Dále klikněte na tlačítko „Upřesnit…”.

• Přes tlačítko „Najít” vyhledejte „NETWORK SERVICE” a klikněte na tlačítko „OK”.

• Označte skupinu uživatelů „NETWORK SERVICE”, zaškrtněte „Úplné řízení” a potvrďte tlačítkem „OK”.

• Pokud není možné nastavit oprávnění výchozího adresáře, postupujte dle kroků uvedených v kapitole Instalace NET Genia přes „Setup.exe”.

4. Stažení a rozbalení NET Genia do cílového adresáře

• Stáhněte si archiv s poslední plnou verzí NET Genia z URL adresy:
  https://www.netgenium.com/download/netgenium4.zip.
• Obsah archivu rozbalte do adresáře „C:\inetpub\wwwroot\netgenium”.

5. Instalace databázového serveru – Firebird nebo MS SQL

• Před instalací NET Genia je potřeba nainstalovat databázový server, a to buď Firebird nebo MS SQL Server. Po instalaci databázového serveru můžete pokračovat v instalaci NET Genia.
  • Postup pro instalaci Firebird najdete v příručce „Instalace Firebird”.
  • Postup pro instalaci MS SQL Serveru najdete v příručce „Instalace MSSQL”.

6. Instalace NET Genia

• NET Genium lze nainstalovat dvěma různými způsoby:
  • Přes „Setup.exe”
  • Přes „IIS”

6.1. Instalace NET Genia přes „Setup.exe”

• Spusťte program „Setup.exe”, který se nachází v adresáři „bin” NET Genia. Po jeho prvním spuštění se pouze vytvoří knihovny pro jeho správný běh, poté „Setup.exe” spusťte znovu („Setup.exe” je nutné spouštět jako správce).
• Pokud vlastníte licenci NET Genia, zkopírujte váš licenční soubor „license.txt” do adresáře „Config” NET Genia.
• Úvodní okno programu vypadá následovně:

• Zaškrtněte volby, které chcete zvolit dle níže uvedeného popisu:
• „Vytvořit virtuální adresář”
  • Zaškrtněte tuto volbu, pokud chcete převést adresář NET Genia na disku na virtuální adresář IIS (spustit ekvivalent ruční instalace NET Genia prováděný v IIS).
• „Autorizovat účet NetworkService pro zápis do adresáře NET Genium”
  • Zaškrtněte tuto volbu, pokud chcete nastavit práva pro účet „NetworkService” na plný přístup do adresáře NET Genium. Pokud jste nastavovali práva podle kapitoly „Nastavení oprávnění výchozího adresáře” pro celý „wwwroot”, není nutné (při zaškrtnutí této volby) nastavovat práva jednotlivě. Tak jsou práva u každého jednotlivého NET Genia již přednastavena.
• „Vytvořit databázi”
  • Zaškrtněte tuto volbu, pokud chcete vytvořit novou databázi, a váš databázový server je umístěn na stejném počítači jako samotná aplikace, resp. IIS. Pokud je databázový server umístěný na jiném počítači, musí se databáze na databázovém serveru vytvořit ručně, a následně je třeba vytvořit soubor „ConnectionString.txt” v adresáři „Config” NET Genia, který obsahuje definici připojovacího řetězce do databáze.
  • Specifikujte, jaký typ databáze budete používat – Firebird nebo MS SQL Server.
  • Nechte zaškrtnutou volbu „Automaticky” – databáze bude mít stejný název jako virtuální adresář, popřípadě specifikujte vlastní název databáze.
  • V případě Firebird zvolte adresář, kde má být databáze uložena (standardní umístění je „C:\Firebird”).
  • V případě MS SQL Serveru zvolte instanci, ve které bude databáze vytvořena.
• „Autorizovat účet NetworkService pro přístup do databáze MS SQL”
  • Zaškrtněte tuto volbu, pokud používáte databázi MS SQL, a váš databázový server je umístěn na stejném počítači jako samotná aplikace, resp. IIS.
  • Autorizace spočívá ve vytvoření loginu k účtu „NetworkService” a přiřazení role „sysadmin”.
• „Vytvořit naplánovanou úlohu pro BackupServer.exe (záloha serveru)”
  • Zaškrtněte tuto volbu, pokud chcete automaticky vytvořit naplánovanou úlohu pro pravidelné zálohování serveru – databáze a adresáře.
• „Vytvořit naplánovanou úlohu pro SqlBackup.exe (záloha databáze)”
  • Zaškrtněte tuto volbu, pokud chcete automaticky vytvořit naplánovanou úlohu pro pravidelné zálohování databáze.
• „Vytvořit naplánovanou úlohu pro FileBackup.exe (záloha příloh)”
  • Zaškrtněte tuto volbu, pokud chcete automaticky vytvořit naplánovanou úlohu pro pravidelné zálohování souborových příloh.
• „Vytvořit naplánovanou úlohu pro Update.exe (aktualizace)”
  • Zaškrtněte tuto volbu, pokud chcete automaticky vytvořit naplánovanou úlohu pro pravidelnou aktualizaci NET Genia na novou verzi.
• „Vytvořit naplánovanou úlohu pro ResendEmlFiles.exe”
  • Zaškrtněte tuto volbu, pokud chcete automaticky vytvořit naplánovanou úlohu pro pravidelné odesílání neúspěšně odeslaných e-mailů z adresáře „Logs”.
• „Vytvořit naplánovanou úlohu pro RunScript.exe”
  • Zaškrtněte tuto volbu, pokud chcete automaticky vytvořit naplánovanou úlohu pro spuštění skriptu s daným ID, ve stanovený čas, případně s možností pravidelného opakování úlohy 2x za hodinu po dobu 18 hodin.
• Instalaci spusťte kliknutím na tlačítko „Nastavit”. Po dokončení instalace program o této skutečnosti zobrazí zprávu.
• Po úspěšném vytvoření databáze je automaticky vytvořen soubor „ConnectionString.txt”.
• V adresáři „Config” se vytvoří soubor „DefaultLanguage.txt”, do kterého se umístí zkratka výchozího jazyka portálu. To bude výchozí jazyk, podle kterého budou vytvářeny všechny následně vytvářené aplikace NET Genia.

6.2. Instalace NET Genia přes „IIS”

• Přes IIS instalujte pouze v případě, že máte vytvořenou databázi NET Genia, a v adresáři „Config” máte soubor „ConnectionString.txt”, který obsahuje definici připojovacího řetězce do databáze.
• Vyhledejte „Správce Internetové informační služby” (IIS) přes nabídku „Start”.

• V otevřeném okně po levé straně rozklikněte stromovou strukturu rozbalovacího seznamu až k „Default Web Site”, označte adresář na disku vašeho NET Genia, klikněte na něj pravým tlačítkem myši, a v nabídce zvolte možnost „Převést na aplikaci”.
• V tomto kroku se předpokládá, že je NET Genium rozbaleno v adresáři „netgenium” ve výchozím adresáři webu (například „C:\inetpub\wwwroot\netgenium”). Viz kapitola „Stažení a rozbalení NET Genia do cílového adresáře”.

7. Řešení problémů

7.1. Instalace NET Genia přes „Setup.exe”

• Pokud se při instalaci NET Genia programem „Setup.exe” vyskytnou jakékoliv problémy, jejich detaily je možné nalézt v adresáři „Logs” v souboru „Install.log”. Mezi tyto problémy patří:
• Problém: Není nainstalována služba IIS.
• Řešení: Nainstalujte službu IIS (viz kapitola „Instalace IIS”).
• Problém: Není nainstalován zvolený databázový systém.
• Řešení: Nainstalujte databázový server (viz kapitola „Instalace databázového serveru – Firebird nebo MS SQL”).
• Problém: Při vytvoření databáze setup hlásí chybu: „Firebird: connection rejected by remote interface”.

• Řešení: Zkontrolujte, jakou verzi Firebirdu máte nainstalovanou. Musí být nainstalovaná verze 2.5.n nebo vyšší.
• Problém: Není nainstalovaná zpětná kompatibilita se službou IIS 6 a rozšíření .NET a ASP.NET.
• Řešení: Nainstalujte příslušné chybějící rozšíření prostřednictvím funkce „Zapnout nebo vypnout funkce systému Windows” (v případě Windows 10) nebo instalací Server Features (v případě Windows Server 2016).

7.2. První spuštění NET Genia

• Problém: NET Genium se zobrazuje bez stylů.
• Řešení: Jestli se vám vaše NET Genium zobrazuje bez stylů, nemáte buď nastavená oprávnění vašeho výchozího adresáře webu (viz kapitola „Nastavení oprávnění výchozího adresáře”, nebo nebyla při instalaci IIS zaškrtnuta volba „Statický obsah” (viz kapitola „Instalace IIS v systému Windows 11”).

• Problém: Nejde uložit formulář v NET Geniu. Při uložení formuláře se zobrazí chyba: „No message for error code 335544865 found”.
• Řešení: Zkontrolujte, zda máte spuštěný program FlameRobin. Jestli ano, program zavřete.