Installatie en configuratie documentatie

Transcriptie

1 Installatie en configuratie documentatie Assistance Web Portal v. 2.58, 2.60 Voor Windows 2003 / 2008 / XP / Vista / Windows 7 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 Assistance Web Portal v. 2.58, 2.60 installation en upgrade (vanaf versie 2.57) Nieuwe installatie Assistance Webportal Update Assistance Webportal Verwijderen versie 2.21 en ouder Update Assistance WebPortal Toevoegen Reportserver rapporten Webbrowers 18 FAQ 19 Vraag: 19 Vraag: 19 Vraag: 19 2

3 Assistance Web Portal v. 2.58, 2.60 installation en upgrade (vanaf versie 2.57) Assistance webportal kan worden geïnstalleerd op een machine met Windows server 2003, windows server 2008, windows xp, windows vista of windows 7 waarbij de voorkeur uitgaat naar Windows server 2003, windows server Dit document beschrijft hoe een nieuwe installatie van Assistance Webportal moet worden uitgevoerd of hoe de huidige Webportal kan worden geupdate. 3

4 1.0 Nieuwe installatie Assistance Webportal Doordat er binnen IIS meerdere websites kunnen draaien wordt er aangeraden om een nieuwe website aan te maken voor Assistance Webportal. 1. Alvorens Assistance Webportal kan worden geinstalleerd dient Assistance PSO te worden geinstalleerd. Dit hoeft niet dezelfde machine te zijn. 2. Open IIS. klik met de rechter muis knop op het niveau van Websites en kies voor Nieuw Website. 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. Zorg dat de opties Lezen en Scripts uitvoeren (zoals ASP) staan aangevinkt. 6

7 3. Start het Portal installatie bestand. 4. De setup controleerd of er een programma directory van Assistance PSO is geïnstalleerd op de machine. 7

8 1. Klik op Ja wanneer Assistance Webportal moet worden gekoppeld aan de gevonden directory. 2. Klik op Nee om een andere locatie te selecteren. 8

9 3. Selecteer een map voor de programmadirectory van Assistance Web Portal op de server en klik op Next. 4. Selecteerd de IIS website en geef een naam op voor de virtual directory. 9

10 5. Volgende scherm kan verschijnen. Installeer dan IIS en klik op Opnieuw 10

11 6. De setup haalt de connectie gegevens op van de database. 11

12 7. Klik op Test connection. Het volgende scherm moet verschijnen. Klik dan op OK 8. Klik op Next 9. Kies de instellingen in het volgende scherm (let op: invoer in Windows domains en Report Server address zijn slechts voorbeelden) en klik op Next. Na de installatie kunnen deze instellingen handmatig worden aangepast in het bestand Portal.ini welke wordt geplaatst in de appdata folder in de weportal directory. 12

13 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: Yes/No door de waarde Yes of No in te geven kan worden aangegeven of ook de zaterdag en zondag moeten worden getoond. WindowsAuthorisatie: Yes/No Met deze optie kan worden aangegeven of er bij het opstarten gebruik moet worden gemaakt van WindowsAuthorosatie. Wanneer deze optie op Yes staat werkt deze alleen in combinatie met de optie WindowsDomein. Wanneer deze optie op No 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= Yes. Wanneer een gebruiker inlogt van buiten het domein of wanneer het domein niet is ingegeven 13

14 verschijnt er een inlogscherm. Project description: Yes/No Met deze optie kan worden aangegeven of naast het projectnummer ook de projectomschrijving moet worden getoond. 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=Yes. Voorwaarde is dat reportserver is geïnstalleerd binnen het netwerk. UseReportingServices: Yes/No Wanneer Portal is geïnstalleerd op een x86 machine kan er gekozen worden om gebruik te maken van Crystal reports rapporten (No) of van Reportserver rapporten (Yes). 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 Yes te worden gezet en moet de optie ReportServerAdres= worden ingesteld. Wanneer er bij Reporting Service wordt gekozen voor No worden op de achtergrond de nodige componenten geïnstalleerd voor Crystal Reports. Dit kan even duren. 10. De volgende vraag verschijnt: 11. Klik op Ja 12. De IIS wordt automatisch herstart 13. De laatste melding Setup is completed bevestigt dat Assistance Web Portal is geïnstalleerd. 14. U kunt nu Assistance Web Portal starten. 14

15 2.0 Update Assistance Webportal Alvorens er gebruik kan worden gemaakt van Web Portal versie 2.58 of 2.60 dient uw huidige versie 2.57 te zijn. Versie 2.21 t/m 2.56 kunnen eerst worden geupdate naar versie 2.57 door de update bestanden van versie 2.57 te downloaden en te installeren en vervolgens de update. Voor versie 2.60 dient u tevens te beschikken over de 2010 versie van Assistance PSO. Versies van voor 2.21 dienen eerst te worden verwijderd waarna er een nieuwe installatie kan worden uitgevoerd. 2.1 Verwijderen versie 2.21 en ouder 1. Maak een back-up van de huidige Web Portal-programmamap en plaatsen buiten C:\inetpub\wwwroot 2. Verwijder in Configuratiescherm, Software van Assistance Web Portal 3. Verwijderd de aanwezige programmamap(pen) van Web Portal in C:\inetpub\wwwroot 4. Volg de stappen uit het hoofdstuk `Nieuwe installatie Assistance Webportal` 2.2 Update Assistance WebPortal 1. Start het Portal installatie bestand. Het installatie bestand controleert de machine op een bestaande installatie van Webportal. 2. Nadat er een geïnstalleerde versie is gevonden zal er worden gevraagd of deze moet worden geupdate. 3. De setup controleert of er een programma directory van Assistance PSO is geïnstalleerd op de machine. 15

16 4. Klik op Ja wanneer Assistance Webportal moet worden gekoppeld aan de gevonden directory. 5. Klik op Nee om een andere locatie te selecteren. 6. De setup voert vervolgens de update uit. 16

17 3.0 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. <Reportlijsten> <DBF>debiteur</DBF> <RAP_FILE>/PortalRapporten/Relatiekaart</RAP_FILE> <OMSCHR>Relatiekaart</OMSCHR> </Reportlijsten> 17

18 4.0 Webbrowers Tot en met versie 2.57 kan er gebruik worden gemaakt van Assistance Webportal op machines met Windows server 2003, windows server 2008, windows xp, windows vista of windows 7 met Internet Explorer. Vanaf versie 2.58 kan Assistance Webportal ook worden aangeroepen op machines met Mac OS X onder Firefox, Safari of Google Chrome. Voor alle browsers geld dat de pop-upblokkering moet worden uitgeschakeld of dat pop-ups worden geaccepteerd voor de Assistance Webportal site. 18

19 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 Vraag: kunnen de instellingen die bij de installatie zijn opgegeven worden achteraf worden aangepast. Antwoord: Bij de installatie worden configuratie gegevens weggeschreven in het bestand Portal.ini. Dit bestand bevind zich in de directory AppData van de portal directory. Door dit bestand te openen met kladblok kunnen de volgende instellingen worden aangepast. 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: Yes/No door de waarde Yes of No in te geven kan worden aangegeven of ook de zaterdag en zondag moeten worden getoond. WindowsAuthorisatie: Yes/No Met deze optie kan worden aangegeven of er bij het opstarten gebruik moet worden gemaakt van WindowsAuthorosatie. Wanneer deze optie op Yes staat werkt deze alleen in combinatie met de optie WindowsDomein. Wanneer deze optie op No staat verschijnt er een inlogscherm. 19

20 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= Yes. Wanneer een gebruiker inlogt van buiten het domein of wanneer het domein niet is ingegeven verschijnt er een inlogscherm. Project description: Yes/No Met deze optie kan worden aangegeven of naast het projectnummer ook de projectomschrijving moet worden getoond. 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=Yes. Voorwaarde is dat reportserver is geïnstalleerd binnen het netwerk. UseReportingServices: Yes/No Wanneer Portal is geïnstalleerd op een x86 machine kan er gekozen worden om gebruik te maken van Crystal reports rapporten (No) of van Reportserver rapporten (Yes). 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 Yes te worden gezet en moet de optie ReportServerAdres= worden ingesteld. 20