Installatie en configuratie documentatie

Transcriptie

1 Installatie en configuratie documentatie Assistance Web Portal v. 2.x Voor Windows 2003 / XP / Vista Assistance PSO handleiding, uitgegeven door Assistance Software. Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd. Ondanks alle aan de samenstelling van de tekst bestede zorg, kan Assistance Software geen aansprakelijkheid aanvaarden voor eventuele schade, die zou kunnen voortvloeien uit enige fout, die in deze uitgave zou kunnen voorkomen. Copyright 2009 Assistance Software 1

2 Inhoudsopgave Installatie en upgrade Fout! Bladwijzer niet gedefinieerd. Instellingen Web.Config 13 Instellingen Portal.ini 14 FAQ 17 2

3 Assistance Web Portal v. 2.x installation and upgrade 1. Indien reeds geïnstalleerd, back-up maken van de huidige Web Portal-programmamap en plaatsen buiten C:\inetpub\wwwroot 2. Indien reeds geïnstalleerd, verwijderen in Configuratiescherm, Software van Assistance Web Portal 3. Indien reeds geïnstalleerd, fysiek verwijderen van reeds aanwezige programmamap(pen) van Web Portal in C:\inetpub\wwwroot Doordat er binnen IIS meerdere websites kunnen draaien wordt er aangeraden om een nieuwe website aan te maken voor Assistance Webportal. 4. Open IIS. klik met de rechter muis knop op het niveau van Websites en kies voor Nieuw Website. 3

4 Geef een omschrijving op voor de site bv Asportal en klik op Volgende. 4

5 Geef in het volgende scherm een poort nummer op welke niet wordt gebruikt door een andere site en klik op Volgende. Wanneer er gebruik wordt gemaakt van een Hostheaders kan er gebruik worden gemaakt van een gebruikte poort. 5

6 In het volgende scherm kan het pad worden opgegeven waar de site in moet worden geplaatst, bv C:\intepub\wwwroot\AsPortal. Het wordt niet aangeraden hiervoor een map aan te maken binnen Share die door eindgebruikers kan worden benaderd. Vink de optie Anonieme toegang tot deze website toestaan uit en klik op Volgende. 6

7 Zorg dat de opties Lezen en Scripts uitvoeren (zoals ASP) staan aangevinkt. 6. Dubbelklik op het Msi bestand om de installatie te starten. Selecteer de net aangemaakte website en geef een naam voor de site bv ASPortal. Assistance webportal wordt nu geïnstalleerd. 7. Maak in de ASPortal directory een map LogFiles aan. 8. Schrijfrechten geven op de map XML en LogFiles aan de gebruikers: <computernaam>-iwam <computernaam>-iusr IIS_WPG (niet locaal zoeken!) 7

8 9. Open het tabblad Documenten voor de website van Portal en voeg hier de optie Default.htm toe. 8

9 Open vervolgens het Tabblad ASP.NET. Hier moet versie 2.x van.net Framework geselecteerd staan bij version. 9

10 Controleer op het Tabblad Mapbeveiliging, Bewerken of de optie Anonieme toegang uit staat en Geintegreerde Windows-verificatie aan staat. 10

11 Controleer tenslotte via Internet Explorer Extra Opties Beveiliging Lokaal Intranet Aangepast niveau of de optie Alleen automatisch aanmelden op intranetzone of Automatisch aanmelden met huidige gebruikersnaam en wachtwoord aan staat. 11

12 12

13 Instellingen Web.Config Het bestand web.config bevind zich in de root van de ASPortal directory. Open het bestand in een teksteditor om de volgende zaken in te voeren. 1. Plaats de Connectiestring naar de database van Assistance PSO in het bestand Web.Config bij de entry. <appsettings> <add key=" "/> </appsettings> Bij een update kan deze worden gekopieerd uit het web.config bestand uit de gemaakte back-up. 2. Wijzig in het bestand web.config de volgende opties: debug= true in debug= False <allow users="*"/> in <!-- <allow users="*"/> -- > 13

14 Instellingen Portal.ini Het bestand Portal.ini bevind zich in de map appdata van de portal directory en bevat de volgende regels. language=uk show weekend=false rittenstaat=false Maatwerk= WindowsAuthorisatie=True WindowsDomein=Assistance ProjectOmschrOpUrenscherm=True ReportServerAdres= UseReportingServices=False Language=UK/NL Vul hier UK of NL in om aan te geven of de labels in het Engels of in het Nederlands moeten worden getoond. Dit is een instelling op bedrijfsniveau. show weekend=true/false door de waarde True of false in te geven kan worden aangegeven of ook de zaterdag en zondag moeten worden getoond. rittenstaat= True/False deze optie is niet in gebruik. Maatwerk= Bij deze optie kan een URL worden ingegeven. Er zal vervolgens binnen portal een knop Maatwerk verschijnen waarmee de betreffende pagina kan worden opgeroepen. WindowsAuthorisatie= True/False Met deze optie kan worden aangegeven of er bij het opstarten gebruik moet worden gemaakt van WindowsAuthorosatie. Wanneer deze optie op True staat werkt deze alleen in combinatie met de optie WindowsDomein. Wanneer deze optie op False staat verschijnt er een inlogscherm. WindowsDomein= Hier dient de domein naam te worden ingevuld. Wanneer er meerdere domeinen zijn dan kan er voor elke domeinnaam een regel worden aangemaakt. Deze optie werkt alleen in combinatie met de optie WindowsAuthorisatie= True. Wanneer een gebruiker inlogt van buiten het domein of wanneer het domein niet is ingegeven verschijnt er een inlogscherm. ProjectOmschrOpUrenscherm=True/False Met deze optie kan worden aangegeven of naast het projectnummer ook de projectomschrijving moet worden getoond. 14

15 ReportServerAdres= Hier kan de URL worden opgegeven van de reportserver om rapportages te kunnen afdrukken. Deze optie werkt alleen in combinatie met de optie UseReportingServices=True. Voorwaarde is dat reportserver is geïnstalleerd binnen het netwerk. UseReportingServices=True/False Wanneer Portal is geïnstalleerd op een x86 machine kan er gekozen worden om gebruik te maken van Crystal reports rapporten of van Reportserver rapporten. Wanneer portal is geïnstalleerd op een x64 machine kan er alleen gebruik worden gemaakt van Reportserver rapporten. Voor het gebruik van Reportserver rapporten dient deze optie op True te worden gezet en moet de optie ReportServerAdres= worden ingesteld. Start webportal met de ingestelde URL om te controleren of het programma opstart. Toevoegen Reportserver rapporten. Wanneer er in het bestand Portal.ini is aangegeven dat er gebruik moet worden gemaakt van Reportserver rapporten moeten de volgende handelingen worden verricht. Open de reporting server site Maak een nieuwe folder aan met de naam PortalRapporten. Open de aangemaakte map rapporten en maak een nieuwe datasource aan die door middel van een connectie string verwijst naar de database van Assistance PSO. Geef bij credentials de gebruikers naam en het wachtwoord op van de SQL gebruiker van de PSO Database. Vanuit de folder PortalRapporten kunnen vervolgens de rapporten worden geupload door middel van de knop Upload File. Per rapport of op Datasource niveau kunnen rechten worden toegekend aan de gebruikers die de rapporten mogen afdrukken. Deze rechten kunnen niet worden bepaald vanuit Assistance PSO. Wanneer er gebruik wordt gemaakt van een nieuw gemaakt rapport open het bestand reportlijsten.xml met kladblok in de directory appdata. Kopieer het deel <Reportlijsten> till </Reportlijsten> en vul de juiste informatie in zoals in het volgende voorbeeld. 15

16 <Reportlijsten> <DBF>debiteur</DBF> <RAP_FILE>/PortalRapporten/Relatiekaart</RAP_FILE> <OMSCHR>Relatiekaart</OMSCHR> </Reportlijsten> 16

17 FAQ Vraag: Bij het opstarten van Portal verschijnt de melding dat het xml bestand niet kan worden weggeschreven: Antwoord: Controleer of de rechten goed zijn ingesteld op de XML map. Vraag: Bij het opstarten verschijnt foutmelding ontvangen: "HostingEnvironmentException: Failed to access IIS metabase" Antwoord: De installatievolgorde van IIS en.net kan verkeerd zijn geweest. Voer het volgende commando uit om.net binnen IIS te registreren. cd C:\Windows\Microsoft.NET\Framework\v aspnet_regiis.exe -i 17