Skip to main content
pdf?stylesheet=default
Blackboard Help

Running the Updater

Running the Updater on 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) version 7u7 or higher. 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.

    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 as this will cause the upgrade to fail and may leave the database in an indeterminate state.

Running the Updater on UNIX (Red Hat and Solaris)

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) version 7u7 or higher. 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.