INSTALLATION

 

GOLPE 4.5 is distributed in CD-ROM format. The CD is recorded using iso9660 format with both Rock Ridge and Joliet extensions. It can be read either in UNIX workstations (including SGI) and in any PC running Windows95/98/NT.

GOLPE can be either installed or updated. The main difference between the two procedures is that the Installation requires to ask a installation key to MIA, while the Update is made over a previous running version of GOLPE and does not require any MIA intervention.

 

From version 4.5.6 the installation procedure has changed. GOLPE can be installed on a NFS server and exported, in such a way that different hosts can share this resource and execute GOLPE on the local CPU. If you plan to share the GOLPE install directory between different host please read the section Installing GOLPE on a NFS server before starting.

 

Install

STEP 1.

If you have a local CD-ROM you can execute the installation program directly from the CD-ROM. Proceed to STEP 2.

If you have no CD-ROM directly attached to your computer you will need to transfer the CD-ROM contents (except the directories tutor1 and tutor2) to a temporary directory in a local filesystem. The distribution CD-ROM is readable in most computers running UNIX or Windows. The contents can be transferred using FTP, rcp etc...

If you transfer the CD-ROM contents, make sure that the capitalization of the files was preserved. If you use FTP please make sure to transfer all the files as binary data.

 

STEP 2.

Gain super-user privileges. This is not strictly required and is necessary only to write some icons in the directory /usr/lib/images. In any case you must have read and execute permissions for the source directory and writing and execute permissions for the destination directory.

Change to the mount point of your local CD-ROM or to the temporary directory where you have copied the contents of the CD-ROM. For example:

 

cd /CDROM

 

Start the GOLPE installation tool

 

./ginstall

 

ginstall

 

By default, ginstall will recognize the version of IRIX that you are running and will suggest as the source directory, the subdirectory in the CD-ROM containing the most appropriate version of GOLPE for your system. The CD-ROM contains three versions of GOLPE: irix62, irix63 and irix65. As a rule of thumb, the version of GOLPE should be equal or lower than the version of IRIX. To check the version of IRIX that you are using, type:

 

uname -R

 

If you are doubtful, simply accept the default.

Type the name of the directory Destination, the directory where the GOLPE programs will be installed. This should be the name of a new, non-existing directory. Do not create this directory before running ginstall. Be aware that you must have permission to create such directory.

Select the type of license: 1 month, 3 months or 1 year.

Press the Install button.

The program will copy all the required files to the installation directory and prepare the GOLPE binary file. Please notice that in this version NO INSTALLATION CODE IS SHOWN. Exit from the program pressing the Exit button.

GOLPE 4.5 uses a SGI library that might be not present in your system. The installation program will search in the local disk and would present a warning message if it does not succeed on finding it. If you get this warning message you can still proceed with the installation, but we recommend you to install the required library before using GOLPE. Please read the section Installing required libraries for detailed instructions.

A copy of the output produced by the program is dumped to a file called INSTALLATION.LOG or, if you are installing directly from the CD-ROM, to the window where you started ginstall.

 

STEP 3

The installation program creates a file named golpe.csh that should be sourced before the program can run. If you wish to make GOLPE generally available we suggest to add the following like to the /etc/cshrc file (you will need administrator privileges to do this):

 

source /usr/local/golpe/golpe.csh

 

where we assume that the installation directory for GOLPE is /usr/local/golpe

If you have no administrative privileges in your computer you can obtain the same results adding such a line to the file .cshrc present in your home directory.

This line adds access to the required libraries and adds an alias to the program. It is no longer needed to add the installation directory to the path or add aliases in any other files. If you have done so in previous installations, please remove them in order to avoid potential conflicts. Additionally, the file contains some configuration options that can be changed for special purposes. System administrators are encouraged to edit and customize this file to better adapt the program to the system environment. Please consult the section Editing the golpe.csh file

 

STEP 4

If you added the above mentioned line to your configurations file you will need to open a new window. In this window type:

 

golpe

 

GOLPE will show a message like this:

No suitable license line was found for this host. 
Please send the following line to MIA S.r.l. 
    
willy 1542612352 01 09-Sep-2001 1734912222 KEY 1172848414 
    
e-mail: mia@miasrl.com
FAX : +39 075 690 285 

Please copy this line verbatim and send by FAX or e-mail to MIA S.r.l. (mia@miasrl.com or FAX +39-075-690285). We will send back a similar line containing the license key. This line is called the "license line".

License lines should be copied verbatim to the file golpe.license, present in the GOLPE install directory. Until this file does not contain a suitable license line, GOLPE will keep showing the above information or an error message and will not start.

Please notice that license lines are unique for each installation instance and each system. If you repeat the installation you will need a new license line.

 

 

Update

IMPORTANT: GOLPE licensing system has changed in version 4.5.6. GOLPE versions 4.5.6 or higher can not be updated over previous versions. Please re-install.

STEP 1.

If you have a local CD-ROM you can execute the installation program directly from the CD-ROM. Proceed to STEP 2.

If you have no CD-ROM directly attached to your computer you will need to transfer the CD-ROM contents (except the directories tutor1 and tutor2) to a temporary directory in a local filesystem. The distribution CD-ROM is readable in most computers running UNIX or Windows. The contents can be transferred using FTP, rcp etc...

If you transfer the CD-ROM contents, make sure that the capitalization of the files was preserved. If you use FTP please make sure to transfer all the files as binary data.

 

STEP 2.

Gain super-user privileges. This is not strictly required and is necessary only to write some icons in the directory /usr/lib/images. In any case you must have read and execute permissions for the source directory and writing and execute permissions for the destination directory.

Change to the mount point of your local CD-ROM or to the temporary directory where you have copied the contents of the CD-ROM. For example:

 

cd /CDROM

 

Start the GOLPE updating tool

 

./gupdate

 

gupdate

 

By default, gupdate will recognize the version of IRIX that you are running and will suggest as the source directory, the subdirectory in the CD-ROM containing the most appropriate version of GOLPE for your system. The CD-ROM contains three versions of GOLPE: irix62, irix63 and irix65. As a rule of thumb, the version of GOLPE should be equal or lower than the version of IRIX. To check the version of IRIX that you are using type:

 

uname -R

 

If you are doubtful simply accept the default.

Type the name of the directory Destination, the directory where the previous version of GOLPE was installed. This directory should contain a operative version of GOLPE, or the updating will fail. The previous version will be overwritten and lost. If you wish, you can make a backup copy of your old version before updating.

Press the Update button.

The program will copy all the required files to the installation directory and will prepare the GOLPE binary file. Exit from the program pressing the Exit button. No more operations are required.

GOLPE 4.5 uses a SGI library that might be not present in your system. The installation program will search in the local disk and would present a warning message if it does not succeed on finding it. If you get this warning message you can still proceed with the installation, but we recommend you to install the required libraries before using GOLPE. Please read the section Installing required libraries for detailed instructions.

 

 

Installing required libraries.

Some GOLPE 4.5 plots make use of SGI's Inventor library. If it is not installed on your system, the installation or updating tool will show a warning message in the screen. If you see such a message during the install please proceed with the installation. When it is finish you must install the required libraries.

The Inventor Execution Only Environment libraries (inventor_eoe.sw) are distributed in any release of IRIX 6.x. Find in the IRIX distribution CD-ROM's the product "Inventor Execution Only Environment", using the Software Installation Tool. If you are installing GOLPE in a system running IRIX 6.5, press the Customize Installation button, open the product folder and make sure that the sub-product "Inventor n32 Run-time" is selected for installation.

 

 

Installing GOLPE on a NFS server.

Start installing GOLPE in the server using the steps 1 and 2 of the general procedure described above. This can be done locally on the server or from any workstation sharing a exported server directory. In any case, make sure that you have writing permissions on the installation directory during the install. For regular GOLPE use, the installation directory can be mounted "read-only".

For example, lets imagine that GOLPE is installed in the server bigboss, in the directory /usr/programs/golpe. This directory is exported to the workstations willy and billy which mount this directory read-only as /nfs/golpe.

In each workstation the following tasks should be done:

1. Source the file golpe.csh adding the following line to the local /etc/cshrc file of every workstation

source /nfs/golpe/golpe.csh.

2. Review the file golpe.csh and make sure that the settings are suitable for the workstations. Edit and change as required (refer to the following section for a description of the golpe.csh file).

3. Make sure that every workstation contains the required Inventor library.

4. Start GOLPE in every workstation. Collect the lines produced in a single block of text:

willy 1542612352 01 09-Sep-2001 1734912222 KEY 1172848414
billy 1521566712 01 09-Sep-2001 1734912222 KEY 1234671178

Send the line produced by every workstation to MIA S.r.l. (mia@miasrl.com or FAX +39-075-690285). We will send back similar lines containing the license keys. Copy verbatim these lines to the file golpe.license, present in the GOLPE install directory. Until this file does not contain a suitable license line for a certain host, GOLPE will keep showing the above information or an error message and will not start.

A different line is required for every workstations or system running GOLPE. If the server itself is not used to run GOLPE, no license line is required for this host.

Please notice that license lines are unique for each installation instance and each system. If you repeat the installation you will need a new license line.

 

 

Editing the file golpe.csh.

The file golpe.csh sets some environment variables required for GOLPE normal operation. In a simple local install, the installation program automatically creates a suitable file and no user intervention is required. However, in complex site installations or after changes in the directories, etc.. the file can require some editing.

The file golpe.csh basically serves to set some environment variables and to add an alias. These environment variables are:

GOLPE_DIR

Defines the complete path to the installation directory. Should be change when this directory is moved elsewhere or in NFS installs, when the path is different from the point of view of the workstations.

MIA_LIB (or MIAN32_LIB for IRIX6.5 systems)

This variable points to the place where suitable dynamic object libraries are placed, usually the lib subdirectory hanging from the installation directory. Even if more than one MIA product is installed in the system, this environment variable must be set only once. The directory containing these libraries is added to the dynamic linker path, adding them at the beginning of the list of directories in the LD_LIBRARY_PATH (LD_LIBRARYN32_PATH for IRIX 6.5 systems).

 

Apart from these environment variable settings, the script golpe.csh adds the alias golpe to the executable, so it is no longer required to add the installation directory to the PATH environment variables or adding alias otherwise.

 

 

Customizing GOLPE look.

GOLPE 4.5 uses SGI schemes in order to have a consistent look and feel with other SGI applications. The color of the background and the foreground of the main window can be also changed including in root directory a resource file called Golpe. The directory gifts present in the distribution directory contains an example that can be used as a template.

In addition, the aspect of the program can be changed using the schemes browser (schemebr) provided with the IRIX operative system.

If the icons were not installed due to insufficient writing permission, it's still possible to install them copying the icons present in the CD-ROM (directory /icons) to the the directory .icons of every user.