Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Migration of unmigrated content due to installation of a new plugin

...

Integrating

...

Blackboard

...

CE

...

6

...

with

...

LAMS

...

The

...

LAMS2-Blackboard

...

CE

...

6

...

(formerly

...

known

...

as

...

WebCT)

...

integration

...

was

...

developed

...

with

...

Blackboard

...

Version

...

6.1.2

...

and

...

has

...

been

...

tested

...

for

...

6.2.

...

It

...

is

...

recommended

...

that

...

LAMS

...

and

...

Blackboard

...

CE

...

6

...

be

...

installed

...

on

...

separate

...

servers

...

to

...

account

...

for

...

the

...

heavy

...

memory

...

requirements

...

of

...

Blackboard

...

CE

...

and

...

LAMS.

...

Please

...

view

...

the

...

release

...

notes

...

for

...

version

...

update

...

information.

...

Tutorials

Center
Lozenge
colorbronze
arrownone
icon!home^clapper.png!
|
width
=
60%
|
link
=
Blackboard
CE
6
Usage
|arrow=none|title=LAMS & Blackboard CE 6 Animation|color=bronze}This animation demonstrates how LAMS 2.x is integrated within Blackboard CE 6. {lozenge} {center} h3. System Requirements * It is strongly recommended that you use separate servers for LAMS and Blackboard CE installations to account for the heavy CPU usage of Blackboard CE. * LAMS
titleLAMS & Blackboard CE 6 Animation
This animation demonstrates how LAMS 2.x is integrated within Blackboard CE 6.

System Requirements

  • It is strongly recommended that you use separate servers for LAMS and Blackboard CE installations to account for the heavy CPU usage of Blackboard CE.
  • LAMS 2.0.6

...

  • +

...

  • MySql

...

  • 5

...

  • (LAMS

...

  • database

...

  • will

...

  • do)

...

  • A

...

  • web

...

  • app

...

  • server

...

  • to

...

  • store

...

  • the

...

  • Powerlink

...

  • image

...

  • files.

...

  • (LAMS

...

  • server

...

  • will

...

  • do).

...

  • JDK

...

  • 1.4

...

  • +

...

  • Required

...

  • for

...

  • Running

...

  • WebCT

...

  • and

...

  • Powerlink.

...

  • Ant

...

  • 1.7

...

  • (included

...

  • with

...

  • LAMS

...

  • Powerlink

...

  • Package)

...

Installation

...

Steps

...

-

...

Blackboard

...

CE

...

6

...

Side

...

Pre-Steps

...

There

...

is

...

some

...

setup

...

before

...

we

...

can

...

commence

...

the

...

installation

...

of

...

the

...

Powerlink.

...

  1. Follow

...

  1. the

...

  1. steps

...

  1. at

...

  1. in

...

  1. the

...

  1. appropriate

...

  1. Blackboard

...

  1. CE

...

  1. 6.x

...

  1. Setup

...

  1. guide

...

  1. to

...

  1. install

...

  1. Blackboard

...

  1. CE.

...

  1. Make

...

  1. sure

...

  1. you

...

  1. follow

...

  1. the

...

  1. correct

...

  1. setup

...

  1. guide

...

  1. for

...

  1. your

...

  1. version

...

  1. as

...

  1. the

...

  1. installation

...

  1. steps

...

  1. can

...

  1. change

...

  1. from

...

  1. version

...

  1. to

...

  1. version.

...

  1. The

...

  1. setup

...

  1. guides

...

  1. can

...

  1. be

...

  1. found

...

  1. at

...

  1. https://behind.blackboard.com/s/developer/refcenter/docs/

...

  1. .

...

  1. Install

...

  1. LAMS

...

  1. 2.0.6

...

  1. or

...

  1. higher

...

  1. on

...

  1. a

...

  1. separate

...

  1. server.

...

  1. Ensure

...

  1. that

...

  1. each

...

  1. server

...

  1. can

...

  1. access

...

  1. the

...

  1. web

...

  1. addresses

...

  1. of

...

  1. the

...

  1. other,

...

  1. this

...

  1. can

...

  1. simply

...

  1. be

...

  1. done

...

  1. by

...

  1. accessing

...

  1. the

...

  1. LAMS

...

  1. or

...

  1. Blackboard

...

  1. CE

...

  1. login

...

  1. page.

...

  1. Set

...

  1. up

...

  1. a

...

  1. web

...

  1. server

...

  1. address

...

  1. to

...

  1. store

...

  1. the

...

  1. images

...

  1. used

...

  1. by

...

  1. the

...

  1. Powerlink.

...

  1. The

...

  1. easiest

...

  1. way

...

  1. to

...

  1. do

...

  1. this

...

  1. is

...

  1. to

...

  1. copy

...

  1. it

...

  1. into

...

  1. the

...

  1. LAMS

...

  1. server

...

  1. images

...

  1. folder

...

  1. -

...

  1. Copy

...

  1. the

...

  1. 'treeicons'

...

  1. folder

...

  1. found

...

  1. in

...

  1. /path/to/lams2-webct-integration-1.0.0/deploy/web/tigra/

...

  1. into

...

  1. /path/to/jboss-4.0.2/server/default/deploy/lams.ear/lams-central.war/images.

...

  1. Test

...

  1. that

...

  1. the

...

  1. images

...

  1. are

...

  1. accessible

...

  1. on

...

  1. the

...

  1. web

...

  1. by

...

  1. opening

...

  1. a

...

  1. web

...

  1. browser

...

  1. and

...

  1. going

...

  1. to

...

  1. http://<your

...

  1. lams

...

  1. server>:8080/lams/images/tigra_base.gif.

...

  1. Set

...

  1. up

...

  1. a

...

  1. MySql

...

  1. database

...

  1. which

...

  1. is

...

  1. accessible

...

  1. from

...

  1. the

...

  1. Blackboard

...

  1. CE

...

  1. server

...

  1. (This

...

  1. can

...

  1. be

...

  1. the

...

  1. same

...

  1. database

...

  1. as

...

  1. used

...

  1. for

...

  1. the

...

  1. LAMS

...

  1. server

...

  1. if

...

  1. appropriate).

...

  1. Set

...

  1. up

...

  1. a

...

  1. special

...

  1. MySql

...

  1. user

...

  1. which

...

  1. the

...

  1. Powerlink

...

  1. can

...

  1. use

...

  1. to

...

  1. talk

...

  1. to

...

  1. the

...

  1. database.

...

  1. Make

...

  1. sure

...

  1. the

...

  1. user

...

  1. has

...

  1. cross-server

...

  1. permission

...

  1. if

...

  1. the

...

  1. MySql

...

  1. server

...

  1. is

...

  1. not

...

  1. located

...

  1. on

...

  1. the

...

  1. same

...

  1. server

...

  1. as

...

  1. Blackboard

...

  1. CE.

...

  1. This

...

  1. can

...

  1. be

...

  1. done

...

  1. using

...

  1. a

...

  1. command

...

  1. on

...

  1. the

...

  1. MySql

...

  1. command:

...


  1. GRANT

...

  1. ALL

...

  1. PRIVILEGES

...

  1. ON

...

  1. <database

...

  1. name>.

...

  1. *

...

  1. TO

...

  1. '<username>'@'<host>'

...

  1. IDENTIFIED

...

  1. BY

...

  1. '<user

...

  1. password>.

...

  1. You

...

  1. can

...

  1. test

...

  1. the

...

  1. cross-server

...

  1. MySql

...

  1. access

...

  1. by

...

  1. installing

...

  1. a

...

  1. MySql

...

  1. client

...

  1. and

...

  1. the

...

  1. typing

...

  1. the

...

  1. following

...

  1. command:

...


  1. mysql

...

  1. -h

...

  1. <host>

...

  1. -u

...

  1. <user>

...

  1. -p

...

  1. <password>

...

  1. <database

...

  1. name>;

...

  1. Open

...

  1. up

...

  1. the

...

  1. createTable_MySql.sql

...

  1. script

...

  1. in

...

  1. a

...

  1. text

...

  1. editor,

...

  1. edit

...

  1. all

...

  1. appearances

...

  1. of

...

  1. $

...

  1. {dbTable

...

  1. }

...

  1. to

...

  1. name

...

  1. the

...

  1. table

...

  1. as

...

  1. you

...

  1. wish.

...

  1. Run

...

  1. the

...

  1. create

...

  1. table

...

  1. script

...

  1. using

...

  1. the

...

  1. following

...

  1. command:

...


  1. mysql

...

  1. -u<mysql

...

  1. user>

...

  1. -p

...

  1. <database

...

  1. name>

...

  1. <

...

  1. path/to/createTable_MySql.sql

...

Installation

...

of

...

Powerlink

   1.

...

Download

...

lams2-webct-integration-1.0.0.zip

...

from

...

the

...

downloads

...

page.

...


   2.

...

Unzip

...

to

...

a

...

temporary

...

location.

...


   3.

...

The

...

package

...

should

...

contain

...

the

...

following

...

files:

...

  • lams2

...

  • (directory)

...

    • authmodule_CE_1.4.jar

...

    • commons-codec-1.3.jar

...

    • lams2-webct-integration-1.x.x.jar

...

    • mysql-connector-java-3.1.2-bin.jar

...

    • xercesImpl.jar

...

  • readme.txt

...

  • license.txt

...

  • release_notes.txt

...

  • createTable_MySql.sql

...

   4.

...

Create

...

a

...

directory

...

called

...

"lams2"

...

in

...

the

...

/path/to/bea815/weblogic81/config/WebCTDomain/deployablecomponents

...

folder
   5.

...

Copy

...

the

...

authmodule_CE_1.4.jar,

...

commons-codec-1.3.jar,

...

lams2-webct-integration-1.x.x.jar,

...

mysql-connector-java-3.1.2-bin.jar

...

into

...

this

...

directory.

...


   6.

...

IF

...

you

...

are

...

running

...

Blackboard

...

CE

...

6.2

...

or

...

newer,

...

copy

...

xercesImpl.jar

...

into

...

the

...

directory,

...

otherwise

...

DO

...

NOT.

...


Note

Blackboard CE instances are often tweaked and modified so it is difficult to provide a package suitable for every instance, if you find there are problems running the Powerlink, it may be because an included jar is clashing with another existing jar. In this case, simply remove the jar and try again. 


Configuring the Blackboard CE Side

  1. Login to the Blackboard CE server as serveradmin.
  2. Make sure you are at the server level, by clicking it on the Administration tree on the left.
  3. Click on utilities (the red box) tab, then settings to get to the admin screen.
  4. Under the System Integration list there should now be a link called "LAMS Integration Module", click on that link.
  5. Select the true option of the Enable setting and also ensure you select the "Override Setting at Child Contexts" option to enable it at all contexts.
  6. Edit the configuration fields to suit your needs. The important fields are listing in the following steps.
  7. The "Database Server Host" should be filled to match the JDBC URL to connect to your database.
  8. The "Database driver jar" should be left as default, unless you are using a non-mysql database.
  9. The "Database Table Name" should be the same name that you used for your table in the createTable_MySql.sql scritpt in the pre-steps.
  10. The "Database User" should be the same as the one set up in the pre-steps.
  11. The "Database Password" needs to be correct to connect to the database.
  12. The "LAMS server url" is the url to get to the LAMS login page, make sure it has a forward slash "/" at the end.
  13. The "LAMS server id" is a arbitrary name that will be used to configure the LAMS/WebCt server connection, make sure you remember this feild.
  14. The "LAMS server secret key", is the secret field that will be used to hash requests between LAMS/WebCT servers. Choose a field only your administrators know, and make sure you remember it.
  15. The "WebCT request source" field is an arbitrary name which the LAMS server will use when returning to the Blackboard CE server, you can leave it as Blackboard CE, or change it to whatever you wish to call you 'home' Blackboard CE server.
  16. The "Images URL" should be set to point to a web address folder containing the Tigra images, as was set up in the pre-steps.
  17. The LAMS Author, Monitoring and Learner roles allow you to map WebCT roles to LAMS roles.
  18. Once finished configuring settings, make sure for each setting the "Override Setting at Child Contexts" is selected and then save.
  19. Next, click on the Powerlinks Proxy Tools tab, then click the Create Proxy Tool button.
  20. From the drop down menu, select "LAMS Integration Module".
  21. Enter the proxy tool name, version (1.0) and description, do not lock any of they settings, and do not select the "Release to My WebCT" option.
  22. Click save, the new Proxy Tool should appear in the list.
  23. Now return to the settings screen by clicking on the utilities (red box) tab then clicking settings.
  24. Under tools, a new link should appear with the same name as you used for the proxy tool name. Click it.
  25. The Enable Tool Field should be locked, you will need to unlock it first, then return to the menu again and select true to enable the tool. Make sure you select the "Override Setting at Child Contexts" also.

Configuring the LAMS Side

  1. Follow the instructions to install LAMS, it is recommended that you install LAMS and Blackboard CE on separate servers to account for heavy memory requirements. You can either build LAMS from source or follow the instructions for Window Installers or Unix Installers.
  2. Login to LAMS as sysadmin.
  3. Goto Sys Admin->Maintain integrated servers->Add New Server.
  4. Setup the fields to match those that you put on the Blackboard side
  5. The id and key should map to the "LAMS SERVER ID" and "LAMS SERVER SECRET KEY" fields respectively on the LAMS properties page in Blackboard (see above).
  6. Fill in a description of the Blackboard server.
  7. The "Prefix" field denotes a prefix that will be added to all users from Blackboard CE, for example if you put webct as the prefix and accessed LAMS with a user called "user", their name in LAMS would be "webct_user".
  8. The 'disabled' checkbox disables this integration, you can select this later if you wish to disable the connection.
  9. The User Information URL is arbitrary for LAMS/Blackboard CE integrations, so put a dummy URL in.
  10. You can specify a timeout page that LAMS will go to if there is an error. Image Added
    And you are done! You can now create and access LAMS content from Blackboard CE.

LAMS 2 Powerlink Source Code

Info

The LAMS-Blackboard CE Integration Building Block source code is available on our CVS server. You can access the source from from cvs by checking out the lams_webct_integration project. The project comes with an ant build script that will compile the code into .jar format, then just follow the installation step to install.

  • access method: pserver
  • user name: anonymous
  • server name: code.lamsfoundation.org
  • location: /usr/local/cvsroot

Help, Questions, Comments?

If you have any questions or comments, please post them in the LAMS Community Tech Forums (smile)