IGB Release Documentation
Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 205 Current »

Introduction

Since IGB 8.3.0 (released 1/22/15), IGB has made use of a native platform installer for Windows, Mac, and Linux.

Test the IGB installer for each operating system both before and after the new version is released.

Test the automatic version updater after the new version is released.

Pre-Release Installer Testing

Go to the Loraine Lab bitbucket repository for IGB, then download and run the most recent main-JDK8 branch installers for your operating system.

  • IGB Setup Wizard launches.
  • mac
  • linux
  • windows
  • Follow the prompts on the wizard. When the setup is complete click Finish and the IGB Splash image will appear. 
  • mac
  • linux
  • windows
  • IGB launches and runs normally.
  • mac
  • linux
  • windows


After the new version release of IGB is complete and available on the bioviz.org IGB download page, follow the steps below for post-release testing.  

Post-Release Installer and Update Testing

After the release of a new version of IGB, follow the instructions to download the now outdated previous version of IGB. Running this IGB version should trigger the updater.

This will let us test that the IGB updater is working properly to automatically update old versions of IGB to the new release.

General Function Checklist

Start by following this link to go to the IGB Downloads page: http://bioviz.org/download.html

  • Any download button on this page (including the upper-right corner) does in fact download an installer, but discard the installers for now.
  • mac
  • linux
  • windows


Select the word here in the sentence, "Click here for other ways to download IGB" (as seen below).


Scroll to the middle of the page and select the word sourceforge in the sentence, "Older releases of IGB are available at sourceforge" (as seen below). This will take you to SourceForge where you can download older versions of IGB.


Click the folder for the second most recent version of IGB. For example, the image below shows IGB version 8.5.2 as the most recent version, so for testing purposes we will need to download IGB version 8.5.1.


Once inside the appropriate folder, select the proper download file for your operating system to download that version of IGB. Once downloaded, open the file to begin the installation. The IGB Installer will launch upon opening the downloaded file.

  • The installer opens to the IGB Setup Wizard Welcome screen.
  • mac
  • linux
  • windows
  • If there is a previous IGB installation on your computer then the Installer should display a message similar to the one below.


Note: For testing purposes, it can be helpful to install different versions of IGB to their own folder rather than replacing your previous IGB installation. This will allow you to quickly open different versions of IGB to compare while testing.

  • mac
  • linux
  • windows


To install this version of IGB to its own directory, select No, install into a different directory on the IGB Setup Wizard Welcome screen and then select Next >.

In the Destination Directory text box, enter the path to your desired installation directory and click Next >. I personally like to create an "IntegratedGenomeBrowser" folder within "Program Files" and then install each version of IGB into its own folder within the "IntegratedGenomeBrowser" folder, as seen below:


If you wish to test the creation of a Start Menu folder then make sure the checkbox is enabled for Create a Start Menu folder and select Next> (see below).


Make sure the checkbox is enabled for Create a desktop icon and select Next > (see below).

  • A new IGB icon appeared on the Desktop.
  • mac
  • linux
  • windows


Rename this Desktop Shortcut to include the IGB version name, as seen above.



  • The installer eventually showed the IGB Setup Wizard Completion screen.
  • mac
  • linux
  • windows



Make sure the checkbox is enabled for Run Integrated Genome Browser and click Finish.

  • The IGB Splash Screen appears.
  • mac
  • linux
  • windows



  • The Automatic IGB Updater appears, as seen above (the automatic updater appears when you try to run a version of IGB which is not the most recent version).
  • mac
  • linux
  • windows



Select Next > to download the most recent version of IGB to the specified directory.

  • The IGB Updater showed the "Download Finished" screen.
  • mac
  • linux
  • windows



Select Yes, execute the update installer now and click Finish.

  • The IGB Setup Wizard Welcome Screen appears for the most recent version of IGB (see above).
  • mac
  • linux
  • windows



Select No, install into a different directory and then click Next >.

Install this version of IGB to its own directory, as seen in the image below:

Continue and finish the IGB Setup Wizard to install the most recent version of IGB.

Once it is installed, launch IGB.

  • IGB opens and the most recent version number can be seen in the window's title bar (see above).
  • mac
  • linux
  • windows



Now return to the IGB Downloads page and reinstall the most recent version of IGB, replacing the current installation directory in the process:

  • The previous installation directory has been replaced and the most recent version of IGB can be launched properly.
  • mac
  • linux
  • windows
  • No labels