Skip to main content
Blackboard Help

Running the Updater on UNIX

Running the Updater on an existing system will reset many back-end and user interface customizations. Customizations will need to be reapplied after the upgrade. 

How to Run the Updater on UNIX

  1. Place the Updater file in the desired location.
  2. Login as root.
  3. From the command line, navigate to the location of the Updater.
  4. Issue the following command to run the Updater:

    $JAVA_HOME/bin/java -jar updater_filename

    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. Press ENTER to continue. Follow the prompts.
  6. Confirm the installation and content directories for your environment, and then press ENTER. If the Blackboard Learn installation is not found in the path provided, the Updater attempts to install in this location.
  7. At the next prompt, select the Provide new license file option, and then press ENTER. The Provide new license file option updates the system and applies the new license file that you obtained.
  8. 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.
  9. Click Next to start the upgrade.

Do not close the command line window during the upgrade as it will cause the Upgrade to fail and may leave the database in an indeterminate state.

To ensure that adaptive release rules are functioning correctly, courses created prior to Blackboard Learn Service Pack 6 need to be copied, imported, or restored after upgrading. This process updates all links to content within a course and removes specific read permissions from students. Updating the links provides students with access to all files they had previously been granted access to. Removing specific read permissions prevents students from accessing content that they are not allowed see while honoring adaptive release rules.