Generic Build Support (GBS)

Developed by Randy Marques of Randy Marques Consultancy

Introduction

GBS can be installed in two ways:

1. Single User:
   GBS will be installed in your environment.
   Setup (make this version current) is optional.
   A Local Shortcut will be created to run the Setup.
2. Multi User:
   GBS will be installed in a System area or on another global accessible location (E.g.: network drive).
   A System Shortcut will be created for all users to be able to Setup this version.
   Elevated privileges are required. (Linux: sudo -E, Windows: Run as Administrator).

GBS is distributed in .zip files.
You can download and install a User version or a Development version (sources)
The Development version will install as Single User only.
Do not install the Development version if you are not familiar with GBS

Syntax of the.zip files: type_version_build-date
Where:

type: gbs or gbsdev
version: full_version (Proj-RR.VV or Proj-RR.VV-patch)
build-date: YYYY-MM-DD

User: gbs_RMC-06.02_2023-10-04
Dev.: gbs_dev_RMC-06.02_2023-10-04

Prerequisites (general)

1. You must have Perl installed and in the PATH OR referred to by EnvVar GBS_PERL_PATH.
   You need at least Perl 5, version 16 (v5.16.3).
   Missing Perl modules can be installed via CPAN.
   More info: CPAN modules
2. Decide where GBS will be installed (GBS_SCRIPTS_ROOT).

Additional Prerequisites (Linux)

1. GBS runs in bash
2. You will need the bash commands ‘xterm’, ‘at’, ‘gcc’ and ‘make’.
   Install with sudo apt install

Download and Install

1. Download the .zip file (NOT where you want to install GBS).
2. Unzip the file to a new temporary directory (NOT where you want to install GBS).
3. cd to this directory.
4. Run the install script
   • On Windows:
     Run Install.bat or
     Run Install_As_Administrator.bat or
     Run DevInstall.bat for Development
   • On Linux:
     Set the properties of Install*.sh to executable (chmod u+x *.sh)
     Run ./Install.sh or
     Run ./Install_As_Administrator.sh or
     Run ./DevInstall.sh for Development
5. Answer the questions.
   For most questions you can assume the default. (between [])
   You will need a ‘SITE-ID’. This identifies your physical location uniquely in case you work multisite. For single use, the default (MAIN) will do fine.
6. When done, you may delete the new temporary directory.

Instructions for Setup

If not executed during Install:

• Run the ‘GBS Setup [<version>]’ shortcut (Desktop and/or Programs)
• If it is not available:
  1. cd to <GBS_SCRIPTS_ROOT>/<wanted_version>.
  2. Run _gbssetup.bat (Windows) or _gbssetup.sh (Linux) and answer questions.
     This needs to be done only once per GBS user.
     Once GBS is installed you can use the command gbssettings to change your setup.

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. After the first install there will be a unzipgbs.bat/.sh or unzipgbs_admin.bat/.sh file for
   subsequent combined unzip and installs

Online Documentation and Help

1. The GBS Home page
   Here you will find a proper introduction and also links to the
   • Release Notes
   • Installation Notes
   • Full GBS documentation of the last released version: GBSHelp
2. To proceed with GBS it is strongly recommended to read at least the Quickstart

After the Setup

Startup GBS by running the ‘GBS Startup [cur]’ shortcut

Get Help with the command gbshelp

In the Development environment you also have the command gbshelpdev