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

• 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):

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.

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))

• Podrazumevani jezik PAW

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

• 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.

Ako WorkflowService ne radi:

• proverite proces PAWorkflowWSSRV i prekinite njegovo izvršenje
• izvršite PAW\WebService\RunWFSrvr.bat iz PAW direktorijuma za podešavanje. CMD prozor mora ostati otoren (ne odjavljujte  se sa servera, već prekinite vezu)

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 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.