CGG

HRS 10 Software and Licence

Installation Guide

Last major version: HRS 10.4

Updated for HRS 10.6 (minor version)
September 2020
HRS 10 Software & License Installation Guide

Contents
HRS 10.6 SUPPORTED PLATFORMS ..................................................................................................... 4
LINUX Platform...................................................................................................................................... 5
Software Installation ............................................................................................................................ 5
Installation Log .............................................................................................................................. 6
Software Configuration ................................................................................................................ 7
Default Data Location ................................................................................................................... 7
License File ............................................................................................................................................ 7
Using Flexlm to Read the License File.......................................................................................... 9
First Installation of the License – Starting the License Manager Daemon................................ 9
Upgrading the License Server in Linux....................................................................................... 10
Using the License Server Utility lmutil ....................................................................................... 11
Client Machine License Set-up for Linux ................................................................................... 11
WINDOWS Platform ........................................................................................................................... 14
Software Installation .......................................................................................................................... 14
License File .......................................................................................................................................... 14
Setting-up and Starting the Flexlm License Server ................................................................... 16
Configuring the License Server Manager as a Windows Service ............................................. 18
Starting the License Server ......................................................................................................... 23
Upgrading the License Server in Windows................................................................................ 24
Restart the license daemon........................................................................................................ 25
Client Machine License Set-up for Windows ............................................................................ 27
DONGLES ............................................................................................................................................. 30
Installing the Dongle Driver on RedHat Linux ................................................................................... 30
Installing the Dongle Driver on Windows 64 bit ............................................................................... 31
Inserting and Testing the Dongle ....................................................................................................... 32
Setting-up and Starting the Flexlm License Server for the Dongle ................................................. 32
Dongle License .................................................................................................................................... 33
Managing Multiple HRS License Files on One System...................................................................... 33
TECHNICAL SUPPORT & ASSISTANCE ................................................................................................ 34
APPENDIX A: Linux Installation Example .......................................................................................... 35
APPENDIX B: Installation Log Example ............................................................................................. 42
APPENDIX C: General Troubleshooting Hints on License Installation ............................................. 44
Anti-Virus Issues .......................................................................................................................... 44
Updated for HRS 10.6 2 Last Updated: September 2020
HRS 10 Software & License Installation Guide

License Server is Slow to Start on Windows ............................................................................. 44

APPENDIX D: Using your own version of the QT libraries with Geoview........................................ 46

Updated for HRS 10.6 3 Last Updated: September 2020

HRS 10 Software & License Installation Guide

HRS 10.6 SUPPORTED PLATFORMS

LINUX
• CentOS 6.6+
• CentOS 7
• RedHat Enterprise 6.6+
• RedHat Enterprise 7
• Debian 7

WINDOWS
• Windows 7
• Windows 8
• Windows 10

Updated for HRS 10.6 4 Last Updated: September 2020

HRS 10 Software & License Installation Guide

LINUX Platform
Software Installation
1. Make sure you have downloaded or obtained the latest HRS 10 .tar file.
2. Using the mkdir command create an installation directory.
e.g. mkdir/apps/HRS_Installation_Directory
3. Save the HRS 10 .tar file to the directory created above.
4. Using tar commands, extract the software from the .tar file.
e.g. tar –xvf linux.tar
5. Using the change directory command, navigate to the SETUP.sh file.
e g. cd /apps/HRS_Installation_Directory/linux_cd.
6. List the contents of the directory using the ls command
e.g. ls gives result ( . .. SDK SETUP.SH Unix)
The Unix directory contains all of the files necessary for the installation of Hampson-Russell
software.
The SETUP.SH file is the executable that installs the software from the directory to the installation
directory created in steps above.
The SDK directory contains additional plug-in/development software that allows the user to build
plug-ins in HRS 10. Documentation outlining the steps for building customized plug-ins and
system requirements can be found in Appendix C.
7. Run the setup script to install the software.
e.g. setup.sh
8. The script will guide you through the installation process.
For context sensitive help, type “help” at any prompt.
To customize the installation, use command line arguments.
To see a list of command line options, type “setup.sh – i”.
To access the README file, type “setup.sh -R”.
When the script starts, it displays a table showing the amount of disk space required by the
program to install the software. This includes the space needed to install the common elements
of the software (including demo data).
You should confirm that there is enough disk space available to install the software before
proceeding.
To continue the installation, type "C" to continue.
The installation prompts for the location of the directory for the software files.

Updated for HRS 10.6 5 Last Updated: September 2020

HRS 10 Software & License Installation Guide

The installation then asks if a new license file was received and if so, prompts for the location of
that file.

Then a menu lists all of the modules that are available to install. To select one or more of these
options, type the corresponding numbers, with spaces between multiple entries and press the
Return key. To select all the options, type the wildcard “ * ” symbol and press the Return key.
For a more detailed installation example, see Appendix A.

Installation Log
When the SETUP.SH script runs, the program creates a log of the installation process. The file
install.log will be written in the installation directory created in the previous steps. This file
records which Hampson-Russell software has been installed. We recommend that you keep the
file in this location for later reference.
For a more detailed installation log example, see Appendix B.

Updated for HRS 10.6 6 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Software Configuration
You can configure the software using the script configure_programs, which is in the installation
directory.
Run the script with the command: ./configure_programs to prompt for the location of
the installation directory and then search for existing Hampson-Russell software in that
directory.
You are then presented with a menu of programs and may select one or all to reconfigure.

If you add a new program or license file and need to re-configure, run the script with the following
commands:
./configure_programs –p (installation directory location) –e (environ file location) -l (full path
and name of the license file).

This command will read your existing configuration.

Default Data Location

You can set default data and project directories when the program is configured or by setting
preferences while running the software. While it is not necessary, you can customize the location
for data and project directories by setting environment variables.
The variable USER_PROJECT_DIR sets the location of the default project directory. The variable
USER_DATA_DIR sets the location of the default data directory.
Example:
You can add these lines to the .cshrc file in your $Home directory.
setenv USER_PROJECT_DIR $HOME/projects
setenv USER_DATA_DIR $HOME/data
These directories must exist and you must be able to write in them. These variable will cause the
program to write data to the folder named "projects" and the folder named "data" in your home
directory.

License File
You should have received an HRS 10 license file specific to your designated Unix/Linux host. If
you have lost or misplaced your license file, please contact your regional Hampson-Russell
representative to retrieve it. Make sure to create a copy of your license file for back-up.

The last major version of HamspsonRussell Geoview was HRS 10.4 and the HRS 10.4 license
enables features in HRS 10.5 and HRS 10.6, both minor versions of HRS 10.4.

Updated for HRS 10.6 7 Last Updated: September 2020

HRS 10 Software & License Installation Guide

A typical HRS 10 license file for the Unix/Linux platform will look similar to this:
SERVER hostname a1b2c3d4e5f6
USE_SERVER
DAEMON Hamp-Russ Hamp-Russ.exe
INCREMENT HRS-avo_hist Hamp-Russ 10.4 21-sep-2019 3 2D9C635303C8 \
SUPERSEDE vendor_info=HRS-AVO dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=111 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=98DCBA5CC7AA
INCREMENT HRS-emerge_hist Hamp-Russ 10.4 21-sep-2019 2 8F5B29DE54D4 \
SUPERSEDE vendor_info=HRS-Emerge dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=169 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=0779135A18D4

The SERVER line defines the only valid host this license can be installed on. You can manually edit
the server name without invalidating the license file. You cannot change the host ID though – in
this case a1b2c3d4e5f6. The customer may choose to manually include a port number on the
SERVER line.

The USE_SERVER line makes it possible to use this license file to point a client machine to the
license server defined on the SERVER line. If the host ID of the current machine does not match
the host ID defined on the SERVER line, the software will go into ‘client’ mode and try to contact
the license server specified on the SERVER line.

The customer may choose to manually include a port number on the SERVER line. For example,
SERVER hostname a1b2c3d4e5f6 21987
Here, 21987 will be the TCP/IP port number used by the license server manager.

A valid number is any unused port number in the range 1 to 65535. If you specify a port number
greater than 65535, the client fails to establish a connection with the license server manager. If
no port number is specified, one of the default ports in the range 27000 to 27009 is used.

You must specify a port number when the SERVER line defines license servers configured for
three-server redundancy.

The DAEMON line indicates this is a Hamson-Russell license file. The daemon executable, Hamp-
Russ.exe, must be found by the FLEXnet server process for this license to function properly. The
customer may edit the path to the daemon executable or insert a path the options file. That will
not invalidate the license file.

The INCREMENT lines enable the licensed features. The SUPERSEDE and ISSUED fields work
together to make sure the INCREMENT line supersedes all other INCREMENT lines for the same
feature with previous issue dates.
Updated for HRS 10.6 8 Last Updated: September 2020
HRS 10 Software & License Installation Guide

The SN field contains the license request # and allows us to link the license file to a particular
customer contract in Navision.
The vendor_info field contains the feature description and dist_info contains our company name.

The START field indicates the first day the license can be used on.

The license file should have proper file permissions for each user and/or machine that will be
operating the software.
Follow these steps to set up the license file:
1. Place the license file in a location that the users machine can access the file.
2. Make the license manager (Flexlm) aware of your new license.
3. Configure Hampson-Russell to use the new license.

Using Flexlm to Read the License File

Once you have placed the license file in an accessible location, anyone needing to read the new
license file must run the appropriate flexlm command. If the HRS license is already running on
the license server, then follow the instructions on Upgrading the license server. If this is the first
time that the HRS license is run on the license server machine, then follow the instructions First
installation of the license.

First Installation of the License – Starting the License Manager Daemon

If this is the first time that the HRS license is to be run on the license server machine, you must:
1. Change directory to the HRS_Installation_Directory created in steps above:
e.g. cd /apps/HRS_Installation_Directory/lmgr
2. Start the license server using flexlm command
./lmgrd -c Full_Path_To_License_File -l [+]Full_Path_To_Debug_Log_File

where prepending debug_log_path with the + character appends logging entries. For
example,
./lmgrd –c /apps/flexlm/license.txt –l /apps/flexlm/license.log

We recommend you start lmgrd by a user other than root since processes started by root can
introduce security risks.

Make sure you always use the lmgrd executable and the license daemons included in the latest
CGG GeoSoftware distribution. Using outdated versions of these executables will result in a slow
software response time.
Updated for HRS 10.6 9 Last Updated: September 2020
HRS 10 Software & License Installation Guide

3. To confirm that the daemon is running, use the lmstat utility:

./lmutil lmstat –c /apps/flexlm/license.txt

Upgrading the License Server in Linux

Stop the running license daemon.
If you already have a HRS10.4.x or ealier license running on the license server, you must stop the
current license daemon and start the latest license daemon included in the latest CGG
GeoSoftware distribution. The LMTOOLS version (or license daemon) to use with HRS 10.6 is
v11.15.1.0. To check the version number in the LMTOOLS window, click Help>About.

Hampson-Russell software sets 20 minutes that the license server will wait for a heartbeat before
checking in all licenses issued to a client project, so this time period will be enough not to disrupt
any work being performed with the software. Stop the current license daemon by following
steps:
1. Change the directory to the Installation directory created in HRS10.6.x or earlier installation:
e.g. cd /apps/HRS10.x_Installation_Directory/lmgr
2. Stop the license daemon. The command lmdown is used to gracefully shutdown all license
daemons. This will shut down the Hamp-Russ daemon listed in the license file:
e.g. ./lmutil lmdown -c /apps/flexlm/license.txt -vendor Hamp-Russ

As a last resort, use the linux/unix commands to stop the license daemon if the command
lmdown is not able to stop the license daemon.

1. First find the process ID of the license daemon by typing:

ps –ef |grep lmgrd | grep –v grep
flexlm 4013 1 -24 Sep27 ? 00:00:18 /usr/local/flexlm/bin/lmgrd -c
/flexlm/license.dat
flexlm 4016 4013 24 Sep27 00:00:10 Hamp-Russ -T hou100ora 10.8 3 –c
/flexlm/license.dat -lmgrd_start 4ca150b8

2. Then kill the process by typing:

kill -9 4013 <enter>
Restart the license daemon
1. Change the directory to the HRS_Installation_Directory created in the steps above:
e.g. cd /apps/HRS_Installation_Directory/lmgr
2. Restart the license daemon using the lmgrd command:
e.g. ./lmgrd -c /apps/flexlm/license.txt -l /apps/flexlm/license.log

Updated for HRS 10.6 10 Last Updated: September 2020

HRS 10 Software & License Installation Guide

To confirm that the daemon is running, use the lmstat command:

e.g. ./lmutil lmstat –c /apps/flexlm/license.txt

MAKE SURE TO STOP AND RESTART THE LICENSE DAEMON WITHIN 20 MINUTES
Using the License Server Utility lmutil
Installed at the lmgr directory, lmutil is as a wrapper that runs the individual command as lmutil
command.
e.g. ./lmutil lmstat
Note, ./lmutil –help will display usage information and exits.

Client Machine License Set-up for Linux

Whenever you have a new license file and finished set-up/upgrading the license server, make
sure to run the script with the following commands:
./configure_programs -p (installation directory location) -e (environ file location) -l (full path and
name of the license file).

Running the script will make your new license available to all Linux client machines.

Note, if you have multiple valid HRS license servers running on different machines, you can use
the license search path to make all your licenses available to HRS applications on your client
machine. The license search path is set on your machine using the HAMP-RUSS_LICENSE_FILE or
LM_LICENSE_FILE environment variable. HRS will try each license server on the license search
path in order until it succeeds or get to the end of list, so the order of license servers listed in the
license seach path does matter. The license search path entries are separated by colons ‘:’, and
can consist of the license file full path and setting port@hostname or @hostname.

For example, there are three HRS license servers with hostname – global-server (port=1234),
denver-local, calgary-local. And the license features in the license server denver-local/calgary-
local are only allow to be accessed for the users in Denver/Calgary. For the machines in Denver,
the path should be @denver-local:1234@global-server. For the machines in Calgary, the path is
@calgary-local:1234@global-server. For the machines in other location, the path is
1234@global-server.

One of following options can be used to set the license search path using environment variable
HAMP-RUSS_LICENSE_FILE or LM_LICENSE_FILE:
1. In file $HOME/.flexlmrc, set HAMP-RUSS_LICENSE_FILE e.g.:

Updated for HRS 10.6 11 Last Updated: September 2020

HRS 10 Software & License Installation Guide

HAMP-RUSS_LICENSE_FILE=/app/HRS/evaluation-license.txt:@denver-
local:1234@global-server

Updated for HRS 10.6 12 Last Updated: September 2020

HRS 10 Software & License Installation Guide

2. In file $HOME/.cshrc, set LM_LICENSE_FILE e.g.:

set LM_LICENSE_FILE=/app/HRS/evaluation-license.txt:@denver-local:1234@global-
server

Updated for HRS 10.6 13 Last Updated: September 2020

HRS 10 Software & License Installation Guide

WINDOWS Platform
Software Installation
1. Make sure you have downloaded or obtained the latest HRS 10 .zip file.
2. Unzip the file.
3. Click setup.exe in the unzipped folder.
4. Run through the InstallShieldWizard prompts.

License File
You should have received an HRS 10 license file specific to your designated Windows host. If you
have lost or misplaced your license file, please contact your regional Hampson-Russell
representative to retrieve it. Make sure to create a copy of your license file for back-up.

The last major version of HamspsonRussell Geoview was HRS 10.4 and the HRS 10.4 license
enables features in HRS 10.5 and HRS 10.6, both minor versions of HRS 10.4.

A typical HRS 10 license file for the Windows platform will look similar to this:
License file locked to a Ethenet Address:
SERVER hostname 0024d7c8c0c8
USE_SERVER
DAEMON Hamp-Russ Hamp-Russ.exe
INCREMENT HRS-avo_hist Hamp-Russ 10.4 21-sep-2019 3 2D9C635303C8 \
SUPERSEDE vendor_info=HRS-AVO dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=111 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=98DCBA5CC7AA
INCREMENT HRS-emerge_hist Hamp-Russ 10.4 21-sep-2019 2 8F5B29DE54D4 \
SUPERSEDE vendor_info=HRS-Emerge dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=169 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=0779135A18D4

License file locked to a disk serial number:

SERVER hostname DISK_SERIAL_NUM=2b556989
USE_SERVER
DAEMON Hamp-Russ Hamp-Russ.exe
INCREMENT HRS-avo_hist Hamp-Russ 10.4 21-sep-2019 3 2D9C635303C8 \
SUPERSEDE vendor_info=HRS-AVO dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=111 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=98DCBA5CC7AA

Updated for HRS 10.6 14 Last Updated: September 2020

HRS 10 Software & License Installation Guide

INCREMENT HRS-emerge_hist Hamp-Russ 10.4 21-sep-2019 2 8F5B29DE54D4 \

SUPERSEDE vendor_info=HRS-Emerge dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=169 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=0779135A18D4

License file locked to a dongle:

SERVER hostname FLEXID=9-41091E3D
USE_SERVER
DAEMON Hamp-Russ Hamp-Russ.exe
INCREMENT HRS-avo_hist Hamp-Russ 10.4 21-sep-2019 3 2D9C635303C8 \
SUPERSEDE vendor_info=HRS-AVO dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=111 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=98DCBA5CC7AA
INCREMENT HRS-emerge_hist Hamp-Russ 10.4 21-sep-2019 2 8F5B29DE54D4 \
SUPERSEDE vendor_info=HRS-Emerge dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=169 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=0779135A18D4

HampsonRussell software expects license files to be in a default location for a Windows

installation. The default location is C:\flexlm. The program also expects the license file name to
be license.txt. The software will look for file license.txt as a license file by default.

Updated for HRS 10.6 15 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Setting-up and Starting the Flexlm License Server

Note that, on Windows 7 and 8, the firewall is enabled by default. For those operating
systems, allow a firewall exception for both lmgrd.exe and Hamp-Russ.exe for license to
work properly by navigating to:
Control Panel > Windows Firewall > Allowed Programs
Set the executables to be pass the firewall.

Display the FLEXlm LMTOOLS window by navigating to Start > All Programs > HRS
Applications > HRS 10.X.X > License Manager (on Windows 7) or click Start and search for
HampsonRussell 10.6>License Manager (on Windows 8/10).

Updated for HRS 10.6 16 Last Updated: September 2020

HRS 10 Software & License Installation Guide

The license server information is configured from the resulting LMTOOLS by Flexera window.
When setting up the server, select the Configuration using Services option:

Select the Config Services tab:

Updated for HRS 10.6 17 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Configuring the License Server Manager as a Windows Service

If this is the first time that the HRS license is to be run on the license server machine, you must
do following steps:
1. Specify a unique Service Name. The license server will be installed as a service. By
installing in this manner, you can use the Services control panel to control the starting or
stopping behavior of the license server:

Updated for HRS 10.6 18 Last Updated: September 2020

HRS 10 Software & License Installation Guide

2. Specify the path to the License manager executable (lmgrd.exe) file. This file is usually
located in the unzipped Hampson-Russell > license_manager folder:

3. Specify the full path to the license file:

Updated for HRS 10.6 19 Last Updated: September 2020

HRS 10 Software & License Installation Guide

4. Specify the full path to the debug log file as that log file provides useful debugging
information. You can either enter a fully qualified path, or browse to the debug file that
this license server writes.

Note: To append logging entries, prepend the debug log file name with “+”, for example,
+C:\Flexlm\license.log

Updated for HRS 10.6 20 Last Updated: September 2020

HRS 10 Software & License Installation Guide

5. Click the Save Service button. When you install licenses in this manner, you can use the
services control toggle boxes to control the starting or stopping behavior of the license
server:

Updated for HRS 10.6 21 Last Updated: September 2020

HRS 10 Software & License Installation Guide

If you check the Use Services box, you make this license server manager a Windows
service, so the license manager will look for license information as a service. We
recommend this. Then you can check the Start Server at Power Up box, you set the license
server to run when the PC is rebooted (note: you must first select Use Services):

Updated for HRS 10.6 22 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Starting the License Server

Select the Start/Stop/Reread tab and click the Start Server button to start the server:

If the Flexlm license server has been set-up correctly, you will see a Server Start Successful
message at the bottom of the window:

Updated for HRS 10.6 23 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Upgrading the License Server in Windows

Stop the running license daemon.

If you have a HRS10.3.x or earlier license running on the license server, you must stop the current
license daemon and start the latest license daemon included in the latest CGG GeoSoftware
distribution.

The LMTOOLS version (or license daemon) to use with HRS 10.6 is v11.15.1.0. To check the
version number in the LMTOOLS window, click Help>About.

Hampson-Russell sets 20 minutes that the license server will wait for a heartbeat before checking
in all licenses issued to a client project, so this time period will be enough not to disrupt any work
being performed with the software.

Updated for HRS 10.6 24 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Under the “Start/Stop/Reread” tab, check the “Force Server Shutdown” box and click “Stop
Server” to stop the highlighted service:

Restart the license daemon

1. Under tab “Config Services”, make sure to specify the path to the License manager executable
(lmgrd.exe) file in the location of HRS10.6 installation:

Updated for HRS 10.6 25 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Then click the Save Service button.

2. Click Start Server under tab “Stat/Stop/Reread”:

Updated for HRS 10.6 26 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Client Machine License Set-up for Windows

You have the following options for making your licenses available to all systems:
1. Place a copy of the license file named as “license.txt” on the client machine in the
C:\flexlm folder.
2. Environment variable setting:

Note, if you have multiple valid HRS licenses, the license search path entries are separated
by semicolons ‘;’.

Updated for HRS 10.6 27 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Start HRS 10 software by navigating to Start > All Programs > HRS Applications > Geoview or
click Start and search for HampsonRussell 10.6>Geoview:

If Flexnet License Finder prompts, select the Specify the License Server System option, click Next,
enter the name of the license server in the next dialog box, and click Next again to start up the
main Geoview program:

Updated for HRS 10.6 28 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Updated for HRS 10.6 29 Last Updated: September 2020

HRS 10 Software & License Installation Guide

DONGLES
To run a dongle license, the user needs to install a proper FlexNet ID dongle driver on the license
server if it is not already installed.

Installing the Dongle Driver on RedHat Linux

1. Login as a super user. Navigate to the folder “lmgr” of the installation.
Since 64 bit dongle drivers have the extension “.rpm”, we use the command rpm (RPM
Package Manager) to install or remove the driver.

2. If you have installed a dongle driver earlier, at a command prompt from the directory
“lmgr” of the installation, enter the appropriate command to :
rpm –e aksusbd

3. For the first time installation, decompress the file aksusbd-redhat-suse-7.6.tar.gz. The
directory “Sentinel_LDK_RedHat_and_SuSE_RPM_Run-time_Installer” contained the
dongle driver will be created.

4. Navigate to the folder “lmgr/ Sentinel_LDK_RedHat_and_SuSE_RPM_Run-time_Installer”

of the installation, type the command:
rpm –i aksusbd-7.6.i386.rpm

5. Define the FlexNet environment variable FLEXID_LIBRARY_PATH to point to the location

(the folder “lmgr” of the installation) of the dongle shared object
libhasp_linux_x86_64.so.

Note, uninstalling the dongle driver is by command:

rpm -e aksusbd

Updated for HRS 10.6 30 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Installing the Dongle Driver on Windows 64 bit

1. Cautions - Install the driver file before plugging the dongle in to your machine. Use the
methods described in this section to install the current versions of the dongle drivers. Do
not allow Windows Update to install these drivers.
2. Using Windows Explorer, navigate to the Hampson-Russell > HRS 10.X.X >
license_manager folder, unzip the FLEXID9_Windows_v7_60_x64.zip file:

3. If you have installed a dongle driver earlier, open a command (DOS) window, navigate to
the license_manager folder of the installation, run the following command:
FLEXID_Dongle_Driver_Installer.exe /remove
4. In a command (DOS) window, navigate to the license_manager \
FLEXID9_Windows_v7_60_x64 folder of the installation, enter the following:
haspdinst.exe -i
5. After the installation, do one of the following:
• Define the FlexNet environment variable FLEXID_LIBRARY_PATH to point to the
location (folder "license manager" of the installation) of the dongle shared object,
haspsrm_win64.dll.
• Manually copy haspsrm_win64.dll to %windir%/System32.

Note, uninstalling the dongle driver is by command:

haspdinst.exe -r

Updated for HRS 10.6 31 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Inserting and Testing the Dongle

You should have received a dongle device specific to your license file. If you have lost or misplaced
your dongle device, please contact your regional Hampson-Russell representative to retrieve it.
A typical dongle device will look similar to this:

Insert the dongle device into the USB port on the license server. A light will appear in the
dongle when a successful connection has been made.

To verify that the dongle is working properly, open a command (DOS) window, navigate
to the license_manager folder and type the command ./lmutil lmhostid –flexid.

If the dongle works properly, the command should return an output that looks similar to
the following: The FLEXnet host ID of this machine is “FLEXID=9-41091e3d”:

Setting-up and Starting the Flexlm License Server for the Dongle
Please follow the same procedure as outlined starting on page 9 of this manual (for a Linux
license) or page 14 (for a Windows license). Note, before starting the Linux license server for the
Updated for HRS 10.6 32 Last Updated: September 2020
HRS 10 Software & License Installation Guide

dongle, define the FlexNet environment variable FLEXID_LIBRARY_PATH to point to the location
(the folder “lmgr” of the installation) of the dongle shared object libhasp_linux_x86_64.so.

Dongle License
A dongle license contains a hostname and a FLEXID number. A typical dongle license looks similar
to this:

SERVER hostname FLEXID=9-41091E3D

USE_SERVER
DAEMON Hamp-Russ Hamp-Russ.exe
INCREMENT HRS-avo_hist Hamp-Russ 10.4 21-sep-2019 3 2D9C635303C8 \
SUPERSEDE vendor_info=HRS-AVO dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=111 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=98DCBA5CC7AA
INCREMENT HRS-emerge_hist Hamp-Russ 10.4 21-sep-2019 2 8F5B29DE54D4 \
SUPERSEDE vendor_info=HRS-Emerge dist_info="CGG GeoSoftware" \
ISSUED=21-Jan-2018 ck=169 SN=C15LQJTEST01 START=21-Jan-2018 \
SIGN=0779135A18D4

It is important that the hostname in the license file matches the hostname of the machine exactly.
If the hostname does not match, you can edit the hostname in the license file with a text editor.
The FLEXID number cannot be edited.

Managing Multiple HRS License Files on One System

You may have multiple HRS license files, production and evaluation licenses, running on the same
system. One of following two can be used to manage this scenario:
1. Command “./lmgrd –c license_file_list [other lmgrd options]”. Where
license_file_path_list consists of a list of one or more of the following components. (Use
a colon (:) to separate the license file names on LINUX; on Windows, use a semicolon (;).):
the full path to the license file; port@host; @host
2. Combine the license files into a single license file if the number of SERVER lines in each
file is the same and the hostid field of each SERVER line in one file exactly matches the
hostid field of each SERVER line in other file. The combined license file consists of one
SERVER line, USE_SERVER line, DAEMON/VENDOR line, and all FEATURE/INCREMENT
lines from the files.

Updated for HRS 10.6 33 Last Updated: September 2020

HRS 10 Software & License Installation Guide

TECHNICAL SUPPORT & ASSISTANCE

If you are experiencing issues with installation or require assistance with any items outlined in
this manual, please contact our support staff specific to your region. To access email addresses
for each office listed below, please visit: http://www.cgg.com/en/What-We-
Do/GeoSoftware/GeoSoftware-Support-Contact-Information

Updated for HRS 10.6 34 Last Updated: September 2020

HRS 10 Software & License Installation Guide

APPENDIX A:
Linux Installation Example

======================================================================
HAMPSON RUSSELL SOFTWARE SERVICES LTD. CALGARY, ALBERTA, CANADA
======================================================================
Welcome to Hampson-Russell's CD install script; this script can install
AFI, AVO, EMERGE, ISMap, STRATA and PRO4D for the operating
systems listed in the table below, which also summarises the required
disc space for each program.

Please make sure you have space on the disc you want to install to for the
things you want to install and make sure you have write permission.

Linux
----------------------------------
mandatory 1065 MB
GEOVIEW 450 MB
AFI 60 MB
ISMap 90 MB
PRO4D 135 MB
-------------------------------------------
Full Install 1.8+ GB

o See the file readme.txt on the CD for full details about this script
o Houston, U.S.A.
Tel: +1 800 561-5479
E-Mail: [email protected]
o Calgary, Canada
Tel: +1 800 561-5479
E-Mail: [email protected]
o Villahermosa, Mexico
Tel: +52 (993) 310 4670 Ext 7010
E-Mail: [email protected]
o Rio de Janeiro, Brazil
Tel: +55 21 2126 7392
E-Mail: [email protected]
Updated for HRS 10.6 35 Last Updated: September 2020
HRS 10 Software & License Installation Guide

o Buenos Aires, Republica Argentina

Tel: +54 11 4325 9653 Ext. 153
E-Mail: [email protected]
o Colombia
Tel: +57 1 743 3270
E-Mail: [email protected]
o Mumbai, India
Tel: +91 22 6605 9188
E-Mail: [email protected]
o Jakarta, Indonesia
Tel: +62 02 1252 2240
E-Mail: [email protected]
o Kuala Lumpur, Malaysia
Tel: +60 3 2731 3755
E-Mail: [email protected]
o Perth, Australia
Tel: +61 8 9214 6299
E-Mail: [email protected]
o Bangkok,Yangon & Ho Chi Minh City, Malaysia
Tel: +60 3 2731 3755
E-Mail: [email protected]
o Netherlands
Tel: +44 1293 683 434
E-Mail: [email protected]
o Crawley, United Kingdom
Tel: +44 1293 683 434
E-Mail: [email protected]
o Abu Dhabi, United Arab Emirates
Tel: +971 2 410 1700
E-Mail: [email protected]
o Beijing, China
Tel: +86 10 8446 1700
E-Mail: [email protected]
o Moscow, Russian Federation
Tel: +7 495 662 7471 Ext 251
E-Mail: [email protected]
o this script uses gunzip, which is free software - see the file copying.txt
in the directory gunzip on the CD. The full source distribution is in a
file gzip_1_2_4.tar in that directory.

Updated for HRS 10.6 36 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Type C to continue, Q to quit or HELP for help: C

Where do you want to install the HRS software[] ? /apps/HRS_Installation_Directory

opening permissions on /apps/HRS_Installation_Directory ... finished.

Have you received a new licence file from Hampson-Russell (yes/no) ? YES
Enter full path & filename of new licence file (ENTER to cancel):
apps/flexlm/license.txt

Current license file is then output to screen

INCREMENT HRS-geoview Hamp-Russ 10.4.1 30-jun-2019 5 CF964201A45D \
SUPERSEDE vendor_info=HRS-Geoview dist_info="CGG GeoSoftware" \
ISSUED=20-May-2018 ck=102 SN=C15LQJBV04143 START=24-Apr-2018 \
SIGN=FC14A4DCEB12
INCREMENT HRS-avo Hamp-Russ 10.4.1 30-jun-2019 1 DAE8C3AAA922 \
SUPERSEDE vendor_info=HRS-AVO dist_info="CGG GeoSoftware" \
ISSUED=20-May-2018 ck=128 SN=C15LQJBV04143 START=24-Apr-2018 \
SIGN=BED81330CAFC
What you can install
[ ] 1 - AFI program THIS IS A LIST OF PROGRAMS TO
[ ] 2 - ISMap program INSTALL A wildcard “*” can be
[ ] 3 – Pro4D program used to select all
[ ] 4 – ProMC program

Type numbers (1-11) separated by spaces to toggle options

or *-select all, C-Clear all, Q-abort
When you've finished picking what to install, type I to install the
selected programs to your hard disc

Your choice(s): *

What you can install

[x] 1 - AFI program

[x] 2 - ISMap program
[x] 3 – Pro4D program NOTE X’s mark the choices
[x] 4 – ProMC program marked for installation

Type numbers (1-4) separated by spaces to toggle options

or *-select all, C-Clear all, Q-abort

When you've finished picking what to install, type I to install the

selected programs to your hard disc
Updated for HRS 10.6 37 Last Updated: September 2020
HRS 10 Software & License Installation Guide

Your choice(s): I
installing configuration scripts ...
installing common directories ...
bin ...
tar: Read 9216 bytes from -
NOTE: INSTALLATION WILL CONTINUE UNTIL
ALL FILES ARE EXTRACTED.
tar: Read 1024 bytes from -lmgr ..
tar: Read 7680 bytes from - lib ...
tar: Read 6144 bytes from -

Installation finished

To set the software up: change directory to /apps/HRS_Installation_Directory and

run./configure_programs

You may need to have root privileges to do this

Would you like to do this now (yes/no) ? YES

Enter the base directory of the installation [/apps/HRS_Installation_Directory]:

HIT <ENTER> TO ACCEPT THE DEFAULT

Examining license file "/apps/flexlm/license.txt" ...

License /apps/flexlm/license.txt ... afi ...permanent
License /apps/flexlm/license.txt ... avo ...permanent
License /apps/flexlm/license.txt ... elog ...permanent
License /apps/flexlm/license.txt ... emerge ...permanent
License /apps/flexlm/license.txt ... pro4d ...permanent
License /apps/flexlm/license.txt ... autocal ...permanent
License /apps/flexlm/license.txt ... promc ...permanent
License /apps/flexlm/license.txt ... ismap ...permanent
License /apps/flexlm/license.txt ... geoview ...permanent
License /apps/flexlm/license.txt ... strata ...permanent

Setting up the programs:

1 -- set up GEOVIEW
software in: /apps/HRS_Installation_Directory
license in: /apps/flexlm/license.txt
2 -- set up AFI
software in: /apps/HRS_Installation_Directory
license in: /apps/flexlm/license.txt
3 -- set up ISMAP
software in: /apps/HRS_Installation_Directory
license in: /apps/flexlm/license.txt
4 -- set up PRO4D
software in: /apps/HRS_Installation_Directory
license in: /apps/flexlm/license.txt

Updated for HRS 10.6 38 Last Updated: September 2020

HRS 10 Software & License Installation Guide

5 -- set up PROMC
software in: /apps/HRS_Installation_Directory
license in: /apps/flexlm/license.txt

Data -- Set up default data location.

Currently:

End -- Finish setting up and go on to build the program script files.

Quit -- Quit and abort installation completely.

At this point you can choose END and the software will ask you for the location of
Acrobate Reader. Specify the location and continue to run configure programs.

If you wish to configure select programs instead of confiduring all the programs
you can do so by following the information below.

Enter choice [1,2,3,4,5,Data, End or Quit]: 2

Setting up the AFI software ...

Where did you install the AFI software?

Default is: [/apps/HRS_Installation_Directory]:
If the default is correct, simply press <RETURN>.
Otherwise, enter the path where the software was installed.
If you do not own or are not evaluating the AFI software,
type in the word none.

Note: You will not be able to launch the AFI program from
GEOVIEW if your answer is none. The AFI button will
be inactive in GEOVIEW.

Default is: [/apps/HRS_Installation_Directory]:

Where did you install the license for the AFI software?

If you have not installed the license file somewhere else, you
can simply use the default. Otherwise, specify the complete
path to the license file.

Default is: /apps/flexlm/license.txt:

Do you want to use this license file for other software [yes|no](no)? YES
To set up the next module, repeat the process by choosing the number of the module
you wish to install.

Enter choice [1,2,3,4,5,6,7,8,9,10, Data, End or Quit] 3

Setting up the ISMAP software ...

Updated for HRS 10.6 39 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Where did you install the ISMAP software?

If the default is correct, simply press <ENTER>.

Otherwise, enter the path where the software was installed.

If you do not own or are not evaluating the ISMAP software,
type in the word none.

Note: You will not be able to launch the ISMAP program from
GEOVIEW if your answer is none. The ISMAP button will
be inactive in GEOVIEW.

Default is: [/apps/HRS_Installation_Directory]:

Where did you install the license for the ISMAP software?

If you have not installed the license file somewhere else, you
can simply use the default. Otherwise, specify the complete
path to the license file.

Default is: [/apps/flexlm/license.txt]:

Enter choice [1,2,3,4,5,Data, End or Quit]: End

NOTE:
The Adobe Acrobat Reader is not provided with this installation.
Most of our programs do not use this reader to show the on-line
help, but it is used by our software to display the guide and theory
notes. The GLI3D program does use the Adobe Acrobat Reader to show
the on-line help. None of our software depends upon having the
reader to run correctly.

If you know where the Adobe Acrobat Reader is installed on your

system, then you can provide the path to it now. If you do not know
where it is or if you do not have it installed, you can carry on
with this installation and install Acrobat later.

Acrobat Reader found at "/usr/bin/acroread"

Use this version of Acrobat Reader? [yes|no]? YES

Please wait. Building Environment script...

Please wait. Building AFI run script...
Please wait. Building AVO run script...
Please wait. Building ELOG run script...
Please wait. Building PRO4D run script...
Please wait. Building AUTOCAL run script...
Please wait. Building PROMC run script...
Please wait. Building ISMap run script...
Please wait. Building GEOVIEW run script...
Updated for HRS 10.6 40 Last Updated: September 2020
HRS 10 Software & License Installation Guide

Please wait. Building WLExchange run script...

Please wait. Building GeoFrame WLExchange run script...
Please wait. Building STRATA run script...
Please wait. Building owver run script...
Please wait. Building qtconfig wrapper script...

Setting permission of the files and directory

Please wait ...

NOTE: You do not have permission to write to /usr/bin, so you cannot link
GEOVIEW to be in your path. If you would like to make
the links later, login as a user with permission to write in
/usr/bin and run this script again

Configuration completed successfully.

Updated for HRS 10.6 41 Last Updated: September 2020

HRS 10 Software & License Installation Guide

APPENDIX B:
Installation Log Example

e.g. /apps/HRS_Installation_Directory/install.log
(22787) BEGIN: ********** 22787 **********
(22787) Mon Mar 1 11:05:33 CST 2010
(22787) user_john_smith
(22787) Linux Machine 2.6.25.16-SIrevC #1 SMP Thu Oct 30 15:34:26
CDT 2008 x86_64 x86_64 x86_64 GNU/Linux
(22787) /apps/HRS_Installation_Directory/linux_cd
(22787) installing l64_ from l64_
(22787) installing from/apps/HRS_Installation_Directory/linux_cd/
to /apps/HRS_Installation_Directory/
(22787) version SETUP.SH 1.12 10/10/10
(22787) command ./SETUP.SH
(22787) root
(22787) afi
(22787) autocal
(22787) avo
(22787) emerge
(22787) ismap
(22787) geoview
(22787) strata
(22787) elog
(22787) pro4d
(22787) promc
(22787) wlexchange
(22787) configure_programs init: 0
(22787) END: ********** 22787 **********

Line # Explanation:

2 The local date and time the script was started.

3 The name of the user executing the script.
4 The result of uname –a on the machine running the script.
5 The current directory where the script was started.
6 Platform the script is to install and platform it is running on.
7 Source and target directories for the installation.
8 Version information
9 Full command line example of how the script was invoked. If
Hampson-Russell software has been installed previously in the target

Updated for HRS 10.6 42 Last Updated: September 2020

HRS 10 Software & License Installation Guide

directory, this line will contain the word “ALREADY” followed by a

list of the software that has been detected.
10-16 Names of components installed “ root” refers to the mandatory items
such as configuration scripts and the bin, lib and lmgr directories.
17 When the script configure_programs is run, this line shows the result
of (0 for no error, non-zero for failure) and whether the script used an existing configuration
(“from environ”) or began a new one(“init”).
(8807) The left most column is the process ID of the script when it was running – in the unlikely
event that more than one person tries to run the script at the same time and install to the same
directory, you will see a discontinuity in this column between BEGIN and END lines.

Updated for HRS 10.6 43 Last Updated: September 2020

HRS 10 Software & License Installation Guide

APPENDIX C:
General Troubleshooting Hints on License Installation
This list provides some general debugging information:
• When you start the license server be sure that you direct the output into a local log file
where you can examine it. The log file often contains useful information. Examine it when
you have a problem, and be prepared to answer questions about it when you talk to a
support person.
• When you talk to a support person, be prepared with answers to the following questions:
• What kind of system is your license server running on?
• What version of the operating system?
• What system and operating system is HRS 10 Geoview running on?
• What version of HRS 10 geoview?
• What error or warning messages appear in the log file?
• Did the server start correctly? Look for a message such as:
server xyz started for: feature1 feature2
• Are you running other FlexEnabled products?

Anti-Virus Issues
If you are experiencing issues with the HRS application, please have your IT group review the anti-
virus logs and add an exception as needed to the local client or the company AV policies for the
HRS application installation.

License Server is Slow to Start on Windows

If your license server is slow to start after you open HRS on Windows, it may me set to the Auto
(Delayed Start) option.
1. Click Start and type “Services” to open the Services dialog (View Local Services).
2. Search for the name of your configured license server (for example, Flexlm Service 1) and
right-click.
3. Select Properties.
4. Change the Startup Type option to Automatic.

Updated for HRS 10.6 44 Last Updated: September 2020

HRS 10 Software & License Installation Guide

Updated for HRS 10.6 45 Last Updated: September 2020

HRS 10 Software & License Installation Guide

APPENDIX D:
Using your own version of the QT libraries with Geoview

HampsonRussell Geoview dynamically links an unmodified version of the Qt library (Copyright

© 2017 The Qt Company Ltd. and other contributors), licensed under GNU Lesser General
Public License, version 3 (https://www.gnu.org/licenses/lgpl-3.0.html). An open source copy
of the Qt library can be downloaded from the CGG GeoSoftware Knowledge Base.
To use your own modified version of the QT libraries with Geoview, you need to do the following:
For Windows:
Overwrite the existing QT libraries from the modified QT libraries
(Qt5Concurrent.dll, Qt5Core.dll, Qt5DBus.dll, Qt5Gui.dll, Qt5Multimedia.dll,
Qt5MultimediaQuick_p.dll, Qt5MultimediaWidgets.dll, Qt5Network.dll, Qt5OpenGL.dll,
Qt5PrintSupport.dll, Qt5Qml.dll, Qt5Quick.dll, Qt5QuickParticles.dll, Qt5QuickWidgets.dll,
Qt5Sql.dll, Qt5Svg.dll, Qt5WebEngineCore.dll, Qt5Widgets.dll, Qt5Xml.dll and
Qt5XmlPatterns.dll) into [HRS_INSTALL]\geoview\exe folder.
For Linux:
Overwrite the existing QT libraries from the modified QT libraries
(libQt5Concurrent.so.5, libQt5Core.so.5, libQt5DBus.so.5, libQt5Gui.so.5, libQt5Network.so.5,
libQt5OpenGL.so.5, libQt5PrintSupport.so.5, libQt5Sql.so.5, libQt5Widgets.so.5,
libQt5X11Extras.so.5, libQt5XcbQpa.so.5, libQt5Xml.so.5, libQt5MultimediaWidgets.so.5,
libQt5Multimedia.so.5, libQt5Quick.so.5, libQt5XmlPatterns.so.5, libQt5Svg.so.5,
libQt5QuickWidgets.so.5 and libQt5Qml.so.5) into [HRS_INSTALL]\lib64 folder.

Updated for HRS 10.6 46 Last Updated: September 2020