Installatie en configuratie
1.1
,
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: Fax: E-mail: Internet:
(073) 523 39 50 (073) 523 39 98
[email protected] http://www.crotec.nl
Crotec Helpdesk Tel: 073 5233994 Email:
[email protected]
2
Installatie toelichting bij versie 1.0
(oktober 2011)
Inhoudsopgave Hoofdstuk 1 1.1 1.2 Hoofdstuk 2 2.1 2.2 Hoofdstuk 3 3.1 3.1.1 3.1.2 3.1.3 3.2 3.2.1 3.2.2 3.2.3 Hoofdstuk 4 4.1 4.2
Inleiding ................................................................................ 4 Eisen aan de software ......................................................... 4 Verkrijgen software............................................................ 4 Beschrijving systeem ................................................................ 5 Server tools en componenten ................................................ 5 Client tools en componenten ................................................ 6 Installatie en configuratie.......................................................... 7 Server installatie en configuratie ........................................... 7 Port nummer instellen ........................................................ 9 Licentie bestand naam en locatie instellen .............................. 10 Logging instellen .............................................................. 10 Client installatie en configuratie........................................... 12 Server naam instellen ........................................................ 12 Port nummer instellen ....................................................... 13 LicenseToolClient programma .............................................. 13 Support en Contact ................................................................ 17 Algemeen ....................................................................... 17 Contact.......................................................................... 17
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 (
[email protected]) om de software los te verkrijgen.
4
Installatie toelichting bij versie 1.0
(oktober 2011)
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 2011)
Hoofdstuk 3 Installatie en configuratie 3.1
Server installatie en configuratie
De benodigde componenten dienen handmatig op de juiste locatie te worden geplaatst voordat de server installatie kan worden uitgevoerd! De standaard locatie is “C:\Program Files\Crotec\Licenties\Program”. Kopieer de benodigde bestanden naar deze folder en verplaats het bestand “crotec_licenses.lic” naar de bovenliggende folder (“C:\Program Files\Crotec\Licenties” dus).
Indien een andere locatie gewenst is dan dient het bestand “install_licsystem.bat” aangepast te worden (zie hieronder voor nadere informatie)!
Dé specialist in ruimtelijke informatievoorziening
7
Het daadwerkelijk 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:
Door op CrotecLicentieService te dubbelklikken kunnen de eigenschappen worden ingesteld.
8
Installatie toelichting bij versie 1.0
(oktober 2011)
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: 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.
Dé specialist in ruimtelijke informatievoorziening
9
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!
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.
10
Installatie toelichting bij versie 1.0
(oktober 2011)
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:
<param name="File" value="c:\Program Files\Crotec\Licenties\CrotecLicense.log"/> <param name="AppendToFile" value="true" /> <maxSizeRollBackups value="3" /> <maximumFileSize value="10MB" /> <staticLogFileName value="true" /> <param name="ConversionPattern" value="%-8level%date{yyyy-MM-dd HH:mm:ss}
Dé specialist in ruimtelijke informatievoorziening
11
%method - %message%newline" /> 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
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: 1) met behulp van de registry: HKEY_LOCAL_MACHINE\\Software\\Crotec\\Licenties\server
2a) voor de LicenseToolClient.exe: 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 2b) voor RoPlan:
12
Installatie toelichting bij versie 1.0
(oktober 2011)
met behulp van de environment variabele (Windows of Microstation niveau) RP_CROTEC_LICENSE_SERVER Voorbeeld: RP_CROTEC_LICENSE_SERVER=localhost Let op: zowel CROTEC_LICENTIE_SERVER als RP_CROTEC_LICENSE_SERVER moeten goed zijn ingesteld!
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
2a) voor de LicenseToolClient.exe: met behulp van de Windows environment variabele CROTEC_LICENTIE_PORT Voorbeeld: SET CROTEC_LICENTIE_PORT=48901 2b) voor RoPlan: met behulp van de environment variabele (Windows of Microstation niveau) RP_CROTEC_LICENSE_PORT Voorbeeld: RP_CROTEC_LICENSE_PORT=48901 Let op: zowel CROTEC_LICENTIE_PORT als RP_CROTEC_LICENSE_PORT moeten goed zijn ingesteld!
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:
Dé specialist in ruimtelijke informatievoorziening
13
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):
14
Installatie toelichting bij versie 1.0
(oktober 2011)
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”:
Dé specialist in ruimtelijke informatievoorziening
15
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.
16
Installatie toelichting bij versie 1.0
(oktober 2011)
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:
[email protected]
4.2
Contact
Ondersteuning, service en contact Crotec BV Parallelweg 21, ‘s-Hertogenbosch Postbus 2447 5202 CK ‘s-Hertogenbosch Nederland Telefoon: Fax: E-mail: Internet:
(073) 523 39 50 (073) 523 39 98
[email protected] http://www.crotec.nl
Dé specialist in ruimtelijke informatievoorziening
17
Crotec bv Parallelweg 21 5223 AL ’s-Hertogenbosch Postbus 2447 5202 CK ’s-Hertogenbosch T 073 523 3950 F 073 523 3998 www.crotec.nl
[email protected] Vestiging Amsterdam Plotterstraat 22 1033 RX Amsterdam Vestiging Zwolle Schrevenweg 3-18 8024 HB Zwolle
Dé specialist in ruimtelijke informatievoorziening