Skip to main content
pdf?stylesheet=default
Blackboard Help

Complete the Pre-Installation Worksheet for Windows on One or Two Servers

The installation worksheet helps identify all the information required by the installer when installing on one or two servers. Filling out the worksheet prior to installation will help the installation process run smoothly.

The following information is needed by the installer to complete the installation.

Blackboard Destination Directory: ___________________________________________

The path to a directory on the application server where Blackboard Learn will reside. The installer will create a directory called blackboard within this directory.

Setup Type: ___________________________________________

Select the Full Installation option to install Blackboard Learn on one or two servers. This option is also used when installing Blackboard Learn on the database and first application server in a Load-Balanced configuration.

License File: ___________________________________________

The path to the current license file for this release and your institution. If a current License File is not available, contact your Blackboard Client Representative to request one. The License file determines which capabilities, such as the Click to toggle glossary term definition: <begin definition>

----------------Insert Glossary Link to---------------

content management <end definition>., are installed. The license file will be detected automatically if it is renamed bb-license.xml and placed in the same directory as the installer.

Java Location: ___________________________________________

The path to the JDK.

Shared Content Directory: ___________________________________________

The path to the directory where the Blackboard Learn content files associated with Courses, images uploaded to the system, and all other files added to the system will be stored. The default location is c:\blackboard\content. The location can be a share on one of the application servers or on the database server, or it can be a SAN (storage area network) or NAS (network-attached storage) on a separate file server. To learn more about using a separate file server, see Set Up File System Storage for Windows.

Application Server Machine Name: ___________________________________________

The name of the application server. The installer will automatically populate this value. The installer must be run on the application server. To find the machine name of a server, follow the steps below.

  1. Right-click My Computer and select Properties.
  2. Click the Network Identification tab.
  3. The full computer name and the domain name both appear. The full computer name is the application server Machine Name with the domain name appended (webservermachinename.domain).

Application Server Domain Name: ___________________________________________

The name of the domain where the Web server resides. The application server Machine Name and the application server Domain Name form the URL for Blackboard (http://webservermachinename.domain). Because these names form the URL, do not use any characters other than standard letters and numbers in the application server name or the domain name. Underscores and spaces will cause problems.

Application Server Port Number: ___________________________________________

The port that the application engine uses. The default value is 8009.

Web Server Port Number: ___________________________________________

The port that the Web server will use for http connections with clients. The default value is 80.

Database Hostname: ___________________________________________

The domain name and machine name where the SQL Server database that Blackboard Learn will use is installed. The database machine name can be found the same way as the Web server machine name. When installed on a one server configuration, the database machine name is the same as the application server machine name. For this reason, the default value is the machine name of the local machine.

Database Instance: ___________________________________________

The name of the SQL Server instance that will run the Blackboard Learn database. This may be left blank if Blackboard Learn will run on the default instance of SQL Server.

SQL System Database Administrator Password: _______________________________

The SQL System Database Administrator password associated with the "sa" login.

Blackboard Database User Password: ___________________________________________

A password for a SQL Server user that Blackboard Learn creates at install. This account is also used by the application to access the database.

Blackboard Database Report User Password: __________________________________

The password for the Database Report User. This is a SQL Server user that Blackboard Learn uses.

Database Identifier: ___________________________________________

Database identifiers must be unique within the database server. The database identifier is, by default, BBLEARN. If this parameter is left blank, it will default to BBLEARN. This option is not visible during an upgrade, and is typically used exclusively in a multi-tenancy environment. A multi-tenancy environment offers the ability to host multiple Blackboard Learn instances on a single machine without the data being shared between instances. Multi-tenancy environments are not standard. If you are upgrading your environment and wish to rename your database identifier, contact Blackboard Support for assistance.

Database Data Files Directory: ___________________________________________

The directory that will store Blackboard Learn database data files (.mdf). This directory will not store application data or content. This directory must be on the database server.

Database Log Files Directory: ___________________________________________

The directory that will store Blackboard Learn database log files (.ldf). This directory will not store application or Web logs. This directory must be on the database server.

Content Management Database Password: _______________________

This is the password for the database user that the installer creates for the Content Collection databases. This value is required only if your school licenses content management.

Courses Directory: ___________________________________________

The path to the content management \courses directory. This directory will store all of the files under the \courses heading. This value is only required if your school licenses content management.

Institution Directory: ___________________________________________

The path to the content management \institution directory. This directory will store all of the files under the \institution heading. This value is only required if your school licenses content management.

Library Directory: ___________________________________________

The path to the content management \library directory. This directory will store all of the files under the /library heading. This value is required only if your school licenses content management.

Organization Directory: ___________________________________________

The path to the content management \orgs directory. This directory will store all of the files under the \orgs heading. This value is required only if your school licenses content management.

Users Directory: ___________________________________________

The path to the content management \users directory. This directory will store all of the files under the \users heading. This value is required only if your school licenses content management.

Collaboration Server Machine Name: _________________________________________

The machine name that runs the Collaboration Server. It is possible to dual-purpose an existing application to also serve as the Collaboration Server. Though not typically required, a separate server may be dedicated as the Collaboration server exclusively. In one server and two server configurations, this machine name is the same as the application server machine name.

Collaboration Server TCP/IP Port: ___________________________________________

TCP/IP is the preferred communication method for the Collaboration server. The default port is 8010.

Collaboration Server HTTP Port: ___________________________________________

HTTP communication is used to connect users to the Collaboration server is TCP/IP communication is unavailable. The default port is 8011.

SMTP Server: ___________________________________________

The full hostname of the SMTP server that Blackboard Learn will use to send emails. For example: smtp.blackboard.com. The parameter bbconfig.email.bitbucket_address=email_address must be added and set in the bb-config.properties file to avoid system-generated messages, such as enrollment notifications and discussion board subscriptions from being sent to the administrator. The bit-bucket email address should be set to a valid campus address that has no recipients, failure to use a valid address will result in rejection by email servers.

Administrator Password: ___________________________________________

The Administrator account has full Administrator privileges. This account and the root_admin account are the only two accounts that can log in until more users are created.

Integration User Password: ___________________________________________

The integration user is used only to facilitate Snapshot operations. This account cannot be used to log in through the GUI nor does it appear in any lists of users in the user interface. To change the password for this account, on the Administrator Panel, under Building Blocks, click Integration Password.

To learn more about the integration account, see Editing the Integration Password .

Root Administrator Password: ___________________________________________

The root_admin account has full administrative privileges including the management of Virtual Installations through the Administrator Panel. When the root_admin account user views the Administrator Panel, the Manage Virtual Installations link appears at the top of the panel. The root_admin can log in to any Virtual Installation and access the Virtual Installation management features from this link.

The root_admin account is created even if your license does not include the use of additional Virtual Installations. The root_admin account can be modified from the Edit Root Administrator Profile page.

Administrator Name: ___________________________________________

The name of the Administrator.

Administrator Email: ___________________________________________

The email address of the Administrator.

Institution Name: ___________________________________________

The institution that will be using Blackboard Learn.

Institution Type: ___________________________________________

Choose one of the following options:

  • K-12
  • Higher Education
  • Continuing Education
  • Corporate
  • Professional Association
  • Hobby

City: ___________________________________________

The state, province, or territory where the institution is located.

State: ___________________________________________

The state, province, or territory where the institution is located.

ZIP/Postal Code: ___________________________________________

The ZIP or Postal Code where the institution is located.

Country: ___________________________________________

The Country where the institution is located.