GBS Logo Generic Build Support (GBS) - User Manual HOME
Install Notes
Environment| Install| Setup|

Environment

OS / Shell

GBS runs on:

Perl

GBS is based on Perl-scripts.
Perl must be installed and the perl command must be either in the PATH or specified via an Environment-Variable (GBS_PERL_PATH).
You need at least Perl version 5.16.3

If Perl (or the proper Perl version) is not in the PATH, define an environment variable GBS_PERL_PATH to point to the top-level directory where the proper Perl is installed.
e.g.: export GBS_PERL_PATH=/opt/ActivePerl-5.16

Perl can be obtained for free via GBS was developed and tested with the Perl Distributions from ActiveState

Install

After download From ActiveState: More information: Installing ActivePerl 5.16.x

Note: There is a bug in core Perl on Windows that doesn't set up @INC correctly if Perl is installed into a directory that starts with the letter '5'. Your problem should go away if you install into something like C:\MyPrograms\perl\v5.10 instead.
This bug is at least 10 years old and somewhat related to finding additional site_lib directories when you are using the versioned directory layout scheme where multiple Perl versions share site_lib directories.
Found in Perl Monks

Install

Pre-Installed

If GBS is pre-installed (local or on a network drive) your GBS Administrator will be able to tell you where GBS is installed.
You will then only need to do the Setup as explained below.

Need to Install

Several versions of GBS can be installed in a GBS_SCRIPTS_ROOT directory.
They are installed using the Hard versioned directories method.
The latest build of a version is always installed under the plain directory. E.g: 2.02
This is called the Current Build of a version. It will be overwritten with every install of the same version.
Specific Builds are installed under version_build directory. E.g.:

                        +- 2.01
                        +- 2.01_2006-11-23
      any_root -+- GBS -+- 2.02
                        +- 2.02_2007-08-05
                        +- 2.02_2007-09-15

<--GBS_SCRIPTS_ROOT-->     <---GBS_SCRIPTS_REL--->

The Install scripts only installs GBS (possibly on a central location).
To be able to use GBS, each user must 'Setup' GBS as explained below.
This tells GBS which of the version to use.
During the Install you have the option to execute the setup immediately after the install.

Prerequisites:
  1. You must have Perl installed and in the PATH
  2. Decide where GBS will be installed (GBS_SCRIPTS_ROOT)
    GBS will provide some nice defaults, but you can also specify you own location
  3. You will need to provide a Site-ID

Instructions for Install:
Notes:
  1. Subsequent installs can be run with -q flag (quiet). This will run the script without human intervention assuming all defaults to be correct.
  2. Using the WinZip Wizard (on Windows):
    1. Double-click on the zip-file
    2. Make sure you run in Wizard mode and Click 'Next'
    3. Choose 'Unzip or Install' and Click 'Next'
    4. Make sure you will not unzip to the directory where you want to install GBS
    5. Enable 'Display file icons after unzipping'
    6. You can use 'View Zip Documentation' to read this text
    7. Click 'Unzip Now'
    8. After the file is unzipped a 'Windows Explorer' window will appear.
    9. Double-click on 'Install.bat' and answer the questions. GBS is installed
    10. Close the WinZip wizard by clicking on 'Finish'

Setup

General

To setup GBS: What happens on Windows: What happens on Unix/Linux: Note that a beta version will install red shortcuts. The regular versions will install yellow shortcuts.