atcor ver 2014 - geosystems€¦ · · 2014-02-171. install atcor for imagine on the machine...

$: ATCOR Ver 2014 - GEOSYSTEMS€¦ · · 2014-02-171. Install ATCOR for IMAGINE on the machine where your ERDAS IMAGINE 2014 ... \Intergraph ERDAS IMAGINE 2014 ATCOR documentation$
Installation Guide for Windows

ATCOR for IMAGINE 2014 Haze Reduction, Atmospheric and Topographic Correction

ATCOR for IMAGINE 2014

ii ATCOR – Installation Guide

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 – 14.02.2014


ATCOR – Installation Guide 1

Contents:

1 ATCOR for IMAGINE 2014 - 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:.......................... 3

1.1 CD-ROM Installation: .................................................................................. 4

1.2 Web-Download Installation: ....................................................................... 4 1.2.1 Installation of ATCOR for IMAGINE 2014 ................................................. 4 1.2.2 Installation of the GEOSYSTEMS License Tools......................................... 6

2 ATCOR for IMAGINE 2014 – Licensing: ............................................. 9

2.1 License Setup on a Standalone (local) System or on a dedicated

(remote) License Server: ............................................................................ 9

2.2 License Setup on a Client: ......................................................................... 11

2.3 Ports used on the ATCOR License Server: ................................................. 12 2.3.1 Port for the RLM Daemon (License Server Port): ..................................... 12 2.3.2 Port for the geosystems Vendor Daemon (Vendor Port): .......................... 12 2.3.3 Info on Ports: ..................................................................................... 14

2.4 The GEOSYSTEMS License Tools: .............................................................. 15 2.4.1 The GEOSYSTEMS Licensing Tool - Options: ........................................... 15 2.4.2 Menu Buttons in the GEOSYSTEMS Licensing Tools: ................................ 16 2.4.3 Licensing ERROR Messages: ................................................................. 17

2.5 ATCOR Licence File Request: .................................................................... 18

3 ATCOR for IMAGINE 2014 - DEMO DATA: ....................................... 19


2 ATCOR – Installation Guide

(this page has been left blank intentionally)



1 ATCOR for IMAGINE 2014 - 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 18.

4. 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 What needs to be installed and configured

Standalone systems

Install ATCOR for IMAGINE 2014. 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).

Client(s) in a Network

Install ATCOR for IMAGINE 2014. 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].

Remote License Server

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 2014.

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.



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 1.2.1 below...

1.2 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

1.2.1 Installation of ATCOR for IMAGINE 2014

The License Agreement dialog opens:

Click Next

Click I Agree



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 2014.

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 Local-

or Client-Systems you need to install all options. On a dedicated License Server the Licen-

sing 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).

Click Install



1.2.2 Installation of the GEOSYSTEMS License Tools

The License Agreement dialog opens:

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.

Click I Agree

Click OK

Click Next



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.

Click Install



(this page has been left blank intentionally)



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 Licen-

se 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):



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.

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 / in-

formation 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. Pro-

duct, 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 li-

cense service is started, the local copy of ATCOR for IMAGINE 2014 is licensed and can

be used.

We recommend using the

local LAN (Ethernet)



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 Ser-

ver. To do this, enter the Server Name of your ATCOR License Server in the following Menu:

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:

If the license is visible the ATCOR license server is active [Note: in this case a local Win-

dows 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.

Port number for the

RLM daemon (e.g. 7044).

Name of the dedicated

ATCOR License Server



2.3 Ports used on the ATCOR 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 ATCOR License File (_.lic) will have to be edited with another available port:

Example:

HOST localhost 00199981eef6 5053

ISV geosystems

LICENSE geosystems atcor 2014 18-jul-2013 2 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 click-

ing 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:

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.

Change to e.g. 7044

(if available)

Add Ports to Firewall



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 ATCOR License Server by editing the ATCOR 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

LICENSE geosystems atcor 2014 18-jul-2013 2 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 click-

ing 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:

Add port=24000

(if available)



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:

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.

http://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers



2.4 The GEOSYSTEMS License Tools:

The GEOSYSTEMS License Tools are used to configure the license availability for your in-

stallation of ATCOR for IMAGINE 2014. 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.

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 ‘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.



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:



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.

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.

http://www.geosystems.de/support/licensing



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-82110 Germering, Germany

Phone: +49 (8) 89 – 89 4343 0

Fax: +49 (8) 89 – 89 4343 99

E-mail: [email protected]

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.

mailto:[email protected]



3 ATCOR for IMAGINE 2014 - 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-82110 Germering, GERMANY

+49(0)89/894343-0, +49(0)89/894343-99

:[email protected], URL: www.geosystems.de / www.atcor.de

mailto:[email protected]

http://www.geosystems.de/

http://www.atcor.de/

atcor ver 2014 - geosystems€¦ · · 2014-02-171. install atcor for imagine on the machine...

Documents