1.0 Installatie en configuratie, Licentie Systeem Dé specialist in ruimtelijke informatievoorziening
Copyright Deze publicatie is een uitgave van Crotec BV, s-hertogenbosch (KvK Oost Brabant 1715 9294) Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand of openbaar gemaakt in enige vorm of op enige wijze; hetzij elektronisch, mechanisch, door fotokopieën, opnamen of enige andere manier, zonder voorafgaande schriftelijke toestemming van de uitgever. Aansprakelijkheid De informatie in deze publicatie is door Crotec BV met constante zorg en naar eer en geweten samengesteld. Crotec BV sluit bij voorbaat alle aansprakelijkheid uit voor directe of indirecte schade, welke voortvloeit uit of in enig opzicht verband houdt met het gebruik van de informatie, producten en diensten welke worden beschreven in deze publicatie. Merknamenrecht Alle geregistreerde merknamen welke in deze publicatie worden genoemd zijn gebruikt ten gunste van de merknaamhouder, zonder inbreuk te plegen op het merknamenrecht. Ondersteuning, service en contact Crotec BV Parallelweg 21, s-hertogenbosch Postbus 2447 5202 CK s-hertogenbosch Nederland Telefoon: (073) 523 39 50 Fax: (073) 523 39 98 E-mail: info@crotec.nl Internet: http://www.crotec.nl Crotec Helpdesk Tel: 073 5233994 Email: helpdesk@crotec.nl 2 Installatie toelichting bij versie 1.0 (oktober 2010)
Inhoudsopgave Hoofdstuk 1 Inleiding...4 1.1 Eisen aan de software... 4 1.2 Verkrijgen software... 4 Hoofdstuk 2 Beschrijving systeem...5 2.1 Server tools en componenten... 5 2.2 Client tools en componenten... 6 Hoofdstuk 3 Installatie en configuratie...7 3.1 Server installatie en configuratie... 7 3.1.1 Port nummer instellen... 8 3.1.2 Licentie bestand naam en locatie instellen... 9 3.1.3 Logging instellen...10 3.2 Client installatie en configuratie...11 3.2.1 Server naam instellen...11 3.2.2 Port nummer instellen...12 3.2.3 LicenseToolClient programma...12 Hoofdstuk 4 Support en Contact... 16 4.1 Algemeen...16 4.2 Contact...16 Dé specialist in ruimtelijke informatievoorziening 3
Hoofdstuk 1 Inleiding In dit document wordt de installatie van het Crotec licentie systeem toegelicht. De belangrijkste randvoorwaarden worden geschetst en er zal worden aangegeven welke acties er uitgevoerd dienen te worden. 1.1 Eisen aan de software De geleverde software versie werkt in combinatie met de volgende programmatuur: Software Versie Operating System Windows 2000 (SP3 of hoger), Windows Server 2003, XP (SP2 of hoger), Vista, Wondows 7, Windows Server 2008 dotnet framework 2.0 of hoger Crotec kan geen garanties geven voor een ongestoorde werking van het licentie systeem als afgeweken wordt van bovenstaande software-eisen. 1.2 Verkrijgen software Het Crotec licentie systeem wordt meegeleverd met Crotec software (zoals bijvoorbeeld RoPlan). Neem contact op met de Crotec helpdesk (helpdesk@crotec.nl) om de software los te verkrijgen. 4 Installatie toelichting bij versie 1.0 (oktober 2010)
Hoofdstuk 2 Beschrijving systeem Het Crotec licentie systeem bestaat uit een client en een server deel. De client is een applicatie zoals RoPlan of RoTekst. Een client zal aan de licentie server vragen of er een geldige licentie beschikbaar is. Schematisch overzicht van de componenten: Overigens kunnen de client en de server dezelfde fysieke machine zijn! 2.1 Server tools en componenten De licentie server (de service) bestaat uit de volgende onderdelen: 1. CrotecLicense.dll 2. CrotecLicentieService.exe 3. log4net.dll 4. logging.config 5. CrotecLicentieService.exe.config Dé specialist in ruimtelijke informatievoorziening 5
6. install_licsystem.bat 7. uninstall_licsystem.bat Het server deel van het licentie systeem is als een Windows service geïmplementeerd. De service heeft de naam CrotecLicentieService.exe. 2.2 Client tools en componenten Op de client machine is slechts één programma aanwezig: LicenseToolClient.exe. Dit programma kan door de gebruiker worden gebruikt om het licentie bestand te tonen of om een nieuw product aan de licentie server toe te voegen. 6 Installatie toelichting bij versie 1.0 (oktober 2010)
Hoofdstuk 3 Installatie en configuratie 3.1 Server installatie en configuratie Het installeren van de licentie server gebeurt d.m.v. het batch bestand install_licsystem.bat. Het batch bestand bevat twee regels: C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\regasm /tlb /codebase "C:\Program Files\Crotec\Licenties\Program\CrotecLicense.dll" C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727\installutil "C:\Program Files\Crotec\Licenties\Program\CrotecLicentieService.exe" De eerste regel registreert de croteclicense.dll op de machine (in de Windows registry). De tweede regel registreert de service. De service is hierna als elke andere service te starten en te stoppen. LET OP: 1) de batch file gaat er nu van uit dat de licentie componenten in de directory C:\Program Files\Crotec\Licenties\Program is geplaatst. Als dit niet het geval is dan moet de batch file worden aangepast. 2) U dient zelf deze directory aan te maken. 3) U dient administrator-rechten te hebben om de batch file succesvol te kunnen starten! Als het proces succesvol is afgerond dan is er op Windows niveau een nieuwe service beschikbaar: Dé specialist in ruimtelijke informatievoorziening 7
Door op CrotecLicentieService te dubbelklikken kunnen de eigenschappen worden ingesteld. Zo dient het Opstarttype op Automatisch te worden gezet zodat de service automatisch gestart wordt als de machine opnieuw opgestart wordt. 3.1.1 Port nummer instellen De service luistert naar binnenkomende licentie verzoeken op een TCP poortnummer. Het standaard poortnummer is 48901. Dit zal in de meeste gevallen prima voldoen. Mocht om wat voor reden dan ook dit standaard poortnummer niet voldoen (bijvoorbeeld omdat een andere applicatie dit poortnummer al gebruikt) dan kan het poortnummer worden ingesteld. Dit kan op twee manieren: 8 Installatie toelichting bij versie 1.0 (oktober 2010)
1) met behulp van de registry: HKEY_LOCAL_MACHINE\\Software\\Crotec\\Licenties\port 2) met behulp van de Windows environment variabele CROTEC_LICENTIE_PORT Voorbeeld: SET CROTEC_LICENTIE_PORT=48901 LET OP: Als er een firewall actief is op de server machine (dit is waarschijnlijk het geval) dan dient de ingestelde TCP poort open te worden gezet in de firewall! Als de poort geblokkeerd is dan is er geen werkend licentie systeem mogelijk. 3.1.2 Licentie bestand naam en locatie instellen De gelicenseerde producten en de actieve (uitgegeven) licenties worden in een bestand opgeslagen. Dit bestand is versleuteld (bevat niet-herkenbare informatie). De default naam van het licentie bestand is: C:\Program Files\Crotec\Licenties\crotec_licenses.lic Als er een afwijkende naam en locatie gewenst is dan kan dit op twee manieren worden ingesteld (op de server dus): 1) met behulp van de registry: HKEY_LOCAL_MACHINE\\Software\\Crotec\\Licenties\licentiebestand 2) met behulp van de Windows environment variabele CROTEC_LICENTIE_BESTANDSNAAM Herstart de service na het aanpassen van de naam of locatie van het licentie bestand! Dé specialist in ruimtelijke informatievoorziening 9
3.1.3 Logging instellen Het is mogelijk om de licentie service en de licentie DLL logging informatie aan te laten maken. Deze informatie kan inzicht geven in het gebruik van de licenties en kan helpen om eventuele problemen op te sporen. a) Logging van de licentie service is met behulp van het bestand CrotecLicentieService.exe.config in te stellen. <?xml version="1.0" encoding="utf-8"?> <configuration> <appsettings> <add key="loggingenabled" value="true" /> <add key="logdebuginfo" value="true" /> <add key="logname" value="croteclicentieservice" /> <add key="logcategory" value="application" /> </appsettings> </configuration> LoggingEnabled en LogDebugInfo staan standaard aan (waarde true ). Logging van de service vindt plaats in het Windows eventlog (of logboek ): b) Logging van de licentie DLL is met behulp van het bestand logging.config in te stellen. De default inhoud van dit bestand is als volgt: 10 Installatie toelichting bij versie 1.0 (oktober 2010)
<?xml version="1.0" encoding="utf-8"?> <log4net> <root> <level value="info" /> <appender-ref ref="logfileappender" /> </root> <appender name="logfileappender" type="log4net.appender.rollingfileappender" > <param name="file" value="c:\program Files\Crotec\Licenties\CrotecLicense.log"/> <param name="appendtofile" value="true" /> <rollingstyle value="size" /> <maxsizerollbackups value="3" /> <maximumfilesize value="10mb" /> <staticlogfilename value="true" /> <layout type="log4net.layout.patternlayout"> <param name="conversionpattern" value="%-8level%date{yyyy-mm-dd HH:mm:ss} %method - %message%newline" /> </layout> </appender> </log4net> In bovenstaand voorbeeld wordt de logfile genaamd "c:\program Files\Crotec\Licenties\CrotecLicense.log ingesteld. Als de logfile op een andere locatie geplaatst moet worden kunt u dit hier instellen. Welke informatie er in de logfile wordt geschreven kan worden bepaald met behulp van de regel <level value="info" /> Als de waarde INFO wordt gebruikt dan worden de basis meldingen in de logfile geschreven. Als hier ALL wordt ingevuld dan worden ook interne (debug) meldingen getoond. Als de waarde OFF wordt gebruikt dan wordt er niets geschreven. 3.2 Client installatie en configuratie Met de client wordt de machine bedoeld waar een Crotec applicatie zoals RoPlan of RoTekst gebruikt wordt. Op de client machine dient bekend gemaakt te worden hoe de licentie server heet en (optioneel) welk poortnummer er gebruikt moet worden. De client machine zal over het netwerk communiceren met de licentie server. Aan de client-zijde is er één hulpprogramma van belang, dit programma zal in dit hoofdstuk worden beschreven. 3.2.1 Server naam instellen De client dient te weten welke machine de licentie server is. Het instellen van de server naam kan op twee manieren: Dé specialist in ruimtelijke informatievoorziening 11
1) met behulp van de registry: HKEY_LOCAL_MACHINE\\Software\\Crotec\\Licenties\server 2) met behulp van de Windows environment variabele CROTEC_LICENTIE_SERVER Voorbeeld: SET CROTEC_LICENTIE_SERVER=localhost of SET CROTEC_LICENTIE_SERVER=127.0.0.1 3.2.2 Port nummer instellen De client praat met de server op een TCP poortnummer. Dit poortnummer is normaal gesproken 48901. Het is mogelijk dit standaard poortnummer in te stellen. Dit kan op twee manieren: 1) met behulp van de registry: HKEY_LOCAL_MACHINE\\Software\\Crotec\\Licenties\port 2) met behulp van de Windows environment variabele CROTEC_LICENTIE_PORT Voorbeeld: SET CROTEC_LICENTIE_PORT=48901 3.2.3 LicenseToolClient programma In een normale klant-omgeving zal aan de client-zijde (de machine waar een applicatie zoals RoPlan op moet draaien) alleen het programma LicenseToolClient.exe aanwezig zijn. Het kan direct gebruikt worden, het hoeft niet geïnstalleerd te worden. Dit programma kan door de gebruiker worden gebruikt om het licentie bestand te tonen of om een nieuw product aan de licentie server toe te voegen. De eerste stap bestaat uit het verbinden met de licentie server: 12 Installatie toelichting bij versie 1.0 (oktober 2010)
Voer hier de naam of het IP adres van de server in: Als de licentie server de machine is waarop gewerkt wordt (machine is gelijktijdig server en client) dan kan de naam localhost worden ingevuld. Overigens kan hier zowel de naam als het IP adres van de server worden ingevuld. Nadat er succesvol een verbinding is gemaakt kan de inhoud van het licentie bestand worden bekeken. Activeer het tabblad Licentie bestand tonen en klik op de link Licentiebestand tonen (links onderin het scherm): Dé specialist in ruimtelijke informatievoorziening 13
In het resultaten deel zal de inhoud worden getoond. Onder het kopje Licenties zijn de gelicenseerde producten zichtbaar (b.v. RoPlan versie 88). Onder het kopje Gebruikers zijn de actieve sessies zichtbaar (de in gebruik zijnde licenties). Hiermee kan worden gecontroleerd welke gebruikers de licenties in gebruik hebben. Het toevoegen van een nieuw product aan de licentie server gaat met behulp van de functie Product toevoegen : 14 Installatie toelichting bij versie 1.0 (oktober 2010)
Vervolgens kan na het aanklikken van de link linksonder ( Product toevoegen ) een licentie bestand (*.txt) bestand worden gekozen. Zo n licentie bestand wordt door Crotec aangeleverd en bevat de licentiesleutel en de kenmerken van de licentie zoals productnaam, versie, aantal gebruikers etc. Als het bestand succesvol is ingeladen zal dit door het systeem worden gemeld. Het is van belang te realiseren dat de licentiegegevens op de server (in het croteclicenses.lic bestand) zijn opgeslagen. Vanaf dit moment is het systeem gereed en kan het product (bijvoorbeeld RoPlan) gebruikt worden. Het tabblad Product details bekijken is bedoeld om de licentie eigenschappen van een bepaalde product/versie combinatie te bekijken: De functie toont de eigenschappen zoals het maximale aantal gebruikers en de einddatum. Puur informatief dus. Dé specialist in ruimtelijke informatievoorziening 15
Hoofdstuk 4 Support en Contact 4.1 Algemeen Met vragen over de werking van het Crotec licentie systeem, voor het melden van problemen en met wensen voor extra functionaliteit kunt u contact opnemen met de Crotec Helpdesk. Crotec Helpdesk Tel: 073 5233994 Email: helpdesk@crotec.nl 4.2 Contact Ondersteuning, service en contact Crotec BV Parallelweg 21, s-hertogenbosch Postbus 2447 5202 CK s-hertogenbosch Nederland Telefoon: (073) 523 39 50 Fax: (073) 523 39 98 E-mail: info@crotec.nl Internet: http://www.crotec.nl 16 Installatie toelichting bij versie 1.0 (oktober 2010)
Crotec bv Parallelweg 21 5223 AL s-hertogenbosch Postbus 2447 5202 CK s-hertogenbosch T 073 5233950 F 073 523 3998 www.crotec.nl info@crotec.nl Vestiging Amsterdam Plotterstraat 22 1033 RX Amsterdam Vestiging Zwolle Schrevenweg 3-18 8024 HB Zwolle Dé specialist in ruimtelijke informatievoorziening