Skip to main content
pdf?stylesheet=default
Blackboard Help

Complete the Pre-Installation Worksheet on UNIX in a Load-Balanced Configuration

The installation worksheet helps identify all of the information required by the installer. Filling out the worksheet prior to installation will help the installation process run smoothly.

Note:  Most of the values required by the installer must be the same for each application server and for the Collaboration server. All ports and settings that point to the database server, Collaboration server, and file system server must be the same for all.

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. Note that the installer will create a directory called blackboard within this directory.

Setup Type: ___________________________________________

Select one of the following options:

  • Full Installation: Select this option to install the database and the first application server.
  • Appserver-only Installation Select this option when installing the second and all subsequent application servers or when setting up the Collaboration server on a separate device.

License File: ___________________________________________

The path to the License File. If a License File is not available, contact Blackboard Client Representative to request one. The License file determines which capabilities are installed. The license file will be automatically detected 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 /usr/local/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. In a load-balanced configuration, this location must be accessible by all of the application servers. To learn more about using a separate file server, see Set Up File System Storage for UNIX.

Application Server Machine Name: ___________________________________________

The name of the application server. The installer will find the name of the machine that the installer is on and automatically populate this value. The installer must be run on the application server.

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 (underscores and spaces will cause problems) in the application server name or the domain name.

Application Server Port Number: ___________________________________________

The port that the application engine uses. The default value is 8009. This port is internal to the Blackboard application and should not be available to end users.

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

Oracle Database Instance Name: ___________________________________________

The Oracle SID where Blackboard Learn databases will reside.

Oracle Database Port: ___________________________________________

The Oracle Database port used by Blackboard Learn to communicate with the database. The default value is 1521.

Oracle (sys) System Database Administrator Password: _________________________

The Oracle Database Administrator password.

Blackboard Database User Password: ________________________________________

A password for an Oracle 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 an Oracle user that Blackboard Learn uses to access the reporting database.

Content Management Database Password: _______________________

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

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, please contact Blackboard Support for assistance.

Database Data Directory: ___________________________________________

The directory that will store Blackboard Learn database data files. This directory will not store application data or content. This directory must be on the database server in a directory where Oracle has read/write/execute privileges. Make sure that the directory has space to accommodate database growth. This directory must be created before installing Blackboard Learn.

Database Index Data File Directory: __________________________________________

The directory that will store database index data files. This directory must be on the database server in a directory where Oracle has read/write/execute privileges. If possible, this directory should be separate from the data directory.

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 required only if your institution 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 institution 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 institution 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 institution 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 institution 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 (example: smtp.blackboard.com) of the SMTP server that Blackboard Learn will use to send emails. 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.