Connecting IBM Lotus Virtual Classroom

Learning Management System R1

software

Disclaimer THE INFORMATION CONTAINED IN THIS DOCUMENTATION IS PROVIDED FOR INFORMATIONAL PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS DOCUMENTATION, IT IS PROVIDED “AS IS” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN ADDITION, THIS INFORMATION IS BASED ON IBM’S CURRENT PRODUCT PLANS AND STRATEGY, WHICH ARE SUBJECT TO CHANGE BY IBM WITHOUT NOTICE. IBM SHALL NOT BE RESPONSIBLE FOR ANY DAMAGES ARISING OUT OF THE USE OF, OR OTHERWISE RELATED TO, THIS DOCUMENTATION OR ANY OTHER DOCUMENTATION. NOTHING CONTAINED IN THIS DOCUMENTATION IS INTENDED TO, NOR SHALL HAVE THE EFFECT OF, CREATING ANY WARRANTIES OR REPRESENTATIONS FROM IBM (OR ITS SUPPLIERS OR LICENSORS), OR ALTERING THE TERMS AND CONDITIONS OF THE APPLICABLE LICENSE AGREEMENT GOVERNING THE USE OF IBM SOFTWARE.

Licensed Materials - Property of IBM ©Copyright IBM Corporation 1985, 2003 All rights reserved. US Government Users Restricted Rights - Use, duplication or disclosure restricted by GS ADP Schedule Contract with IBM Corp. Lotus Software IBM Software Group One Rogers Street Cambridge, MA 02142

List of Trademarks IBM, the IBM logo, AIX, AS/400, DB2, LearningSpace, LearningSpace Forum, IBM Directory Server, RS/6000, iSeries, xSeries, MQSeries, Cloudscape, Netfinity, OfficeVision, OS/2, OS/390, OS/400, S/390, Tivoli, WebSphere, 1-2-3, cc:Mail, Domino, Domino Designer, Freelance Graphics, iNotes, Lotus, Lotus Discovery Server, Lotus Enterprise Integrator, Lotus Mobile Notes, Lotus Notes, Lotus Organizer, LotusScript, Notes, QuickPlace, Sametime, SmartSuite, and Word Pro are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Crystal Reports is a registered trademark of Crystal Decisions Corporation in the United States, other countries, or both. Pentium is a trademark of Intel Corporation in the United States, other countries, or both.

Java, JavaServer Pages, JavaBeans, JavaScript, J2EE, JDBC, Sun Enterprise, and Sun Solaris are trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. JReport and JReport Designer are trademarks of Jinfonet Software, Inc. in the United States, other countries, or both. Macromedia, Pathware, and Dreamweaver are registered trademarks of Macromedia, Inc. in the United States, other countries, or both. Netscape and Netscape Navigator are registered trademarks of Netscape Communications Corporation in the United States and other countries. Oracle is a registered trademark of Oracle Corporation in the United States, other countries, or both. PKZIP is a registered trademark of PKWARE, Inc. in the United States, other countries, or both. SmartForce is a trademark of SkillSoft Corporation in the United States, other countries, or both. SQL Server and Internet Explorer are trademarks of Microsoft Corporation in the United States, other countries, or both. Windows, Windows NT, Active Directory, and Outlook are registered trademarks of Microsoft Corporation in the United States, other countries, or both. UNIX is a registered trademark of The Open Group in the United States and other countries. Other product, company, and service names mentioned herein may be the trademarks, registered trademarks, or service marks of their marks of their respective owners.

Contents Installing the LVC Connector tool .......................................................................................................................................... 1

Enabling a Lotus Virtual Classroom Catalog server in the Learning Management System.......................................... 2

Enabling SSO and importing the LTPA key on Lotus Virtual Classroom servers........................................................... 2

Prerequisites........................................................................................................................................................................... 2

To merge single sign-on ....................................................................................................................................................... 2

Creating and editing courses that include a Live session.................................................................................................... 3

About courses generated outside of Lotus Virtual Classroom ....................................................................................... 4

How externally generated courses appear in Lotus Virtual Classroom........................................................................ 4

How externally generated courses differ from Lotus Virtual Classroom courses ....................................................... 4

Managing courses that include a Live session ...................................................................................................................... 5

Adding Live session instructors.............................................................................................................................................. 5

Tips for working with Live sessions....................................................................................................................................... 5

Replacing files after uninstalling the LVC Connector.......................................................................................................... 6

Index ............................................................................................................................................................................................... 7

Contents iii

Using Lotus Virtual Classroom for Live sessions A Live session is a scheduled, online, class for which all participants log in at the same time. If your company has Lotus Virtual Classroom (LVC), along with the IBM® Lotus® LVC Connector (the tool that makes it work with the Learning Management System), courses in the Learning Management System can include a Live session as a course activity. Users enrolled in a course that includes a Live session can join the session by going to their calendar, by launching the course, or by going to This Week’s Activities.

Note This document supercedes any previous information on installing the LVC Connector and using the Lotus Virtual Classroom with the Learning Management System.

Installing the LVC Connector tool If you want to be able to include Live sessions in your Learning Management System courses, you must install the LVC Connector. This tool provides the Web services required for using Lotus Virtual Classroom with the Learning Management System. Contact IBM to obtain a copy of the LVC Connector.

You must install the LVC Connector on the Lotus Virtual Classroom Catalog server. For information on installing Lotus Virtual Classroom, see the IBM Lotus Virtual Classroom Installation Guide in the Documentation Library at http://www.lotus.com/ldd.

To install the LVC Connector, do the following:

1. On the LVC Catalog server, stop the Domino server by entering the quit command in the Domino console window.

2. Start the LVC Connector Startup program (setup.exe) from the CD.

3. Choose Setup Language, select a language for your site, and click OK.

4. At the Software License Agreement screen, review the license agreement and click Accept.

5. At the Welcome screen, click Next.

6. At the Start-up Method screen, select the same mechanism for starting the LVC Connector as you use for starting Domino services, and click Next. At this point, the installation program copies a series of files from CD to server, displaying the Setup Complete screen when done.

7. At the Setup Complete screen, click Finish.

8. If you have not set up the Connector as a Windows service, restart the server machine now and skip the next procedure.

If you have set up the LVC Connector as a Windows service, it defaults to the Manual setting (requiring youto start it manually). Change this setting to Automatic with the following procedure:

1. Start the Services Manager by clicking Start – Programs – Administrative Tools – Services.

2. Select IBM WebSphere Application Server V5 – LVC Connector by double-clicking it.

3. Set the Startup Type to Automatic.

4. Click OK.

5. Close the Services Manager window.

6. Restart the server machine.

Using Lotus Virtual Classroom with the Learning Management System 1

Enabling a Lotus Virtual Classroom Catalog server in the Learning Management System For Live-session capability to be available from within the Learning Management System, you must provide information about each Lotus Virtual Classroom Catalog server in your company that is providing the service.

1. In the Learning Management System, click the Settings tab.

2. Click the Collaboration Servers link, and then click the LVC tab.

3. Click Add.

4. Enter a name for the Lotus Virtual Classroom Catalog server that can be used to identify the server when the course offering is created. For example, enter LVC1.

5. Enter a description for that server.

6. Enter the Learning Management System user name and password. This user name should have Workplace Collaboratice Learning administration privileges.

7. Enter the base URL and port for LVC Web Services; for example: http://myLVCserver.com:9650/LVC This example specifies that the LVC Connector tool is installed in a folder called “LVC” on the “myLVCserver” and uses port 9650 on that server for communication with the Learning Management System. Notice that the port is preceded with a colon ( : ) in the URL.

8. Click Save.

9. Repeat steps 3 to 8 for each Lotus Virtual Classroom Catalog server.

10. Click Done.

Enabling SSO and importing the LTPA key on Lotus Virtual Classroom servers The Learning Management System and Lotus Virtual Classroom both use Web Single Sign-On (SSO). To use the products together, you must merge the SSO solutions together, using the credentials from the Learning Management System.

Prerequisites

• You successfully installed the Learning Management System.

• You successfully installed Lotus Virtual Classroom.

• All computers are in the same DNS domain.

• All computers use the same LDAP directory server.

• You exported the WebSphere LTPA (Lightweight Third Party Authentication) key to a file.

• The LVC Catalog Server and LVC Session Server are running.

To merge single sign-on

1. Copy the WebSphere LTPA key to the LVC Catalog Server.

2. On the LVC Catalog Server, start Lotus Notes.

3. Choose File – Database – Open.

4. In the Open Database dialog box, do the following:

2 Using Lotus Virtual Classroom with the Learning Management System

• In the Server field, open the drop-down list and select the hierarchical name of the Catalog Server's Domino Server, for example, catalog/CertifierName.

• In the Database list, highlight the domain’s Domino Directory (the address book). When you select the correct database, the Filename field displays NAMES.NSF. Now click Open.

5. In the Domino Directory's navigator, click Server to open the list of subcategories.

6. Click Web Config (at the bottom) to open that view, and then double-click * - All Servers -.

7. Double-click Web SSO Configuration for LtpaToken.

8. On the action bar, click Edit, Keys, Import WebSphere LTPA Keys.

9. When the message "The Web SSO Configuration has already been initialized. Creating new keys will overwrite existing SSO keys. Continue?" appears, click OK.

10. Enter the full path name of the WebSphere LTPA key, and click OK.

11. Enter the password for the WebSphere LTPA Import file, and click OK.

12. Two new fields will display on the Web SSO Configuration document.

13. In the LDAP Realm field, add a backslash (\) between the host name and the colon that precedes the LDAP port number. For example, change "ldap.example.com:389" to "ldap.example.com\:389."

14. On the action bar, click Save and Close.

15. Exit Notes.

16. Open the LVC Catalog Server's Domino Server console window and type the following: replicate session/certifiername names.nsf restart server

17. Open the LVC Session Server's Domino Server console window and type the following: restart server

If SSO is configured correctly, the following message appears on the Domino server console:

HTTP: Successfully loaded Web SSO Configuration.

If a Domino server enabled for SSO cannot find a Web SSO Configuration document, or is not included in the Domino Server Names field and therefore cannot decrypt the document, the following message appears on your server's console:

HTTP: Error Loading Web SSO configuration. Reverting to single-server session authentication.

Creating and editing courses that include a Live session When course developers create course content in the Learning Management System authoring tool, they can add materials for a Live session as one of the activities that makes up the course. This Live session activity then becomes part of the course master. When you create a course offering from the master, the Learning Management System passes the materials to Lotus Virtual Classroom so that it can deliver the Live session. Returning to the authoring tool is the only means of editing these materials -- an existing offering is updated only when the course is republished to the Learning Management System.

If the course developer prefers to store Live session materials for a course in Lotus Virtual Classroom, you can use the course master and offering creation process to create a new course in Lotus Virtual Classroom. The resulting Lotus Virtual Classroom course includes a QuickPlace to store the course contents, and profiles of instructors so that they can access the course materials from Lotus Virtual Classroom. The Learning Management System instructors can also edit the QuickPlace course materials directly from “Courses I’m Teaching” in Learning Home.

Using Lotus Virtual Classroom with the Learning Management System 3

About courses generated outside of Lotus Virtual Classroom

Generated courses are courses that are created in a program other than Lotus Virtual Classroom (for example, in the Learning Management System authoring tool), but are available in Lotus Virtual Classroom. The content for generated courses - the outline and associated course materials - can be developed in Lotus Virtual Classroom. In this case, you click the "Develop outline" button in the Builder page in the Learning Home, just as you do to develop Lotus Virtual Classroom course outlines and materials.

If you are using the Learning Management System, you access the Builder page from a link within that product.

If you are using Lotus Virtual Classroom with the Learning Management System, you can create the course outline and materials using the Learning Management System authoring tool. Courses whose content is developed outside Lotus Virtual Classroom do not appear in the Lotus Virtual Classroom Learning Home.

The sessions for generated courses take place in Lotus Virtual Classroom, regardless of where the course content is developed. However, with generated courses, most tasks are carried out outside of Lotus Virtual Classroom (for example, in the Learning Management System), including creating courses, scheduling sessions, and enrolling users.

How externally generated courses appear in Lotus Virtual Classroom

Only Lotus Virtual Classroom instructors and administrators can see generated courses. They never appear in the course catalog and thus students never see them.

In Lotus Virtual Classroom, instructors see generated courses listed under the category "Generated course" on the Builder tab. Their status is always "Generated."

How externally generated courses differ from Lotus Virtual Classroom courses

Generated courses have some differences with courses created in Lotus Virtual Classroom. Specifically, you cannot do the following with generated courses:

• Include assessments with them

• Publish them to the course catalog

• View them in the My Sessions list (either as an instructor or a student) The following tasks are performed outside Lotus Virtual Classroom (for example, in the Learning Management System), rather than in the Lotus Virtual Classroom Learning Home:

• Scheduling sessions (even though the schedule of sessions appears in the Learning Home)

• Enrolling students (for administrators)

• Starting sessions

• Changing catalog information, such as the course description or list of instructors In addition, the Lotus Virtual Classroom interface differs between generated courses and courses created in Lotus Virtual Classroom. For example, when editing a generated course:

• The Edit catalog information and Schedule sessions buttons do not appear in the Course details page.

• The "New Assessment" button does not appear for the course on the Assessments and Questions page (since generated courses do not support assessments.)

Any pre-session requirements must be set outside Lotus Virtual Classroom, for example, in the Learning Management System environment or other eLearning product.

4 Using Lotus Virtual Classroom with the Learning Management System

Managing courses that include a Live session After you specify a Lotus Virtual Classroom server in Learning Settings, you can schedule the Live session at the same time that you create the course offering. For information on creating course offerings, see the Learning Management System Administrator’s Guide.

You can schedule a new Live session at any time; sessions can begin immediately (depending only on the time needed to publish the session materials to the session server) or in the future. You can also enroll students up until the session ends, allowing late-comers. For more information see creating course offerings in the LVC on line help.

The instructor for a Live session can change the session’s start and end times in the “Courses I’m Teaching” section of Learning Home.

You cancel or delete a Live session by editing the course offering or master.

Adding Live session instructors When you add a user as a course instructor in the LMS for a course that includes a Live session, the LMS automatically adds the instructor as a full instructor in Lotus Virtual Classroom. The instructor can then both use the LMS to modify Lotus Virtual Classroom course materials for Live sessions originating in the Learning Management System, and use Lotus Virtual Classroom to create LVC-only courses and sessions.

Note Removing a user from the list of instructors removes only the ability for that user to edit the Lotus Virtual Classroom course materials from the Learning Management System. All Lotus Virtual Classroom instructor privileges remain unless an administrator removes them using Lotus Virtual Classroom’s own administrative tools.

Tips for working with Live sessions Working with Live sessions can be tricky; use the following suggestions to avoid problems:

• Create your Live session offering well in advance of the scheduled start time. This provides participants with advance notice (helping to ensure attendance). It also allows for the orderly creation of the session on the designated LVC session server.

This allows time for information about the session to be communicated between the Lotus Virtual Classroom and the Learning Management System. Attempting to start the session sooner may result in errors.

• After creating the Live session offering, don’t touch the keyboard for a couple of minutes. Immediately after session creation, information from the keyboard may still affect your session definition and cause errors. Wait a couple minutes before proceeding to your next task.

• Make sure all dates for a Live session are correct and in sync. For a Live session created in the authoring tool, the Learning Management System may display different start dates in the Virtual Classroom Details page and the Scheduled Offering page. The date on the Scheduled Offering page is the correct date; edit the date on the Virtual Classroom Details page to match it. If you don’t, the session may fail.

• If a Live session fails (for example, because you scheduled it to start too early), delete the session and create a new one. Attempting to correct the failed session may cause errors; you should just delete it and start again.

• If you import a Live session definition from the Authoring Tool, do not try to modify those materials within the Learning Management System.

Using Lotus Virtual Classroom with the Learning Management System 5

Attempting to modify the materials from within the Learning Management System will cause errors. If you need to modify the materials, you should delete the session, edit it from within the Authoring Tool, and re-import it.

Note The button that appears within the Learning Management System is intended only for use with sessions that you actually create within that product.

Replacing files after uninstalling the LVC Connector You will need to replace the following Lotus Virtual Classroom files because they are inadvertently removed when you uninstall the LVC Connector tool:

• LVC.JAR

• LVCStart.BAT

• LVCTerm.BAT After uninstalling the LVC Connector tool, do the following:

1. Open the URL below and download the patch to your hard drive. ftp://ftp.software.ibm.com/software/lotus/fixes/LearningSpace/Virtual_Classroom/Replace.zip

IMPORTANT By downloading and using this Code, you agree to these terms and conditions:

The software samples, updates and fixes ("Code") available in this archive or on this web site for this Program are copyrighted materials. By clicking the download link, you agree that the Code is provided under, and is subject to, the terms and conditions of the license agreement(s) which accompanied or were contained in the copy or copies of the Program for which you are obtaining the Code. You are not authorized to install or use the Code except as part of a Program for which you have a valid Proof of Entitlement or other authorization as specified in such license agreement(s). You further agree that you will comply with all applicable laws and export regulations.

2. Unzip the file.

3. Copy the file, LVC.JAR, into the \Lotus\lvc\lib directory (on the drive where LVC was installed).

4. Copy the two .BAT files into the \Lotus\lvc\bin directory (on the drive where LVC was installed). Notes

• If LVC was installed on any drive other than the C drive, the .BAT files must be edited using a text editor, such as Notepad, to enter the correct drive. The .BAT files contain the following two lines: C: cd "C:\Lotus\lvc\bin"

Change the disk designation ("C:") on both lines to reflect the location of the lvc\bin directory of your installation.

a. If you tried to start LVC after uninstalling the LVC Connector tool, the Start menu shortcut may now point to a file other than the LVCStart.BAT. To check what file the shortcut is pointing to, right-click the ""Start Lotus Virtual Classroom" menu item and choose Properties. If necessary, edit the shortcut target to point to \Lotus\lvc\bin\LVCStart.BAT.

6 Using Lotus Virtual Classroom with the Learning Management System

Index automatic service, 1

courses created in LVC, 3 generated outside LVC, 4 Live sessions in, 1, 3 managing Live sessions in, 5

enabling LVC servers, 2

Live sessions, 1 adding instructors, 5 tips, 5 within courses, 5

Lotus Virtual Classroom using with the Learning Management System, 1

LVC Connector

installing, 1 uninstalling, 6

LVC servers, enabling, 2

servers enabling SSO, 2 Lotus Virtual Classroom, 2

service, Windows, 1

single sign-on, 2

SSO, 2

uninstalling LVC Connector, 6

URL for LVC Connector, 2

Windows service, 1

Index 7

Printed in USA