Employee Portal: Installatie
Microsoft Dynamices Navision Employee Portal is een uitbreiding van Dynamics NAV waarmee je in staat bent om snel, zonder kennis van programmatie, een intranet website in elkaar te steken, waarop je Dynamics NAV contect kan plaatsen. Employee Portal kan je beschouwen als een toolkit om een web gebaseerde interface te bouwen op je ERP applicatie: Dynamics NAV.
Employee Portal is gebouwd rond WSS (Windows Sharepoint Services) en wat je maakt is dus eigenlijk een Sharepoint site met webparts die data ophalen uit de Navision database. Je kan niet alleen data ophalen en tonen, je kan eveneens data aanpassen (read, modify, delete,...).
Er zijn 4 soorten webparts beschikbaar: List, Card, Header-Line en Search. Natuurlijk kan je ook andere webparts op je site plaatsen, zoals de bende webparts die standaard bij een Sharepoint installatie meekomen. Eigenlijk ben je in staat om een eigen (mini) client te voorzien aan je gebruikers, ipv de standaard Navision client applicatie. En als dit allemaal nog niet voldoende is, kan je natuurlijk zelf je eigen webparts ontwikkelen.
Wat zijn nu de requirements voor Employee Portal ?
- Windows Server 2003
- Internet Information Server (deel van Win2003)
- .NET framework 1.1 (deel van Win2003)
- Message Queuing Services (deel van Win2003)
- Sharepoint Services (deel van Win2003 of gratis downloadbaar van Microsoft site)
- Visual J# .NET framework redistributable (gratis downloadbaar van Microsoft site)
- Navision Database Server
- Navision Application Server (NAS)
- Employee Portal Front End
Verder is het ook aan te raden steeds te werken met de laatste service packs en windows updates.
De volgorde zoals de onderdelen hierboven staan vermeld is ook de aan te raden volgorde van installatie.
We zullen nu even in het kort de installatieprocedure doorlopen. Het is ook mogelijk om Key Exchange te implementeren in Employee Portal. Op die wijze kan je de communicatie tussen de Front End (WSS) en de Back End (Navision) beveiligen. Dit gebeurt door het toepassen van een combinatie van assymmetrische en symmetrische encryptie. (Private/Public keys) De installatie hiervan ga ik in dit blog artikel niet bespreken. [Dit is stof voor een volgend artikel ;-)]
Ik zal beginnen vanaf de installatie van de NAS. Voor de andere items ga ik uit dat de installatie zeer eenvoudig is en zichzelf uitwijst.
NAS components:
Run de Navision Application Server setup van de installatie CD. Kies voor een "custom" installatie en zorg ervoor dat je de Employee Portal components selecteert. Op een bepaald moment moet je dan de Navision Database Server Namen ingeven. Hier maak je best een duidelijk onderscheid tussen de native database en de sql server database door de namen bijvoorbeeld als volgt te kiezen: NEP-CLASSIC en NEP-SQL. Let op, de namen die je hier kiest, zullen ook de namen van de services zijn die gecreeerd zullen worden. Als je later de NAS manager configureert zal je naar deze namen exact moeten verwijzen.
EP Front End:
Run de Front End installatie setup.exe van de installatie CD. Belangrijk is dat de front end moet geinstalleerd worden op de machine waar ook de WSS geinstalleerd is geweest. Als je dus werkt met meerdere servers moet je daarmee rekening houden ! Tijdens de installatie moet je op een bepaald moment de "Request Message Queue" naam ingeven, dit is de naam van de server die de message queuing services host. Als je bij de installatie van de front end kiest voor een complete installatie (ipv custom) dan wordt ook een demo site mee geïnstalleerd op je WSS site. Deze kan zeer handig zijn om je op te inspireren tijdens het maken van je eigen site(s).
NAS configureren:
Na de installatie van de NAS moet deze nog geconfigureerd worden. Het is de NAS die de communicatie tussen Sharepoint en Navision gaat regelen. Je kan (moet) een application server record maken in Navision voor elke NAS die je opzet. Je kan dus ook meerdere NAS opzetten. Standaard wordt er 1 NAS opgezet.
In Navision vind je die terug in het window: "EP Appln. Server Setup Card". Hij heeft default de code NEP-1. Normaalgezien bij een standaard installatie gaan we hier niets wijzigen. Belangrijk om te onhouden is de naam NEP-1.
Na de installatie van de NAS is er in je start menu bij Microsoft Dynamics Navision een item bijgekomen: "Microsoft Business Solutions Navision Application Server Manager". Dit is de tool waarmee je uw NAS service(s) kan configureren en starten/stoppen. Je hoeft hiervoor deze tool niet te gebruiken, je kan dit ook doen via de command prompt door naar de installatie folder te navigeren van de NAS en de nas.exe aan te roepen. Je moet dan hieraan de correcte parameters meegeven.
Open de NAS Manager. Klik met de rechtermuisknop op het ikoontje en kies "New Application Server".
Geef als naam op: NEP-CLASSIC en/of NEP-SQL. Let op: dit moet exact dezelfde naam zijn die je opgaf tijdens de installatie (zie hoerboven). Druk op OK en nu zal er een ikontje bijkomen. Als je erop klikt verschijnen dan rechts de configuratieparameters van je NAS:
Nu moet je de correcte NAS parameters invoeren. Op de installatieCD van de NAS naast de installatiesoftware zit er normaalgezien ook een NAS pdf document. Hierin vind je een hele hoop interessante informatie terug over de NAS en hoe je deze kan installeren en de mogelijke configuratie parameters.
Bekangrijk te onthouden hier is dat je, wat betreft Employee Portal en de NAS, altijd een startup parameter moet meegeven die begint met "NEP-". In ons geval is dit NEP-1. (zie hierboven)
In codeunit 1 trigger 99 wordt daar namelijk naar gezocht. In deze codeunit is er de functie NASHandler(...). Hierin zit oa volgende code:
IF (COPYSTR(Parameter,1,4) = 'NEP-') THEN BEGIN
EPNASSetup.GET(Parameter);
IF EPNASSetup."Front End Processing" THEN BEGIN
EmployeePortalApplSrv.SetNASID(Parameter);
EmployeePortalApplSrv.RUN;
CGNASStartedinLoop := TRUE;
END;
IF EPNASSetup."Handle Key Exchange" THEN BEGIN
EmployeePortalTrustNAS.SetNASID(Parameter);
EmployeePortalTrustNAS.RUN;
CGNASStartedinLoop := TRUE;
END;
END;
Dus deze code wordt uitgevoerd bij het starten van de NAS en als er geen 'NEP-' parameter gevonden wordt dan zal de Employee Portal application server niet runnen.
Front End processing:
Nu moet je nog enkele zaken bekijken in de Front End (WSS). Namelijk moeten we ervoor zorgen dat de Front End dezelfde setup gaat gebruiken als de Back End. Hiervoor moet je op zoek gaan naar de web.config. Deze vind je terug in de root folder van IIS.
Samengevat: Front End ==> web.config en Back End ==> "EP Appln. Server Setup Card".
In de web.config vind je dan een aantal parameters terug zoals bijvoorbeeld:
<add key=“UseEncryption” value=“0” />
<add key=“UseCompression” value=“0” />
Zorg ervoor dat dit in overeenstemming is met wat je al dan niet hebt geselecteerd in de Back End. Als je hier aanpassingen maakt moet je erna de IIS en ook NAS herstarten.
Voila, je hebt nu alle stappen doorlopen voor de installatie van Employee Portal.
Troubleshooting:
De NAS wil niet starten, of je krijgt een boodschap op je WSS site in de aard van 'Incorrect Function' of 'Unable to locate Application Server'.
Meestal is dat te wijten aan een verkeerde configuratie van de NAS. Om te weten of je NAS succesvol werkt moet je eens gaan zien in de eventlog op de server waar de NAS moet werken. Als de NAS goed is geconfigureerd moet je er ergens een boodschapje terugvinden zoals deze:
Als je deze niet terug vindt, dan zal er ongetwijfeld een warning of error terug te vinden zijn waarin je meer informatie kan vinden over het waarom. Als je in de eventlog niet voldoende informatie hebt dan kan je alsnog eens proberen dezelfde NAS op te starten via de command prompt. Hierin krijg je meestal meer relevante informatie terug. Een voorbeeld van zo'n commando kan zijn:
nas appservername=nep-1, company="CRONUS International Ltd.", NETTYPE=TCP, startupparameter=NEP-1, database=..\client\database.fdb
Error Receiving Backend Private Key.
Als je deze error krijgt tijdens het opstarten van je NAS moet je in Navision gaan en het "EP Setup Card" window openen. Daar moet je dan de key laten genereren:
Recent Comments