Skip to main content
pdf?stylesheet=default
Blackboard Help

Complete the Pre-Installation Worksheet for Windows in a Load-Balanced Configuration

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. Complete the following steps to find the machine name of a server.

  1. Right-click My Computer and select Properties from the context menu.
  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.

Database Instance: ___________________________________________

The name of the SQL Server instance that will run 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 log 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: _______________________ 

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

Courses Directory: ___________________________________________

Enter the path to the content management /courses directory. This directory will store all of the files under the /courses heading. This value is required only 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 required only 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.

Orgs 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 Load-Balanced configurations, it is important to direct all Collaboration Tool traffic to one server to maintain session integrity across users.

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