¶ Inštalácia QASIDA START s Oracle XE
Na tejto stránke uvádzame minimálne technické požiadavky pre informačný systém QASIDA START a postup inštalácie.
¶ Minimálne systémové požiadavky
- Operačný systém: MS Windows 11 Pro so zapnutými aktualizáciami, alebo Windows Server 2022.
- RAM: 8 GB RAM
- Diskový priestor: SSD disk s voľným priestorom 50 GB
- Externé úložisko pre zálohy: 100+ GB
- Podporované virtualizačné platformy: Oracle VM Server, Microsoft Hyper-V
- Je potrebné mať na tomto zariadení nainštalované Microsoft WebView2
POZOR: Názov pc (hostname) nesmie byť rovnaký ako názov používateľa (username) v systéme windows. Inak inštalácia databázy nebude úspešná hneď v prvom kroku.
¶ Typy inštalácie
Produkt QASIDA Start umožňuje dva typy inštalácií - serverová (SERVER) alebo klientska (KLIENT).
¶ KLIENT- Klientska inštalácia
- Obsahuje len aplikáciu QASIDA Start (ktorá je sama o seba nepoužiteľná, je potrebné vykonať aj serverovú inštaláciu na zvolenom prostredí).
- Daný typ inštalácie je vhodný pre notebook, kedy počítač môže ísť aj do režimu spánku či hybernácie.
- Je potrebné mať sieťovo dostupné "serverové prostredie", kde beží databáza a zvyšné serverové aplikácie QASIDA Start produktu.
¶ SERVER - Serverová inštalácia
- Obsahuje plne funkčnú QASIDA Start so všetkými aplikáciami a databázou.
- Odporúčané je inštalovať na prostredie, ktoré sa riadne vypnína a zapína a má zakázaný režim spánku či hybernácie.
¶ Architektúra riešenia
V závislosti od plánovaného spôsobu používania, je potrebné zvoliť vhodnú architektúru riešenia - lokálne alebo sieťové, a podľa toho použiť správny typ inštalácie.
¶ Lokálna
- Je potrebný jeden počítač, ktorý spĺňa systémové požiadavky.
- Typ inštalácie - SERVER.
- Neodporúča sa inštalácia na notebook.
- Preferovaná inštalácia je na počítač typu pracovná stanica.
- Bude využívať len jeden používateľ.
- Možná práca v Qaside Start len z daného počítača, kde je produkt nainštalovaný.
- Počítač sa musí riadne vypínať a zapínať.
- Má zákazaný režím spánku, či hybernácie.
- Po našartovaní počítača a prihlásení sa doňho, je potrebné čakať cca 10 - 15 min, kým naštartujú všetky serverové komponenty QASIDA Start produktu na danom počítači.
- Potrebné mať počítač zapnutý v čase, kedy je naplnánovaná záloha databázy.
- Počas zálohovania databázy je potrebné očakávať vyššie zaťaženie počítača.
- Odporúčame zálohovať databázové zálohy do cloudu alebo na sieťové úložisko. Všetky dáta QASIDA Start aplikácie sú uložené v databáze. Bez platnej databázovej zálohy nie je možné obnoviť databázu v prípade potreby.
¶ Sieťová
Je potrebné dva a viac počítačov, v závislosti od počtu používateľov.
¶ Hlavný počítač
- Hlavný počítač bude plniť účel "serverového prostredia" a spĺňa systémové požiadavky. Môže to byť fyzický server, virtuálne prostredie servera alebo pracovná stanica. Daný počítač nesmie byť typ notebook.
- Typ inštalácie - SERVER
- Povolená sieťová komunikácia na TCP portoch 1521, 8083, 8888. Počítače jednotlivých používateľov musia mať sieťovo dostupný hlavný počítač na požadovaných TCP portoch.
- Počítač sa musí riadne vypínať a zapínať.
- Má zákazaný režím spánku, či hybernácie.
- Potrebné mať počítač zapnutý v čase kedy je naplnánovaná záloha databázy.
- Počas zálohovania databázy je potrebné očakávať vyššie zaťaženie počítača.
- Odporúčame zálohovať databázové zálohy do cloudu alebo na sieťové úložisko. Všetky dáta Qasida Start aplikácie sú uložené v databáze. Bez platnej databázovej zálohy nie je možné obnoviť databázu v prípade potreby.
¶ Používateľský počítač
- Akékoľvek prostredie, ktoré spĺňa systémové požadavky.
- Typ inštalácie - KLIENT
- Počítač môže mať povolený režím spánku, či hybernácie.
¶ Pred inštaláciou
¶ Aktualizácia operačného systému
Je požadované, aby pred samotnou inštaláciou QASIDA Start bol zaktualizovaný operačný systém Windows. Ak by na prostredí boli aktualizácie, ktoré čakajú na vykonanie, môže dôjsť k zlyhaniu samotnej inštalácie.
¶ Príprava používateľa, pod ktorým bude vykonaná inštalácia
Pripraviť, prípadne skontrolovať si účet podľa požiadaviek, pod ktorým bude inštalácia vykonaná. V prípade ak by bola spustená inštalácia pod používateľom, ktorý nespĺňa požiadavky, dôjde k zlyhaniu samotnej inštalácie.
Požiadavky na používateľa s administrátorskými právami:
- Lokálny používateľ
- Meno používateľa nesmie byť také isté ako názov počítača, či domény.
- Meno používateľa nesmie obsahovať žiadne interpunkčné znamienka, či špeciálne znaky.
- Meno používateľa nesmie obsahovať medzeru.
¶ Inštalácia QASIDA START
¶ 1. Spustenie inštalácie
-
Prihláste sa na cieľový počítač s administrátorskými právami.
-
Stiahnite si inštalačný súbor zo stránky https://asseco-qasida.com/sk/erp/qasida-start cez tlačidlo Stiahnuť
-
Inštalátor (napr. „QasidaStart_XXXX.exe“) uložte do C:\temp a spustite.
-
Po spustení inštalačného súboru postupujte v oknách nasledovne: Ak nie je vyžadovaná žiadna interakcia, pokračujte tlačidlami Next / Ďalej.
¶ 2. Licenčné podmienky
- Pred inštaláciou QASIDA START si preštudujte licenčné podmienky a ak s nimi súhlasíte, kliknite na tlačidlo Agree / Súhlasím.
¶ 3. Voľba súčastí programu
Zvoľte typ inštalácie KLIENT alebo SERVER a súčasti programu QASIDA START, ktoré chcete nainštalovať:
- KLIENT – nainštaluje sa iba aplikácia, t.j. Client QASIDA ERP. Túto možnosť zvoľte iba pokiaľ už je nainštalovaný server v rámci vašej siete a chcete vytvoriť iba klientsku pracovnú stanicu.
- SERVER – nainštalujú sa všetky súčasti QASIDA START.
- Install DB SW – inštalátor nainštaluje databázu Oracle XE.
- Client QASIDA ERP – inštalátor nainštaluje aplikáciu QASIDA START so všetkými súčasťami.
- Jasper (software only) – nainštalujú sa všetky súčasti potrebné na tvorbu zostáv.
- QASIDA.api – nainštalujú sa všetky súčasti potrebné na aktualizáciu.
¶ 4. ORACLE XE Parameters
- Do poľa Install Code vložte inštalačný kód, ktorý Vám bol zaslaný prostredníctvom e-mailu.
Zvoľte Typ inštalácie (DB type):
STANDARD – inštalácia štandardného typu,
PUBLIC – inštalácia pre organizácie vo verejnej správe.
-
Inštalátor vygeneruje automaticky 6 hesiel, ktoré sú potrebné pre chod aplikácie a bezpečnosť. Tieto heslá sa uložia v zašifrovanom tvare aj na disk, aplikácia k nim počas práce pristupuje automaticky - teda nie je potrebné si ich zvlášť ukladať ako používateľ. Heslá nie je možné meniť, výnimkou je len heslo pre aktualizáciu.
-
Pomocou tlačidla Rozšírené resp. Expert Settings je možné zobraziť vygenerované heslá, ako aj ďalšie dodatočné nastavenia. V expertných nastaveniach je možné meniť aj konfigurácie pre zálohovanie údajov - adresa inštalácie, adresa zálohovania a časové parametre zálohovania. Odporúčame ponechať preddefinované nastavenia.
Heslo musí byť minimálne 8 znakov dlhé, maximálne 14 znakov dlhé. Heslo musí obsahovať aspoň jedno malé písmeno, aspoň jedno veľké, aspoň jedno číslo a aspoň jeden z týchto špeciálnych znakov:
! ASCII-33
$ ASCII-36
% ASCII-37
( ASCII-40
) ASCII-45
- ASCII-42
+ ASCII-43
_ ASCII-95
* ASCII-41
Heslo je potrebné neskôr pri spúštani QasidaStartUpdater (t.j. ide o heslo pre update, ktoré vyžaduje updater).
¶ 5. QASIDA Modules
- Ponechajte všetky Qasida moduly, prípadne zvoľte iba vybrané moduly.
- Ponechajte preddefinovaný adresár pre inštaláciu, prípadne vyberte vlastný adresár.
- Kliknite na Ďalej / Next.
¶ 6. Jasper software
- V tomto kroku sa zobrazia nastavenia inštalácie pre tvorbu zostáv a tlačív.
- Nastavenia sú preddefinované a nie sú potrebné žiadne kroky – kliknite na Ďalej / Next.
¶ 7. QASIDA.API parameters
- V nasledovných oknách sa zobrazia nastavenia pre aktualizáciu a komunikáciu ERP systému so systémami tretích strán.
- Nastavenia sú preddefinované, nie sú potrebné žiadne úpravy.
- Kliknite na tlačidlo Ďalej / Next a v nasledovnom okne Nainštalovať / Install.
¶ 8. Dokončenie inštalácie
- Inštalátor následne začne sťahovať a rozbaľovať potrebné súbory. Inštalovanie trvá cca 30 minút.
- Počas inštalačného procesu bude potrebné udeliť firewall povolenie – prístup pre Oracle Java vo Windows Defender Firewall. Toto okno nepozastaví inštalačný proces.
- Po úspešnom nainštalovaní sa automaticky otvorí webový prehliadač na adrese, kde prebehne kontrola Health check. Text musí obsahovať „Healthy – can connect to the database.“
- Zároveň sa automaticky otvorí vo webovom prehliadači aj odkaz, kde je možné prihlásit sa do Jasper software.
¶ Zmena hesla pre jasperadmin aplikačného používateľa
Heslo, ktoré bolo zadané do inštalátora pre jasperadmin používateľa, je potrebné ešte zmeniť aj cez jasper konzolu. Tá sa automaticky otvorila vo webovom prehliadači po jej nainštalovaní.
Predvolené heslo je jasperadmin
¶ 9. Validácia
- Je silno odporúčané po inštalácii skontrolovať funkčnosť nainštalovanej aplikácie a to prihlásením sa do aplikácie Qasida Start.
- Reštartovať počítač. Po reštarte opätovne skontrolovať funkčnosť prihlásenia sa do aplikácie Qasida Start.
¶ Log inštalácie a hlásenie chýb
- Po inštalácii je k dispozícií log inštalácie a nastavenie Oracle databázy: C:...\QASIDA\Temp\log\install_db_21_xe.log.
- V prípade problémov inštalátor vypíše chybovú hlášku. Chyba bude evidovaná v logovacom súbore. V prípade problému, prosím, kontaktujte našu spoločnosť, resp. svojho konzultanta.
¶ Ďalšie kroky
- Vylúčte Oracle štruktúru (C:\QASIDA\oracle) z online skenovania antivírusom.
- Nainštalujte aktuálnu verziu Acrobat Reader.
¶ Možné chyby a riešenia
¶ Zlyhanie inštalácie databázy pod používateľom s administrátorskými právami
¶ Symptóm
Zlyhanie inštalácie databázového softvéru "Install database software". Inštalácia bola spustená pod poúžívateľom s administrátorskými právami.
¶ Popis
Inštalácia vyžaduje, aby bežala pod používateľom s administrátorskými právami.
Požiadavky na používateľa s administrátorskými právami:
- Lokálny používateľ
- Meno používateľa nesmie byť také isté ako názov počítača, či domény.
- Meno používateľa nesmie obsahovať žiadne interpunkčné znamienka, či špeciálne znaky.
- Meno používateľa nesmie obsahovať medzeru.
Ide o najčastejší problém zlyhania inštalácie databázového softvéru vykonávanej pod používateľom, ktorý nespĺňa požiadavky.
¶ Riešenie
Manuálne odinštalovať a nanovo spustiť inštaláciu pod používateľom, ktorý spĺňa požiadavky.
¶ Manuálna odinštalácia
Vymazať adresáre na disku
Remove-Item -Recurse -Force "C:\qasida"
Remove-Item -Recurse -Force "C:\Temp\backup"
Remove-Item -Recurse -Force "C:\Temp\software"
Remove-Item -Recurse -Force "C:\ProgramData\AssecoSolutions"
Vymazať ORACLE kľúč z registrov
Computer\HKEY_LOCAL_MACHINE\SOFTWARE\ORACLE
¶ Databázový listener automaticky nenabehne po štarte operačného systému
¶ Symptóm
Po štarte operačného systému Windowsová služba databázového listenera OracleOraDB21Home1TNSListener automaticky nenabehne hoci má nastavené Startup Type na Automatic.
Manuálny reštart služby prebehne v poriadku.
¶ Popis
Ide o chybu inštalácie, ktorá bude riešená v novších verziách.
V konfiguračnom súbore databázového listenera listener.ora je použitý alias qasidaerp, ktorý odkazuje na localhost.
¶ Riešenie
Upraviť v konfiguračnom súbore listenera alias qasidaerp na názov počítača vo formáte FQDN.
Umiestnenie konfiguračného súboru databázového listenera C:\qasida\oracle\homes\OraDB21Home1\network\admin\listener.ora.
Upraviť HOST = qasidaerp na HOST = nazov_pocita.domena.
- nazov_pocita.domena - názov počítača vo formáte FQDN
Príklad:
Predtým
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = qasidaerp)(PORT = 1521))
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
)
Potom
LISTENER =
(DESCRIPTION_LIST =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCP)(HOST = nazov_pocita.domena)(PORT = 1521))
(ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1521))
)
)
Po zmene konfiguračného súboru je potrebný následný reštart Windowsovej služby databázového listenera.
Restart-Service -Name "OracleOraDB21Home1TNSListener" -Force
Po daných úpravách odporúčame otestovať riešenie následným reštartom počítača a tak zvalidovať, či služba následne pri štarte operačného systému nabehla.
¶ Databáza nenabehne pri nábehu operačného systému
¶ Symptóm
Po štarte operačného systému Windowsová služba databázy OracleServiceXE nabehne, ale databáza nie je dostupná. Databázová služba beží pod pužívateľom LocalSystem.
Následný manuálny reštart databázovej služby, naštartuje databázu.
Počítač je pripojený do domény.
¶ Popis
Problém nastáva len na prostrediach kde je počítač pripojený do domény.
Problém so štartom databázy nastáva, pretože LocalSystem štartuje príliš skoro, kedy ešte nie sú doménové služby plne funkčné. Oracle skúša NTS autentifikáciu kedy nedostáva spätne prihlasovacie údaje (credentials). Preto manuálny reštart služby po nejakom čase od nábehu systému funguje.
Riešením je inštalácia databázových služieb bežiacich pod virtuálnymi účtami.
¶ Riešenie
Na vyriešenie problému je potrebná reinštalácia Qasida Start produktu.
- Export databázy - db_export.bat
- Odinštalácia Qasida Start produktu
- Inštalaćia databázy s najnošiou verziou inštalátora pre Qasida Start
- Import databázy - db_import.bat