Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Installation Guide
GEOVARIANCES & ECOLE DES MINES DE PARIS No part of the material protected by this copyright notice may be reproduced or utilized in any
form or by any means including photocopying, recording or by any information storage and
March 2016 retrieval system, without written permission from the copyright owner.
1 Isatis Installation Guide
Table of Contents
1 Introduction .................................................................................................. 3
6 Borrowing.................................................................................................... 42
Two kinds of Isatis licenses are provided: floating license and single user license.
· Floating License: This license is hosted by a server and is available for any computer
connected to the network.
· Single User License: This license is hosted locally by a computer and Isatis is available only
from this computer.
The licenses are attached to a host ID which is a unique computer identifier and is used by the
Geovariances License System to lock a license to a specific computer. Note that Geovariances also
provides customers with dongle licenses. These kinds of licenses are floating or single user
licenses and are attached to a USB dongle host ID. This means the license can be activated and
used on any server or computer which has the dongle plugged in.
2.1.1 Hardware
A PentiumTM 4 - class computer (at least 1 GHz) is recommended to run Isatis, with a minimum of
This section describes the procedure to follow in order to install the Windows 1 GB of RAM and 1 GB of available disk space for software installation only. An Ethernet card or
version of Isatis on your PC. This version runs under Windows 7 or 8. a USB dongle is also mandatory on the machine running the License Manager or on the machine
Running Isatis under Windows requires that Exceed (from OpenText) is running Isatis with a single license.
already installed on your PC. For Isatis evaluation purposes, you can install Isatis now uses of specific SSE2 processor instructions in order to boost its performances; however
an evaluation version of Exceed from the Isatis CD-ROM, or, download it these instructions are not implemented on old generation processors. The list of compatible / non-
from the Geovariances web site. You must install Exceed before Isatis. compatible processors can be found on the following webpage: http://en.wikipedia.org/wiki/SSE2.
Please read the system requirements carefully before proceeding with the Isatis makes use of virtual memory, however, the more memory available the better the
installation itself. performance.
The software installation consists of three compulsory steps: Isatis is also taking advantage of multi-core processors.
· Installing Exceed A CD-ROM drive or Internet connection is required to proceed with the installation.
· Installing Isatis
· Activating a License NVIDIA graphic cards with most recent drivers are recommended for the use of the 3D Viewer.
AMD/ATI cards with recent drivers are also supported. Intel graphic cards are known to cause some
problems during 3D graphic rendering.
Note that if you purchased a floating (site or multi-site) license (instead of a
single user license) you will have to perform an extra step before activating
the license i.e. installing the License Manager on a server. 2.1.2 Software
Before installing Isatis itself, please make sure that the following software products are also
installed on your Personal Computer:
Windows 7 or 8 (32 or 64-bit). 64-bit Operating System is recommended.
Exceed 14 software from Open Text.
Note Exceed 15 is not supported by Isatis.
Note If you do not have the Exceed software on your PC, you can install an evaluation version of
Exceed from the Isatis CD-ROM or download it from the Geovariances web site. You can install
this temporary version - valid for three months - on your PC in order to evaluate Isatis.
An HTML 4.0 compliant browser such as: Firefox (recommended), Google Chrome or Internet
Explorer (11.0 or higher). It is recommended to set Firefox, Google Chrome or IE as default.
Silent installation 7 8 Isatis Installation Guide
This file is also present on Isatis CD-ROM. Double click on the file. This will automatically
extract and install the required Exceed functionalities on your system.
Silent installation 9 10 Isatis Installation Guide
2.3.2.1 Welcome
Read the license agreement and press “I agree” to continue the installation. You must accept the
agreement to install Isatis. You can download this contract at:
http://www.geovariances.com/en/IMG/pdf/CGL_ISATIS_150615_UK.pdf
Silent installation 11 12 Isatis Installation Guide
The software can be installed anywhere on your computer, provided that 300 Mb of free space is The installation will take a few minutes.
available on the selected disk.
The usual installation folder, offered as a default, is: 2.3.2.5 Setup Complete
You have reached the end of the installation procedure and you can ask to Show Release Notes.
C:\Program Files\Geovariances\Isatis
If the license is hosted by a server machine (floating license), go to the next section (License
However you can select any other folder by clicking on Browse. Manager Installation) otherwise jump to the section License Activation.
The installation folder should NOT exist, as the installation script will create it.
2.3.2.6 Silent Installation
A silent installation can be achieved by using the /S switch when launching the installer from a
DOS command window.
C:\> C:\Isatis_2016_winnt.exe /S
You can set the installation directory using /DIR=<installation directory> instead of using the
default installation directory - C:\Program Files\Geovariances\Isatis
Silent installation 13 14 Isatis Installation Guide
C:\> C:\ Isatis_2016_winnt.exe /S /DIR=c:\My_Directory.
2.4 License Manager Installation
Note Skip this section if you have purchased a ‘single-user’ license or if you are installing Isatis for
evaluation or for a training session.
This section describes how to install the Geovariances License Manager on a license server. The
Geovariances License Manager is based on the RLM, from reprise Software. The Geovariances
License Manager allows the sharing of an Isatis license over the network. This version runs under
Windows 7 or 8 and Linux.
Note If the server be a Linux server, refer to the section Installation under Linux/License Manager
Installation
licserver_2016_winnt.exe
For 64-bit platform
licserver_2016_win64.exe
It is recommended to copy the Geovariances License Manager file under a temporary folder, such
as:
C:\TEMP
The installation of Isatis itself is the same as when using a CD-ROM.
Silent installation 15 16 Isatis Installation Guide
Once licserver.exe is accessible on your PC - either from a CD-ROM or from a temporary copy
downloaded from the web - you can proceed with the software installation by double clicking on
licserver.exe.
2.4.2.1 Welcome
The License Manager uses RLM from Reprise Software. To have the software running when the
PC starts up, a Windows service has to be created. The service runs rlm.exe which will in turn run
the ISV daemon geovar.exe.
RLM works by communicating with other machines over the network. Isatis clients will need to C:\Program Files\Geovariances\Geovariances License
discuss with the RLM server to be able to acquire licenses. If you have a firewall installed, it must
be configured to let incoming requests to rlm.exe and geovar.exe go through. If you use Windows Manager
Firewall, this can be automatically done by the installer by letting this checkbox ON. You can
However you can select any other folder by clicking on Browse.
safely let this ON too even if you don’t use Windows Firewall in the case one day you do use it.
The installation folder should NOT exist, as the installation script will create it.
· Unregister Previous License Manager
2.4.2.4 Extraction
This option can only be checked if a License Manager from an Isatis older than Isatis 2012.2 is
detected on the PC.
The software can be installed anywhere on your computer, provided that 40 Mb of free space is
available on the selected disk.
The usual installation folder, offered as a default, is:
Silent installation 19 20 Isatis Installation Guide
2.4.2.5 Setup Complete The /NODONGLE=1 option avoids the installation of dongle driver if you don’t need them.
You have reached the end of the installation procedure and you may then activate a license. Please
refer to the section License Activation
You can set the installation directory using /DIR=<installation directory> instead of using the
default installation directory - C:\Program Files\Geovariances\Geovariances License Manager
C:\> C:\ licserver_2016_winnt.exe /S /DIR=c:\My_Directory.
This section describes the procedure to follow in order to install Isatis under 3.1.1 Hardware
Linux.
Isatis runs on different Linux distributions platforms, with a minimum of 1 GB of RAM and 1 GB
Please read the system requirements carefully before proceeding with the of available disk space for software installation only.
installation itself.
A CD-ROM drive or Internet connection is required to proceed with the installation.
The software installation consists of two compulsory steps:
· Installing Isatis Isatis uses virtual memory, however the more memory available the better the performance. Isatis
· Activating a license also takes advantage of multi-core processors.
NVIDIA graphic cards with most recent drivers are recommended for the use of the 3D Viewer.
Note: if you purchased a floating (site or multi-site) license (instead of a AMD/ATI cards with recent drivers are also supported. Intel graphic cards are known to cause some
single user license) you will also have to install the License Manager, which problems during 3D graphic rendering.
is provided separately.
3.1.2 Software
Before installing Isatis itself, please make sure that your Operating System is compatible, with the
following requirements:
Linux Red Hat Enterprise 5 or 6 (64-bit) - or higher - on PCs with Intel compatible processors.
Note: You can identify your Linux version with the command: # cat /etc/redhat-release.
An HTML 4.0+ compliant browser such as Firefox (recommended) or Google Chrome. If possible,
you should avoid use Internet Explorer which might have difficulties to handle some functionalities
of the Help.
Silent installation 23 24 Isatis Installation Guide
Depending on the type of license you purchased, you can either store the license on the user The different steps of the installation are described later on. Please skip the next section.
computer (single user license) or on a server (floating license). In the last case you must first select
the server machine on which Isatis will be installed, this will also be the host for the License
Manager. In order to perform the installation you must login as the system administrator (root) on 3.2.3 Installation From a CD-ROM
the server station.
The Installation Script for Isatis is located under /cdrom/isatis_2016/isatis directory of the CD-
ROM and is named setup.sh.
3.2.2 Installation from the web
To start up the setup script just type in the following command:
# sh /cdrom/isatis_2016/isatis/setup.sh
3.2.2.1 Downloading Isatis
This Bourne-Shell script has a basic terminal user interface that will give you options and actions
If you have an Isatis CD-ROM available you may skip this section. to choose from. Answers are expected to be numbers, character strings or y/n, while default
options are mentioned between brackets [ ].
If you wish to download Isatis from our web site you must be registered as an Isatis User and
therefore you should have your own login and password. Once you have your login and password,
simply go to the download section: 3.2.4 Installation Script
http://www.geovariances.com/
3.2.4.1 License Contract
Then download the Isatis file corresponding to your platform, e.g. for Isatis version 2016:
isatis_2016_linux64-gcc41.tgz The installation script shows you the license contract. Use PAGE UP and PAGE DOWN to review
this contract. You can download this contract at:
isatis_2016_linux-gcc41.tgz http://www.geovariances.com/en/IMG/pdf/CGL_ISATIS_150615_UK.pdf
It is recommended to copy the Isatis file under a temporary folder, such as: Accept the contract with y to continue the installation.
Do you accept the license contract? [y/n] y
/tmp/isatis
Then specify a directory path to install Isatis.
3.2.2.2 Launching the Installation Script Enter a directory path where the product must be installed: /apps/isatis
Once the file has been downloaded it must be uncompressed (original size: approx. 250Mb): If this directory already exists, the script will warn you:
# cd /tmp/isatis /apps/isatis already exists, overwrite it? [y/n] y
# gunzip isatis_2016_linux64-gcc41.tar.gz
Silent installation 25 26 Isatis Installation Guide
Isatis uses the Browser for its on-line documentation. Specify the full path of the executable, so
that Isatis can launch it whenever it is necessary. Isatis does not support Google Chrome! Please 3.3 License Manager Installation
use Firefox.
Enter full path of the Brower’s executable: /usr/bin/firefox
Note Skip this section if you have purchased a ‘single-user’ license or if you are installing Isatis for
evaluation or for a training session.
3.2.4.2 Cleanup
This section describes how to configure the Geovariances License Manager on a License Server.
If you have downloaded Isatis from the web, do not forget to backup or cleanup the temporary
The Geovariances License Manager is based on the RLM, from Reprise Software. The
installation files: linux64-gcc41, common.tar, contract.txt, setup.sh.
Geovariances License Manager allows the sharing of an Isatis license over the network.
3.2.4.3 Setting up the User Environment Note If the server is a Windows server, refer to the section Installation under Windows/License
Manager Installation
Some environment variables must be initialized, in the user's .login, .cshrc or .profile:
the GTX_HOME variable must be set in order to locate the Isatis Home directory, e.g.:
3.3.1 Installation from the web
/apps/isatis
the PATH variable must also be updated in order to give access to Isatis executables, by adding the
directory $GTX_HOME/bin to the path. 3.3.1.1 Downloading the License Manager
As an example, a typical .cshrc file may contain the following statements: If you have an Isatis CD-ROM available you may skip this section.
setenv GTX_HOME /apps/isatis
If you wish to download Isatis from our web site you must be registered as an Isatis User and
setenv PATH $PATH:$GTX_HOME/bin
therefore you should have your own login and password. Once you have your login and password,
simply go to the download section:
3.2.4.4 Installation Complete
http://www.geovariances.com/
You have reached the end of the installation procedure.
Then download the Isatis file corresponding to your platform, e.g. for License Manager version
If the license is hosted by a server machine (floating license), go to the next section (License
2016:
Manager Installation) otherwise jump to the section License Activation.
licserver_2016_linux64-gcc41.tgz
It is recommended to copy the License Manager file under a temporary folder, such as:
/tmp/licserver
start() {
To start up the setup script just type in the following command: echo $debuglog
# sh /cdrom/isatis_2016/licserver/setup.sh su - $rlmuser -c "$rlmdir/bin/$rlmplat/rlm -c $rlmdir -dlog $debuglog &"
}
This Bourne-Shell script has a basic terminal user interface that will give you options and actions stop() {
to choose from. Answers are expected to be numbers, character strings or y/n, while default su - $rlmuser -c "$rlmdir/bin/$rlmplat/rlmdown -c localhost@5053 RLM -q"
}
options are mentioned between brackets [ ].
case "$1" in
start)
start
3.3.3 Installation Script ;;
stop)
stop
;;
3.3.3.1 Installation restart)
stop
sleep 2
Then specify a directory path to install the License Manager. start
;;
Enter a directory path where the product must be installed: /apps/licserver *)
echo $"Usage: $0 {start|stop|restart}"
If this directory already exists, the script will warn you: exit 1
esac
/apps/licserver already exists, overwrite it? [y/n] y exit 0
You MUST modify this example in order to set the correct definition of variables rlmuser,
3.3.3.2 Cleanup rlmdir, rlmplat and debug_log.
If you have downloaded Isatis from the web, do not forget to backup or cleanup the temporary
RLM License Manager can be run as any user. You might use root as the rlmuser or any user you
installation files: linux64-gcc41, setup.sh.
created for this particular service.
3.3.3.3 Starting the License Manager Do not forget to set the Startup Script Executable:
# cp /apps/licserver/install/rlm.sh /etc/init.d/
The Geovariances License Manager daemon is a process that must always run; therefore it is
# chmod +x /etc/init.d/rlm.sh
advisable to launch it at boot time.
Under Linux type the following command in order to activate the script for the next reboot.
Here is an example of a boot script that can be saved as a file /etc/init.d/rlm.sh (you can find a copy
# chkconfig --add rlm.sh
of this script in /apps/licserver/install/rlm.sh).
#! /bin/sh
# For other platforms, please check your Operating System documentation.
Silent installation 29 30 Isatis Installation Guide
If you want to start the License Manager daemon now, without rebooting your machine, just type
the following command:
# /etc/init.d/rlm.sh start
4 License Server Administration
You may also start up the License Manager at any time by following a few steps:
· change directory to the license directory of the installation The Geovariances License Manager includes various programs: geovar.exe, GVlictool.exe,
# cd /apps/licserver lic_scan.exe, rlm.exe, rlmanon.exe, rlmdebug.exe, rlmdown.exe, rlmnewlog.exe, rlmremove.exe,
· start the License Manager in background mode: rlmread.exe, rlmstat.exe, rlmswitch.exe, rlmswitchr.exe and rlmutil.exe.
# ./bin/linux64-gcc41/rlm –c . & These tools are handled by the RLM License Server Administration Application. This web-based
application is accessible from the port 5054 and offers all the necessary tools for License
However, running the License Manager like this will require you to run it after each reboot of the
Management:
system, so once you are satisfied with the configuration, you should make the startup automatic
using a startup script like explained above. · Starting/stopping the license manager
You have reached the end of the installation procedure and you may activate a license. Please refer · Showing the status of the current licenses
to the section License Activation
· Diagnostics and logs for troubleshooting.
To open the web based application, enter http://my-server-name:5054 in the address bar of
your internet browser.
Silent installation 31 32 Isatis Installation Guide
For more information about these commands refer to the rlm-Enduser.htlm file available in the
installation directory of the Geovariances License Manager.
5 License Activation
To use a license, it must to be activated using the Geovariances Activation Tool, based on RLM(r).
The activation process requires an Internet connection. To activate the license enter your name
and e-mail address and the activation key provided by Geovariances. This license can be used
locally on a workstation or through the network using a server.
· Single user license: Install the product package on a workstation and activate the licence from
this workstation.
· Floating license(s): Install the license tools on the server and activate the license(s) from this
computer. Then install the software package on one or several workstations, specifying the
server name when starting Isatis for the first time.
The license is attached to a unique device and must be activated from the appropriate computer.
The license can be attached to computer hardware or to a USB dongle. Note the USB dongle has to
be plugged into the workstation or license server during the license activation process.
This chapter describes how to activate a license, use a license server, select a product pack and
borrow a license from a server.
When launching Isatis, a window pops up asking you to select a Product Pack. The window lists all
the activated packages if you have defined the license environment correctly. If no package
appears, this indicates that you must activate a key or specify a license server. From this window,
you can select a package and launch it, specify a licence server or even activate a licence.
Silent installation 33 34 Isatis Installation Guide
If no package is available or if you want to use another license click Specify a server or activate
a license. You can either use license server or activate a new license using a key on this computer.
Silent installation 35 36 Isatis Installation Guide
Note- If you are using a dongle on the license server, the dongle must be plugged into the server before
launching the “license Manager”. If the dongle is not plugged in, please plug it in and restart
GVlictool.exe.
Enter your Name, E-mail address and the Activation Key. This key has been sent by Geovariances.
It is a series of 16 digits with a dash every 4 digits (e.g.: 1234-5678-1234-5678).
Press Verify Key and a short description of the activation key will appear specifying the contents,
the expiration date and the type of the license that will be activated with the key.
The bottom line specifies the Host ID of the machine or dongle.
The program will connect to the Geovariances servers and check the consistency between the Host
ID and the Key. Press OK to get the new license that will be stored in the License Manager
installation folder.
The Activation Tool establishes an Internet connection to the Geovariances servers when pressing
Verify Key or OK buttons.
If OK and Verify Key buttons don’t know work, you might need to setup a Proxy configuration.
Please read the paragraph below about Proxy Configuration (see 5.3).
Select the option Activate Locally and enter your Name, your E-mail address and your Activation
Key. This key has been send by the Geovariances’ support Team. It is a code with 16 digits with a
dash every 4 digits (e.g: 1234-5678-1234-5678).
Silent installation 39 40 Isatis Installation Guide
5.4 Diagnostics
Should you have any problem during license activation or if asked so by the Geovariances
Technical Support Team, you can press the Diagnostics button to get information about current
machine configuration (and existing license diagnostics).
This will generate a text file in a temporary location and tell you where it has been stored on disk.
Please locate the file and send it to the Geovariances Technical Support
(support@geovariances.com) to help you activate your license.
· No Proxy
This option tells the program to directly connect to the Internet not going though any proxy server.
Select the package you want to use. For each package the number of currently available licences
and the total number of licences are specified. Highlight a package so that the list of corresponding License borrowing enables you to share licenses on your local area network (floating licenses)
options will appear on the right hand side. Select the package that you wish to use and press OK while allowing you to “check out” a license for working offline, i.e. while disconnected from the
to start using it. network. You may thus bring along this “borrowed” license while traveling. This temporary license
remains valid for 35 days, but can be released at any time before the end of the period.
If you select this option Remember my Decision, this panel will never pop up again, while if you
do not select this option, the question will popup again in 3 month.
Use the button Show me the Information I share to display the statistics file that will be send
anonymously if you answer Yes. This file shows few details about the computer configuration and
some statistics about the used panels of Isatis.