ATCOR for IMAGINE 2014

Transcription

1 Installation Guide for Windows ATCOR for IMAGINE 2014 Haze Reduction, Atmospheric and Topographic Correction

2 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 ii ATCOR Installation Guide

3 Contents: 1 ATCOR for IMAGINE Installation:... 3 a) 4 Steps to make your ATCOR for IMAGINE 2014 run:... 3 b) The GEOSYSTEMS Licensing what has to be installed where?... 3 c) What you need to know before you start the installation: CD-ROM Installation: Web-Download Installation: Installation of ATCOR for IMAGINE Installation of the GEOSYSTEMS License Tools ATCOR for IMAGINE 2014 Licensing: License Setup on a Standalone (local) System or on a dedicated (remote) License Server: License Setup on a Client: Ports used on the ATCOR License Server: Port for the RLM Daemon (License Server Port): Port for the geosystems Vendor Daemon (Vendor Port): Info on Ports: The GEOSYSTEMS License Tools: The GEOSYSTEMS Licensing Tool - Options: Menu Buttons in the GEOSYSTEMS Licensing Tools: Licensing ERROR Messages: ATCOR Licence File Request: ATCOR for IMAGINE DEMO DATA: ATCOR Installation Guide 1

4 (this page has been left blank intentionally) 2 ATCOR Installation Guide

5 1 ATCOR for IMAGINE Installation: a) 4 Steps to make your ATCOR for IMAGINE 2014 run: 1. Install ATCOR for IMAGINE on the machine where your ERDAS IMAGINE 2014 runs and you would like to work... see section c). 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 ATCOR license file - see section 2.5 on page Once you have received the License File install the file and configure the licensing with the GEOSYSTEMS Licensing Tools. 5. Start up ATCOR... 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 ATCOR for IMAGINE It includes the GEOSYSTEMS License Tools Add the ATCOR 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 ATCOR for IMAGINE It includes the GEOSYSTEMS License Tools Add the ATCOR 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 ATCOR license]. Install the GEOSYSTEMS License Tools Add the ATCOR 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 of ATCOR for IMAGINE 2014 is performed: Prerequisite: ERDAS 2014 must be installed on the systems where ATCOR shall run. A minimum requirement is an ERDAS IMAGINE 2014 Advantage license. Quit ERDAS IMAGINE 2014 if it is still running: As ERDAS IMAGINE program files will be updated please exit ERDAS IMAGINE prior to attempting an installation of ATCOR for IMAGINE For the ATCOR and GEOSYSTEMS License Tools installation, please make sure you have full administration privileges. The documentation for ATCOR can be found after the installation - in the following directory...\intergraph\erdas IMAGINE 2014\ATCOR\documentation. The Installation Guide is available after unzipping the file ATCOR_setup_2014.zip. ATCOR Installation Guide 3

6 1.1 CD-ROM Installation: - Insert the ATCOR for IMAGINE 2014 CD-ROM into the drive and start the installation. - Now the ATCOR installation routine should start automatically... - In case the autostart is not invoked double-click in the MS Explorer on: <CD-DRIVE>:\ATCOR_setup_2014.exe Continue with chapter below Web-Download Installation: - Unzip the downloaded file into a new directory. - Start the ATCOR installation routine by double-clicking in the MS Explorer on: <unzip-directory>:\atcor_setup_2014.exe Installation of ATCOR for IMAGINE 2014 Click Next The License Agreement dialog opens: Click I Agree 4 ATCOR Installation Guide

7 If you accept the terms of the License Agreement, click I Agree to continue. You must accept the agreement to be able to install ATCOR for IMAGINE Click Install The components to install are ATCOR, the License Tool and the Start Menu Shortcuts (this includes the Uninstaller, direct access to ATCOR and the ATCOR Website). On Localor Client-Systems you need to install all options. On a dedicated License Server the Licensing Tools are required only. Compare with chapter 1b) on page 3 of this guide. The installer automatically selects the correct destination folder (ATCOR must be installed where ERDAS 2014 is located: On 64bit Systems it will be e.g. C:\Intergraph\ERDAS IMAGINE 2014 On 32bit Systems it will be e.g. C:\Program Files\Intergraph\ERDAS IMAGINE 2014 Now the installation of ATCOR for IMAGINE 2014 will start: Wait until the installation has completed. It will take approximately 2 minutes until all files are copied. As soon as all ATCOR files are copied to your local disk, the GEOSYSTEMS License Tool will be installed. This is a separate installer which is automatically started. You can choose the language (currently English and German are available only). ATCOR Installation Guide 5

8 1.2.2 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. 6 ATCOR Installation Guide

9 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 ATCOR license file. You may do this also any time later. In the Start Programs listing you can find a new entry for ATCOR for IMAGINE 2014 the GEOSYSTEMS License Tools: After installation - once you start ERDAS IMAGINE - the Menu for ATCOR can be found in the IMAGINE Ribbon User Interface in the Tab: Toolbox: ATCOR To run ATCOR for IMAGINE you need a valid license. For details see section 2. ATCOR Installation Guide 7

10 (this page has been left blank intentionally) 8 ATCOR Installation Guide

11 2 ATCOR for IMAGINE 2014 Licensing: ATCOR for IMAGINE 2014 has its own licensing. It is not licensed together with ERDAS IMAGINE 2014 using FlexNet, instead ATCOR uses the equivalent licensing scheme RLM from Reprise Soft. Essentially the licensing consists of a Windows service which provides the ATCOR license. The tool to set this service up are the GEOSYSTEMS License Tools which must be installed on all systems where ATCOR for IMAGINE 2014 is supposed to run. In a Client-Server environment it additionally needs to be installed on a remote License Server. All ATCOR licenses are floating (concurrent) 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 ATCOR for IMAGINE 2013 and the GEOSYSTEMS License Tools (for a dedicated (remote) License Server the GEOSYSTEMS License Tools only), there will be a new program in your Start Menu: GEOSYSTEMS GEOSYSTEMS License Tools 1.x.: Start the GEOSYSTEMS License Tools (make sure you have administration privileges on your machine): ATCOR Installation Guide 9

12 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 ATCOR license. Please also provide your CustomerID or any other proof / information of your purchase. For detailed instructions how to request an ATCOR license file please see section 2.5 of this document. Once you have received your ATCOR License file (e.g. actor_2014.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 ATCOR for IMAGINE 2014 is licensed and can be used. 10 ATCOR Installation Guide

13 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 ATCOR license file and installed it on your ATCOR License Server (see 2.1 License Setup... on a dedicated License Server) you must make your ATCOR License Server available as a License Source with the option Add Remote License Server. To do this, enter the Server Name of your ATCOR License Server in the following Menu: Name of the dedicated ATCOR 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.2) 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 is visible the ATCOR license server is active [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 ATCOR for IMAGINE 2014 receives its license from the License Server and can be used. ATCOR Installation Guide 11

14 2.3 Ports used on the ATCOR License Server: This section is meant for system administrators or experienced users only Port for the RLM Daemon (License Server Port): The default port which is used for the RLM daemon on the License Server is port 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 ATCOR License File (_.lic) will have to be edited with another available port: Example: Change to e.g (if available) HOST localhost eef ISV geosystems LICENSE geosystems atcor jul start=16-jan-2014 issuer=geosystems customer="john Graham" contract="intergraph Corporation, Huntsville" issued=16-jan-2014 _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 ATCOR 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 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. 12 ATCOR Installation Guide

15 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 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 ATCOR License Server by editing the ATCOR license file on the server (_,lic) with a new port. A port number of is recommended for the ISV geosystems vendor daemon. Example: The part > port=24000 < has to be added manually: HOST localhost eef ISV geosystems port=24000 Add port=24000 (if available) LICENSE geosystems atcor jul start=16-jan-2014 issuer=geosystems customer="john Graham" contract="intergraph Corporation, Huntsville" issued=16-jan-2014 _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: ATCOR Installation Guide 13

16 If a Firewall is running only: 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: Info on Ports: On 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. 14 ATCOR Installation Guide

17 2.4 The GEOSYSTEMS License Tools: The GEOSYSTEMS License Tools are used to configure the license availability for your installation of ATCOR for IMAGINE 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 ATCOR license 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 2014 ). - 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. ATCOR Installation Guide 15

18 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: 16 ATCOR Installation Guide

19 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 If ATCOR for IMAGINE 2014 cannot be started ATCOR displays different Error Messages: or In this case first check your license by opening the GEOSYSTEMS Licensing Tools. ATCOR Installation Guide 17

20 2.5 ATCOR Licence File Request: To request your ATCOR for IMAGINE 2014 Licence File, contact your Hexagon Geospatial Distributor from where you have purchased your ATCOR. if you have received your ATCOR for IMAGINE 2013 from GEOSYSTEMS, Germany: GEOSYSTEMS GmbH Riesstrasse 10 D Germering, Germany Phone: +49 (8) Fax: +49 (8) keycode@geosystems.de Important: You must provide the selected HostID (see chapter 2.1 and 2.2). Please also provide your CustomerID or any other proof / information of your purchase. 18 ATCOR Installation Guide

21 3 ATCOR for IMAGINE DEMO DATA: Example data can be found in two sub-directories within the ERDAS IMAGINE /examples directory named /atcor2 and /atcor3. (end) GEOSYSTEMS GmbH, Riesstr. 10, D Germering, GERMANY +49(0)89/ , +49(0)89/ :info@geosystems.de, URL: / ATCOR Installation Guide 19