Version 12.

Moodle Module v3.0 for Web Conferencing

Configuration and Installation Guide

June 1, 2013

Table of Contents

Preface Purpose of This Guide Audience Help and Other Resources Technical Support Documentation and Learning Resources Community Blackboard Collaborate Product Feedback Chapter 1 Product Overview Chapter 2 Installing the Module Pre-Installation Requirements Installation Chapter 3 Configuring the Module Chapter 4 Configuring User Role Permissions Chapter 5 Uninstalling the Module Blackboard Collaborate Copyright Trademarks

1 1 1 2 2 2 2 2 3 5 5 5 9 15 19 21 21

Page i

Preface

Purpose of This Guide

This guide provides detailed steps for Moodle administrators to install, configure, and administer the Blackboard Collaborate Moodle Module for Web Conferencing. This guide does not provide information on linking to or creating, editing, backing up, or restoring Blackboard Collaborate web conferencing content. For details on those processes, refer to the Blackboard Collaborate Moodle Integration for Web Conferencing User's Guide. This guide does not provide information on the use of Blackboard Collaborate web conferencing features. For detailed information on how to use these features once they have been linked to your course, refer to the The Blackboard Collaborate Web Conferencing Moderator's Guide. If you are a student or other participant, refer to the Blackboard Collaborate Web Conferencing Essentials for Participants Guide.

Audience
It is assumed that the user has a basic working knowledge of the following:
l l l

The administration of Moodle The operating system on which your Moodle instance resides. The Blackboard Collaborate web conferencing web server, services, and the client JNLP files.

Page 1

Help and Other Resources

Technical Support
Blackboard Collaborate technical support and the support Knowledge Base are available through the Support Portal: http://support.blackboardcollaborate.com

Documentation and Learning Resources

Documentation and learning resources (for all Blackboard Collaborate products) are available on the On-Demand Learning Center, which can be reached as follows:
o

In your browser, enter the following address:

http://www.blackboard.com/Platforms/Collaborate/Services/On-Demand-Learning-Center.aspx

Community
We encourage Blackboard Collaborate users of all levels (administrators, instructors and students) to submit questions to Ask the Doctors , a free question-and-answer forum moderated by an expert team of your fellow Blackboard Collaborate users. Their goal is to provide quality answers to your questions in a highly responsive manner, while building a global knowledge base for online teaching and learning. You can find Ask the Doctors at the link below: http://discussions.blackboard.com/forums/default.aspx?GroupID=9 Messages posted in the Ask the Doctors forum do not go to our Support Team. If you require technical support assistance to resolve a problem, please contact Technical Support (see the headingTechnical Support in this section).

Blackboard Collaborate Product Feedback

Blackboard Collaborate welcomes your comments and suggestions. If you have an idea for a new feature or enhancement, or would like to send other feedback, please send an email to BBCollaborateFeedback@blackboard.com. Your feedback will be sent directly to our Product Management Team.

Preface

Chapter 1
Product Overview
The Blackboard Collaborate Moodle Module for Web Conferencing enables your Moodle course management system (CMS) to create and launch Blackboard Collaborate web conferencing sessions and recordings. Once integrated, Moodle will provide the following additional functions to instructors and course builders:
n n n n n

Create a public, private, or course sessions Automatically invite and grant access to a session to a specific course, group, or grouping. Provide access to recordings of past sessions. Grade students on their Blackboard Collaborate session attendance. Archive, restore, and duplicate sessions using Moodle's backup, restore, and import functions.

Page 3

Chapter 2
Installing the Module
Pre-Installation Requirements
Before installing the Moodle Module, ensure the following:
l

You have a login group and web service account on the Blackboard Collaborate scheduling server (SAS). You have received your Blackboard Collaborate Moodle Module for Web Conferencing welcome e-mail. A Moodle installation exists on your server. Note: For an example, well use http://www.example.com/moodle as the URL of your Moodle web site and /var/www/html/moodle/ as the location of the Moodle code on the server.

Installation
To install the Blackboard Collaborate Moodle Module for Web Conferencing on your server, follow the steps below.

Page 5

1. Download the Blackboard Collaborate Moodle Module for Web Conferencing from The Blackboard Collaborate Support Portal as instructed in your welcome package. 2. Extract the .zip file to a temporary location. Note: Although the product is now named Blackboard Collaborate web conferencing, the elluminate directory and web addresses were retained to ensure compatibility with earlier versions of the Moodle Module. 3. From the temporary location, copy the contents of:
elluminate_blocks/elluminate

into:
moodle_dir/blocks/elluminate

(where moodle_dir is the location of the Moodle code on the server, for example, /var/www/html/moodle). In this case you would copy the contents to
/var/www/html/moodle/blocks/elluminate

4. From the temporary location, copy the contents of:

elluminate_mod/elluminate

into:
moodle_dir/mod/elluminate

for example
/var/www/html/moodle/mod/elluminate

5. (Optional) If you're using a theme that displays its own icons, you must copy the Blackboard Collaborate activity module icon into your themes directory. For example, if you were using the Chameleon theme with Moodle 1.6 or above, you will need to create a Blackboard directory in that theme. Copy
moodle_dir/mod/elluminate/icon.gif

into the following Chameleon directory:

moodle_dir/theme/chameleon/pix/mod/elluminate/

For example, copy

/var/www/html/moodle/mod/elluminate/icon.gif

into
/var/www/html/moodle/theme/chameleon/pix/mod/elluminate/

6. Visit the Moodle administration page (for example, http://www.example.com/moodle/admin). This page shows you the progress as the database installation script for the Moodle Module is executing.

Installing the for Moodle

7. When installation is complete, click Continue. You will be notified of any errors or warnings, if they exist. 8. Ensure that the Moodle cron job is correctly set up and configured. For instructions see http://docs.moodle.org/en/Cron. Note: Blackboard Collaborate recordings will be visible through the Blackboard Collaborate web conferencing block only after the Moodle cron job executes.

Installing the for Moodle

Chapter 3
Configuring the Module
To change the settings of the Moodle Module activity module, follow the steps below. 1. Log in to your Moodle site as the Moodle Administrator (for example, by opening http://www.example.com/moodle/admin). The Administration page opens.

Page 9

2. In the Settings area, choose Site Administration > Plugins > Activity Modules > Manage activities . The Activities configuration page opens.

10

Configuring the for Moodle

3. Under the Settings column, click on the Settings link for Blackboard Collaborate Session.

The Blackboard Collaborate Session configuration page opens.

Configuring the for Moodle

11

4. Enter the appropriate Session Administration System information (refer to your Blackboard Collaborate Moodle Module for Web Conferencing welcome e-mail):
n

Server URL is the URL of the Blackboard Collaborate scheduling server that has been enabled for web services access. Note: The URL must be set to use version 3 of the adapter. The upgrade process will automatically set this to the correct URL if you upgrade from a previous version. Do not alter it.

Username and Password are the credentials of the account on the Blackboard Collaborate scheduling server to be used for Moodle administration.

12

Configuring the for Moodle

5. Select a Default Boundary Time for all Blackboard Collaborate sessions. This is the number of minutes (15, 30, 45 or 60) before the scheduled start time of a session during which a participant may join the session. If you want teachers to be able to set their own boundary time, select Choose. The default is 15 minutes.

6. Specify whether or not you want the following user options and permissions turned on or off by setting to them to Yes (on) or No (off). The default is No for all options.
n

Pre-Populate Moderators Pre-populates all Blackboard Collaborate Sessions associated with the course with the users who have the permission to moderate sessions within the course. Raise Hand on Entry Automatically raises the hand of every user who joins the session. By default, you will hear an audible notification when someone raises their hand. Permissions On Grants full Moderator permissions to all users who join the session. This permits users to upload content, control the permissions of other users, and any other permission normally limited to instructors. Must be Supervised Permits Moderators to view all private chat messages in the Blackboard Collaborate Session. All session attendees will see an icon in the Chat panel to notify them that Moderators are able to view private messages. Choose -- Moderators can choose, for each session, whether or not teleconferencing will be enabled. Yes -- Teleconferencing will be enabled for all new sessions. No -- Teleconferencing will be disabled for all new sessions

7. Configure Enable Session Teleconference.

l

l l

8. Specify whether or not you want Web Services Debugging turned on (Yes ) or off (No). The default is No.

Configuring the for Moodle

13

9. Set the Log Level to control how much information is written to logs. ERROR is the least verbose level and DEBUG is the most verbose. Usually this should be set to ERROR. Only set this to DEBUG on the advice of Blackboard Technical Support. Note: Logs are stored in the Moodle data directory in blackboard_collaborate/sas/logs. Moodle does not automatically remove old logs, so you should set up a cron job to do so periodically. 10. Click Save changes to complete the configuration. The module will automatically check the connection. You should see "Connection test succeeded!".

You are now ready to add Blackboard Collaborate activities into courses on your site.

14

Configuring the for Moodle

Chapter 4
Configuring User Role Permissions
Each user has a default set of permissions when interacting with Blackboard Collaborate sessions. Instructors can create and edit sessions associated with their courses, students can enter sessions but not edit them, and administrators can edit and delete any session on the Moodle server. You can also create a custom set of permissions, or even custom roles, through Moodle's permission controls: 1. Log in to Moodle as an administrator. 2. In the Site Administration window, expand the Users menu followed by the Permissions menu.

Page 15

3. In the Settings area, choose Site Administration > Users > Permissions > Define roles . The Manage roles page opens.

16

Configuring User Role Permissions

4. To view a role's permissions, click the name of the role. That role's page opens.

5. To edit the role's permissions, click the Edit button. 6. Scroll down until you see the header Activity: Blackboard Collaborate. Note: There may be more than one section with that header.

Configuring User Role Permissions

17

7. Place a check in the box to the right of each permission to grant that permission to this role. Uncheck the box to revoke a permission.

8. Click Save changes to apply your changes to the site.

18

Configuring User Role Permissions

Chapter 5
Uninstalling the Module
To uninstall the Blackboard Collaborate Moodle Module for Web Conferencing from your server, follow the steps below. 1. Log in to the your Moodle site (for example, http://www.example.com/moodle/admin) as the Moodle Administrator. The Administration page opens. 2. In the Site Administration menu, expand the Activities menu and click Manage Activities . The Activities configuration page will open. 3. Under the Delete column, click Delete in the Blackboard Collaborate web conferencing Session row in the table. 4. Click Yes to confirm deletion. 5. In the Site Administration menu, expand the Blocks menu and click Manage Blocks . The Blocks configuration page opens. 6. Under the Delete column, click Delete in the Blackboard Collaborate web conferencing row in the table. 7. Click Yes to confirm deletion. 8. On the file system on your Moodle server, delete the elluminate folder from moodle_dir/mod for example /var/www/html/moodle/mod.

Page 19

9. On the file system on your Moodle server, delete the elluminate folder from moodle_dir/blocks for example /var/www/html/moodle/blocks.

20

Uninstalling the for Moodle

Blackboard Collaborate Copyright

This document contains confidential proprietary information and is protected by law. This document and the information contained in it are intended for authorized users only and may be used only for the express purpose of legally accessing and using Blackboard Inc. products; any other use, without Blackboard Inc.s prior written permission, is strictly prohibited. 2013 Blackboard Inc. All Rights Reserved.

Trademarks
Blackboard, the Blackboard logo, Blackboard Collaborate, the Blackboard Collaborate logo, Behind the Blackboard, Wimba and Elluminate are trademarks or registered trademarks of Blackboard Inc. or its subsidiaries in the United States and/or other countries. All rights reserved. All other brand or product names are trademarks or registered trademarks of their respective companies or organizations.

Uninstalling the for Moodle

21