Installera Rebnis Portal (även känd som Rebnisportalen)

Rebnis Portal är en lokal webbtjänst som är tänkt att ge kunderna möjlighet att enkelt och på ett samlat ställe komma åt översikter och funktioner i våra system. Tanken är att den ska installeras på kundens server och att de sedan kan surfa till sidan i sitt intranät, t.ex. via adressen "http://servern:8080" eller liknande.InstallationPortalen i sig drivs som en tjänst och installeras via ett msi-paket. Mer om det nedan.Sedan förlitar sig Portalen på att den kan snacka med Jupiter-databasen, Jupiter Server, Jupiter Web API samt Rebnis Kassa's service runner.FörhandskravPortal 1.0 För att kunna installera Portalen krävs att ASP.NET Core Runtime 8 Hosting Bundle är installerat. Det går att hämta härifrån. Kom ihåg att välja HOSTING BUNDLE.Tidigare versionerFör att kunna installera Portalen krävs att ASP.NET Core Runtime 7 Hosting Bundle är installerat. Det går att hämta härifrån. Kom ihåg att välja HOSTING BUNDLE.Tänk även på att .NET inte går att köra på hur gamla operativsystem som helst. Dessa stöds enligt Microsoft för .NET 7:(hämtad härifrån)Dessa stöds för .NET 8:(hämtad härifrån)StädrappenStädrappen ingår numera i Portalen och därför måste den tidigare varianten avinstalleras innan Portalen läggs in. Ta dock reda på vilken port den tidigare städrappen kördes på, så att du kan installera Portalen på samma port. Den informationen finns antingen i IIS'en (om det är den riktigt gamla varianten av Städrappen som är installerad) eller i "appsettings.json" i AdminWeb-mappen. Kolla vad som står på "Urls:"-raden.Avinstallera sedan så här:Kör kommandotolken som administratörTa dig till mappen där AdminWeb liggerSkriv "Rebnis.Jupiter.AdminWeb.exe /uninstall" och tryck enterNu bör tjänsten ha blivit avinstalleradTa bort AdminWeb-mappenKöra Portalen mot JupiterSom tidigare nämnts måste tre saker vara installerade/fungerande för att Portalen ska kunna hämta information från Jupiter utan problem:Rebnis Jupiter WebAPILäs här för instruktioner hur den installerasJupiter Server (antingen via Console eller IIS)Jupiters databasInstallera PortalenDet är rekommenderat att den installeras på samma dator där våra övriga system ligger installerade. Gör sedan så här:Kopiera över "Rebnis Portal.msi" till servern där Portalen ska installeras.Starta trollkarlen genom att dubbelklicka på msi-filen.Portalen säger ifrån om .NET saknas på datorn. Det går dock att gå förbi denna varning, men det rekommenderas bara om man misstänker att varningen visas felaktigt. Följden av att installera utan .NET blir att tjänsten "Rebnis Portal" inte kan starta och Portalen fungerar följaktligen inte.Klicka "Next" och peka sedan ut en lämplig plats att lägga Portalen på. Ett bra ställe är \Rebnis\Privat\Portal.Klicka "Next" och välj vilken port Portalen ska köras på. OM kunden kör städrappen sedan tidigare är det lämpligt att välja samma port som städrappen redan körs på. Kom sedan ihåg att avinstallera städrappen, se längre upp i denna guide.Sedan installeras PortalenKonfigurera PortalenNär Portalen installerats öppnar den ett webbläsarfönster där du får ställa in inställningarna till var de nödvändiga tjänsterna som Portalen ska snacka med ligger. Denna sida går även att nå via http://[serverdator]:[port]/settings om du behöver ändra någon inställning.Kryssa i och fyll i de system som Portalen ska komma åt. Tänk på att sökvägarna ska vara relativa till datorn där Portalen är installerad. Normalt kommer Portalen att ligga installerad på serverdatorn, så localhost är i det fallet korrekt.Det går även att testa anslutningen för att se att Portalen får kontakt.När du trycker "Spara" ska tjänsten "Rebnis Portal" automatiskt startas om och webbsidan tappar därför kontakten.Det har visat sig att i vissa fall lyckas den inte starta tjänsten på nytt igen, så därför kan den behöva startas igen manuellt.När tjänsten sedan är igång igen borde du kunna surfa till Portalens startsidaTÄNK PÅ! att du kan behöva göra undantag för den port du valt att installera portalen på i Windows-brandväggen på serverdatorn. Om detta inte är gjort kan det bli så att Portalen funkar fint på servern, men går inte att nå från övriga datorer.Gör så här:Öppna Windowsbrandväggen genom att trycka "Win + R" och skriv "firewall.cpl"Tryck OKTryck på "Avancerade inställningar"Markera sedan "Regler för inkommande trafik" och sedan "Ny regel"Välj "Port" i trollkarlen som dyker upp. Tryck sedan "Nästa"Skriv in det portnummer som du angav när du installerade Portalen i rutan "Specifika lokala portar". Ändra inget annat.Tryck "Nästa" tre gånger, tills du kommer till rubriken "Namn"Döp regeln till "Rebnis Portal" och tryck "Slutför"Nu borde det gå att surfa till Portalen även från andra datorer (så länge de är med i samma nätverk som servern)Flera Rebnis Portal på samma serverFör att installera flera Rebnis Portal på samma server i de fall det finns flera installationer av Rebnis Kassa eller Jupiter så rekommenderas att man använder zip-filen "Rebnis.Portal.zip".Packa upp innehållet i en lämplig mapp.Öppna appsettings.json och ändra detta:"TenantProfile": "Default" till något lämpligt."Urls": "http://*:80" till en lämplig port.Skapa upp tjänsten manuellt:Öppna cmd som admin.skriv "sc create Rebnis.Portal.<något lämpligt> start= auto binPath= <sökvägen till Rebnis.Portal.exe>" och tryck enter.Starta sedan tjänsten och gå in på URL:en och ställ in enligt ovan.Varje Rebnis Portal kommer få en egen TenantProfile.json under C:\ProgramData\Tenants\<det man angav som TenantProfile i appsettings.json>\TenantProfile.json.OBS! Flera installationer kräver ju också flera WebApi och Jupiter Server.