Inštalátor nainštaluje QASIDA API ako službu Windows. Rieši celý postup v jednom sprievodcovi:
Inštalátor je jeden súbor QasidaApiInstaller.exe. Nepotrebuje nainštalovaný .NET – nesie si ho v sebe.
Linux nie je týmto inštalátorom podporovaný, inštaluje sa manuálne.
Inštaluje sa v režime HTTP. Prechod na HTTPS je možný po inštalácii. Pripravujeme na to konfigurátor – dovtedy prechod vykoná náš technik. Viac na stránke QASIDA.API cez HTTPS.
Inštalátor sa musí spustiť ako správca. Vyžaduje to sám – systém zobrazí výzvu kontroly
používateľských kont (UAC). Bez zvýšených oprávnení nedokáže vytvoriť službu ani pravidlo firewallu.
| Systém | Podporované edície |
|---|---|
| Windows Server 2019 – 2025 | Standard, Datacenter, Essentials |
| Windows 11 | Pro, Enterprise, Education |
| Oracle Linux 8 – 10 | (podporované produktom, ale nie týmto inštalátorom – ten beží len na Windows) |
Vyžaduje sa 64-bitový systém. Windows 10, Windows 11 Home, Windows Server 2016 a staršie
podporované nie sú a inštalátor ich odmietne.
| Zdroj | Minimum |
|---|---|
| Procesor | 1 vCPU |
| Operačná pamäť | 2 GB |
| Voľné miesto na disku | 10 GB |
Nesplnené minimum inštaláciu nezastaví – zobrazí sa ako upozornenie spolu s tým, čo môže spôsobiť. Rozhodnutie pokračovať je na zákazníkovi.
| Cieľ | Účel | Blokuje inštaláciu? |
|---|---|---|
https://asolhub.assecosolutions.sk |
stiahnutie API a Instant Client | áno |
https://alis.assecosolutions.sk |
overenie licencie | áno |
https://email-sender.assecosolutions.sk |
notifikácie | áno |
ftp://ftp.datalock.sk (port 21) |
prenos súborov mimo inštalácie | nie |
Ak sa zo zariadenia von dá len cez proxy, nastavte ju na prvej strane (kapitola 3.1) – inštalátor
cez ňu potom posiela všetky tri HTTPS spojenia a zapíše ju aj do konfigurácie API.
FTP je jediné spojenie, ktoré sa cez proxy nadviazať nedá (je to priame TCP spojenie, nie HTTP). Ak
sa priame spojenie nepodarí a proxy je nastavená, inštalátor to nehlási ako nedostupnosť, ale ako
„cez proxy sa priamym spojením nedá overiť" – inštaláciu to neblokuje.
QasidaAPI). Ak neexistuje, inštalátor ho vytvorí –Qasida API inštalátor je možné stiahnuť na tejto adrese:
https://asseco-spin.sk/Qasida/QasidaApiInstaller.exe
Sprievodca má štyri strany. Medzi nimi sa pohybujete tlačidlami « Späť a Ďalej ».
V pravom hornom rohu sa dá prepnúť jazyk (SK | EN).

| Pole | Význam |
|---|---|
| Nájdené inštalácie | Zoznam QASIDA API, ktoré na zariadení už bežia – v IIS aj ako služby. Výberom položky nasmerujete inštaláciu na ňu (po potvrdení otázky). |
| Meno pre API | Databázový účet, pod ktorým sa API pripája. Štandardne QasidaAPI. |
| Heslo pre API | Heslo tohto účtu. Ak účet ešte neexistuje, inštalátor ho s týmto heslom vytvorí. |
| Heslo pre update DB | Heslo používateľa DL. Používa sa aj na zašifrovanie zálohy pôvodnej konfigurácie. |
| Data Source | Oracle pripojenie (TNS názov alebo popisovač). |
| Disk pre API | Disk, na ktorý sa API nainštaluje. Adresár pod ním určuje inštalátor sám – vypíše ho v okne kontrol. |
| Port | Port, na ktorom bude API počúvať. Štandardne 8888. |
| Proxy server | Zaškrtnite len vtedy, ak sa zo zariadenia von dá iba cez proxy. Adresu a prihlasovacie údaje zadáte tlačidlom Nastaviť… vedľa. Viď nižšie. |
Zaškrtnutím Zobraziť heslá si môžete zadané heslá skontrolovať.
Pod poľami je panel, ktorý hovorí, aká inštancia sa nainštaluje – prvá (bez portu v názve) alebo
ďalšia (s portom v názve).

V spodnej časti strany je alternatíva k ručnému vypĺňaniu: tlačidlom Načítať appsettings.json…
prevezmete hodnoty z konfiguračného súboru inej inštalácie.
.zip treba najprv rozbaliť (7-Zip); inštalátor číta len .json.Pod poľom Port je zaškrtávacie pole Proxy server a vedľa neho tlačidlo Nastaviť…, ktoré
je aktívne len pri zaškrtnutom poli. Proxy je možnosť, nie povinnosť – ak sa server pripája na
internet priamo, nechajte pole nezaškrtnuté.
Tlačidlo otvorí samostatné okno s týmito poľami:
| Pole | Význam |
|---|---|
| Adresa proxy | Adresa a port, napríklad proxy.firma.sk:8080. Protokol netreba písať, doplní sa http://. |
| Používateľ / Heslo | Vyplňte len pri proxy, ktorá vyžaduje prihlásenie. Heslo sa nezapisuje do appsettings.json, ale do úložiska poverení Windows. Zaškrtnutím Zobraziť heslo si ho skontrolujete. |
OK nastavenie potvrdí a rovno skontroluje, či je adresa použiteľná; pri chybe okno ostane
otvorené. Zrušiť (aj Esc a krížik) vráti hodnoty, aké boli pri otvorení okna.
Ak zaškrtnete Proxy server a adresu nezadáte, inštalátor vám okno otvorí sám pri stlačení
Ďalej ».
Inštalátor proxy predvyplní sám:
appsettings.json),Ak ju predvyplnenú hodnotu zmeníte alebo zaškrtnutie zrušíte, inštalátor vašu voľbu už neprepíše.
Prihlasovacie údaje zapísané priamo do adresy (http://meno:heslo@proxy.firma.sk:8080) inštalátor
rozdelí do polí Používateľ a Heslo – heslo sa tak nedostane do konfiguračného súboru ani do
logu.
Rovnaká proxy sa použije na kontroly dostupnosti na druhej strane, na stiahnutie API a zapíše sa aj
do konfigurácie nainštalovanej služby. Ktorá sa naozaj použije, vypíše okno kontrol v riadku
Proxy server – vrátane prípadu, keď pole nezaškrtnete, ale zariadenie samo má proxy nastavenú.
Ak cieľový adresár už obsahuje dáta, inštalátor sa opýta:
Kontroly sa spustia automaticky pri vstupe na stranu. Tlačidlo Ďalej » sa sprístupní, až keď prejdú.

| Kontrola | Čo overuje |
|---|---|
| Operačný systém | Podporovaná verzia a edícia Windows |
| Procesor / Operačná pamäť / Voľné miesto | Minimálne zdroje |
| QASIDA API v IIS | Aké API bežia v IIS |
| Služby AssecoQasidaAPI | Aké API bežia ako služby |
| Cieľ inštalácie | Ktorú inštaláciu beh nahradí, alebo že ide o novú |
| Adresár pre API | Kam sa API nainštaluje – vypočítané z disku a portu |
| Proxy server | Cez čo pôjdu odchádzajúce spojenia, alebo že idú priamo |
| Port | Či je zvolený port voľný, prípadne kto ho drží |
| ASOL HUB / Licenčný server / Mailový server / FTP | Dostupnosť služieb Asseco |
| Inštalačný kód | Načítanie z databázy |
| Verzia aplikačných skriptov | Minimálne 26.6 |
| Verzia inštalátora | Či nie je k dispozícii novšia |
| Užívateľ pre API v databáze | Či účet existuje a či sa s daným heslom prihlási |
| Role pre API účet | Či ich DL vie účtu prideliť (len upozornenie, neblokuje) |
| Kontrola licencie | Platnosť licencie na ALIS |
Význam značiek:
| Značka | Význam |
|---|---|
| ✓ zelená | prešlo |
| ! oranžová | neprešlo, ale neblokuje – nedostatok zdrojov, nedostupné FTP, chýbajúci účet pre API |
| ✗ červená | chyba, inštalácia nemôže pokračovať |
Ak zmeníte port, databázu alebo heslá a vrátite sa na túto stranu, kontroly sa spustia znova –
výsledky sa vždy vzťahujú na aktuálne zadané hodnoty.

| Pole | Význam |
|---|---|
| API používateľ | Používateľ, pod ktorým API pracuje s databázou (zoznam z databázy) |
| API mandant | Predvolený mandant |
| Výsledky aktualizácií – email | Adresa, na ktorú chodia správy o aktualizáciách databázy |
Ak kontrola zistila, že databázový účet pre API neexistuje, zobrazí sa navyše sekcia na jeho
vytvorenie. Meno je predvyplnené (QasidaAPI) a stačí zadať heslo.
Požiadavky na heslo: minimálne 8 znakov, veľké aj malé písmeno, číslica a špeciálny znak.
Heslo nesmie obsahovať dvojitú úvodzovku.
Inštalátor účet vytvorí a pridelí mu role, ktoré API potrebuje.
Ak účet už existuje, inštalátor mu tie isté role pridelí tiež – zoznam rolí sa medzi verziami
dopĺňa a účet založený starším inštalátorom by inak zostal bez tých, ktoré pribudli. Role, ktoré účet
už má, ani žiadne ďalšie, ktoré mu pridelil zákazník, sa pritom neodoberajú; iba sa dopĺňa.
Pridelenie rolí robí inštalátor pod účtom DL, takže DL musí mať právo tieto role postúpiť ďalej.
Napovie to už strana kontrol v riadku Role pre API účet (kapitola 3.2): ak podľa databázy DL
niektorú z rolí prideliť nevie, riadok ich vymenuje oranžovým upozornením. Inštaláciu to
nezastaví – databáza dokáže právo na pridelenie odovzdať aj cestami, ktoré sa takto zistiť nedajú,
takže posledné slovo má až samotné pridelenie.
Ak sa pridelenie naozaj nepodarí, beh sa zastaví skôr, než sa čokoľvek stiahne alebo prepíše –
zariadenie ostane nedotknuté a v podrobnom logu je príkaz grant … na ručné spustenie databázovým
administrátorom.
Na tejto strane je aj informácia o protokole – inštalácia prebehne v režime HTTP.
Tlačidlom Inštalovať sa spustí samotná inštalácia. Zobrazuje sa priebeh a jednotlivé kroky;
podrobnosti sa zapisujú do log súboru.
Po úspešnom dokončení sa tlačidlo zmení na Dokončiť. Ak niektorý krok zlyhal, inštalátor
vypíše zoznam chýb a pokyny, čo poslať podpore.
Posledným krokom inštalácie je skutočný self-update práve nainštalovaného API – tým istým
balíkom, ktorý sa pred chvíľou nainštaloval. Nie je to skúška nanečisto: spustí sa nástroj
SelfUpdate.exe z balíka, zastaví službu, vymení binárky, obnoví konfiguráciu, službu naštartuje
a počká na /health.
Je to tu preto, že úspešná inštalácia ešte nehovorí nič o tom, či sa API na danom zariadení dokáže
neskôr aktualizovať samo. Aktualizácia robí veci, ktoré inštalácia nerobí, a ktorúkoľvek z nich môže
zablokovať oprávnenie, antivírus alebo odlišné rozloženie adresárov u konkrétneho zákazníka. Lepšie
je to zistiť teraz, kým je pri tom technik, než o pol roka pri ostrej aktualizácii.
Keďže sa aplikuje tá istá verzia, úspech na inštalácii nič nemení. Ak test zlyhá, nástroj vráti
inštaláciu zo svojej zálohy a inštalátor to vypíše ako chybu – API je nainštalované a beží, ale
aktualizovať sa samo na tomto zariadení nedokáže. Podrobnosti aj log nástroja sú v podrobnom logu.
Zrušenie inštalácie je možné len do momentu, keď sa začne nahrádzať pôvodná inštalácia.
Od tej chvíle sa inštalátor zrušiť nedá – prerušenie by na zariadení nenechalo funkčné API
a nebolo by sa kam vrátiť. Beh je krátky, treba ho nechať dobehnúť.

Pri prvej inštancii C:\Qasida\QasidaAPI, pri ďalších C:\Qasida\QasidaAPI_<port>
(písmeno disku podľa výberu).
| Podadresár | Obsah |
|---|---|
Api |
Samotná aplikácia a appsettings.json |
InstantClient |
Oracle Instant Client vrátane SqlPlus |
Logs |
Logy služby (QasidaApi<dátum>.txt) |
DataProtectionKeys |
Kľúče, ktorými sú chránené uložené heslá |
ClientInstallFiles, DownloadInstallFiles |
Inštalačné súbory klienta |
| Vlastnosť | Hodnota |
|---|---|
| Názov | AssecoQasidaAPI, pri ďalších inštanciách AssecoQasidaAPI_<port> |
| Zobrazovaný názov | Asseco QASIDA API Service (pri ďalších s portom) |
| Spustenie | Automaticky (oneskorene) |
| Účet | Virtuálny účet NT SERVICE\<názov služby> |
| Pri zlyhaní | Trojnásobný automatický reštart po 60 sekundách |
Prečo oneskorene: pri bežnom automatickom štarte služba po reštarte servera súťaží s nábehom
systému – Oracle listener sa ešte len viaže na sieť (keď je databáza na tom istom zariadení), alebo
nie je hotová samotná sieť (keď je vzdialená). API vtedy databázu nenájde, nenaštartuje sa a server
nabehne bez neho. Oneskorený štart ho posunie približne dve minúty za boot; spolu s trojnásobným
reštartom pri zlyhaní to dáva asi päť minút tolerancie na pomalú databázu.
Ak databáza beží na tom istom zariadení, oplatí sa pridať ešte priamu závislosť na Oracle
službách – inštalátor ju nenastavuje, lebo Data Source býva často vzdialený a závislosť na
neexistujúcej službe by API zablokovala úplne (chyba 1075). V elevovanom príkazovom riadku:sc config AssecoQasidaAPI depend= OracleServiceXE/OracleOraDB21Home1TNSListener(presné názvy služieb zistíte cez
sc query type= service state= all; medzera zadepend=je
povinná)
<názov služby>-<port> pre prichádzajúce TCP spojenia.QASIDA_API_BASE_URL na adresu tohto servera. Ďalšie inštancie toto nastavenie nemenia,appsettings.json, ale do úložiska poverení Windows.Na jednom serveri môže bežať viac QASIDA API, každá na vlastnom porte.
AssecoQasidaAPI, C:\Qasida\QasidaAPI).QASIDA_API_BASE_URL mení len prvá inštancia.Ak port už niekto drží, inštalátor to oznámi na druhej strane a nepustí inštaláciu ďalej.
Ak na zvolenom porte beží QASIDA API pod IIS, inštalátor to zistí sám a ponúkne jej nahradenie
službou Windows. Postup:
appsettings.json (prihlasovacie údaje, Data Source, mandant).%ProgramData%\Asseco\QasidaApiInstaller\Backup ako ZIP zašifrovaný heslom pre update DBZ pôvodnej konfigurácie sa prenášajú tieto sekcie – v dvoch skupinách, ktoré sa pri konflikte
správajú opačne:
| Sekcie | Čo sa stane, ak ich nová konfigurácia už obsahuje |
|---|---|
ServerAgent, OpenBanking, LdapAuth, QasidaHub, QasidaMobile, Firmsio |
Ponechá sa hodnota z novej konfigurácie, pôvodná sa neprenesie. |
SpinApi, ExchangeRateListImport |
Prenesie sa pôvodná hodnota a novú prepíše. |
Zo sekcie SpinApi sa teda nič nestráca – zoznam zapnutých modulov aj ostatné kľúče zostanú
presne také, aké boli. Inštalátor do zoznamu SpinApi:EnabledModules len doplní moduly
SpinEshop a SpinUpdater, ak v ňom nie sú; bez nich by API nainštalovalo a naštartovalo sa, ale
nefungoval by eshop ani self-update. Čo bolo v zozname navyše (napríklad AsolAuth, SpinPayroll),
tam ostáva. Doplnenie sa vypíše v priebehu inštalácie.
Prihlasovacie údaje vo všetkých týchto sekciách sa neprenášajú do súboru, ale do úložiska poverení.
Sekciu Proxy inštalátor neprenáša – zapisuje si ju sám podľa nastavenia na prvej strane. Hodnoty
z pôvodnej konfigurácie sa tam predvyplnia (kapitola 3.1), takže výsledok je rovnaký, ale je vidieť
a dá sa zmeniť ešte pred inštaláciou.
Obmedzenie: ak je QASIDA API v IIS len aplikáciou pod cudzou stránkou, inštalátor port
uvoľniť nedokáže – port patrí bindingu tej stránky a jej zastavenie by zhodilo aj ostatné
aplikácie. V takom prípade inštalátor inštaláciu odmietne. Riešením je odstrániť binding na daný
port ručne v IIS Manageri, alebo zvoliť pre API iný port.
http://<server>:<port>/healthAllowedHosts v appsettings.json – inak takúto požiadavku API odmietne. Jednotlivé hodnoty sa| Log | Umiestnenie |
|---|---|
| Podrobný log inštalácie | %ProgramData%\Asseco\QasidaApiInstaller\Logs\install-<dátum-čas>.log |
| Log služby | <inštalačný adresár>\Logs\QasidaApi<dátum>.txt |
| Konfigurácia služby | <inštalačný adresár>\Api\appsettings.json |
| Záloha pôvodnej konfigurácie | %ProgramData%\Asseco\QasidaApiInstaller\Backup |
Cestu k logu aj ku konfigurácii inštalátor vypíše na poslednej strane.
| Hlásenie | Príčina a riešenie |
|---|---|
| Port … obsadzuje … | Port drží iný proces alebo IIS stránka. Zastavte ju, alebo zvoľte iný port. |
| QASIDA API na porte … je v IIS len aplikáciou pod stránkou … | Viď obmedzenie v kapitole 6 – odstráňte binding ručne, alebo zvoľte iný port. |
| Stav portu … sa nepodarilo zistiť | Systém nedokázal vrátiť zoznam načúvajúcich portov. Skúste inštaláciu zopakovať. |
| Existenciu databázového užívateľa … sa nepodarilo overiť | Dopyt do databázy zlyhal. Skontrolujte dostupnosť databázy a heslo DL. |
| Užívateľ … existuje, ale pripojenie zlyhalo | Zadané heslo pre API účet nie je správne. |
| Na tomto zariadení chýba .NET runtime… | Doinštalujte uvedený ASP.NET Core Runtime – Hosting Bundle. |
| Služba … sa ani za … nezačala načúvať na porte … | Služba sa nerozbehla. Pozrite log služby v podadresári Logs. Ak sú v logu inštalátora chyby 1053, štart nestihol 30-sekundový limit Windows – pozri nižšie. Čas v sekundách (namiesto minút) znamená, že služba padala hneď, nie že štartovala pomaly. |
| Služba … sa ani po … pokusoch o spustenie neudržala bežať | Služba sa spustí a hneď padá. Dôvod býva v jej logu v podadresári Logs – chýbajúca knižnica, zlá konfigurácia. Port v tomto prípade nedrží nikto iný. |
The service did not respond to the start or control request in a timely fashion je limit
Windows, nie chyba služby: správca služieb dá službe 30 sekúnd na ohlásenie, že beží, a potom ju
ukončí.
Prvý štart po inštalácii býva pomalý, lebo antivírus skenuje všetkých ~600 práve skopírovaných
súborov pri ich načítaní. Inštalátor s tým počíta – skúša štart opakovane päť minút a každý ďalší
pokus je rýchlejší, lebo súbory už sú v cache skenera.
Ak sa to na danom zariadení opakuje, pridajte výnimku antivírusu pre inštalačný adresár
(štandardne C:\Qasida\QasidaAPI) a inštaláciu zopakujte.
| Verzia aplikačných skriptov je nižšia ako 26.6 | Najprv aktualizujte databázu. |
| Je dostupná novšia verzia inštalátora | Stiahnite a použite aktuálny inštalátor. |
Inštalátor na záver vypíše zoznam chýb a vyzve na kontaktovanie podpory. Pripravte dva súbory:
appsettings.json z inštalačného adresára,Odošlite ich cez zákaznícky portál:
https://customer-portal.qasida.sk/
Súbory môžu obsahovať heslá – posielajte ich len cez portál, nie e-mailom.