Tempus:Sjaforportal installasjon: Forskjell mellom sideversjoner

Fra DataGrafikk
Hopp til navigeringHopp til søk
(Ny side: DataGrafikk Sjåførportal – Installasjonssveiledning Innholdsfortegnelse FORORD 2 1. INTRODUKSJON 3 2. INSTALLASJON AV APPLIKASJONSSERVER 4 2.1. Installasjon 4 2.2. Konfigurasjon 8...)
 
Ingen redigeringsforklaring
Linje 1: Linje 1:
DataGrafikk
{{DISPLAYTITLE:Sjåførportal – Installasjonssveiledning }}
Sjåførportal – Installasjonssveiledning  


Innholdsfortegnelse
FORORD 2
FORORD 2
1. INTRODUKSJON 3
1. INTRODUKSJON 3
Linje 17: Linje 15:
   
   


Forord
= Revisjonshistorikk =
 
Dato - Grunn for endring
Revisjonshistorikk
22.10.2013 - Første versjon av dokument
Versjon Dato og forfatter Grunn for endring
07.04.2016 - Config flyttet til xml-fil. ASP.NET-side distribusjon endret fra msi til zip.
1.0 22.10.2013
Gjert-André Første versjon av dokument
1.1 07.04.2016
Gjert-André Config flyttet til xml-fil




   
   
1. Introduksjon
= Introduksjon =


Dette er en installasjonsveiledning for Sjåførportalen og Tempus Applikasjonsserver. Disse er frittstående tjenester utenom DGTempus og krever eget oppsett og konfigurasjon utenom DGTempus.
Dette er en installasjonsveiledning for Sjåførportalen og Tempus Applikasjonsserver. Disse er frittstående tjenester utenom DGTempus og krever eget oppsett og konfigurasjon utenom DGTempus.
Linje 35: Linje 29:




Definisjoner og forkortelser
== Definisjoner og forkortelser ==


For dette dokumentet gjelder følgende termer og definisjoner.
For dette dokumentet gjelder følgende termer og definisjoner.
Linje 43: Linje 37:


   
   
2. Installasjon av applikasjonsserver
= Installasjon av applikasjonsserver =


Applikasjonsserveren publiserer utvalgte deler av Tempus-databasen som en webservice. Denne brukes i dag foreløpig kun av sjåførportalen, så det er bare det som er relevant for aktiviteter som gjøres tilgjengelig. Tilgangen styres via en rolle i databasen kalt «appserver».
Applikasjonsserveren publiserer utvalgte deler av Tempus-databasen som en webservice. Denne brukes i dag foreløpig kun av sjåførportalen, så det er bare det som er relevant for aktiviteter som gjøres tilgjengelig. Tilgangen styres via en rolle i databasen kalt «appserver».
Linje 49: Linje 43:
Feltene og tabellene som selve kjøreoppdraget inneholder og som sjåføren kan lagre eventuelle avvik og tilbakemeldinger til, er faste. Kjøreordren som kjørekontoret kan skrive ut er det imidlertid mulig å tilpasse til den enkelte kundes behov.
Feltene og tabellene som selve kjøreoppdraget inneholder og som sjåføren kan lagre eventuelle avvik og tilbakemeldinger til, er faste. Kjøreordren som kjørekontoret kan skrive ut er det imidlertid mulig å tilpasse til den enkelte kundes behov.


Alle tabeller og felter som kjøreordren i papirformat kan inneholde er derfor ikke tilgjengelig i denne rollen. Hvis man vil publisere kjøreordren som en PDF rett i sjåførportalen må man derfor foreløpig sette opp databasetilgangen til applikasjonsserveren enten med rettigheter til alt, eller legge til lesetilgang til de nødvendige tabellene til rollen.
Alle tabeller og felter som kjøreordren i papirformat kan inneholde er derfor ikke tilgjengelig i denne rollen. Rapportgeneratoren kan eventuelt bruke ini-filen fra Tempus for å få ødvendig tilgang.
2.1. Installasjon
 
== Installasjon ==


Installasjon av applikasjonsserveren er forholdsvis enkelt. Start installasjonsfilen (TempusAppServer.msi). Du blir møtt av følgende vindu:
Installasjon av applikasjonsserveren er forholdsvis enkelt. Start installasjonsfilen (TempusAppServer.msi). Du blir møtt av følgende vindu:
Linje 76: Linje 71:


   
   
2.2. Konfigurasjon
== Konfigurasjon ==


Som standard vil applikasjonsserveren ligge her:
Som standard vil applikasjonsserveren ligge her:
Linje 84: Linje 79:
I katalogen applikasjonsserveren er installert i ligger det tre konfigurasjonsfiler.
I katalogen applikasjonsserveren er installert i ligger det tre konfigurasjonsfiler.


2.2.1. Databaseinfo - TempusAppServer.daConnections
=== Databaseinfo - TempusAppServer.daConnections ===


Denne filen inneholder databasetilkoblingsinfo. Filen ser slik ut:
Denne filen inneholder databasetilkoblingsinfo. Filen ser slik ut:
Linje 120: Linje 115:




2.2.2. Andre innstillinger - DataGrafikk.TempusAppServer.exe.config
=== Andre innstillinger - DataGrafikk.TempusAppServer.exe.config ===


Her settes alle andre applikasjonsserver-spesifikke innstillinger. Filen inneholder følgende:
Her settes alle andre applikasjonsserver-spesifikke innstillinger. Filen inneholder følgende:
Linje 184: Linje 179:
Merk at sessiondata lagres i minne, så etter en restart av applikasjonsserveren må brukerne alltid logge inn på nytt.
Merk at sessiondata lagres i minne, så etter en restart av applikasjonsserveren må brukerne alltid logge inn på nytt.


2.2.3. Rapportgenerator - dgdb.ini
=== Rapportgenerator - dgdb.ini ===
I de fleste tilfeller vil rapportgeneratoren som bl.a. lager nedlastbare pdf-versjoner av kjøreordre trenge utvidet tilgang databasen i forhold til applikasjonsserveren. Rapportgeneratoren kan lese egne tilkoblingsinnstillinger fra filen dgdb.ini. Denne er identisk med Tempus sin dgdb.ini-fil, så man kopierer i tilfelle denne filen fra Tempus.   
I de fleste tilfeller vil rapportgeneratoren som bl.a. lager nedlastbare pdf-versjoner av kjøreordre trenge utvidet tilgang databasen i forhold til applikasjonsserveren. Rapportgeneratoren kan lese egne tilkoblingsinnstillinger fra filen dgdb.ini. Denne er identisk med Tempus sin dgdb.ini-fil, så man kopierer i tilfelle denne filen fra Tempus.   


2.3. Starte applikasjonsserveren
== Starte applikasjonsserveren ==


Start servicen "TempusAppServer service". Sjekk også at den er satt opp til å starte automatisk, og evt. til å restarte hvis den feiler:
Start servicen "TempusAppServer service". Sjekk også at den er satt opp til å starte automatisk, og evt. til å restarte hvis den feiler:
Linje 195: Linje 190:
   
   
   
   
3. Installasjon av Sjåførportalen
= Installasjon av Sjåførportalen =


Sjåførportalen er en ASP.NET webside som lar sjåfører se på og returnere kjøreordre. Denne må installeres på en IIS webserver. Den krever at .NET Framework 3.5 er installert.
Sjåførportalen er en ASP.NET webside som lar sjåfører se på og returnere kjøreordre. Denne må installeres på en IIS webserver. Den krever at .NET Framework 3.5 er installert.


3.1. Installasjon
== Installasjon ==


Sjåførportalen installeres under en eksisterende site i IIS. Hvis ønsket site ikke eksisterer, må denne opprettes i IIS. Sertifikater, domenenavn etc. spesifiseres i IIS, ikke i Sjåførportalen.
Sjåførportalen installeres under en eksisterende site i IIS. Hvis ønsket site ikke eksisterer, må denne opprettes i IIS. Sertifikater, domenenavn etc. spesifiseres i IIS, ikke i Sjåførportalen.
Linje 205: Linje 200:
Selve sjåførportalen distribueres som en zip-fil. Denne pakkes ut og legges i en katalog på webserveren. Opprett en Application i IIS for denne katalogen, og sett Application Pool til ASP.NET v4.0
Selve sjåførportalen distribueres som en zip-fil. Denne pakkes ut og legges i en katalog på webserveren. Opprett en Application i IIS for denne katalogen, og sett Application Pool til ASP.NET v4.0


3.2. Konfigurasjon
== Konfigurasjon ==


Sjåførportalen må settes opp til å peke til applikasjonsserveren. Dette gjøres i Web.config-filen. Denne ligger i katalogen man pakket ut sjåførportalen i.
Sjåførportalen må settes opp til å peke til applikasjonsserveren. Dette gjøres i Web.config-filen. Denne ligger i katalogen man pakket ut sjåførportalen i.
Linje 216: Linje 211:
   </appSettings>
   </appSettings>


3.3. Starte sjåførportalen
== Starte sjåførportalen ==


Sjåførportalen skal nå være klar til bruk. Den vil være tilgjengelig under domenenavnet til tilhørende site i IIS. Brukertilgang styres fra Tempus, og er beskrevet i et eget dokument.
Sjåførportalen skal nå være klar til bruk. Den vil være tilgjengelig under domenenavnet til tilhørende site i IIS. Brukertilgang styres fra Tempus, og er beskrevet i et eget dokument.

Sideversjonen fra 7. apr. 2016 kl. 13:14


FORORD 2 1. INTRODUKSJON 3 2. INSTALLASJON AV APPLIKASJONSSERVER 4 2.1. Installasjon 4 2.2. Konfigurasjon 8 2.2.1. Databaseinfo - TempusAppServer.daConnections 8 2.2.2. Andre innstillinger - DataGrafikk.TempusAppServer.exe.config 9 2.3. Starte applikasjonsserveren 11 3. INSTALLASJON AV SJÅFØRPORTALEN 12 3.1. Installasjon 13 3.2. Konfigurasjon 16 3.3. Starte sjåførportalen 16


Revisjonshistorikk

Dato - Grunn for endring 22.10.2013 - Første versjon av dokument 07.04.2016 - Config flyttet til xml-fil. ASP.NET-side distribusjon endret fra msi til zip.


Introduksjon

Dette er en installasjonsveiledning for Sjåførportalen og Tempus Applikasjonsserver. Disse er frittstående tjenester utenom DGTempus og krever eget oppsett og konfigurasjon utenom DGTempus.

Alle eksemplene og skjermbildene er fra Windows 2008 R2.


Definisjoner og forkortelser

For dette dokumentet gjelder følgende termer og definisjoner. Sjåførportal Webside hvor sjåførene kan logge på og se på kjøreoppdragene sine, og melde inn f.eks. km-stand, forbrukt tid og endringer ihht. planlagt kjøring. Applikasjonsserver En tjeneste som publiserer nødvendige deler av Tempus-databasen for sjåførportalen.


Installasjon av applikasjonsserver

Applikasjonsserveren publiserer utvalgte deler av Tempus-databasen som en webservice. Denne brukes i dag foreløpig kun av sjåførportalen, så det er bare det som er relevant for aktiviteter som gjøres tilgjengelig. Tilgangen styres via en rolle i databasen kalt «appserver».

Feltene og tabellene som selve kjøreoppdraget inneholder og som sjåføren kan lagre eventuelle avvik og tilbakemeldinger til, er faste. Kjøreordren som kjørekontoret kan skrive ut er det imidlertid mulig å tilpasse til den enkelte kundes behov.

Alle tabeller og felter som kjøreordren i papirformat kan inneholde er derfor ikke tilgjengelig i denne rollen. Rapportgeneratoren kan eventuelt bruke ini-filen fra Tempus for å få ødvendig tilgang.

Installasjon

Installasjon av applikasjonsserveren er forholdsvis enkelt. Start installasjonsfilen (TempusAppServer.msi). Du blir møtt av følgende vindu:




Velg katalogen som applikasjonsserveren skal installeres i:



Applikasjonsserveren installeres:



..og fullføres:




Konfigurasjon

Som standard vil applikasjonsserveren ligge her:

C:\Program Files (x86)\DataGrafikk\TempusAppServer\

I katalogen applikasjonsserveren er installert i ligger det tre konfigurasjonsfiler.

Databaseinfo - TempusAppServer.daConnections

Denne filen inneholder databasetilkoblingsinfo. Filen ser slik ut:

<Connections>

 <PoolTransactionBehaviour>Fail</PoolTransactionBehaviour>
 <Definitions>
   <Definition>
     <Description />
     <ConnectionString>MSSQL.NET?Server=;Database=;User ID=;Password=;</ConnectionString>
     <ConnectionType>MSSQL</ConnectionType>
     <Default>True</Default>
     <Name>Tempus ADO Connection</Name>
   </Definition>
 </Definitions>
 <CanRaiseEventsInternal>True</CanRaiseEventsInternal>

</Connections>

Her fyller man ut ConnectionString. Eksempel:

... <Description /> <ConnectionString>MSSQL.NET?Server=databaseserver.domene.local;Database=TempusDB;User ID=TempusDBBruker;Password=Passord;</ConnectionString> <ConnectionType>MSSQL</ConnectionType> ...

Databasebrukeren trenger kun tilgang til rollen "appserver" i Tempus-databasen.

Server Servernavn (evt. fqdn/ip) til databaseserveren, etterfulgt av \Instance hvis det ikke er default instans (f.eks. DBServer\SQLExpress). Database Databasenavn til Tempus User ID Databasebruker i Tempus-databasen. Denne trenger kun tilgang til appserver-rollen. Password Passord til databasebrukeren



Andre innstillinger - DataGrafikk.TempusAppServer.exe.config

Her settes alle andre applikasjonsserver-spesifikke innstillinger. Filen inneholder følgende:

<?xml version="1.0"?> <configuration>

 <configSections>
   <section name="nlog" type="NLog.Config.ConfigSectionHandler, NLog"/>
   <section name="tempusAppServer" type="DataGrafikk.TempusAppServer.Engine.TempusAppServerConfiguration, DataGrafikk.TempusAppServer.Engine"/>
 </configSections>
 <tempusAppServer
   port="Port"
   certificateName="Certificate"
   smtpHostname="Hostname"
   smtpPort="Port"
   smtpUsername="Username"
   smtpPassword="Password"
   busDriverWebUrl=""
   sessionTimeoutDays="14"
 />
 <nlog xmlns=http://www.nlog-project.org/schemas/NLog.xsd
 .........

</configuration>

Her fyller man inn domenenavn til databaseserver og mailserver, brukernavn, passord etc. Merk at Certificate er Common Name til sertifikatet. Man kan finne dette ved å kjøre følgende PowerShell-kommando:

Get-ChildItem -Path Cert:\LocalMachine\My

Eksempel:

PS C:\> Get-ChildItem -Path Cert:\LocalMachine\My


   Directory: Microsoft.PowerShell.Security\Certificate::LocalMachine\My


Thumbprint Subject


-------

000102030405060708090A0B0C0D0E0F10111213 CN=common.name

PS C:\>

I dette tilfellet vil man sette

certificateName="CN=common.name"


Tilkoblingsinnstillinger for innkommende trafikk Certificate HTTPS-sertifikat for kryptering av trafikk mellom sjåførportal og applikasjonsserver Port TCP-porten som sjåførportalen lytter på (std. 8099)

SMTP-info for eventuell utsendelse av e-post smtpHostname Adresse til e-postserver smtpPort Port som SMTP-serveren lytter på (std. 25) smtpUsername Brukernavn for å logge på e-postkonto smtpPassword Passord for å logge på e-postkonto

Diverse innstillinger busDriverWebUrl URL til sjåførportalen hvor brukerne kan logger på. Brukes i epost som sendes ut når man resetter passord sessionTimeoutDays Antall dager en brukers sesjon varer. Når denne er passert må brukeren logge inn på nytt. Merk at sessiondata lagres i minne, så etter en restart av applikasjonsserveren må brukerne alltid logge inn på nytt.

Rapportgenerator - dgdb.ini

I de fleste tilfeller vil rapportgeneratoren som bl.a. lager nedlastbare pdf-versjoner av kjøreordre trenge utvidet tilgang databasen i forhold til applikasjonsserveren. Rapportgeneratoren kan lese egne tilkoblingsinnstillinger fra filen dgdb.ini. Denne er identisk med Tempus sin dgdb.ini-fil, så man kopierer i tilfelle denne filen fra Tempus.

Starte applikasjonsserveren

Start servicen "TempusAppServer service". Sjekk også at den er satt opp til å starte automatisk, og evt. til å restarte hvis den feiler:



Installasjon av Sjåførportalen

Sjåførportalen er en ASP.NET webside som lar sjåfører se på og returnere kjøreordre. Denne må installeres på en IIS webserver. Den krever at .NET Framework 3.5 er installert.

Installasjon

Sjåførportalen installeres under en eksisterende site i IIS. Hvis ønsket site ikke eksisterer, må denne opprettes i IIS. Sertifikater, domenenavn etc. spesifiseres i IIS, ikke i Sjåførportalen.

Selve sjåførportalen distribueres som en zip-fil. Denne pakkes ut og legges i en katalog på webserveren. Opprett en Application i IIS for denne katalogen, og sett Application Pool til ASP.NET v4.0

Konfigurasjon

Sjåførportalen må settes opp til å peke til applikasjonsserveren. Dette gjøres i Web.config-filen. Denne ligger i katalogen man pakket ut sjåførportalen i.

Finn appSettings-seksjonen, og sett ServiceUrl til dns-navnet som applikasjonsserveren kjører på:

 <appSettings>
   <add key="ServiceUrl" value="https://appserver.domene:8099/bin" />
   <add key="Theme" value="Default" />
 </appSettings>

Starte sjåførportalen

Sjåførportalen skal nå være klar til bruk. Den vil være tilgjengelig under domenenavnet til tilhørende site i IIS. Brukertilgang styres fra Tempus, og er beskrevet i et eget dokument.