Skip to main content
Blackboard Help

Uninstalling Blackboard Learn

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.

Note:  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.

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 (‘BBLEARN_ADMIN’,’BB_BB60’,’BB_BB60_STATS’);

Uninstalling 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.

How to Uninstall Blackboard Learn

IMPORTANT!  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. 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, click Next or press ENTER to continue.
  4. To specify the directory where Blackboard is located, click Next to accept the default, or enter a new value and then click Next. If Blackboard Learn is not found in the directory provided, the Updater will attempt to install at the given location.
  5. Select the Uninstall Blackboard Learn option and click Next.
  6. A message displays explaining what will be uninstalled. Click Next to uninstall.