Priročnik za lokalno namestitev PANTHEON Web Light

To je tehnični priročnik, v katerem lahko pregledamo nekatere konfiguracijske aspekte namestitvenga programa PAW. Ta priročnik zahteva določeno stopnjo tehničnega znanja pri delu s strežniki.

Namestitveni program namesti vse potrebne stortive v IIS in samosojno različico Workflov ervisov, kateri omogoča popolno delovanje PAW. Med namestitvijo se bo kreirala nova "PAW_master" baza, katera omogoča povezave med ostalimi PANTHEON podatkovnimi bazami. Privzeta vrata strežnika so 9000, zato uporabnik po namestitvi lahko zažene localhost:9000 (ali pa ustrezen IP oz. ime strežnika). Za prijavo preko brskalnika v PAW upošteva prijavne podatke za PANTHEON (uporabnik, geslo, sistemski naziv baze). 

1. Predpogoji za ISS

• Microsoft Windows Server 2016 operacijski sistem ali novejši
• Microsoft SQL Server 2016 ali novejši
• Microsoft .NET 4.8 ali novejši
• Microsoft IIS namestitev (nameščen kot strežniška vloga - server role)
• Potrebne funkcije za IIS:
  • .NET extensibility 4.7
  • ASP.NET 4.7

• .NET Core 2.1. Hosting bundle (prenesete ga lahko na: https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-2.1.20-windows-hosting-bundle-installer)

NAMIG Po namestitvi  .NET Core ne pozabite znova zagnati strežnika, če se vas program pozove k temu.

2. Predpogoji za SQL Server

• Nameščen eden ali več MSSQL strežnikov (Eden za  PAW_master, drugi  (priporočeno) ali isti za Pantheon bazo)
• Pantheon namestitev (za potrebe PAW  je pomembna samo baza, ne program / EXE)
• Uporabnik strežnika SQL, ki ima pravico kreirati novo bazo (PAW_Master)
• Uporabnik strežnika SQL, ki lahko dostopa do Pantheon baze ali več baz (samo za preverjanje povezave).  V primeru, da je SQL instanca ista za  PAW_master  bazo in Pantheon bazo, je  lahko uporabnik tudi isti.

3. Predpogoji za PANTHEON 

• Aktivirana (ustrezna) PAW licenca
• Država "našega podjetja" v šifrantu subjektov ne sme biti prazna.

4. Namestitev – pomembni koraki

3.  PowerShell konzola

Pred namestitvijo odprite PowerShell konzolo kot administrator in zaženite: 

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

Po namestitvi spremenite nastavitev  nazaj na prejšnjo vrednost:

Set-ExecutionPolicy -ExecutionPolicy Restricted

----////

4. Namestitev – pomembni koraki

Prenesite Pawsetup.exe iz Datalab ftp: http://ftp.datalab.si/upgrade/si/release/PAW/ . Nahaja se v stisnjeni obliki .7z 

• Vnesite podatke o PAW master SQL strežniku

:

Kreirala se bo PAW_master baza

• Vnesite  informacije o Pantheon SQL strežniku in Pantheon bazi (lahko je isti server kot zgoraj)
  

V Paw_ master se bo dodal zapis o tej bazi. 

Dostop do lokalno nameščenega PAWa lahko preizkusite preko brskalnika, tako da vpišete localhost:9000.Prikazati bi se moralo prijavno okno za Pantheon WEB.  Dodatno lahko nastavimo druga vrata in nastavimo zunanji dostop

//Po namestitvi ne pozabite na PowerShell (korak3)

5. Dodatne konfiguracijske nastavitve

• Dodatni dostopi

V novo kreirani bazi PAW_Maste odprite tabelo  “tRA_MasterComSite”. Dodajte nove vrstice in vstavite podatke po zgledu iz že vstavljenih vrstic. Vsaka vrstica predstavlja povezavo do druge  Pantheon baze.

• Privzet jezik vmesnika PAW

V BackOffice/Web.config datoteki, poiščite  “SiteConfig”. Odkomentirajte ustrezno vrstico, da spremenite privzeti jezik Pantheon WEB.

• Vrata / porti  (samo za napredne uporabnike)

Privzeto PAW strežnik posluša na vratih 9000, PAW API na vratih 9001 in PAW Workflow servis na 9003. V primeru, da je potrebna menjava vrat, mora biti ta opravljena tako v IIS kot tudi v naslednji konfiguracijskih datotekah:

- BackOffice/Web.config

<add key="PAWMasterWebApiUrl" value="http://localhost:9001/api" />

<add key="PantheonWebApiUrl" value="http://localhost:9001/api" />

- WebService/PAWorkflowWSSrv.ini

6. Odpravljanje napak / preverjanje, če storitve delujejo

• WebApi: V brskalniku odpri localhost:9001/swagger. IČe se odpre karkoli, storitev deluje.
• BackOffice: V brskalniku odpri localhost:9000swagger. Če se odpre prijavni zaslon, deluje.
• WorkflowService: V brskalniku odpri  localhost:9003swagger. V kolikor vas sprašuje za uporabniško ime in geslo, deluje.

V kolikor   ne deluje WorkflowService:

• preverite delovanje procesa  PAWorkflowWSSRV  in ga ustavite
• zaženite PAW\WebService\RunWFSrvr.bat iz PAW namestitvene mape. CMD okno (okno Ukaznega poziva) mora ostati odprto (ne odjavite se iz strežnika, ampak samo prekinite povezavo s strežnikom).

Napake pri prijavi 

• zelo pogosta napaka, katere razlog je lahko širok spekter konfiguracijskih  nastavitev ali sistemskih napak. Navajamo samo nekatere najpogostejše:

• PAW ne podpira prijave brez gesla, kot je to podprto pri PAntheonu
• Preverite zgornje predpogoje in  preverite delovanje vseh treh storitev ( WebApi, WorkflowService, WebApi)
• "Naše podjetje" mora imeti državo
• preverite, če je prava licenca na cilji bazi oz serijski številki te baze
• preverite avtorizacije za PAW ( preko Pantheona)