Skip to main content
pdf?stylesheet=default
Blackboard Help

Install the Blackboard Learn Application Server and Database Server on UNIX

The installer is launched from a command line prompt and may be run in command-line mode or GUI mode. The installer presents a series of questions about the system. In many cases, the installer automatically detects the required settings and provides default values. This topic also includes detailed information about the values required at each installer prompt.

Where to Find the Installer

To request a current license file for this release and your institution and instructions for downloading the installer, contact your Blackboard Client Representative.

Before Running the Installer

Make sure that the system meets the supported software requirements and is properly configured before running the installer. To confirm that the system is ready for installation, see the Pre-Installation Checklist.

The instructions below assume the following:

  • Blackboard Learn must be installed as root. Service startup and shutdown must also be performed as root.
  • The installer is run on a two-server system: The instructions reference the application server and the database server. When installing on one server, these machines are the same.
  • The installer is run using the command-line interface: The GUI installer requires the same inputs from the user. The only difference between the command-line and the GUI interface is navigation. The GUI interface uses mouse-clicks instead of using keystrokes to accept a value and continue. The command line places the default or anticipated value in brackets. You may either ENTER a new value or simply press ENTER to select the value in brackets.
  • The optional steps for installing content managementt. These steps are included for testing purposes. Blackboard recommends that content management be used only with Load-Balanced systems.

How to Run the Installer

Follow the steps below to run the installer on UNIX:

  1. Place both the installer and the license file in a directory on the application server. The installer will automatically recognize the license file if it is renamed bb-license.xml and placed in the same directory as the installer. The following steps use /usr/local/bbinstaller/ as an example.
  2. Open a command-line prompt and navigate to the directory that contains the installer.
  3. Login as root on the server:

    su - root

    If Xwindows or a similar GUI is running, the installer will launch in GUI mode. (The following steps assume that the command line installer is used). Use the “-text” option to force text mode even if a GUI is running.

    If the installer failed, please check the installer log and see Troubleshooting to diagnose and fix the problem.

  4. Run the following command to launch the installer:

    /usr/local/bbinstaller/java -jar bb-installer.jar

  5. After reading the welcome message, press ENTER to continue.

    Instructions display for navigating through the installer prompts. The installer, in most cases, will provide a default value in brackets. Press ENTER to accept the default and continue or ENTER a different value. Press ENTER to continue after ENTERing a new value.

  6. Provide the directory where Blackboard will be installed. To accept the default value of /usr/local/blackboard, press ENTER. Blackboard does not recommend changing this default.
  7. To select the type of installation, type 1 and press ENTER to select Full Installation.
  8. After reading the License Agreement, type Y and press ENTER to continue the installation. To refuse the terms of the agreement and close the installer, type N and press ENTER
  9. Provide the location of the license file. The installer will detect the license file and use it as the default value if the license file is renamed bb-license.xml and placed in the same directory as the installer. Press ENTER to accept the default or ENTER a new value and then press ENTER.
  10. Provide the location of the JDK. The installer will use the path that was provided to launch the installer.
  11. Provide the location of the Shared Content Directory, which is used to store the content files associated with Courses, images uploaded to the system, and all other files added to the system. 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. To accept the default value of /usr/local/blackboard/content, press ENTER.

    Note:   Blackboard Client Support recommends that you change this value to a location outside of the <blackboard_home> directory.

  12. Provide the name of the application server. The installer detects the machine name of the server it runs on and uses that to populate the default. Press ENTER to accept the default.
  13. Provide the domain that hosts the application server. The installer detects this value and populates the default. Press ENTER to accept the default.
  14. Provide the port number for the application server. This is the port that the application uses for communication. The default value is 8009. Press ENTER to accept the default, or provide a new value and then press ENTER.
  15. Provide the port number for the Web Server. This is the port that is used for http connections with users. The default value is 80. Press ENTER to accept the default, or provide a new value and then press ENTER.
  16. Provide the database server hostname. The default value is the current machine. This is the correct value for one server installations. Press ENTER to accept the default if installing on only one server. If installing on two servers, provide a value for the separate database machine and press ENTER to continue. Keep in mind that the hostname is represented by machine_name.domain_name.
  17. Provide the Oracle SID. Provide a value and then press ENTER.
  18. Provide the Oracle sys database administrator password. Provide a value and then press ENTER.
  19. Provide the Blackboard database user password. This database login is used by the application to access the database. Provide a value and then press ENTER.
  20. Provide the Blackboard database report password. This database login is used by the application to access the reporting database. ENTER a value and then press ENTER.
  21. Optional Step for Content Collection Users: Provide the content management database password and then press ENTER. This login is used by the application to access content management database.
  22. Provide the location for the database data directory and then press ENTER. The directory that will store Blackboard Learn database data files. This directory will not store application data or content. This directory must be 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.
  23. Provide the location for the database index directory and then press ENTER. The directory that will store Blackboard Learn database index files. This directory must be in a directory where Oracle has read/write/execute privileges. If possible, this directory should be separate from the data directory.
  24. Optional Step for Content Collection Users: Provide the storage directories for the content management storage locations and then press ENTER. For example, the default value is /usr/local/blackboard/cms/courses.
  25. Provide the path to the content management /institution directory. The default value is /usr/local/blackboard/institution. Repeat for each of the four additional locations: Institution, Library, Orgs, and Users.
  26. Provide the Collaboration server hostname. In a one or two server environment, the default value is the application server. In a load-balanced environment, select one of the existing application servers to also act as the Collaboration server. Though not typically required, a separate server may be dedicated as the Collaboration server exclusively. To learn more, see Set Up a Collaboration Server. The Collaboration server runs Virtual Classroom and chat sessions. Press ENTER to accept the default or provide a new value and then press ENTER.
  27. Provide the TCP port number for the Collaboration server. The default port number is 8010. Press ENTER to accept the default or provide a new value and then press ENTER.
  28. Provide the HTTP port number for the Collaboration server. The default port number is 8011. Press ENTER to accept the default or provide a new value and then press ENTER.
  29. Provide the hostname of the SMTP server. The SMTP server is used to send out email communications. Keep in mind that the hostname is the represented by machine_name.domain_name. Provide a value and then press ENTER.
  30. Provide the Blackboard Administrator password. The Administrator account has full privileges. Provide a value and then press ENTER.
  31. Provide the Blackboard Integration 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. Provide a value and then press ENTER.
  32. Provide the Blackboard 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. While it is necessary to ENTER a password for this account, it is very rare that a system with Virtual Installations will be run on one server or two servers. Provide a value and then press ENTER.
  33. Follow the prompts to ENTER the administrator's contact information.
  34. ENTER the Server Type. This is information is used for better management of centralized services. Options include: Production, Staging, Test, and Development. Properly categorize each server when running the installer.
  35. Press ENTER to install the software. Do not close the command line window during the installation.