Version 3.1 is the current stable release version. The AG3.1 packages available here have no known issues at present; please report any problems so they can be fixed.

In this release, AGVCR and VPCScreen will be included automatically if the AG3.1 Toolkit is installed with Synaptic or apt-get as described below.

After installation of the toolkit, the AGVCR launcher still needs to be manually initialised. This can be done by running the following command at the command line:
    agpm3.py -p /usr/share/accessgrid3.1/agvcrlauncher3.1-1.2.agpkg3
(note that this is done as a normal user)

1. Using Synaptic:

Open the Synaptic Package Manager and then the Software Sources window (from the Settings->Repostitories menu) and add the following entry in the Third Party tab of the Software Sources widget:
    deb http://www.vislab.uq.edu.au/debian hardy/

Also ensure that the "Universe" repository option is checked selected in the main Ubuntu 8.04 tab.

Close the Software Sources window.

Now reload the package information (use the Reload button, or select Reload Package Information from the Edit menu).

Finally, search for and install the accessgrid3.1 package. A number of prerequisite packages should also be automatically installed.

2. Using apt-get:

Add the universe section to those associated with your main Ubuntu repository. Do this by editing your /etc/apt/sources.list file so that the line similar to:
    deb http://archive.ubuntu.com/ubuntu/ hardy main restricted
becomes
    deb http://archive.ubuntu.com/ubuntu/ hardy main restricted universe

Next, add the UQVislab package repository to your sustem's source. Either add the following line to the beginning of your /etc/apt/sources.list file:
    deb http://www.vislab.uq.edu.au/debian hardy/
or run this command at the command line:
    sudo wget http://www.vislab.uq.edu.au/debuntu/sources.list.d/hardy.list -O /etc/apt/sources.list.d/uqvislab.list

If upgrading from a 3.1-cvs version, remove it with:

sudo apt-get remove accessgrid3.1

Now run:

sudo apt-get update

and then

sudo -H apt-get install accessgrid3.1

(Please note the -H option for the sudo command)

Should be set to go now - log out, then log in again to find "Access Grid 3" entry in the main menu (assuming use of the default Gnome desktop).

The AG3 packages for Ubuntu hardy are available separately from the download directory

Installation fails due to problems with bajjer and/or agzsi conflicts (especially just after upgrading from Ubuntu Gutsy to Hardy)
    - this is most likely due to the renaming of these packages; it should be a rare situation now that new packages with corrected dependencies have been released. However if you have this problem, it can be fixed by first removing the old bajjer and agzsi packages and reinstalling the accessgrid3.1 package again - like this:
Post installation of accessgrid3.1 fails due to agversion error (especially just after upgrading from Ubuntu Gutsy to Hardy)
    - this can be fixed by removing an out of date .pyc file, as follows:
Upgrade issues:
A packaging error has been causing issues (such as listed below). This was fixed in 3.1-4ubuntu4  but for all versions prior to this verison, upgrades should be performed using the following ccommands in a shell:
    sudo apt-get purge accessgrid3.1
    sudo apt-get install accessgrid3.1
It will then be necessary to reinstall any additional service packages such as vpcscreen and aghdvic.
Typical error caused by the packaging error are:
    - use of package manager (slapt-get, Synaptic) may leave /etc/AccessGrid3/* directories in an inconsistent state after an upgrade of the accessgrid3.1 package.
    - the vpcsreen or aghdvic service is "lost" (even though it appears to be installed) after an upgrade of the accessgrid3.1 package.

NB. accessgrid3.2 is now available and its generally recommended that everyone should upgrade. If upgrading from a version up to and including accessgrid3.1-4ubuntu3, the upgrade is best done as above i.e. by purging the old version first (rather than normal upgrade), then installing the 3.2 version - like this:
    sudo apt-get purge accessgrid3.1
    sudo apt-get install accessgrid3.2

Please send any comments, advice etc., to Chris Willing <c.willing _at_ uq.edu.au>