Skip to main content
Blackboard Help

Uninstall Learn

If you are a Managed Hosting customer, this topic doesn't apply to you.

The Blackboard Learn Installer is run at the command line. If uninstalling on Windows, this action must be performed by a user with Administrator privileges. If uninstalling on Linux, the action must be performed by bbuser.

Before running the uninstaller on UNIX

It is important to close all Blackboard Learn-related sessions that are connected to the Oracle database. Follow these steps to disconnect related sessions:

  1. Login as root:

    su - root

  2. Stop all Blackboard Learn services.
  3. Terminate database connections by shutting down and restarting Oracle Database Server.


    Issue the following SQL command to find connected sessions:

    SQL>select process from v$session where schemaname IN

Uninstall on a load-balanced system

Uninstalling a load-balanced system requires removing the application files from each application server and the Collaboration server. After running the Uninstall option on one application server, that application server, the file system, and the database will be removed. Use the Uninstall Appserver option to remove the application files on the Collaboration server and the other application servers. To uninstall app server only, add the -a option to the command, denoted with [-a] as optional in the examples below.

Uninstall Blackboard Learn 9.1 Q2 2016 and later

If the uninstall procedure fails, contact Blackboard Technical Support by logging in to Behind the Blackboard at

Follow these instructions to fully uninstall Blackboard Learn.

  1. Stop all Blackboard Learn services.
  2. Launch the installer

    Please note that the Q2 2016 installer does not create a persistent bb-installer-log.txt file. As a result, one should always capture the output from the installation for troubleshooting purposes. Run the following command to launch the installer:


    To uninstall, open a terminal and enter:

    /usr/local/bbinstaller/ -c /full/path/to/ -u [-a] | tee -a bb-installer-log.txt


    To uninstall, open Command Prompt and enter:

    C:\bbinstaller\installer.bat -c C:\full\path\to\ - u [-a] 1> bb-installer-log.txt 2>&1

    Installer properties must be referred to at its full absolute path and is required for uninstalling the Learn application. For more information on setting up your properties file, see Preparing Installation Properties.

  3. The installer will download the appropriate version of Gradle and begin the process of uninstalling the application.

Uninstall Blackboard Learn 9.1 Q4 2015 and earlier

The Installer and Updater includes two uninstall functions.

  • Uninstall completely removes the application files, content files, and the database.
  • Uninstall App Server Only uninstalls only the application files, and leaves the content files and database. Typically, Uninstall App Server Only is used as part of the process when uninstalling a load-balanced system. However, it can be useful to uninstall the application files and save the content files and databases for archiving.

As a best practice, Blackboard recommends that instead of uninstalling, you re-image the application and database servers and then perform a fresh operating system installation. If the uninstall procedure fails, contact Blackboard Technical Support by logging in to Behind the Blackboard at

  1. Stop all Blackboard Learn services.
  2. Launch the Installer. Windows users can double-click the Installer. UNIX users should run the following command to launch the Installer, where /usr/local/bbinstaller/java is the location of the installer file:

    /usr/local/bbinstaller/java –jar updater_file

  3. After reading the welcome message, select Next or press ENTER to continue.
  4. To specify the directory where Blackboard is located, select Next to accept the default, or enter a new value and then select Next.
  5. Select the Uninstall Blackboard Learn option and select Next.
  6. A message displays explaining what will be uninstalled. Select Next to uninstall.