Installing GIserver:

Detailed install instructions can also be found in the various readme files on the distribution CD's or download site files. If you are installing GIserver on a UNIX/LINUX machine, you must still install GIadmin on a Windows machine. Skip to GIADMIN Install section for this option.

On Native Windows servers:

GIADMIN Install

  • If you previously selected the GIadmin install option, the following screen will not be presented. Check the Windows GIadmin install option in the following screen and click Next:
  • The Program License Agreement will appear. Read the message and click on Yes, if you accept all of the terms:
  • The default installation destination folder for GIadmin will appear next:
  • If you want to change this location, click on the Browse button:
  • The Choose Folder file selection window will appear. Enter the path you want for the GIadmin. The path must end with \giadmin.
  • Note: If you have just installed filePro, GIadmin will look for the location of the filePro install and set the path for you.
  • Click on OK and then Next to access the next installation screen to specify the location of your filePro data files:
  • Click on OK and then Next
  • Click on Next and the Select Components window will appear. Be sure that Install Java Runtime is also checked if you have not previously installed the Java Runtime with GIserver:
  • If GIadmin has been previously installed, the install shield will ask you if you want to replace your servers file. If you want to replace the servers file you should click on the Yes button:
  • If you don't want to replace the servers file, click on the No button:
  • Click on Yes to replace an existing servers file:
  • When clicking on Yes, a screen is presented to enter the Address, Port # and Name. For Address you can enter either the IP address or machine name of the server. The initial screen will setup a default "localhost" server to be used when there is no network card installed on your system and you are running in Local Host mode. You can add any number of server entries during the GIadmin install to manage your servers:
  • Click on Yes to confirm the server entry:
  • Create additional server entries by filling in the Address, Port# and Name of the server:
  • Click on Yes to confirm each server entry:
  • When you are done creating server file entries, leave all fields blank and click on Next:
  • When Setup Complete screen appears, click on Finish to complete the GIadmin setup:
  • When all setup options are complete, click on Finish to complete the setup and exit the install shield:

    SCO UNIX Install:

    Please note: To run the GIserver, the video display mode must be set to at least 256 colors or above.

    SCO Open Server 5.0.5   GIserver Installation Notes
    
    If you have a previous version of OSR5 you MUST upgrade to version 5.0.5.,
    have the UDK Compatibility Software Version 7.11 (OSRcompat711) and java2.jre2
    installed in order to run GIServer.  (See instructions below).
    
    giserver.gz is a gzipped tar file.  To gunzip giserver.gz you must have
    'gunzip'.  If you do not have it you can download gzip.tar from the "Download"
    section of our web site, www.fptechnologies.com.  cd to a directory that is in
    the PATH then extract gzip.tar with:    tar xvf gzip.tar
    
    To gunzip giserver.gz type:    gunzip giserver.gz
    
    	Once gunzipped it will be called GIserver.
    
    GIserver can be installed in the same directory where you keep filePro but it
    is usually kept in a separate directory, for example, (/appl/fp), however,
    GIserver does not have to be installed on the same machine that has filePro.
    It can be kept on another machine on the network.
    
    

    To install GIserver:

    1. Change to the directory where you have decided to install GIserver. In this example we will use /appl/fp for the install directory and /tmp/giserver for the location of the GIserver tarball. cd /appl/fp 2. Extract giserver with: tar xvf /tmp/giserver 3. To finish the install: ./giserver.finish 4. Obtain file giserver.lic from our website: Before going to the website, make sure you have the following information. * Serial Number of the 5.0 software you are running with GIserver. * Port# Giserver will listen to. (4350 is default) * Number Concurrent Connections that you purchased. * Email address that is registered with fP Technologies, Inc. * MAC_Address for the computer that GIserver will be running on. Note: The MAC_Address is entered as 12 characters with no whitespace or punctuation you can find the MAC address of the primary ethernet adapter on your SCO system by using "ifconfig -a" and look for a line containing "ether" for your primary Ethernet adapter. AN example of what you will see when running "ifconfig -a" follows. lo0: flags=4049 mtu 16384 inet 127.0.0.1 netmask ff000000 inet/perf: recv size: 49152; send size: 49152; full-size frames: 1 inet/options: -rfc1323 net0: flags=4043 mtu 1500 inet 64.220.102.170 netmask ffffffe0 broadcast 64.220.102.191 inet/perf: recv size: 24576; send size: 24576; full-size frames: 1 inet/options: rfc1323 ether 00:10:5a:20:cd:c4 The MAC address (ether) of the primary ethernet adapter is displayed as 00:10:5a:20:cd:c4 This value would be entered as 00105a20cdc4 when submitting your request for the giserver.lic Point your browser to: fptech website Then click on: filePro - Downloads - giserver License File Download - Be careful entering the required information. Once you have entered the information, the resulting giserver.lic file will be locked to that e.g. MAC address, Port and Maximum Concurrent Connection count. You will not be able to re-generate a new giserver.lic file with different settings without contacting fP Technologies sales. You will be able to re-generate another copy with the current settings at any time. 5. Place the downloaded giserver.lic into the ~/fp/giserver/lib directory. IMPORTANT: GIserver on OSR5.0.5 REQUIRES the UDK Compatibility Software Version 7.11 (OSRcompat711) and java2.jre2 in order to run. Un-install any previous version of UDK Compatibility Software before installing OSRcompat711. To install OSRcompat711: Download DL27510P000.tar Move DL27510P000.tar file into a directory called osrcompat Change to the ./osrcompat directory Extract the file with: tar -xvf DL27510P000.tar Uncompress the resulting file with: uncompress OSRcompat.711.pkg.Z Install OSRcompat.711.pkg with: pkgadd -d /OSRcompat.711.pkg YOU ALSO NEED java2.jre2. If you already have a previous version of java installed it does not have to be uninstalled; however, you do need to put /usr/jre2/bin into the PATH prior to the existing java address. On LINUX servers: The distribution CD contains all files needed to install GIserver on Linux platforms. The java2 installation varies depending on the platform you are running. There is a separate Readme_java file for each platform supported. The first step is to extract the GIserver files (into /appl/fp recommended) and run giserver/finish. See Readme_giserver (Readme_fpserver) for instructions. If you don't have a proper version of java2 installed you will be informed and told which java package to install. The java2 installation varies depending on the platform you are running. There are separate Readme_javaPLATFORM and java2jre2_PLATFORM.tar files for each platform supported. ---------------------------------------------------------------------------- Installing java2: --- GIserver requires java2 version 1.2 or better. If you are using the GIserver CD then mount the CD using the instructions that you received with the CD. If you downloaded giserver.gz off of the web site then the files you will need to install java2 are in rpm format in java2jre2_RPM.tar and self- extracting binary format in java2jre2_Linux.tar. They are located under Utilities - linux. Download the appropriate file to the /mnt directory. java2jre2_Linux.tar contains j2re_1_3_0-linux.bin and java2jre2_RPM.tar contains j2re-1_3_0-linux.rpm.bin. ---------------------------------------------------------------------------- To install j2re_1_3_0-linux.tar: If not already root enter: su Move to /usr/java directory cd /usr/java Extract j2re-1_3_0-linux.bin tar xvf java2jre2_Linux.tar Install j2re-1_3_0-linux.bin ./j2re-1_3_0-linux.bin java2 is installed. ---------------------------------------------------------------------------- To install j2re_1_3_0-linux-rpm.tar: If not already root enter: su Move to /usr/java directory cd /usr/java Extract j2re-1_3_0-linux-rpm.bin tar xvf java2jre2_RPM.tar Extract j2re-1_3_0-linux.rpm ./j2re-1_3_0-linux-rpm.bin Install j2re-1_3_0-linux.rpm rpm -iv j2re-1_3_0-linux.rpm Note: It can happen that your installation may fail with a message such as "glibc >= 2.1.2-11 is needed by jre-1.3" even though glibc2.1.29 (or greater) is on your system. This can happen when your glibc was not installed as part of an rpm package and is therefore not on the rpm file list. In that case, this JRE 1.3 rpm installation package won't recognize that glibc is installed. To force the JRE 1.3 installation to proceed, use the --force option: rpm -iv --force j2re-1_3_0-linux.rpm ---------------------------------------------------------------------------- To install the Java Plug-in follow these steps: Uninstall previous installation of the Java Plug-in, if applicable. rm -fr $HOME/.netscape/java rm $HOME/.netscape/plugins/javapulugin.so Set the NPX_PLUGIN_PATH environment variable: export NPX_PLUGIN_PATH=/usr/java/jre1.3/plugin/i386 Start your Netscape browser. If your browser is already running, close it and restart it. Close and restart your Netscape browser again. This is necessary because of bug 4358142. --------------------------------------------------------------------------- GIserver Installation Notes: 12/26/00 If you are using the GIserver CD then mount the CD using the instructions that you received with the CD. giserver.gz is a gzipped tar file. If you don't have 'gzip' see the Readme_java for your operating system. In this Readme the /mnt directory will be used to download/install all packages. --------------------------------------------------------------------------------

    Installing GIserver Linux:

    GIserver will normally be installed in an giserver directory under the fp directory. If the fp directory is /appl/fp, then when the install is complete, there will be an /appl/fp/giserver directory and giserver.jar will be in it. To install GIserver: 1. Change to the directory where you have decided to install GIserver. In this example we will use /appl/fp for the install directory and /mnt/giserver.gz for the location of the GIserver tarball. cd /appl/fp 2. Extract giserver with: tar xvf /tmp/giserver 3. To finish the install: giserver.finish 4. Obtain file giserver.lic from our website: Before going to the website, make sure you have the following information. * Serial Number of the 5.0 software you are running with GIserver. * Port# Giserver will listen to. (4350 is default) * Number Concurrent Connections that you purchased. * Email address that is registered with fP Technologies, Inc. * MAC_Address for the computer that GIserver will be running on. Note: The MAC_Address is entered as 12 characters with no whitespace or punctuation you can find the MAC address of the primary ethernet adapter on your SCO system by using "ifconfig". look for a line containing "HWaddr" for your primary Ethernet adapter. You will see one or more devices listed similar to the following. eth0 Link encap:Ethernet HWaddr 00:50:DA:0D:1B:C0 inet addr:64.220.102.180 Bcast:64.220.102.191 Mask:255.255.255.224 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:77134 errors:0 dropped:0 overruns:0 frame: TX packets:24540 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:100 RX bytes:46417456 (44.2 Mb) TX bytes:4504332 (4.2 Mb) Interrupt:11 Base address:0x1000 lo Link encap:Local Loopback inet addr:127.0.0.1 Mask:255.0.0.0 UP LOOPBACK RUNNING MTU:16436 Metric:1 RX packets:692 errors:0 dropped:0 overruns:0 frame:0 TX packets:692 errors:0 dropped:0 overruns:0 carrier:0 collisions:0 txqueuelen:0 RX bytes:48363 (47.2 Kb) TX bytes:48363 (47.2 Kb) Note that there are two Ethernet adapters identified in the above example, one for the modem (PPP Adapter) and another (NDIS 5.0 driver) for the primary ethernet adapter. The MAC address (Physical Address) of the primary ethernet adapter is displayed as 00:50:DA:0D:1B:C0 This value would be entered as 0050DA0D1BC0 when submitting your request for the giserver.lic Point your browser to: fptech website Then click on: filePro - Downloads - giserver License File Download - Be careful entering the required information. Once you have entered the information, the resulting giserver.lic file will be locked to that e.g. MAC address, Port and Maximum Concurrent Connection count. You will not be able to re-generate a new giserver.lic file with different settings Without contacting fP Technologies sales. You will be able to re-generate another copy with the current settings at any time. 5. Place giserver.lic into the /appl/fp/giserver/lib directory. 6. Giserver is now ready to run. GIserver can be started from either a term window or a character screen by typing: ./startgi& from within the ~/appl/fp/giserver directory. -------------------------------------------------------------------------------- Configuring GIserver --- To start GIserver type: GIserver The first time you run GIserver you will need to 'Setup Users'. To do this Click on 'Edits' then select 'User Configuration'. Double-click on 'username.cfg' and change the 'password:' field to the password for the first user. Make sure to press when leaving the field or the field value will NOT be changed. Click on 'file' then 'save-as' and enter an appropriate filename. If the user's Unix login name is 'fred' - then use 'fred.cfg'. Repeat this process for all users.

    Change History for GIserver

    * 1.13 added GracePeriodWarning * 1.14 modified Producer.doRawMode to use BufferedOutputStream * 1.15 bug fix for change in 1.14 * 1.16 internally buffer raw mode input until newline or end_of_raw_mode sequence received * 1.17 back out 1.16 changes * 1.18 flush raw mode output stream before 'sleep' if anything in buffer * 1.19 now accept (and log) version number of filePro programs in PROCESS_INIT message * 1.20 set FPCLIENT_FEATURE=7 for GIclient connections - tmp workaround for filePro purposes * 1.21 use FileInputStream and byte[] for reading license * instead of FileReader and char[] to avoid encoding problems * 1.22 FEATURES_FLAG changes to CONNECTION_INFO message for Ken * 1.23 Changed server response to too many connections * now the server sends a message and closes the socket * 1.24 numerous changes for admin module * 1.25 fix for raw mode timing bug - moved mode switch to before buffer flush * 1.26 changed secondary license file updating to remove requirement for Java 1.3 or beyond * 1.261 fixed potential "NullPointerException" in logging in Producer.doRawMode * 1.262 added debug code to show when messages are actually sent * 1.263 made raw mode sleep code conditional on Windows platform * 1.264 additional debugging code * 1.265 additional debugging code * 1.266 additional debugging code - Message Types as text * 1.267 added sending log files to admin module for remote viewing * 1.268a added 1.4 conditional code to force disk updates * 1.269 only call 1268a conditional code when logs are requested by GIadmin module * 1.270 added debugging info for forced updates * 1.271 removed additional debugging info for forced updates * 1.272 added logging (in server.err) of failed admin logins * 1.300 modified license file format to accommodate disconnected windows laptops * 1.301 only do check for primary drive serial number on Windows * 1.302 closed hole where 000000000000 was considered a valid MAC address for licensing fixed bug introduced in 1.300 where only the first of multiple MAC addresses was checked * 1.303 added logging of default user properties to logging of environment (if logEnvironment=true is set for user * 1.304 modified loading of gethost library to show java.library.path if load fails * 1.305 modified login routines to allow for empty password if expires (in giserver.cfg) is set to anything other than 0 empty password are disallowed.
    Copyright 2000-2003, fP Technologies, Inc. All Rights Reserved

    These documents are covered under the terms and conditions of the fP Technologies, Inc. Program License Agreement

    rev. 03/05/2003