Learn Installation Requirements for Self-hosted Microsoft Systems

Version 14

    This page documents a few items of note for those who are installing Learn on the Microsoft platform.


    1. Q2 2017 Learn only installs and runs on MS SQL Server 2014 Standard or Enterprise editions. Q4 2016 and prior only install on MS SQL Server 2012 Standard or Enterprise editions. We know Learn does not work on MS SQL Web Edition or Express. Your milage may vary on other editions.
    2. JAVA_HOME should not contain any spaces. Install Java into a directory such that the path to the directory is space free. C:\Program Files will FAIL.
    3. Turn off virus protection during the install.
    4. Turn off firewalls during an install/upgrade.
    5. Turn off User Access control, or set it to a minimum.   (run MSCONFIG > Tools tab > select the UAC line > launch > set the slider to a minimum)
    6. The command line prompt used to run the installer script and other Learn scripts should be elevated. "Run as Administrator"
    7. Use the sa account, and its password, for the Database Administrator (DBA) account.

            # MS SQL Server SA user password is configured with the Q2 2016 or later installer.properties line below.


    1. The account running the installation needs ALTER ANY SQL permission on the DB. See   https://msdn.microsoft.com/en-us/library/ms191291(v=sql.120).aspx
    2. A JRE will not work. Make certain you have a JDK installed.
    3. The system you install on needs to be part of a domain or look like it is part of a domain.  The simple way to do this is as follows:

           Let's say you want to use the name: blackboard.localdomain. Add these lines to your windows\system32\drivers\etc\hosts file:




    Microsoft SQL Server Installation and Configuration Requirements:

    1. Install SQL Server at the drive level, for example, C:\SQL Server.
    2. Use Mixed Mode Security Authentication.
    3. Make sure SQL Server is installed using a local account.
    4. Blackboard recommends using the default instance name. If the default instance name is not used, the instance name must not include any underscores, spaces, or punctuation. Use only alphanumeric characters.
      1. If an instance other than the default is used, make sure that the instance is not case sensitive.
    5. The SQL Server Client Tools must be installed on each application server.


    Q2 2016 and Later Specific Requirements

       1.  Use Unix-style path names in the installer.properties file, unless the property name contains .win.






       2. Create the data directory specified by bbconfig.database.datadir before starting the install.

       3. Ensure that you remove any non-default password policies against MSSQL.

       4. If installing for the first time, ensure that the password given for the BBLEARN accounts meets the MS SQL password requirements.

       5. Gradle, which the installer uses, has a 12-character password limit.

           Ensure that the SA password has 12 or fewer characters and NO special characters. (#!% etc. cause issues.)

       6. MS SQL Server 2008 and MS Server 2008 are NOT supported. Upgrade before attempting the Learn Q2 2016 upgrade/install


    Video Overview: Dropbox - 2017.10.01.WinInstallSetup.mov