Navodila za lokalno namestitev PANTHEON Web Terminal
V tem poglavju je opisano, kako namestiti PANTHEON Web Terminal na lokalni strežnik.
 |
OPOZORILO
Spodaj so navedena tehnična navodila, ki so lahko v pomoč pri nekaterih vidikih konfiguriranja namestitvenega programa za PANTHEON Web Light. Pri uporabi teh navodil je potrebna določena raven tehničnega znanja o delu s strežniki.
|
Namestitveni program namesti vse potrebne storitve v IIS in samostojno storitev (WorkflowService), s čimer omogoči polno funkcionalnost PAW. Med namestitvijo se ustvari nova podatkovna baza PAW_master, ki vsebuje povezave do povezanih PANTHEON-ovih podatkovnih baz.
Privzeta vrata strežnika so 9000, zato lahko uporabnik po namestitvi za dostop do sistema PAW in prijavo v PANTHEON-ovo podatkovno bazo, ki je bila izbrana med namestitvijo, zažene localhost:9000 (ali vnese ustrezni IP ali ime strežnika).
- Operacijski sistem Microsoft Windows Server 2019 ali novejši
- Microsoft SQL Server 2019 ali novejši
- Microsoft .NET 4.8 ali novejši
- Nameščen Microsoft IIS (v vlogi strežnika)
- Obvezna namestitev spodnjih funkcij IIS:
- .NET extensibility 4.7
- ASP.NET 4.7
 |
NAMIG
Znova zaženemo strežnik, če je to zahtevano po namestitvi .NET Core.
|
- Nameščen en Microsoft SQL strežnik ali več, eden za podatkovno bazo PAW_master, drugi (priporočljivo) za PANTHEON-ove podatkovne baze – lahko je tudi isti, če ni mogoče drugače.
- Nameščen PANTHEON (samo podatkovna baza, brez EXE)
- Uporabnik SQL strežnika, ki ima dovoljenje za kreiranje nove podatkovne baze (PAW_master)
- Uporabniki SQL strežnika, ki lahko dostopajo do PANTHEON-ovih podatkovnih baz (samo za preverjanje povezave). Če je SQL instanca enaka za podatkovno bazo PAW_master in PANTHEON-ovo podatkovno bazo, je uporabnik lahko isti.
4.1. Vnašanje podatkov o PAW Master SQL strežniku
Vnesemo SQL strežnik, uporabniško ime in geslo.
Podatkovna baza PAW_master se avtomatsko kreira, če je potrebno.
4.2. Vnašanje podatkov o PANTHEON SQL strežniku
Vnesemo podatke o PANTHEON SQL strežniku in ime PANTHEON-ove podatkovne baze (strežnik je lahko isti kot zgoraj):
4.3. Jezik PANTHEON Web Light vmesnika
|
OPOZORILO
Jezik PANTHEON Web Light vmesnika mora biti enak jeziku izbranega podjetja.
|
V datoteki BackOffice/POS.config poiščemo SiteConfig.
Jezik PANTHEON Web Light vmesnika spremenimo tako, da pri ustrezni vrstici odstranimo programerske oznake za komentar.
|
OPOZORILO
Pri namestitvah s cirilično pisavo je treba polje databaseLocalization vnesti natančno tako, kot je vneseno v PANTHEON-u. Podatke iz PANTHEON-ove podatkovne baze pridobimo tako, da zaženemo spodnjo SQL poizvedbo:
select acISOCode from the_setCountry where acCountry = (select acCountry from the_setSubj where acSubject = (select acOurCompany from tpa_sysparam))
|
4.4. Privzeti kontrolnik
Za pravilno odpiranje Web Terminal je treba v datoteki POS.config nastaviti defaultController na Manufacturing. To je treba nastaviti v vrstici, ki ni del komentarja.
PANTHEON Automation Server (PAAS) se avtomatsko namesti ali nadgradi med namestitvijo ali nadgradnjo PANTHEON Web Light.
*Pri nadgradnjah iz obstoječe namestitve (pred različico 23.10): po nadgradnji je treba datoteko PAW\PA\PAAS.ini ročno urediti, saj je kot privzeta vrednost za ServerName nastavljen trenutni strežnik, medtem ko je to vrednost treba spremeniti v strežnik PANTHEON-ove podatkovne baze.
|
OPOZORILO
Po namestitvi je treba ročno prenesti datoteko Pantheon.exe za našo lokalizacijo in jo kopirati v mapo PAW\PA. Pantheon.exe, ki je že v tej mapi, uporablja lokalizacijo EU (angleščina) in morda ni primeren za našo konfiguracijo. V tem primeru preprosto zamenjamo obstoječi Pantheon.exe.
|
Odpremo tabelo “tRA_MasterComSite” v novo kreirani podatkovni bazi PAW_master. Dodamo nove vrstice po zgledu že vstavljene vrstice. Vsaka vrstica je povezava na drugo PANTHEON-ovo podatkovno bazo.
- Vrata (samo za napredne uporabnike)
V PANTHEON Web Light morajo biti vrata 9000, 9001, 9003 in 9004 privzeto prosta, ker namestitveni program uporablja ta vrata za namestitev različnih PANTHEON Web Light storitev. Če je treba PANTHEON Web Light namestiti na druga vrata, se obrnite na podporo uporabnikom.
- WebApi: v brskalniku odpremo localhost:9001/swagger. Če se karkoli odpre, storitev deluje.
- BackOffice: v brskalniku odpremo localhost:9000. Če se odpre prijavni zaslon, storitev deluje.
- WorkflowService: v brskalniku odpremo localhost:9003. Če zahteva uporabniško ime/geslo, storitev deluje.
- PAAS: v brskalniku odpremo localhost:9004. Če se stran odpre, storitev deluje.
To je zelo pogosta napaka, ki jo lahko povzročijo številne različne možnosti konfiguracije ali sistemske napake. Tukaj so navedene nekatere najpogostejše težave z možnostmi konfiguracije, ki jih je treba preveriti:
- PANTHEON Web Light ne podpira prijave brez gesla, medtem ko PANTHEON podpira.
- Preverimo, ali so izpolnjene zgornje zahteve in ali vse tri storitve delujejo (WebApi, WorkflowService, PAAS).
- Prepričamo se, da je v polju Naša država na panelu Podjetje v Administratorski konzoli v PANTHEON-u vnesena določena vrednost.
- Preverimo, ali je jezik PANTHEON Web Light vmesnika enak jeziku države podjetja. Več informacij je na voljo v zgornjih navodilih.
- Preverimo, ali je v ciljni podatkovni bazi nameščena pravilna licenca za PANTHEON Web Light.
- Preverimo uporabniška dovoljenja za PANTHEON Web Light v PANTHEON-u.
Tukaj so navedeni še nekatere druge možne napake in nasveti za njihovo odpravljanje:
- Napaka HTTP 500.19 – Notranja napaka strežnika, pri čemer ena od prvih vrstic vsebuje Modul IIS Web Core.
- Znova zaženemo .NET Core 2.1. Hosting bundle installer, izberemo Repair (Popravilo) in po namestitvi znova zaženemo IIS.
- V programu EventViewer je prišlo do napake pri pisanju v mapi WebApi/logs:
- V mapi WebApi kreiramo podmapo logs in vsem dodelimo polna dovoljenja zanjo.
- V datoteki WebApi/web.config preverimo, ali je <aspNetCore processPath="dotnet.exe"...> na voljo na naši sistemski poti.