This section reviews the configuration steps necessary before installing Blackboard Learn. The following instructions apply whether the architecture is Single, Two, or Load balanced based. Differences in process per Operating System, Database, or architecture are noted.
Application servers should be dedicated to Blackboard Learn for optimal performance. Make sure that the server is not using valuable space and resources running unnecessary applications.
A load-balanced configuration requires that the first application server, shared content directory, and database server be installed using the two server configuration model. After that, the Installer can be run again on each additional application server to install only the application components. Each additional application server must also meet the required prerequisites.
If using the Collaboration server it must be installed on a single server that is not served as part of a load balanced configuration. The collaboration server may not be spread across multiple application servers because all users participating in a collaboration session must share the same resources. A single server must be configured to run the collaboration server. This server must handle collaboration sessions and performance will be unaffected by other requests. The application servers are configured to connect users to one server that handles all the collaboration sessions.
Hardware Sizing Information for Windows or Linux Dell Environments and Hardware Sizing Information for UNIX Sun Environments detail several different hardware configurations based on performance, cost, and redundancy. Use these reference documents to ensure that the planned hardware configuration meets the needs of the institution.
SPARC hardware is required for to install and run Blackboard Learn under Solaris operating systems.
Institutions can use the load-balancing method of their choice as long as it adheres to a few basic principles:
The load-balancing method must use cookie-based session affinity.
TLS certificates need to be exposed to clients whether via Load-balancer TLS-offloading or certificates on each application server. TLS-offloading is the recommended installation in a Load balanced configuration.
The installation value used for the machine hostname (bbconfig.frontend.fullhostname) must be resolvable and fully accessible from each application server.
To learn more about Load-balancing configuration and options, see Load Balancing - Configuration and Best Practices. Understanding the Load balancing options are essential for proper configuration of Learn behind a Load balancer.
Required Software and Setup
For the exact versions of the operating systems, databases, and Java SE Developers Kit (JDK™) that are supported, see Supported Technologies for Self-Hosted Systems. It is critical that the software used to host Blackboard Learn meets requirements.
After selecting and installing the operating system proceed with installing the Java Virtual Machine on the application server.
Java Virtual Machine
The supported version of the JDK can be downloaded at http://www.oracle.com/technetwork/ja...ads/index.html.
The JDK must be downloaded and installed on each application server.
Once you install the JDK you may simplify future upgrades to java and minimize impact on Learn configuration by creating a soft link of the installed JDK named ‘latest_java’. For example: use /usr/java/latest_java instead of using /usr/java/jdk1.7.0_51 where latest_java is a link to the latest installed java virtual machine.
If you installed UNIX with a non-Oracle JDK (For example: OpenJDK) you should either uninstall OpenJDK or use the alternatives tool for selecting the Oracle JDK after installation.
(Optional) Set JAVA_HOME
The JAVA_HOME environment variable may be set, but is not required for application installation or operation.
Not setting JAVA_HOME will require full paths to the installed JAVA tools. For example: # /usr/local/jdk/bin/java -jar bb-installer.jar instead of # java -jar bb-installer.jar
Make sure that the path to the JDK does not include any spaces. For example, do not use C:\Program Files\Java\jdk1.7.0.... Instead, use C:\Java\jdk1.7.0....
The JAVA_HOME variable may already be set. This may be confirmed via:
Printenv | grep JAVA_HOME
- Create an environment variable that points to the JDK installation directory and call it JAVA_HOME. Add $JAVA_HOME/bin to the system path to be able to run javafrom the command line. You can do this by adding the following lines to the .bashrc file in your home directory.
#In this example /usr/java/jdk1.7.0_51 is the JDK installation directory.
export JAVA_HOME=/usr/java/ jdk1.7.0_51
- If you have more than one version of JVM installed in your machine, make sure you are using the supported JDK1.7 installation as the default java and javac.
Follow these steps to set the JAVA_HOME environment variable:
- Make sure that the correct version of the JDK is installed on the application server.
- Right-click Computer and select Properties.
- Click Advanced System Properties.
- Click Environment Variables.
- In the system variables list, find JAVA_HOME and click Edit. If JAVA_HOME does not exist in the system variables list, click New. A pop-up window will appear. The Variable name should read JAVA_HOME.
- Enter the full path to the JDK in the Variable value field. For example, C:\Java\jdk1.7.0_51.
- Click OK.
Click paths for Windows versions may vary from the steps presented here. For an explanation of how to set environment variables for your 2008/2012 Windows Server see: http://technet.microsoft.com/en-us/l.../cc772047.aspx
Create System User Accounts
Learn requires operating system accounts for installation and operation – these are created using the tools provided by the operating system.
UNIX: Create a Learn System User
The UNIX system user account must be created prior to installation with the following parameters.
- The user name must be bbuser.
- The bbuser account must have a valid home directory.
- Blackboard recommends using /home/bbuser for Linux operating systems and /export/home/bbuser for Sun Solaris operating systems.
WINDOWS: Create a Learn Domain User
Create a domain user (for example, "blackboard") that will have access to the application server, the file server, and the database server. This user must be part of the Administrators group throughout the setup and installation. After this user is created, use it to log in to the servers.
Confirm File System
On UNIX systems select a suitable file system such as ext4. Each application server should use the same file system type.
On Windows operating systems Learn requires the use of NTFS as the file system. Follow the steps below to confirm that the disk is using the NTFS file system.
- Double-click My Computer on your desktop.
- Right-click the drive where Blackboard Learn will be installed.
- Select Properties.
- The File system field must display NTFS. If it displays anything other than NTFS, consult the operating system documentation for steps to convert the drive to NTFS.
- Repeat these steps on each application server, the database server, and the file system server.
Dedicated File System Server
In a load-balanced system – if not using a SAN - maintain one server as a dedicated file system server. The Learn content files must be centralized so that all files are available to users regardless of the application server handling the connection. The application servers are configured to find the content files in a directory on the file system server.
Network File Share and Common Internet File System
For connecting external storage to Learn application servers clients should use the Blackboard supported file system sharing model for their selected operating system:
UNIX platforms should use a network file share (NFS).
Windows platforms should use a common Internet file system (CIFS).
To learn more, Optional - Set Up File System Storage.
Synchronize Server Clocks
Check the date and time on the system and make sure it is accurate and that the time zone is set correctly. If installing on two servers check that the time on the application server and database server match. Remember that the servers may be in a different time zone than users. The server time zone should be the same as the time zone used by the majority of users, instead of the physical location of the server. Blackboard Learn uses the server date and time to control the availability of time-sensitive materials. It is important that users have a clear expectation of when materials will be available and when assignments are due.
The Network Time Protocol daemon (ntpd) program is a Linux operating system daemon. It sets and maintains the system time of day in synchronism with time servers (milliseconds).
You need to configure ntpd via /etc/ntp.conf configuration file.
If ntpd is not installed use any one of the following command to install ntpd:
# yum install ntp
# up2date ntp
You should at least set following parameter in /etc/ntp.conf config file:
server <Time Server Name or IP Address>
For example, open /etc/ntp.conf file using your editor of choice
- Locate the server parameter
- Enter server pool.ntp.org
- Save the file and restart the ntpd service:
# /etc/init.d/ntpd start
You can synchronize the system clock to an NTP server immediately with following command:
# ntpdate pool.ntp.org
Windows clients can synchronize their clocks with an external source. This Microsoft Support page provides details: http://support.microsoft.com/kb/816042
Keep in mind the following when connecting Blackboard Learn to the network:
- Do not use underscores in the machine name for the server or servers. Some versions of Internet Explorer block cookies if the machine name includes an underscore.
- Check with a network engineer to make sure that the network can handle the anticipated load after Blackboard Learn is made available to users.
- An SMTP server must be available so that the Installer can connect to it.
- An SMTP server has to remain available when the application is running to deliver email notifications.
- Set up the DNS server to resolve the hardware load-balancer. The hardware load-balancer will then direct traffic to the application servers. Set up a separate DNS entry for the Collaboration server.
Blackboard Learn requires ports to communicate. Following are the required ports for initial installation and their default values. Make sure to configure server security and any firewalls to allow communication on these required ports. The port values must be the same for each application server.
Depending on post-installation choices additional ports and port related configuration may be required - these are outlined in the Post-Installation and Upgrade section: (Optional) Set Up Load Balancing (Multiple Application Servers), (Optional) Front Learn with a Webserver (For CAS or Shibboleth)
Tomcat port (default value: 8080): This port handles non-secure communication to/from the load-balancer if TLS is off-loaded at the load-balancer.
Tomcat TLS port (default: 8443): This port is the primary secure web application port if TLS is not off-loaded
Out of the box Learn-Only receives requests on ports 8080 and 8443 and by default is accessible via
http://learnserver:8080 and https://learnserver:8443.
To provide default URLs that require port information appended you must route incoming port 80/443 requests to 8081/8444, respectively. See Post-Install or Upgrade Set Up Port Forwarding (Single Application Server) for steps to be performed to make the Learn-Only server available on default ports after install or upgrade.
Web Server Ports
- Web server port (default value: 80): This port handles communication for legacy non-secure connections when a web server is in use. Users will be forwarded to a secure port.
- Web server TLS port (default: 443): This port is the primary secure web server port when a web server is in use.
Ports 80/443 may be closed if not using a webserver.
Single Server Specific Ports
SQL Server Listener port (default value: 1443): This port connects to a database in a Windows environment.
Oracle TNS Listener port (default value: 1521) This port connects to a database in a UNIX environment.
Collaboration Server Ports
These ports are required to be open if the server is being used as a Collaboration Server.
Collaboration server TCP/IP port (default value: 8010): This port handles primary TCP communication for the Collaboration server. By default, TCP communication connects users to the Collaboration server.
Collaboration server HTTP port (default value: 8011): This port handles HTTP communication for the Collaboration server and is configured for legacy reasons, but does not receive traffic in version 201404.
Collaboration server TLS port (default: 8012): This port handles HTTPS communications for the Collaboration server for downloading the applet. Note this was previously 8443 and must be changed in bb-config.properties prior to upgrade!
Any port higher than 1024 must be open between the application servers so that they can communicate through the peer services framework.
Confirm Windows Server Operating System Prerequisites
SQL Server Client Tools needs to be installed on each application server.
Configure SQL Server Agent Automatic Startup
The SQL Server Agent must be running and set to Automatic startup for Blackboard Learn where %INSTANCE% is the name of the database instance (blank for a default instance).
- Right-click Computer and select Manage.
- From the Server Manager, click Configuration, and then click Services.
- Right-click SQL Server Agent (instance) and select Properties.
- From the Startup type, select Automatic.
- Click OK.