Install
Install
Install
PCI Software
Version 9.1
November 2003
Table of Contents
Table of Contents ........................................................................................................................................... 3
Getting Started................................................................................................................................................ 5
Software Packaging .................................................................................................................................... 5
Supported Platforms ................................................................................................................................... 5
System Requirements ................................................................................................................................. 5
Recommended System for Windows version:........................................................................................ 5
UNIX Systems - Recommended............................................................................................................. 5
Specific Hardware and Software Requirements ..................................................................................... 6
Dual Processors ...................................................................................................................................... 6
Notes Before you start ................................................................................................................................ 6
How to Reach Us........................................................................................................................................ 7
Installing PCI Software on a Windows System.............................................................................................. 8
Installing your PCI Software ...................................................................................................................... 8
Installing PCI Software as Floating Server Clients .................................................................................. 11
Clients on a Floating server. ................................................................................................................. 11
Installing PCI Software on a UNIX System ................................................................................................. 13
Preparing to Install your PCI Software..................................................................................................... 13
Installation ............................................................................................................................................ 13
Post Installation Environment variables (UNIX), Licensing and License Server Operations. .................. 14
Setting UNIX Environment Variables...................................................................................................... 14
PCIGROUP .......................................................................................................................................... 15
PCIHOME ............................................................................................................................................ 15
PCILIC ................................................................................................................................................. 15
USERHOME ........................................................................................................................................ 16
LD_LIBRARY_PATH and PATH....................................................................................................... 16
PCI_EASIHLP ..................................................................................................................................... 16
Aliases .................................................................................................................................................. 17
Java....................................................................................................................................................... 17
ORACLE_HOME ................................................................................................................................ 17
Access to License Manager for Windows and Unix................................................................................. 17
About License Manager........................................................................................................................ 18
Cleaning up your License.dat file......................................................................................................... 19
Floating License Server (Windows) Installation and operations ........................................................... 20
Floating Server Environment Settings...................................................................................................... 21
LICSERVR_PORT: Setting the Port.................................................................................................... 21
LICSERV_HOST: Setting the Host ..................................................................................................... 21
PCILIC_OTHER: Setting License Server specifically on a Win2000 Server ...................................... 22
Floating Servers and Clients..................................................................................................................... 22
Checking your Floating Licenses ......................................................................................................... 22
Reading the Floating License Report ................................................................................................... 23
Viewing the Environment Variables ........................................................................................................ 23
Additional Environment Variables ........................................................................................................... 23
PCI_EASIHLP: Setting old style help for EASI .................................................................................. 23
License Server for Unix............................................................................................................................ 23
Cross Platform Floating Licenses............................................................................................................. 24
Using a File Share ................................................................................................................................ 24
Using FTP................................................................................................................................................. 25
Uninstalling PCI Geomatica Software.......................................................................................................... 26
Geomatica Maintenance for Windows ..................................................................................................... 26
Uninstalling for Windows ........................................................................................................................ 27
Using Geomatica Uninstall................................................................................................................... 27
Uninstall Using the Control Panel ........................................................................................................ 27
Uninstall Manually ............................................................................................................................... 27
Getting Started
This section contains information that is required prior to the installation of your PCI Geomatica
software. Subsequent sections will describe installation, licensing and required maintenance to
run your PCI Geomatics Software.
Software Packaging
The following items should be included in your software package:
Manuals
Interlock hardware device (for Windows only): SentinelPro, Sentinel SuperPro, USB
SuperPro
License
Marketing literature
Supported Platforms
Solaris 8, Solaris 9
System Requirements
PCI software is distributed on ISO9660 format CD-ROMs. PCI software requires a valid license
and hardware key (for windows only dongle) to run; otherwise it will run in demo mode with
limited functionality.
CD-ROM drive.
24-bit Windows graphics card or accelerator, running at 1280 x 1024 pixels. The
minimum is a 16-bit graphics card or accelerator, running at 1024 x 768.
OpenGL
X11 windowing system with OpenWindows or Motif (CDE) window manager on Sun
Solaris, and Motif on all other systems. Motif software may have to be purchased from
the manufacturer.
800 MB of free hard disk space in one partition. The required disk space will vary,
depending on the packages installed.
Linux / PC
VGA display of at least 1024 x 768 x 8-bit (more is recommended) supported by RedHat
Linux 9.0 or equivalent.
X-11 windowing system installed and properly configured (tested with XFree and MetroX).
Openmotif-2.2.2-3_ICS.i386.rpm
Sun Microsystems/Solaris
SPARC workstation.
CDE or OpenWindows.
Dual Processors
PCI software is not specifically designed to take advantage of a dual processor configuration. If
you are running a single PCI process, you will not see any speed advantage with a dual
processor configuration.
How to Reach Us
PCI Geomatics
50 West Wilmot Street
Richmond Hill, Ontario
Canada, L4B 1M5
Phone: +1 (915) 764-0614
Fax: +1 (915) 764-9604
Email: info@pcigeomatics.com
Web: http://www.pcigeomatics.com
Customer Services
Phone
1 877 RING-PCI (+1 877 746-4724) (Toll Free North America)
+800 2 RING PCI (+800 2746 4724) (United Kingdom, Belgium, France, The Netherlands)
1 (915) 764-0614 (Direct to PCI Geomatics Headquarters)
Email
support@pcigeomatics.com
license@pcigeomatics.com
Fax
1 (915) 764-9604
On the Web
http://www.pcigeomatics.com/support/support.html
For windows, there are two ways to start the installation. The first option is to load the CD into
the CDROM, this will automatically start the setup process. Or run the command
\CDROM\setup.exe, using a command prompt or an explorer session.
Note: The remainder of this section assumes that the setup program has been activated and is
running. If you are encountering problems with the installation, please contact technical support.
Panel 5: Information
The Information dialog box opens displaying last minute instructions and notes that were not
included in the release at the time of publication. Please review and click Next when finished.
You may encounter problems with the license manager later on if you specify the wrong dongle
type. Please ensure that you are selecting the correct dongle during the installation process. If
you have chosen an USB dongle, on reboot, the system may not find the specific driver. If this is
the case, then a driver configuration wizard panel will appear. Please follow the instructions.
Where requested for the driver, point to the following location:
\geomatica_V91\sys\nt\lic\superpro\win_nt\i386\ sntnlusb.inf
Note: there are approximately 200 Sentinel SuperPro hardware locks in circulation that appear
identical to the SentinelPro locks. On the side of the lock will be stamped Sentinel SuperPro. If
you do have one of these dongles, please select the SuperPro interlock.
Note: Glenco dongles are no longer supported for Geomatica 9. Please contact support for
assistance if you have a glenco dongle.
10
A floating license server has been installed, licensed and is running (i.e. allocation
tokens).
The client machine has access to the Floating License Server, i.e. map the drive.
Note: For each new user to the client machine, they must map the server drive in order to
access the software.
11
12
Installation
You are prompted to select the system type and the directory where the software should be
installed.
To install:
1. In the PCI Setup panel, click the Install button.
2. The Installation Directories panel opens. This dialog box requests that you enter the
appropriate source and installation directories. When you are finished, click Accept.
3. The PCI license agreement panel opens. You should read the agreement carefully. If you
accept the software agreement, click OK.
4. The Choose Components to Install dialog box shows the installable components.
To individually add a component, choose the item in the left hand box, and click Add.
To remove a component, select the item in the right hand box and click Remove.
The required disk space for the current installation is reported at the bottom of the dialog
box.
To accept your list of components, click Accept. PCIsetup copies the software to your
hard disk. The installation will require some time to perform this process.
5. After the installation is complete, a Post Installation dialogue box will appear. This panel
provides important information for the environment setup to run PCI software. To exit
Setup, click OK.
When the installation is complete, please proceed to section for post installation and licensing
instructions.
13
14
PCILIC=$PCIHOME_V91/etc/license.dat
export PCILIC
USERHOME=/usr/workingdirectory
export USERHOME
alias geomatica_91=$PCIHOME_V91/exe/geomatica
In order to use on-line help for Geomatica, Java must be enable. The following environments are
necessary to access Java
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/<java>/lib
export LD_LIBRARY_PATH
PATH=$PATH:/<java>/bin
export PATH
where <java> is the directory where Java has been installed.
PCI_JAVA_HOME=/<java>
export PCI_JAVA_HOME
To access Oracle the following environmental variables should be added.
ORACLE_HOME=/client_name/oracle/OraHome1
export ORACLE_HOME
LD_LIBRARY_PATH=$LD_LIBRARY_PATH:$ORACLE_HOME/lib
export LD_LIBRARY_PATH
PATH=$PATH:ORACLE_HOME/bin
export PATH
PCIGROUP
PCIGROUP
This environment variable is intended for developers that wish to access procedures and
executables they have developed with the PCI software toolbox without needing to copying them
into the installed software tree. Executables and ancillary files located in the pro, hlp, exe, etc,
and models directories, are searched for first in the PCI directory tree pointed to by the PCIGroup
environment variable. then in the PCIHOME_V82 tree, and finally, in the PCI directory tree
pointed to by the PCIMASTER variable.
setenv PCIGROUP $PCIHOME_V91
PCIHOME
It is necessary to set up the PCIHOME_V91 environment variable to point to the root of the
directory tree where Geomatica V91 has been installed. This setting allows users to maintain
multiple versions of PCI software on a single system. This variable can be set as follows:
setenv PCIHOME_V91 /usr/geomatica_v91
PCILIC
When the PCIHOME_V91 environment variable is set, an internal explicit link is set to the
$PCIHOME_V91/etc/license.dat file. If the location of the license.dat file is different than what is
explicitly linked, then the PCILIC environment variable should be set.
If the environment variable PCILIC exists, the software will assume it points directly to the
current, valid license.dat file (not to the directory containing the file, but to the file itself). Using
PCILIC overrides the search for $PCIHOME_V91/etc/license.dat and if the environment variable
is not set to point to a valid license data file, no further search is made.
15
In some cases, such as when sharing a single license file across several systems in a network, or
for those users who receive a supplementary license file to use with a new package, it may be
necessary to set up additional environment variables. Its use, in most cases, is optional. Using
PCILIC is useful in cases where you want to have one copy of the license data file, to be used for
all the systems you are licensed. This makes it possible for maintenance items, such as the
addition of new keys, to be performed only once.
This variable can be set as follows:
setenv PCILIC $PCIHOME_V91/etc/license.dat
USERHOME
To maintain preferences from one session to another for each individual user, the USERHOME
variable should be set. The USERHOME should be set to a directory where the user has write
permissions. This variable can be set as follows:
setenv USERHOME ../usr/workingdirectory
PCI_EASIHLP
This environment variable has been created for users who would prefer to use the old helper style
of help within easi.
The default for this variable is set to the HTML help system.
setenv PCI_EASIHLP HTML
16
Aliases
An alias provides a shortcut to a program. The PCIHOME_V91 variable must be set first, and
then an alias can be defined. The alias can be set for any of the PCI Geomatica program. For
the geomatica toolbar, the alias is set as follows
alias geomatica_v91 $PCIHOME_V91/exe/geomatica
Java
The online help for FOCUS on Unix platforms requires Java to be installed. You will need to get
the latest version of Java for your System. Geomatica Version 9.1 uses Java 1.3 or greater.
Below is a good link to download Java:
http://www.geocities.com/marcoschmidt.geo/jvm.html
This link provides the Java Virtual Machine (JVM) for several UNIX systems - the user would just
have to select and download the system that they are using. Please note that when accessing the
java help, there may be a time delay of a minute or two before the helper panel appears. The help
panel will remain active after a focus session has ended. Simply close the helper application.
The variables can be set as follows:
setenv PCI_JAVA_HOME /<java>
where <java> is the directory where Java has been installed
The following are option if you experience library problems or the path to JAVA hasnt been set
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:/<java>/lib
setenv PATH $PATH:/<java>/bin
ORACLE_HOME
The ORACLE_HOME variable is required to configure PCI Geomatica to Support Oracle 8.1.6i.
To be able to work with Oracle data directly in Geomatica, you need to ensure that the PC or
UNIX system that you are using has a proper installation of Oracle.
If you are accessing Oracle data from a server system, make sure that the system that you are
using has a proper client installation of Oracle. Check with your system administrator (or
database administrator) to find out the location of the Oracle Home directory.
Geomatica needs to know where the Oracle home directory is located to be able to access and
load in Oracle data. When installing Oracle on PC systems, the registry and path variables are all
updated automatically. On UNIX (Solaris) systems, you will have to set up a few environment
variables:
setenv ORACLE_HOME /client_name/oracle/OraHome1
setenv LD_LIBRARY_PATH $LD_LIBRARY_PATH:$ORACLE_HOME/lib
setenv PATH $PATH:ORACLE_HOME/bin
where: /client_name/oracle/OraHome1 indicates the location of the Oracle home
directory.
17
application, and then run License Manager. For Unix you can execute PCISETUP from
Geomatica_v91/exe.
After the installing PCI Geomatica on your PC, a reboot is required (a reboot is not required for
Unix systems). The reboot is required to start system drivers that have been applied. After the
restart, the License Manager application is open. From this panel you can access the following:
Licensing procedures
Customize setup options
A Notepad window is also opens, with the heading PCI Installation Log File. You may want to
print this file for future reference. When you are finished reading or printing the Installation Log
file, close the Notepad window.
Select the License button on the LICMAN panel to get to the license manager.
Note: You may encounter problems with license manager if you have specified the wrong dongle
type. Please ensure that you are selecting the correct dongle during the installation process. To
fix the problem you can either reinstall the software with the correct options, or correct the registry
variable for PCIHLO, where S is for SentinelPro, and SP for SuperPro. Editing registry variables
can be found in section, Editing the Windows Registry.
If you have chosen an USB dongle, on reboot, the system may not find the specific driver. If this
is the case, then a driver configuration wizard panel will appear. Please follow the instructions.
Where requested for the driver, point to the following location:
\geomatica_V91\sys\nt\lic\superpro\win_nt\i386\ sntnlusb.inf
18
System Information
This section of the License manager panel provides information about the software Version, the
Operating System, the CPU id of the System, and the date.
For windows the CPU Id is taken from the interlock (dongle) attached to the parallel or USB port.
On Unix Systems the CPU id is determined from the hardware Ethernet address. To get this id,
you can type sysinfo at the command prompt.
The Save Information to File button allows you to save the system information to a file. This
information is needed by PCI to generate your license key, and is also important when contacting
PCI support with questions.
Note: You should provide this information whenever you contact PCI support as it provides the
most accurate record of your system.
Selecting Accept will save the information to the specified file. The file must not exist or an error
will occur. Selecting Cancel will abort the action and return you to the License panel.
License keys
This section of the License Manager panel provides a list of License Keys as read from the
license file (if found). The current license data (license.dat) file is displayed immediately below the
list of license keys. Each License Key can be selected from the list by simply clicking on it. When
selected the license key is decoded and its information displayed in the lower half of the panel in
a section entitled Current Key.
In the Current Key section you will find the status of the currently selected license string, which
are listed under License Keys. An important piece of information is Users: item. User:
Unlimited indicates a stand-alone license key. User: # indicates that the license is a floating
license code for the indicated number of users. Licensed packages for each string are listed to
the right of the panel.
19
Provided with your install is a clean license.dat file. Simply delete the old file, and copy the
license.dat.clean file to license.dat.
Note: You will not be able to manually clean your license.dat file with an ASCII editor, if this is
done, errors will occur when trying to run PCI software, reporting that you are not be properly
licensed.
Get system Information this provides information for software version, OS specifics
and CPU id.
Check Floating Licenses this has 2 tabs, the first shows the list of license tickets
currently in use, and the second shows the list of licenses by package available on the
current server.
Environment Variables this displays all the environment settings currently in use, or
which may potentially be used
Floating License Server Installation/operations this allows access to install, start,
stop or remove a license server.
To install the license server select Customize from the license manager panel, select the
Floating License Server Installation/Operations button, then select the Install License Server
as Service. To start the service click Start (installed) License Server. The License Server is
enabled for your operating system.
The license server services can also be managed through a command prompt. You have to be
located in the /geomatica_v91/exe directory. To run any of the services you have to type the
following:
licservr -install
licservr -start
licservr -stop
licservr -remove
20
licservr -help
After the service is installed and started you will find it in the Services section of Administrative
Tools via the Control Panel.
Note: If you are applying floating license keys to an already existing floating license server you
must stop and restart the floating license service from the Customize options from License
Manager for the additional keys to be recognized.
21
22
Note: You can run the License Servers for PCI Software Versions 7.x, 8.x and 9.x at the same
time. However, the license.dat that is being used for the specific version of the software must
reside in different locations. If now, there maybe problems when running the multiple servers.
The reports update regularly and show current license information for your system.
The Users data sheet lists ticket identification, software package, program name, and user
identity. If a user runs more than one program using an identical package ticket, the first program
using the ticket is shown. The reference count will reflect the number of programs using the ticket.
The Licenses data sheet shows a list of software packages for active floating licenses, the
number of purchased floating licenses, licenses in use, and licenses available.
23
No special configuration switches are required other then running the license server application in
the background. As an example, for version 9.1, the following line would start the license server:
$PCIHOME_V91/etc/licservr &
Please note: Depending on your system setup, and version, the $PCIHOME_V91 environment
variable, might not be set up at the time the daemon is started. This will depend on how you set
up your system's environment and the version of the software installed. You might need to use
the full path to the licservr application.
To remove the license server, simply use a kill command. Running the psg command on UNIX
will list all of the present processes on that machine. The process can then be stopped by using
the kill -9 nnnnn command (where nnnnn is the process identifier).
24
on these products for other Platforms. If a file share system is in place then the instructions for
installing on a homogenous network described in the manual apply
You will also need to install Geomatica on each client machine.
Note: Be sure to install on the client with the appropriate CD as Windows and Unix are not
usually delivered on the same. Once the floating license service is up a running properly, all that
is needed is to ensure that each client is point the PCILIC variable to the license.dat file found in:
/servermachine/path/Geomatica_V91/etc/license.dat
or
DRIVE:\geomatica_v91\etc\license.dat.
On windows this can be done at the system, users, or the registry level. On Unix this should be
included in the users login script (.cshrs).
Using FTP
If you dont have the proper FILE/DRIVE sharing software in place you can use the second
option. When the license server is started it creates a file called licserv.srv. This contains the
name/ip address, port#, and process id of the server machine. If you have an installation of PCI
on a client machine all you need to do is copy the license.dat file and the license.srv file from the
server to the /geomatica_v91/etc directory on the client machine. When you start the software on
the client it does not find a valid license in the license.dat file and uses the license.srv file to know
where to look for a proper license. This scenario works but it creates issues that require some
imaginative system administration work
On Unix each time the server is rebooted you have to restart the license server, so you probably
have this in a startup script. On windows this is installed as a service and starts automatically.
Each time the license server is restarted the license.dat and license.srv files have to be copied or
ftpd from the server to the client machine. In the case of a Unix server these files can be ftpd at
boot time by adding the appropriate commands to the script you use to start the license server.
An ftp service (such as the ftp component or Microsofts IIS) needs to be running on the Windows
client side to receive the files.
25
26
Uninstall Manually
On some occasion, errors may occur during either the installation or removal of the Geomatica
software. For instance, if the system is not rebooted when requested and a second installation is
performed. This corrupts the uninstall links within the registry and the system assumes that each
time the setup program runs, it uninstalls the software. Also if you have tried to remove the
software manually InstallShield may only be giving you the Modify, Repair, or Remove options
when trying to install new.
To completely remove PCI Geomatica software manually, the following must be removed from
the system.
Registry entries
27
28
29