2. Installation

The VEGA package is available in different archives:

Vega_XX_Irix6.2.tar.gz

SGI IRIX 6.x executable.

Vega_XX_Win32.exe

Windows 9x/ME/NT/2000/XP OpenGL setup wizard.

Vega_XX_Linux_x86.tar.gz

Linux x86 executable.

Vega_XX_Amiga.lha

AmigaOS 68k executable.

Vega_XX_Locale.tar.gz Localization toolkit with FlexCat compiler.

Vega_XX_Source.tar.gz

ANSI C source code, localization toolkit and utilities.

where XX is the release number of each archive. You you can download only the package for your system, because each archive contains all the files needed, but not the source code that is provided in a separate archive.

 

2.1 Unix installation

This section of the manual shows the steps needed to install the VEGA package on Unix-like operating systems (e.g. IRIX, Linux, NetBSD, etc). If your operating system is not directly supported by Authors, you must download and compile the source code (Vega_XX_Source.tar.gz archive).

 

2.1.1 Building the VEGA package

The high portable source code allows to build the package virtually for any computer platform that has a standard ANSI C compiler. It is possible to find some minor compiling problems due to hardware differences. If you can’t solve these problems, please contact the Authors.

As first step, you must unpack the Vega_XX_Source.tar.gz file, using the gzip command. If this command is not available in your system, you can download it from any GNU software archive (see: http://www.opensource.org). The correct syntax is:

gzip –d Vega_XX_Source.tar.gz

the unpacked file (Vega_XX_Source.tar) created by gzip must be dearchived with tar command:

tar –xvf Vega_XX_Source.tar

A directory called Vega will be created.

Check if the libraries libbz2.a, loblocale.a, libxdrf.a, libz.a and libZ32.a are present in the directory ...Vega\Src\MySO where My SO is the directory of your operating system. If not, you must compile these external libraries using the sources paced respectively in ...Vega\Src\Bzip2, ...Vega\Src\LocaleLib, ...Vega\Src\XdrfLib, ...Vega\Src\Zlib and ...Vega\Src\Z32 editing the Makefile and running make. Each library must be copied in ...Vega\Src\MySO.

After this operation, change your current directory in ...Vega\Src\MySO (Amiga, Irix, Linux, Unix, Win32) and, if needed, edit the Makefile with your preferred program. Some remarks can help you in this operation. Please set the CC variable to the compiler name (usually cc or gcc) and the CFLAGS variable for the best optimization (e.g. –O –s).

At this point, run make and the VEGA executable is compiled for your system. The makefile was successfully tested with SGI cc and GNU C (gcc for Linux, gcc for AmigaDOS) compilers.

To rebuild the Win32 version, you need the Borland C++ Builder 4.0.

Warning:
Starting from the 1.5.0 release, it was introduced the use of 64 bit integers to speed-up the manipulation of 8 character strings and thus to build VEGA, it's required a C compiler that supports that integer size. 

 

2.1.2 Setting-up your Unix system

If the downloaded package has been specifically developed for your operating system, you must unpack it using the following two commands:

gzip –d Vega_XX_MyOS.tar.gz

tar –xvf Vega_XX_MyOS.tar

If you have GNU tar, you can even do it in one step only:

tar Zxvf Vega_XX_MyOS.tar.gz

Please note that the pathway where the archive has been unpacked, is the real installation path.
The next step is the editing of your shell start-up script (e.g. .cshrc for csh or tcsh, .bashrc for GNU bash) in order to set VEGADIR and the LD_LIBRARY_PATH environment variables to the installation path. For csh/tcsh shell, you must type:

setenv VEGADIR <INSTALLATION_PATH>
setenv LD_LIBRARY_PATH <INSTALLATION_PATH>

For sh/bash:

VEGADIR=<INSTALLATION_PATH>
LD_LIBRARY_PATH=<INSTALLATION_PATH>
export VEGADIR
export LD_LIBRARY_PATH

The LD_LIBRARY_PATH is requeired to inform your system where are the dynamic libraries needed by VEGA. It’s strongly recommended to add the installation directory pathway in the command search variable path, defined in the shell startup script.

For example, if you installed VEGA in the /usr/local/bin/vega directory, you must set the environment variables as follow (csh/tcsh):

setenv VEGADIR /usr/local/bin/vega
setenv LD_LIBRARY_PATH /usr/local/bin/vega

or (sh/bash):

VEGADIR=/usr/local/bin/vega
LD_LIBRARY_PATH=/usr/local/bin/vega
export VEGADIR
export LD_LIBRARY_PATH

Than, yuou must change the file permissions:

        chmod 755 $VEGADIR/vega

As option, edit the <INSTALLATION_PATH>/Data/prefs file at the item <LANGUAGE> to select your preferred language. The automatic language selection isn't supported with Unix operating systems.

 

2.2 Windows installation

This version is a true Win32 console application and thus can’t be executed under Ms-Dos or Windows 3.x operating systems. VEGA Win32 supports correctly long filenames, Windows threading system and works fine with Windows 95, 98 and NT operating systems. The Win32 package has been compiled using the standard Pentium ® instruction set. In order to increase the performances, the code can be optimized with P6 instruction set (Pentium ® Pro, II, III and AMD K6 ®), simply recompiling the package.
To install the Vega_XX_Win32.exe package, you must execute this file and follow the simple installation wizard. Please note that only the uninstall information are added in Windows registry. If your operating system is Windows 2000 or Windows NT 4, you must have the administrator rights.
It’s strongly recommended to add the installation directory to the command search system using the PATH command present in your AUTOEXEC.BAT. Please use the semicolon (;) to limit each entry (e.g. PATH C:\WINDOWS;C:\WINDOWS\COMMAND;C:\PROGRA~1\VEGA).
If your system has got a software firewall, you must configure it granting the network access to REBOL.exe, otherwise the scripting system doesn't work because it uses the standard TCP/IP communication ports. 

 

2.2.1 About the TurboPack

The TurboPack is a sub-package that contains DLLs for a specific CPU in order to obtain the maximum performance from your hardware system. The setup wizard allows to select the installation of four TurboPack versions:

TurboPack 686    for Intel Celeron, Pentium Pro, Pentium II, Pentium III and Xeon.
TurboPack P4 for Intel Pentium 4.
TurboPack K6 for AMD K6, K6 II 3D, K6 III 3D.
TurboPack K7 for AMD Duron, Athlon (4, XP and MP).

The TurboPack 586 is installed by default. If you don't know your CPU type, install all TurboPacks because VEGA can  automatically load the more efficient DLLs for your CPU.

 

2.3 AmigaDOS installation

System requirements needed to run the AmigaDOS version of VEGA:

To install this version of VEGA package, you must unpack the distribution archive using lha command from the command shell:

lha x Vega_XX_Amiga.lha

A directory called Vega will be automatically created. If you don’t have lha, you can download it from Aminet. As for Unix systems, you must add in the user-startup file (placed in s directory of your boot disk) the following line:

SetEnv VEGADIR <INSTALLATION_PATH>

Instead of the user-startup modification, you can create a new text file in ENVARC: directory containing a single line with the installation pathway. Starting from 1.2 release, this installation step is needed only if VEGA executable is placed in a directory that is not the installation folder.

If you want to add VEGA to your standard command pathway, you can add in the user-startup the following line:

Path <INSTALLATION_PATH> Add

As final step, reboot your computer. Please note that VEGA for Amiga can accept AmigaDOS and Unix-like pathway specification. Use the specific VEGA version for the CPU installed in your system:

Version CPU
VEGA.000 68000, 68010 and any other CPU without FPU.
VEGA.020 68020 and 68030 with 68881/2 FPU.
VEGA.040 68040 and 68060.

The PowerPC CPUs are not supported.