Log in to the target Linux server as root.
Make sure Perl 5 is installed.
On Red Hat, yum install perl
On SLES, zypper install perl
Install the required Perl modules through your package manager, or use yum install on Red Hat and zypper install on SLES systems:
perl-JSON
perl-JSON-XS
perl-libwww-perl
NOTE:For Red Hat 8.1, you will also need to install perl-LWP-Protocol-https.
If any of the Perl Modules are not available through your system package manager, they may also be installed through CPAN:
cpan JSON
cpan JSON::XS
cpan LWP::UserAgent
Obtain the linux_x86_64_bbdriver_install.bin file from your installation media and execute this self-extracting file on your Linux system.
Specify the language choice.
Read and accept the license agreement.
After the package is installed onto your system, you are prompted to enter Driver and Remote Loader passwords. These passwords are used to verify that an authorized driver shim is communicating with the Identity Manager engine. Follow the prompts:
Enter and confirm the Remote Loader Password.
Enter and confirm the Driver Object password.
Next, you are prompted to retrieve an SSL certificate. NetIQ eDirectory must be running to retrieve the certificate. The certificate allows SSL encryption between the Identity Manager engine and the driver shim. Enabling SSL is optional, but is recommended for better security. To retrieve the certificate, follow the prompts:
Specify the DNS name or IP Address of your eDirectory server.
Specify the LDAP secure port, default 636.
Enter Y to accept the certificate.
The installation of the driver shim is finished, with the option of starting the Driver Shim Service. Proceed to the next section to complete the installation of the driver.
If you plan on using the Identity Vault to manage connected system attributes that are not already mapped to standard eDirectory™ attributes, you will need to extend the schema. Otherwise, it is not necessary.
Extending the schema adds auxiliary classes to eDirectory User and Group objects for Blackboard user and group attributes. It also extends the schema for an effective class called DirXML-BB-Enrollment that can be used to represent an enrollment in a Blackboard Course or Organization.
To extend the schema, using the Import Conversion Export Utility (ICE) Command Line Interface:
Obtain the blackboard.sch file for browser access, depending on the operating system you are running:
Linux: Use the blackboard.sch file from /opt/novell/eDirectory/lib/lib/nds-schema/ or obtain a copy from the Metadirectory directory in the ISO image or patch download.
Windows: Copy the blackboard.sch file from the Metadirectory directory in the ISO image or patch download.
Open a Terminal on your eDirectory server.
Run the ice command using the following syntax:
ice -S LDIF -f blackboard.sch -D LDAP -s <host> -p <port> -d <admin> -W
The host option specifies the DNS name or IP address of the LDAP server. The default is localhost.
The port option specifies the integer port number of the LDAP server specified by host. The default is 389. For secure operations, the default port is 636.
The admin option specifies the distinguished name of the entry that should be used when binding to the server-specified bind operation.
NOTE:For a complete list of options, please see the Import Conversion Export Utility section of the .
Setup a Blackboard Learn Application Key and Secret for your installation.
Login to https://developer.blackboard.com. You may need to create an account.
Register a new application.
You will need to fill out the first three fields:
Application Name: NetIQ Blackboard Driver
Description: Provisions users and courses to Blackboard.
Domain(s): myschool.edu (This is the domain of your Blackboard server instance)
Once the API Key is generated, note the Application Key, Secret and Application ID.
Create a Blackboard Learn System Role for use by the driver.
Assign privileges to this System Role so that courses, organizations and users can be created, deleted and modified by the driver. Privileges required:
Administrator Panel (Courses) > Courses
Administrator Panel (Courses) > Courses > Create Course
Administrator Panel (Courses) > Courses > Delete Courses
Administrator Panel (Courses) > Courses > Edit
Administrator Panel (Courses) > Courses > Edit > Enrollments
Administrator Panel (Courses) > Courses > Edit > Enrollments > Add Enrollment
Administrator Panel (Courses) > Courses > Edit > Enrollments > Delete Enrollment
Administrator Panel (Courses) > Courses > Edit > Enrollments > Edit Enrollment
Administrator Panel (Organizations) > Organizations
Administrator Panel (Organizations) > Organizations > Create Organization
Administrator Panel (Organizations) > Organizations > Delete Organization
Administrator Panel (Organizations) > Organizations > Edit > Enrollments
Administrator Panel (Organizations) > Organizations > Edit > Enrollments > Add Enrollment
Administrator Panel (Organizations) > Organizations > Edit > Enrollments > Delete Enrollment
Administrator Panel (Organizations) > Organizations > Edit > Enrollments > Edit Enrollment
Administrator Panel (Users) > Users
Administrator Panel (Users) > Users > Create User
Administrator Panel (Users) > Users > Delete Users
Administrator Panel (Users) > Users > Edit > Change Password
Administrator Panel (Users) > Users > Edit > User Properties
Administrator Panel (Users) > Users > Edit > View Course Enrollments
Administrator Panel (Users) > Users > Edit > View Organization Enrollments
Course/Organization Control Panel (Users and Groups) > Users > Remove Users from Course/Organization
Course/Organization Control Panel (Users and Groups) > Users > Change User’s availability in Course/Organization
Create a Blackboard Learn User for use by the driver and assign the System Role you created above.
Follow Blackboard’s instructions to setup a REST integration: Blackboard REST Integration
Specify the user created in Step 2 as the Learn User for the REST Integration.
NOTE:End User Access should be set to No.
Enter the Application ID from Step 1.