Skip to main content
Blackboard Help

Perform the Install - Q2 2016

After the Get Started, Application Server, Learn Database, and optional configurations have been reviewed, the hardware and software meets the supported requirements and is properly configured, and the pre-install checklist and worksheet have been completed, proceed with installing the Learn Application.


The steps for installation on one application server (one or two server configurations) or the first application server in a load-balanced configuration are the same. For a load-balanced configuration additional installations are necessary. After completing installation on the first server, continue installation following the instructions at the end of this section.

The installer is run at the command line, using Gradle, Maven, and an installer properties file. The command line installer provides a default or anticipated value where possible.

Where to Find the Installer

Blackboard Learn installers are found Behind the Blackboard (

To request a behind the blackboard account, instructions for downloading the installer, a current license file for this release, and any instructions specific to your license, contact your Blackboard Client Representative.

The Installation Process

Installation of Blackboard on Windows requires super-user privileges; thus you must be logged in as the Windows domain user (such as “blackboard”). On Linux, you must be logged in as bbuser, and all directories required for access by the installer must be permissioned appropriately to give bbuser write privileges.

The system super-user must also perform Service startup and shutdown

The installer is run at the command line, using Gradle, Maven, and an installer properties file. The command line installer provides a default or anticipated value where possible. In such cases you may either overwrite the value explicitly in the properties file or omit the value from the properties file to accept the default.

Blackboard recommends that content management be used only with Load-Balanced systems.

In a multi-server environment, the installer must be run multiple times to set up each application server. After the first application server and the database have been installed using the installation script, run the installer using the App Server Only Installation option on each of the additional application servers. Use the App Server Only commands in step 3 to achieve this and minimize downtime during your installation.

The installer properties will be required just as in a Full Installation. The installer will not access the database on an Appserver-only Installation, which means that nodes can be added to a load-balanced configuration while the system is live.

Keep the following points in mind:

  • Blackboard Learn must be installed as the system super-user when installing on Windows. Service startup and shutdown must also be performed as the system super-user.

1. Set Up the Installer

Place the installer, the installation properties file, and the license file in a directory on the application server. The installer is a zip archive, and must be extracted to continue to installation. The installer must be extracted into an EMPTY fresh new directory. We suggest using the given examples as the parent directory, and create a new subdirectory named after the precise installer version. The following steps use the below as examples only - you may use a directory of your choosing (note it cannot be the target Blackboard installation target directory):


Parent folder: /usr/local/bbinstaller/

Empty, new directory for every release: /usr/local/bbinstaller/3000_1_2


Parent folder: C:\bb_installer

Empty, new directory for every release: C:\bb_installer\3000_1_2

2. Login to the server

Blackboard Learn must be installed as the system super-user in Windows. Linux requires the software to be installed by the user that owns the blackboard installation directory, typically bbuser.




Switch to system administrator account.

3. Launch the installer

The Q2 2016 installer creates a persistent bb-installer-log.txt file to capture the output from the installation for troubleshooting purposes. For UNIX systems, the | tee –a bb-installer-log.txt portion of the following commands is optional. For Windows systems, the 1> bb-installer-log.txt 2>&1 portion of the following commands is optional. These portions are redundant, but ensure that the output file is created.

Run the following command to launch the installer:


For full install, open a terminal and enter:

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

To perform an App Server Only installation, run the following command:

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


On Windows open Command Prompt and enter:

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

To perform an App Server Only installation, run the following command:

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

Installer properties must be referred to at its full absolute path. For more information on setting up your properties file, see Preparing Installation Properties For The Q2 2016 Installer.

4. Install the Software

The installation will now commence. The installer will download the appropriate Gradle package and start the installation.

The average installation time for a Full Installation is forty minutes.

Installation Success

The installer will display a 'BUILD SUCCESSFUL' message and you may start Learn.

Installation Failure

If the installer failed, as indicated in the installer results, check the installer log and see Troubleshooting to diagnose and fix the problem.

After the installer has completed Learn will be available of the following ports by default.


Before continuing with the post configuration steps confirm Blackboard Learn is available on the server by accessing the application from those URLs.

Starting and Stopping Learn

Starting, stopping, and restarting Learn is managed using the ServiceController tool located in the admin tools directory. Learn more about using the ServiceController.


Next: Optional - Front Learn with a Webserver or Optional - TLS Configuration