Installation Guide for Windows. Licensing for GEOSYSTEMS Software

Installation Guide for Windows Licensing for GEOSYSTEMS Software

ERDAS, ERDAS IMAGINE and IMAGINE Advantage are registered trademarks of Intergraph Corporation. FlexNet is a registered trademark by Flexera Software LLC. RLM is a registered trademark of Reprise Soft. Version: PC Installation 02.09.2013 ii GEOSYSTEMS Licensing Installation Guide

Contents: 1 GEOSYSTEMS Software- Installation:... 3 a) 4 Steps to get your GEOSYSTEMS Software running:... 3 b) The GEOSYSTEMS Licensing what has to be installed where?... 3 c) What you need to know before you start the installation:... 3 1.1 Installation of the GEOSYSTEMS License Tools... 4 2 GEOSYSTEMS Licensing:... 6 2.1 License Setup on a Standalone (local) System or on a dedicated (remote) License Server:... 6 2.2 License Setup on a Client:... 8 2.3 Ports used by the GEOSYSTEMS License Server:... 9 2.3.1 Port for the RLM Daemon (License Server Port):... 9 2.3.2 Port for the geosystems Vendor Daemon (Vendor Port):... 9 2.3.3 Info on Ports:... 11 2.4 The GEOSYSTEMS License Tools:... 12 2.4.1 The GEOSYSTEMS Licensing Tool - Options:... 12 2.4.2 Menu Buttons in the GEOSYSTEMS Licensing Tools:... 13 2.4.3 Licensing ERROR Messages:... 14 GEOSYSTEMS Licensing Installation Guide 1

(this page has been left blank intentionally) 2 GEOSYSTEMS Licensing Installation Guide

1 GEOSYSTEMS Software- Installation: a) 4 Steps to get your GEOSYSTEMS Software running: 1. Install the GEOSYSTEMS Software on a machine you would like to work by executing the dedicated Software installer (please also refer to the dedicated instruction of the software package if available)... 2. Install the GEOSYSTEMS Licensing Tools on either a standalone machine or a remote license server - see next section b). 3. Retrieve your HostID with the GEOSYSTEMS Licensing Tools and apply for the GEOSYSTEMS license file. 4. Once you have received the License File install the file and configure the licensing with the GEOSYSTEMS Licensing Tools. 5. Run the GEOSYSTEMS Software... b) The GEOSYSTEMS Licensing what has to be installed where? Type of system Standalone systems Client(s) in a Network Remote License Server What needs to be installed and configured Install GEOSYSTEMS Software. It typically includes the GEOSYSTEMS License Tools Add the GEOSYSTEMS license in the License Tools via Add Local License and make sure that the GEOSYSTEMS Windows Service starts up (check icon in lower right). Install GEOSYSTEMS Software. It includes the GEOSYSTEMS License Tools Add the GEOSYSTEMS license in the License Tools via Add Remote License Server. [For the Administrator: if necessary, open the required ports (Firewall) so the Client (the GEOSYSTEMS License Tools) can connect to retrieve the GEOSYSTEMS license]. Install the GEOSYSTEMS License Tools Add the GEOSYSTEMS license in the License Tools via Add Local License and make sure that the GEOSYSTEMS Windows Service starts up. [For the Administrator: if necessary, open the required ports so the Client can connect to the Server to get the License]. c) What you need to know before you start the installation: Please make sure that the following prerequisites are met before the actual installation is performed: For the GEOSYSTEMS License Tools installation, please make sure you have full administration privileges. GEOSYSTEMS Licensing Installation Guide 3

1.1 Installation of the GEOSYSTEMS License Tools Click OK Click Next The License Agreement dialog opens: Click I Agree If you accept the terms of the License Agreement, click I Agree to continue. You must accept the agreement to install the GEOSYSTEMS License Tools. 4 GEOSYSTEMS Licensing Installation Guide

Click Install Choose the destination folder for the GEOSYSTEMS License Tools (can be anywhere) and click Install to begin the installation... Once the GEOSYSTEMS License Tools have been installed you may start the License Tool to retrieve the HostID which is required to generate the GEOSYSTEMS Software license file. You may do this also any time later. To run GEOSYSTEMS Software you need a valid license. For details see section 2. GEOSYSTEMS Licensing Installation Guide 5

2 GEOSYSTEMS Licensing: GEOSYSTEMS has now its own licensing for its software products. It uses RLM from Reprise Soft, an equivalent licensing scheme to FlexNet, used by Intergraph. Essentially the licensing consists of a Windows service which provides the GEOSYSTEMS license. The tool to set this service up is the GEOSYSTEMS License Tools which must be installed on all systems where GEOSYSTEMS Software is supposed to run. Additionally it needs to be installed on a remote License Server in a Client-Server environment. GEOSYSTEMS licenses can be floating (concurrent) or node-locked Client-Server configurations are supported Hardware keys / Dongles are currently not supported 2.1 License Setup on a Standalone (local) System or on a dedicated (remote) License Server: After a successful installation of the GEOSYSTEMS License Tools there will be a new program in your Start Menu: GEOSYSTEMS GEOSYSTEMS License Tools 1.0.: Start the GEOSYSTEMS License Tools (make sure you have administration privileges on your machine): 6 GEOSYSTEMS Licensing Installation Guide

From the tool-bar, open Get HostID and then Show HostID. All HostIDs found on your system will be shown. Select the ID you would like to use. We recommend using the local LAN (Ethernet). Click on Copy selected HostID and the ID will be saved in the clipboard. We recommend using the local LAN (Ethernet) The HostID - specific for your hardware must be sent to GEOSYSTEMS GmbH, Germany to request your GEOSYSTEMS license. Once you have received your GEOSYSTEMS License file (e.g. actor.lic) you must import the local license with the option Add local License. After the selection of the correct ATCOR.lic file, the license is imported and the GEOSYS- TEMS license service for ATCOR will start automatically. The GEOSYSTEMS License Tools will now display information about the license e.g. Product, Version, Expiration Date (if applicable), Number of Licenses and the Licenses in use. To display the Product Info select (=click on) the available Product atcor manually. Now the GEOSYSTEMS License Tools can be closed. The Windows GEOSYSTEMS license service is started, the local copy of your GEOSYSTEMS Software is licensed and can be used. GEOSYSTEMS Licensing Installation Guide 7

2.2 License Setup on a Client: The client as well as the license server must be visible within the network. Start the GEO- SYSTEMS License Tools (located in the Start Menu: GEOSYSTEMS). Make sure you have administration privileges! Once you have received your GEOSYSTEMS license file and installed it on your License Server (see 2.1 License Setup... on a dedicated License Server) you must make your License Server available as a License Source with the option Add Remote License Server. To do this, enter the Server Name of your License Server in the following Menu: Name of the dedicated License Server If the server name had been entered earlier already it is available in the pull down menu Known Server. In case you have had to change the port used by the RLM deamon (see chapter 2.3.1) you need to also set this new port number in the Add Remote Server menu: Port number for the RLM daemon (e.g. 7044). If the license from your license server is visible you are ready to use the software on the client machine [Note: in this case a local Windows service is not necessary and the Service Status (lower right) shows License Server not installed]. Now the GEOSYSTEMS License Tools can be closed. The local copy of the GEOSYSTEMS Software receives its license from the License Server and can be used. 8 GEOSYSTEMS Licensing Installation Guide

2.3 Ports used by the GEOSYSTEMS License Server: This section is meant for system administrators or experienced users only. 2.3.1 Port for the RLM Daemon (License Server Port): The default port which is used for the RLM daemon on the License Server is port 5053. The License Tools choose this port if it is available. If it is not available, the RML Daemon (rlm.exe) will not start up at all and the Windows service cannot be started. This can be seen in the log file by the following entry: 01/17 14:12 (rlm) Port 5053 in use, waiting... In this case the GEOSYSTMES License File (_.lic) will have to be edited, and another available port has to be chosen manually: Example: Change to e.g. 7044 (if available) HOST localhost 00199981eef6 5053 ISV geosystems LICENSE geosystems atcor 2013 18-jul-2013 2 start=16-jan-2013 issuer=geosystems customer="john Graham" contract="intergraph Corporation, Huntsville" issued=16-jan-2013 _ck=06d77c4a30 sig="60q 80PC65FY JK9NQ45VDC5JNX559R7XM0KUX708AG16J8E6FH1W9FF024MYH 0XUVYMVTJXXTYP" To make the License Server use the new port available you need to stop the service by clicking on Stop License Service and then restart the service with from the GEOSYS- TEMS License Tools. If a Firewall is running only: Additionally the new port needs to be added to the Firewall of your License server by clicking with the right mouse button on the License Source and selecting the option Add Ports to Firewall: Add Ports to Firewall 2.3.2 Port for the geosystems Vendor Daemon (Vendor Port): There is no default port which is used for the ISV geosystems vendor daemon on the License Server. It selects a different number whenever the program is started. GEOSYSTEMS Licensing Installation Guide 9

The Bubble Help over the License Source will show: Vendor Port: not fixed The random port automatically selected can be seen in the log file: 01/17 14:01 (rlm) Starting ISV servers: 01/17 14:01 (rlm)... geosystems on port 57831 In case the automatically selected port is not appropriate as it is a) either used by another software (which can be seen in the log file) or b) interferes with the Firewall of your server (check Firewall settings), you can set your own port on your GEOSYSTEMS License Server by editing the GEOSYSTEMS license file on the server (_,lic) with a new port. A port number of 24000 is recommended for the ISV geosystems vendor daemon. Example: The part > port=24000 < has to be added manually: HOST localhost 00199981eef6 5053 ISV geosystems port=24000 Add port=24000 (if available) LICENSE geosystems atcor 2013 18-jul-2013 2 start=16-jan-2013 issuer=geosystems customer="john Graham" contract="intergraph Corporation, Huntsville" issued=16-jan-2013 _ck=06d77c4a30 sig="60q 80PC65FY JK9NQ45VDC5JNX559R7XM0KUX708AG16J8E6FH1W9FF024M YH0XUVYMVTJXXTYP" To make the License Server use the new port available you need to stop the service by clicking on Stop License Service and then restart the service with from the GEOSYS- TEMS License Tools. Now the Bubble Help over the License Source should display the recently set port: 10 GEOSYSTEMS Licensing Installation Guide

If a Firewall is running: Additionally the new port needs to be added to the Firewall of your ATCOR license server by clicking with the right mouse button on the License Source and selecting the option Add Ports to Firewall: 2.3.3 Info on Ports: On http://en.wikipedia.org/wiki/list_of_tcp_and_udp_port_numbers you can check which Internet socket port numbers (=ports) are used or still available. With the command netstat -a (entered in a command window) you can check locally (on the ATCOR License Server) which ports are used on your system. GEOSYSTEMS Licensing Installation Guide 11

2.4 The GEOSYSTEMS License Tools: The GEOSYSTEMS License Tools are used to configure the license availability for your installation of any GEOSYSTEMS Software. On Standalone Systems (or Dedicated License Servers) this is done through automatically adding a Windows service named GEOSYSTEMS License Service. On a Client System the Dedicated License Server provides a network license. 2.4.1 The GEOSYSTEMS Licensing Tool - Options: - Section A displays the License Source. A Bubble Help when pointing on the License Source will display further information on e.g. the type, port, HostID - Section B displays the product (here atcor ) and version (here 2013 ). - Section C displays information on the details of the license. If no correct information is visible in one of the sections use the refresh button For Product Info you need to select the product atcor as Available Product. Check License File: - Clicking on the License source (atcor in this case) the license file will be opened and displayed in the standard editor. - The license (_.lic), once imported from the location where it had been copied originally, is written to [e.g. for Win 7]: c:\programdata\gs_licenses Log File: - A log file is automatically created and written to [e.g. for Win 7]: C:\ProgramData\GS_Licenses. - It can be opened by clicking on the button from the GEOSYSTEMS License Tools. 12 GEOSYSTEMS Licensing Installation Guide

2.4.2 Menu Buttons in the GEOSYSTEMS Licensing Tools: Opens a Log-file in the standard editor Add a local license (on a standalone system on a dedicated license server) Add a remote license server (on a client) Start License service Stop License Service Reread selected License Service Delete selected License source Refresh contents of respective section A new service GEOSYSTEMS License Service is created and started automatically: The service has not started The service is running License Service is not installed The License Service can also be Installed or Removed manually: GEOSYSTEMS Licensing Installation Guide 13

2.4.3 Licensing ERROR Messages: In case the license cannot be found an Error Message is displayed with first hints where to look for probable reasons. Additional information can be found on www.geosystems.de/support/licensing. (end) GEOSYSTEMS GmbH, Riesstr. 10, D-82110 Germering, GERMANY +49(0)89/894343-0, +49(0)89/894343-99 :info@geosystems.de, URL: www.geosystems.de / www.atcor.de 14 GEOSYSTEMS Licensing Installation Guide