There are usually two different scenarios for installing VLAB, depending on how many people are going to be using VLAB at your site. If there is only one person going to be using it, you can perform Personal Installation. Otherwise, Site Installation is probably a better choice as it can save some disk space.
Personal Installation | Site Installation |
An idividual user installs VLAB. This person will be the only person using VLAB. | VLAB is installed in a global location by a system administrator. Multiple users use this installation, but maintain their own customization files. |
VLAB can be installed using the following 4 steps. Depending on which installation you are going to perform, you might have to ommit some steps.
This step applies to both installation types. If your administrator already performed this step, you an skip to then next step. Just find out where VLAB is installed.
a | Pick a directory where you want to install VLAB, e.g.:
/usr/local and 'chdir' into that directory, e.g.: cd /usr/local |
b | Untar the downloaded binary distribution:
gunzip < vlab-4.0-platform.tar.gz | tar xf - |
c | This will create a directory called vlab-4.0, i.e.:
/usr/local/vlab-4.0 'chdir' into this newly created directory: cd vlab-4.0 |
d | Run the following command:
./bin/postinstall.sh |
This step assumes that a VLAB Site Installation at your site already exists. If you are performing a Personal Installation you can skip this step.
a | 'chdir' to where VLAB is installed, e.g.:
cd /usr/local/vlab4.0 |
b | Run the setup script, i.e.:
./bin/setup.sh This script will ask you where you would like to copy some VLAB configuration files. Then the files are copied. |
In order for you to be able to run vlab application from any command-line, you first have set some environment variables. This is what the sourceme.sh and sourceme.csh scripts are for. The best way to do this is to source them automatically as soon as you login.
a | Determine which VLAB directory you are using.
|
b | Determine which shell you are using. Most people use sh, csh, tcsh or bash. |
c | Modify your startup files:
|
After you have modified your startup files, you have to bring the changes to effect. If you know what that sentence meant, just do so. If you do not, logout and log back in. Now type vlab-splash. The VLAB welcome screen should appear on your screen for three seconds and then disappear. If it does not, something went wrong. Go back through the installation steps and try again.
The above steps installed all VLAB components and the default configuration files. They also install example OOFS and HOFS databases. VLAB documentation can be found in the html-docs directory.
Please contact us through email if you have any questions: vlab@cpsc.ucalgary.ca
The home page for VLAB is: http://www.cpsc.ucalgary.ca/Redirect/bmv/vlab/index.html