Si vous êtes un client Managed Hosting, cette rubrique ne vous concerne pas.
This topic discusses the steps to install Blackboard Learn 9.1 Q2 2016 or later. If this doesn't apply to you, consult the installation instructions for earlier versions of Blackboard Learn.
After the Get Started, Application Server, Learn Database, and optional configurations have been reviewed, the hardware and software meets the supported requirements and is properly configured, and the pre-install checklist and worksheet have been completed, proceed with installing the Learn Application.
Installation
The steps for installation on one application server (one or two server configurations) or the first application server in a load-balanced configuration are the same. For a load-balanced configuration additional installations are necessary. After completing installation on the first server, continue installation following the instructions at the end of this section.
The installer is run at the command line, using Gradle, Maven, and an installer properties file. The command line installer provides a default or anticipated value where possible.
Where to find the installer
Blackboard Learn installers are found Behind the Blackboard (http://behind.blackboard.com).
To request a behind the blackboard account, instructions for downloading the installer, a current license file for this release, and any instructions specific to your license, contact your Blackboard Client Representative.
The installation process
Installation of Blackboard on Windows requires super-user privileges; thus you must be logged in as the Windows domain user (such as "blackboard"). On Linux, you must be logged in as bbuser, and all directories required for access by the installer must be permissioned appropriately to give bbuser write privileges.
The system super-user must also perform Service startup and shutdown
The installer is run at the command line, using Gradle, Maven, and an installer properties file. The command line installer provides a default or anticipated value where possible. In such cases you may either overwrite the value explicitly in the properties file or omit the value from the properties file to accept the default.
Blackboard recommends that content management be used only with load-balanced systems.
In a multi-server environment, the installer must be run multiple times to set up each application server. After the first application server and the database have been installed using the installation script, run the installer using the App Server Only Installation option on each of the additional application servers. Use the App Server Only commands in step 3 to achieve this and minimize downtime during your installation.
The installer properties will be required just as in a Full Installation. The installer will not access the database on an Appserver-only Installation, which means that nodes can be added to a load-balanced configuration while the system is live.
Keep in mind that Blackboard Learn must be installed as the system super-user when installing in Windows. Linux requires the software to be installed by the user that owns the blackboard installation directory, typically bbuser. Service startup and shutdown must also be performed as the system super-user.
1. Set Up the Installer
Place the installer, the installation properties file, and the license file in a directory on the application server. The installer is a zip archive, and must be extracted to continue to installation. The installer must be extracted into an EMPTY fresh new directory. We suggest using the given examples as the parent directory, and create a new subdirectory named after the precise installer version. The following steps use the below as examples only - you may use a directory of your choosing (note it cannot be the target Blackboard installation target directory):
UNIX
Parent folder: /usr/local/bbinstaller/
Empty, new directory for every release: /usr/local/bbinstaller/3000_1_2
Windows
Parent folder: C:\bb_installer
Empty, new directory for every release: C:\bb_installer\3000_1_2
2. Login to the server
Blackboard Learn must be installed as the system super-user.
UNIX
bbuser
Windows
Switch to system administrator account.
3. Launch the installer
The installer creates a persistent bb-installer-log.txt file to capture the output from the installation for troubleshooting purposes. For UNIX systems, the | tee -a bb-installer-log.txt portion of the following commands is optional. For Windows systems, the 1> bb-installer-log.txt 2>&1 portion of the following commands is optional. These portions are redundant, but ensure that the output file is created.
Run the following command to launch the installer:
UNIX
For full install, open a terminal and enter:
/usr/local/bbinstaller/installer.sh -c /full/path/to/installer.properties | tee -a bb-installer-log.txt
To perform an App Server Only installation, run the following command:
/usr/local/bbinstaller/installer.sh -c /full/path/to/installer.properties -a | tee -a bb-installer-log.txt
Windows
On Windows open Command Prompt and enter:
C:\bbinstaller\installer.bat -c C:\full\path\to\installer.properties 1> bb-installer-log.txt 2>&1
To perform an App Server Only installation, run the following command:
C:\bbinstaller\installer.bat -c C:\full\path\to\installer.properties -a 1> bb-installer-log.txt 2>&1
Installer properties must be referred to at its full absolute path. For more information on setting up your properties file, see Preparing Installation Properties.
4. Install the software
The installation will now commence. The installer will download the appropriate Gradle package and start the installation.
The average installation time for a Full Installation is forty minutes.
Installation success
The installer will display a 'BUILD SUCCESSFUL' message and you may start Learn.
Installation failure
If the installer failed, as indicated in the installer results, check the installer log and see Troubleshooting to diagnose and fix the problem.
After the installer has completed Learn will be available of the following ports by default.
http://localhost:8080
https://localhost:8443
Before continuing with the post configuration steps confirm Blackboard Learn is available on the server by accessing the application from those URLs.
Start and stop Blackboard Learn
Starting, stopping, and restarting Blackboard Learn is managed using the ServiceController tool located in the admin tools directory.
Install an earlier version of Blackboard Learn
If you want to install an older version of Blackboard Learn, consult the installation instructions for Blackboard Learn Q4 2015 and earlier.