Choose the binary installation instructions below which match the type of hardware on which you are installing Open GENIE.
Unix installation
VMS installation
Windows/NT Windows-95 installation
All unix kits are supplied as compressed tar files (made by the tar program on the appropriate machine). To de-compress you will need to have gunzip installed (if you do not have this, it is available here as a tar file for building on your system).
To install Open GENIE follow the instructions given here for a Digital Alpha machine but substitute the appropriate names and version numbers for your distribution kit of Open GENIE
gunzip genie-1.0-alpha-dec-osf3.2.tar.gz tar xvf genie-1.0-alpha-dec-osf3.2.tar cd genie-1.0-alpha-dec-osf3.2
To install GENIE in the default system location (i.e. data files in /usr/local/genie and executables in /usr/local/bin) type:
./configure make install
You will need to do the "make install" from the super user or "root" account If you wish to see what "make install" will do without actually performing the install, type
make -n install
The last command can only be executed by the superuser and does a system wide installation. If you do not have access to the superuser account, you may change the "./configure" command to give different default installation directories for yourself, for example
./configure --prefix=$HOME/genie --exec-prefix=$HOME/bin
will change the default installation directories putting any binary files into your account's "$HOME/bin" directory and the rest of genie into a "$HOME/genie" directory (your "bin" directory will need to be in your path to run genie automatically).
Once GENIE is installed, it can be invoked by running the "genie" script in the "bin" directory. If the "bin" directory is specified in your shell PATH environment variable, you should be able to just type
genie
If you are using a C shell, you will need to type
rehash
before the command will work properly.
Here are the steps needed to get Open GENIE running on a Dec alpha/AXP machine running VMS6.2 or later.
All VMS/alpha kits are supplied as compressed zip files (made by the public domain zip program). To de-compress you will need to have unzip installed (if you do not have this, it is available here as a VMS alpha executeable).
If unzip is not installed by default on your system, you may need to set up the command by typing the line below
$ unzip :== $ disk:[directory]unzip_axp.exe
where "disk:[directory]" is the location of the unzip_axp.exe file.
Next, uncompress the Open GENIE kit using the command below (you will need approximately 40000 blocks of disk space to successfully uncompress and install Open GENIE).
$ unzip genie-1_0-alpha-dec-vms6_2.zip
This will create a directory "disk:[directory.OPENGENIE_1_0]".
If you already have Tim pearson's PGPLOT package installed on your machine, you can skip to Step 3. You can check by seeing if both logical names PGPLOT_DIR and PGPLOT_FONT are already defined.
If you do not have PGPLOT installed on your system you will
need to copy the file PGXWIN_SERVER.EXE
and put it into the [.OPENGENIE_1_0] directory. If you copied it
at the same time as you got the installation kit you can simply
rename it.
ie
$ rename pgxwin_server.exe [.opengenie_1_0]*.*
Next, change into the OpenGENIE directory and type the following command to convert the format of the GRFONT.DAT file. Note you will need to end the command with two CTRL-Z characters as shown.
$ exchange/network/transfer_mode=block/fdl=sys$input grfont.dat grfont.dat RECORD FORMAT VARIABLE ^Z^Z $
For normal usage, Open GENIE can be run from this directory by adding lines similar to the ones below to your LOGIN.COM file.
$ define GENIE_DIR disk:[directory] ! substitute your local names here $ define GENIE_SMALLTALK_IMAGE genie_dir:genie.im $ define GENIE_GCL_INIT genie_dir:default_genieinit.gcl $ define GENIE_EXE genie_dir:gmain. $ define GENIE_SHARED_LIBRARY genie_dir:genie.so $ define GENIE genie_shared_library $ $! Only define the next two if you do not have PGPLOT installed $ define PGPLOT_DIR genie_dir $ define PGPLOT_FONT pgplot_dir:gfont.dat $ $! set up commands $ opengenie :== $GENIE_EXE $ gmodule :== @GENIE_DIR:GMODULE
To test the installation re-run your login.com
$ @sys$login:login.com $ opengenie
The next step is only necessary if you wish to make Open GENIE available system wide otherwise your installation is now complete.
If you wish to install Open GENIE on a system which is shared between several users you will need to put the logical name definitions above into the system startup file SYSTARTUP_VMS.COM and the two symbol definitions into SYLOGIN.COM. You may also want to install the shared library and executeable as known shareable images which you can do by adding the lines
$ INSTALL ADD GENIE_DIR:GENIE.SO /OPEN /HEADER /SHARED $ INSTALL ADD GENIE_DIR:GMAIN. /OPEN /HEADER /SHARED
to the SYSTARTUP_VMS.COM file after the logical name definitions.
Windows/NT and Windows-95 are not supported in the first release of Open GENIE but will be made available in subsequent releases.