PAW – uputstvo za instalaciju

Ovo je tehnički priručnik koji podržava određene aspekte konfiguracije instalacionog programa PAW. Ovaj priručnik pretpostavlja određeni nivo tehničkog znanja rada sa serverima.

Kratak pregled instalacije:

Instaler instalira sve potrebne usluge u IIS-u i samostalnom (Workflow servis) kako bi omogućio punu PAW funkcionalnost. Tokom instlacije kreira se nova baza podtaka "PAW_ master" koja sadrži veze do pridruženih baza podataka Pantheon-a. Podrazumevani port servera je 9000, tako da nakon instalacije korisnik može pokrenuti localhost:9000 (ili odgovarajuću IP adresu ili ime servera) kako bi pristupio PAW-u i prijavio se u Pantheon bazu podataka koja je izabrana tokom instalacije.

1. IIS Preduslovi

• Microsoft Windows Server 2016 operativni sistem ili noviji
• Microsoft SQL Server 2016 ili noviji
• Microsoft .NET 4.8 ili noviji
• Microsoft IIS instalacija (instaliran sa ulogom servera)
• Obavezne karakteristike IIS:
  • .NET extensibility 4.7
  • ASP.NET 4.7

• .NET Core 2.1. paket hosting (link za preuzimanje: https://dotnet.microsoft.com/download/dotnet-core/thank-you/runtime-aspnetcore-2.1.20-windows-hosting-bundle-installer)

2. SQL Server Preduslovi

• Instalirano je jedan ili više mssql servera (Jedan za PAW_master, drugi ili isti za baze podataka Pantheon)
• Instalacija Pantheon-a (potrebna je samo baza podataka, a ne EXE)
• Korisnik SQL servera koji ima dozvolu za kreiranje nove baze podataka (PAW_master)
• Korisnici SQL servera koji mogu pristupiti bazama podataka Pantheona (samo radi provere veze). Ako je SQL instanca ista za PAW_master i Pantheon, to je isti korisnik.

3. Pantheon preduslovi

• Aktivirana PAW licenca
• Polje države ne može biti prazno za "Naše preduzeće" u Pantheonu

Instalacija - važni koraci

Preuzmite instalacioni fajl sa: http://ftp.datalab.si/upgrade/si/release/PAW/​

• Unesite informacije o PAW Master SQL serveru:
• Unesite informacije o Pantehon SQL serveru, zajedno sa imenom Pantheon baze podataka (može biti isti server kao gore):
• PAW jezik

• Upozorenje: PAW jezik mora da bude isti kao država kod našeg preduzeća.

U BackOffice/Web.config potražite datoteku “SiteConfig”. Uklonite komentar za odgovarajući red da biste promenili zadati jezik PAW.

Za instalacije sa ćirilicom, unesite u polje databaseLocalization baš onako kako je uneto u Pantheonu. Pokrenite SQL upit da biste dobili podatak iz Pantheon baze: select acISOCode from the_setCountry where acCountry = (select acCountry from the_setSubj where acSubject = (select acOurCompany from tpa_sysparam))

5. Dodatne opcije konfiguracije

• Dodatne web stranice

Otvorite tabelu "tRa_MasterComSite"  u novo kreiranoj PAW_Master bazi podataka. Dodajte nove redove na primeru već umetnutih redova. Svaki red je link do druge baze podataka Pantheon-a.

• Portovi (samo za napredne korisnike)

Podrazumevano, PAW server preslušava na portu 9000, PAW api na portu 9001 i PAW Workflow servis na portu 9003. U slučaju da je potrebna promena portova, to treba promeniti i u IIS i u sledećim konfiguracionim datotekama:

- BackOffice/Web.config

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

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

- WebService/PAWorkflowWSSrv.ini

6. Provera da li su servisi operativni

• WebApi: otvorite u pretraživaču localhost:9001/swagger. Ako se bilo šta otvori, radi
• BackOffice: otvorite u pretraživaču localhost:9000. Ako se otovri ekran za prijavu, radi
• WorkflowService: otvorite u pretraživaču localhost:9003. Ako zatraži korisničko ime/lozinku, radi.

7. Greška za nevažeću prijavu

Ovo je česta greška, koja može biti uzrokovana velikim brojem opcija konfiguracije ili sistemskim greškama. Navedene su neke, verovatno ne sve opcije, koje treba proveriti:

• PAW ne podržava prijavu bez lozinke, kao što Pantheon podržava   
• Proverite gore navedene preduslove i proverite da li su sva tri servisa pokrenuta (WebApi, WorkflowService, WebApi)
• "Naše preduzeće" u Pantheonu mora da ima podešenu državu
• Proverite da li je PAW jezik isti kao država kod Našeg preduzeća (videti iznad kako ovo da proverite / ispravite)
• Proverite da  li je ispravna licenca za PAW instalirana u ciljnoj bazi 
• Proverite autorizacije za PAW za tog korisnika  (u Pantheonu)

8. Ostale greške

Postoji još nekoliko mogućih grešaka i njihovo rešavanje:

• Http Error 500.19 - Internal Server Error i jedna od prvih linija sadrži Module IIS Web Core.
  • ponovo pokrenite .NET Core 2.1. Hosting bundle installer (odaberite Repair), posle instalacije restartujte IIS
• U EventViewer je greška writing to WepApi/logs
  • U folderu WebApi kreirajte podfolder logs i dajte svima (everyone) full permissions na njega.