Skip to main content
pdf?stylesheet=default
Blackboard Help

Perform the Upgrade

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

Learn 9.1 April 2014 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 Release Notes and the Install Learn topics completely before proceeding. Pay particular attention to port and web server changes required for Learn 9.1 April 2014.

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. Learn 9.1 April 2014 is TLS-only. If you had TLS Choice configured, it will be turned off during an upgrade.

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.
  3. Run the Pre-Update Change Report.

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.

If you launched the updater from the command line, 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.

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/jdk7.
  2. Place the updater file in the desired location.
  3. Open a command-line prompt as the root user and navigate to the directory that holds the updater.
  4. Issue the following command to launch the updater:

    $JAVA_HOME/bin/java -jar <updater_file>

    If using the X Windows System (X11) or a similar GUI solution and the DISPLAY variable is properly configured, the updater will launch in GUI mode.

    The following steps assume that the command-line updater is used.

  5. A welcome message appears with a reminder to read the release notes and the installations instructions completely before updating.
  6. Press ENTER to continue. Instructions appear for navigating through the updater prompts. The updater, in most cases, will provide a default value in brackets.
  7. Press ENTER to accept the default and continue, or enter a different value. Press ENTER to continue after entering a new value. The first updater prompt asks for the directory where Blackboard will be found.
  8. Press ENTER to accept the default, or enter a new value and then press ENTER. If Blackboard Learn is not found in the directory provided, the updater attempts to install at the given location.
  9. At the next prompt, type 1 for “1 – Upgrade and Convert” and press ENTER. For those clients with content management and the/courses area turned off, a warning appears displaying a message that the /courses content area must be turned on to successfully upgrade. Although not recommended, the /courses area can be disabled again after upgrade, but it must remain on during upgrade.
  10. If the server does not already have a Server Type value, the Server Type screen appears. Properly categorize the server and press ENTER.
  11. When a message appears displaying the changes that will be made when the updater runs, carefully verify the changes. You will not be able to undo the changes after you start the upgrade.
  12. Press ENTER to start the upgrade.

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:\JDK7.
  2. Place the Updater file in the desired location, and then double-click the Updater file to launch the Updater. A welcome message appears with a reminder to read the release notes and the installations instructions completely before updating.
  3. Click Next to continue.
  4. Confirm the installation and content directories for your environment, and then click Next. Load-balanced systems should use the correct UNC path for your content directory. For those clients with content management and the /courses area turned off, a warning appears displaying a message that the /courses content area must be turned on to successfully upgrade. Although not recommended, the /courses area can be disabled again after upgrade, but it must remain on during upgrade.
  5. At the next prompt, select Provide new license file, and then click Next.
  6. If the server does not already have a Server Type value, the Server Type screen appears. Properly categorize the server and click Next.
  7. When a message appears displaying the changes that will be made when the updater runs, carefully verify the changes. You will not be able to undo the changes after you start the upgrade.
  8. Click Next to start the upgrade.

After the installer has completed 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.