Skip to main content
pdf?stylesheet=default
Blackboard Help

Perform the Upgrade - Q2 2016

Using the Installer Update option, administrators upgrade Blackboard Learn to the latest version.

Learn Q2 2016 is based on an Apache™ Tomcat-only architecture, which no longer requires the installation of an HTTPD service (Apache or IIS). As a result, this release requires specific operating system configuration changes prior to installation that were not necessary for previous versions of Learn. Please read the Install Learn topic completely before proceeding. Pay particular attention to port and web server changes required for Learn 9.1 Q2 2016.

If using Portfolios and upgrading Blackboard Learn with an Oracle database there is a risk on Upgrading to to the new Portfolios that will leave partially migrated Portfolios and possible duplicates of partially migrated portfolios.

Only Personal Portfolios with no name are affected.

To mitigate the risk of partially migrated portfolios prior to running the Learn upgrade you must execute the following SQL on your Oracle database: update pflio set title=‘.' where title is null.

TLS Choice is no longer an option in the user interface. Blackboard Learn 9.1 is TLS-only. If you had TLS Choice configured, it will be turned off during an upgrade.

The Q2 2016 release contains an upgrade for ActiveMQ. It is important that the ACTIVEMQ_MSGS table is empty before performing your upgrade. If you are a self-hosted customer and need assistance with this action please open a case with Client Support.

Pre-Upgrade Steps

Before running the installer to upgrade Learn complete the following tasks:

  1. Read the Release Notes and Technical Details.
  2. Read the Install Learn and Upgrade Learn topics.

Perform the Upgrade

Upgrading Learn uses the same installer as if you were performing a fresh installation.

Download the installer for your platform from Behind the Blackboard and place in the desired directory. Extract the installer from the downloaded zip archive.

Do not close the command line window or any of the other windows that pop up during the upgrade. This will cause the upgrade to fail and may leave the database in an indeterminate state.

Installer properties must be referred to at its full absolute path. For more information on setting up your properties file, see Preparing Installation Properties For The Q2 2016 Installer.

UNIX

Follow these steps to run the updater on UNIX.

  1. Make sure that the $JAVA_HOME system environment variable points to a full Java Platform (JDK). The path cannot contain spaces. For example:/usr/jdk8.
  2. Place the updater file in the desired location, and extract the archive.
  3. Ensure the appropriate installer properties file is created and it is located in the installer directory.
  4. Ensure that the Blackboard license file exists, and is located outside of the Blackboard installation directory.
  5. Open a command-line prompt as the 'bbuser' user and navigate to the directory that holds the updater.
  6. Issue the following command to launch the updater:

    /usr/local/bbinstaller/installer.sh -c /full/path/to/installer.properties | tee -a bb-installer-log.txt 2>&

  7. The installer will download the appropriate Gradle files and begin the installation. 

WINDOWS

Follow these steps to run the Updater on Windows:

  1. Make sure that the JAVA_HOME system environment variable points to a full Java Platform (JDK). The path cannot contain spaces. For example: C:\JDK8.
  2. Place the updater file in the desired location, and extract the archive.
  3. Ensure the appropriate installer properties file is created and it is located in the installer directory.
  4. Ensure that the Blackboard license file exists, and is located outside of the Blackboard installation directory.
  5. Open a command-line prompt as the Administrator user or with appropriate Administrator privileges and navigate to the directory that holds the updater.
  6. Issue the following command to launch the updater:

    C:\bbinstaller\installer.bat -c C:\full\path\toinstaller.properties 1> bb-installer-log.txt 2>&1

  7. The installer will download the appropriate Gradle files and begin the installation. 

After the installer has completed Learn, start services and Learn will be available of the following ports by default.
 
http://localhost:8080
https://localhost:8443
 
Before continuing with the post configuration steps confirm Blackboard Learn is available on the server by accessing the application from those URLs.