Lotus IBM Lotus Virtual Classroom Version 1.1.2 Installation Guide G210-1900-00
Terms of Use 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 2002, 2004 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, 1-2-3, Domino, Freelance Graphics, Lotus, Lotus Notes, QuickPlace, Sametime, and Word Pro are trademarks or registered trademarks of International Business Machines Corporation in the United States, other countries, or both. Pentium is a trademark of Intel Corporation in the United States, other countries, or both. Microsoft, Windows, and Windows NT 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. Java and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the United States, other countries, or both. Other company, product, or service names may be trademarks or service marks of others.
Contents About the Installation Guide... v 1 Installing Virtual Classroom... 1-1 About this chapter... 1-1 Supported configuration... 1-1 Installation procedure... 1-3 2 Expanding Virtual Classroom... 2-1 About this chapter... 2-1 Supported configurations... 2-1 Installation procedure... 2-1 3 Rebranding the Virtual Classroom interface... 3-1 About this chapter... 3-1 Modifying the interface... 3-1 4 Upgrading Virtual Classroom... 4-1 About this chapter... 4-1 Supported configuration... 4-1 Upgrade procedure... 4-3 Index... Index-1 iii
About the Installation Guide This Installation Guide provides instructions needed for installing and setting up IBM Lotus Virtual Classroom V1.1.2. This guide provides instructions for: Installing Virtual Classroom V1.1.2 Expanding your deployment of Virtual Classroom V1.1.2 Customizing the user interface branding Upgrading to Virtual Classroom V1.1.2 from V1.1.1. Note You can not upgrade to Virtual Classroom V1.1.2 from a version earlier than V1.1.1. Detailed installation procedures are provided in the following chapters of this guide. v
Chapter 1 Installing Virtual Classroom This chapter contains important information about installing Virtual Classroom. Read this before using this product. About this chapter This chapter of the Virtual Classroom Installation Guide provides information about the following: Supported configuration System requirements Installation procedure How to access Virtual Classroom In addition, refer to the Virtual Classroom online Help for information about using this product. Supported configuration The management server component of Virtual Classroom consists of the Catalog server and Content server. The Catalog server maintains information about the available classes, the scheduled sessions, participants' enrollments in scheduled sessions, moderators' assignments to deliver scheduled sessions, and administrative pieces. The Content server stores the course materials and outlines that are used during the scheduled sessions. The classroom server component of Virtual Classroom consists of the Session server. The Session server provides the scheduled sessions to the moderators and participants. 1-1
The recommended installation of Virtual Classroom V1.1.2 is on two computers: Catalog server and Content server (called catalog.example.com in this document) Lotus Domino 6.5.2 Lotus Notes and Domino Administrator clients 6.5.2 IBM Lotus Team Workplace 6.5.1 (formerly QuickPlace) Virtual Classroom V1.1.2 Catalog server and Content server Session server (called session.example.com in this document) Lotus Domino 6.5.2 IBM Lotus Instant Messaging and Web Conferencing 6.5.1 (formerly Sametime) Virtual Classroom V1.1.2 Session server System requirements You need two computers that meet or exceed the following server hardware and server software prerequisites. The computers do not need to be identical configurations, but they must be set to the same time zone and date/time format. Server hardware CPU: Pentium II 400MHz or higher Memory: A minimum of 1GB RAM is required Disk space: A minimum of 1GB free disk space is recommended Network: Local Area Network interface for TCP/IP Display: A minimum of 256 colors is required. If necessary, switch up to this setting to install Team Workplace, Instant Messaging and Web Conferencing, and Virtual Classroom and then switch back to your normal setting. Server software One of the following operating system platforms: Windows 2000 Server and Advanced Server with Service Pack 3 Windows 2003 Server and Advanced Server 1-2 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
Client and browser requirements Additional computers must meet the browser requirements. (The computers do not need to be identical configurations.) Windows clients (2000, or XP Professional) Microsoft Internet Explorer 5.5 or 6.0 with Service Pack 2 and IE Security Patch Q828750 (with the native Microsoft VM or the JVM 1.4.1 plugin) Mozilla 1.4.1 (Participants only) Moderators need a minimum of 256MB RAM in order to deliver a course that has breakout sessions. What's not supported An external LDAP directory server, especially with SSL, and Virtual Classroom cannot run on the same machine. Installation procedure Installation overview On the Catalog server: 1. Install Domino. 2. Install Lotus Notes client software. 3. Pre-register the Session server. 4. Install Team Workplace. 5. Install Virtual Classroom Catalog server and Content server. On the Session server: 6. Install Domino. 7. Install Instant Messaging and Web Conferencing. 8. Install Virtual Classroom Session server. Before you begin 1. Disable any Web servers running on the computers (e.g., Microsoft IIS). 2. Computer names must be in lowercase, especially the Catalog server. 3. Always enter computer names in lowercase (e.g., catalog.example.com, NOT CATALOG.example.com or Catalog.example.com). 4. If you are using Windows 2000, make sure the computer s Network Identification contains the DNS domain name (e.g., catalog.example.com, not simply catalog). (You can get to Network Identification by right-clicking on the My Computer icon, selecting Properties, and clicking on the Network Identification tab.) 1-3
5. Both computers must be registered in the DNS (Domain Name System). As a temporary workaround, you can create entries in the local hosts files of these computers and every computer that someone uses to connect to them. For example, add lines like these to C:\WINNT\System32\Drivers\etc\hosts (for Windows NT, 2000, and XP Professional) or C:\Windows\hosts (for Windows 98): 192.168.0.5 catalog.example.com catalog 192.168.0.6 session.example.com session Substitute your computers names and TCP/IP addresses. 6. Do you have an LDAP-accessible directory server (called an external LDAP directory server in this document) that stores the user names and Web passwords for your users? Examples of external LDAP directory servers include: A Domino server that is running the LDAP server task IBM Directory Server (formerly known as IBM SecureWay Directory Server) iplanet Directory Server Alternate question: If you have a production deployment of Lotus Domino but are not currently running the LDAP server task, can you run it on one of the servers? NO: You must establish scheduled replication between the two computers' Domino servers. You must register each user in the Virtual Classroom internal directory. There are 2 ways to do this: Administrator-based registration (this is the default) An administrator registers users, assigns initial passwords, and optionally promotes users to moderators and/or additional administrators. (Later, an administrator can promote a participant to a moderator and/or an additional administrator or demote a user.) Self-registration After installation, you can configure the deployment to allow users to self-register as participants. Self-registration allows the users to pick their own user names and passwords. (Later, an administrator can promote a participant to a moderator and/or an additional administrator. An administrator can also demote a user.) YES: 1-4 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
You should configure your deployment to make use of the external LDAP directory server. There are several places where you will do this. 7. If you ever plan to install an external learning product (such as the Learning Management System) with Virtual Classroom, you must use an external LDAP directory service when you install Virtual Classroom. External learning products require LDAP and both those products and Virtual Classroom must use the same external LDAP directory. You can not switch from using an internal Domino Directory to LDAP once you have installed Virtual Classroom. Note Be sure to follow the procedures in this document exactly as they are written, including capitalization of any entries you make. Some entries are case sensitive and will not work properly if you do not enter them correctly. Install the first Domino server Start the Lotus Domino 6.5.2 installation program (i.e., SETUP.EXE) on the Catalog server (e.g., catalog.example.com). 1. Welcome screen 2. License Agreement screen Read the license agreement. Click Yes. 3. Name and Company name screen Enter your name and company name. Do NOT check Partitioned Server Installation. 4. Program Folder and Data Folder screen If you change the default Program Folder installation directory from C:\Lotus\Domino, do NOT specify the same directory for both the Program Folder and Data Folder. 5. Setup type screen Keep the default setting of Domino Enterprise Server. Click the Customize button. 6. Domino Enterprise Server screen Highlight Data Files and click Change. 7. Select Sub-components screen Scroll down and clear the check boxes for Modem Command Scripts and Readme. Click Continue. 8. Domino Enterprise Server screen Highlight Program Files and click Change. 1-5
9. Select Sub-components screen Scroll down and clear the check box for DECS Program Files. Click Continue. 10. Domino Enterprise Server screen Highlight Template Data Files and click Change. 11. Select Sub-components screen Scroll down and clear the check boxes for Teamroom. Click Continue. 12. Domino Enterprise Server screen 13. Program Folder screen If you want, change the default folder name from Lotus Applications. Wait while the installation program copies files. When the installation is complete, click Finish. In the Domino Program directory (e.g., C:\Lotus\Domino directory), rename KVOOP.EXE to KVOOP.EXE-OFF. When the follow message appears: If you change a file name extension, the file may become unusable. Are you sure you want to change it? Answer Yes. Set up the first Domino server Start the Lotus Domino Server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). 1. Lotus Domino Server screen Choose Start Domino as a regular application [maybe broken as a service?]. Select Don't ask me again and click OK. Wait a couple of minutes. 2. Welcome to Domino Server Setup screen 3. First or Additional Server screen Keep the default setting of Set up the first server or a stand-alone server and click Next. 4. Provide a Server Name and Title screen. Enter the server's short name in the Server name box. Type Catalog Server in the Server title box. 1-6 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
5. Choose your Organization Name screen Enter a name in the Organization name box. Enter an Organization Certifier password and confirm the password. It must be at least 8 characters long. If you forget it, you will have to completely reinstall Domino and everything you install after it. Click Next. 6. Choose the Domino Domain Name screen Enter a Domain Name (e.g., DomainName). You can use your DNS domain name. 7. Specify an Administrator Name and Password screen Enter an administrator name. The person you name is automatically registered as a Virtual Classroom participant only, and later can be promoted to a moderator and/or an administrator. Enter and confirm an administrator password. It must be at least 8 characters long. Select Also save a local copy of the ID file. 8. Internet Services screen Check the Web Browsers (HTTP services) check box. Check the Internet Mail Packages section (SMTP, POP3, and IMAP services ) check box. Check the Directory Services (LDAP services) check box. Click Customize. 9. Advanced Domino Services screen Clear the following check boxes: DOLS Domino Offline Services IMAP Server POP3 Server Make sure the following check boxes remain selected: Admin Process Agent Manager HTTP Server LDAP Server SMTP Server Replicator can be deselected for deployments using an external LDAP directory, but must be selected if your deployment uses a local Domino Directory. 1-7
Click OK. 10. Internet Services screen 11. Domino Network Settings screen Click Customize. 12. Advanced Network Settings screen Verify that the TCP/IP check box is selected. Clear all the other check boxes, and then click OK. 13. Domino Network Settings screen 14. Secure your Domino Server screen Clear the Prohibit Anonymous access to all databases and templates check box, and click Next. 15. Review Setup Options screen Review your options, and then click Setup. 16. Setup Summary screen Click Finish. Start the Domino server (with Start.. Programs.. Lotus Applications.. Lotus Domino Server). The Domino server console window (a Command Prompt window) appears. Wait until you see the message HTTP Web server started. Stop the Domino server. Install the Lotus Notes and Domino Administrator client software Start the Lotus Notes 6.5.2 installation program on the Catalog server (e.g., catalog.example.com). If you get an overwrite protection message, answer yes to overwrite all. 1. Welcome screen 2. License Agreement screen Read the license agreement. Select I accept the terms in the license agreement, and click Next. 3. Customer Information screen Enter your name and organization name. 1-8 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
4. Installation Path Selection screen If you want, change the default installation directories from C:\Lotus\Notes and C:\Lotus\Notes\Data. Do NOT specify the same directory for both the Program Folder and Data Folder. Do NOT specify the Domino server s directories. 5. Custom Setup screen Select Domino Administrator. (It includes the Lotus Notes client.) Click the down arrow and select This feature will be installed on local hard drive. 6. Ready to Install the Program screen Click Make Notes my default email program. Click Install. Wait while the program files are copied. When the installation is complete, click Finish. Set up the Lotus Notes and Domino Administrator client software Start the Domino server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). Start the Lotus Notes client (Start.. Programs.. Lotus Applications.. Lotus Notes). The setup process begins. The Domino server must be running. Note If a Notes error Invalid or nonexistent document displays, click OK and ignore it. 1. Welcome screen 2. User Information screen Enter the Administrator s name you specified during Domino server setup. Enter the hierarchical name of the Domino server (e.g., catalog/certifiername) you created during Domino server setup. Select I want to connect to a Domino server. 3. Password screen Enter your Administrator's password that you specified during Domino server setup. 4. Instant Messaging Setup screen Deselect Setup instant messaging. 1-9
5. Additional Services screen Wait until you see the pop-up message Notes setup is complete! Click OK. Wait until you see the Welcome - Lotus Notes page. Pre-register the additional Domino server Before you can install Domino on the Session server, you must pre-register it with the Catalog server s Domino server. 1. Start the Domino Administrator client from the Lotus Notes client (File.. Tools.. Server Administration). Since this is the first time you have used the Domino Administrator client, the What s new page appears. Check the Don t show this again check box. Press ESCAPE. The Domino Administrator workspace opens to the People & Groups tab. 2. Click the Configuration tab. 3. In the Tools column on the right-hand side of the screen, click Registration to display the list of sub-tasks. 4. Click Server... 5. Click the Server dialog box, and select the server name from the list, and then click OK. The Choose a Certifier dialog box appears. 6. In the Registration Server field, find the name of your Domino server (e.g., catalog/certifiername). Click OK. 7. Click Certifier ID... 8. Open cert.id (e.g., C:\Lotus\Domino\Data\cert.id). 9. Click Open. 10. Enter certifier password, and click OK. 11. Certifier Recovery Information Warning screen Click OK. 12. Register Servers screen Click Continue... 13. In the Server name field, enter the short name of the Session server (e.g., session). 14. In the Server title field, type Session server. 1-10 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
15. In the Domino domain field, enter the Domain Name you established in the Administrative Settings section of the Domino server setup (e.g., DomainName). 16. In the Server administrator name field, enter the Administrator s Name you established in the Domino server setup. It should be in the adminname/domain format. 17. Leave the ID file password field blank. 18. Under Location for storing server ID clear the check box for In Domino Directory and check the box for In file:. 19. If you want, click Set ID File to change the location and file name of the file that will be the Session server s Domino server ID file. Click the check mark button to add it the server list. 20. Click Register All. 21. Click Done. 22. Close the Domino Administrator client (File.. Exit Administrator). You should be back at the Lotus Notes client. Configure Web Single Sign on (SSO) While still in the Lotus Notes client, follow these instructions. 1. From the File menu, choose Database.. Open. 2. On the Open Database dialog box: At the end of the Server field, click the downward pointing triangle. Click the hierarchical name of the Catalog server s Domino server (e.g., catalog/certifiername). In the Database list, highlight the DomainName s Directory. If you have the right database, the Filename field displays names.nsf. Click Open. 3. If this is the first time you have opened the database, a window with About Domino Directory appears. Press ESCAPE to close this window. 4. If a window with the Domino Directory Profile appears, click Save and Close. 5. The People view appears. You should see the Domino Administrator name you specified in the main frame. 6. Click Configuration in the left-hand column. A list of sub-categories appears. Click Servers and then click All Server Documents to open to the Server\Servers view. 7. On the Action Bar (just above the view), click Web... and then click Create Web SSO Configuration. 1-11
8. On the Basics tab, in the DNS Domain field, enter the DNS domain name for your servers (e.g.,.example.com). 9. In the Domino Server Names field, enter the hierarchical names of both computers (e.g., catalog/certifiername and session/certifiername). Do this now, even though the Session server has not been set up yet. 10. In the Expiration (minutes) field, change the value to 720. 11. On the Action Bar, click Keys... and then click Create Domino SSO Key. When the pop-up message Successfully created Domino SSO key appears, click OK. 12. On the Action bar, click Save and Close. 13. Double-click the Catalog server, and click Edit server. 14. On the Internet Protocols tab, click Domino Web Engine. In the HTTP Sessions section Set Session Authentication to Multiple Servers (SSO). In the Web Agents section, change the Run web agents concurrently? field from Disabled to Enabled. 15. Click Save and Close. You must choose either OPTION 1 or OPTION 2 that follow this section. 1-12 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
OPTION 1: Set up scheduled replication While still in the Lotus Notes client, follow these instructions: 1. Click Connections to go to the Server\Connections view. 2. Click Add Connection. 3. On the Basics tab, set these fields to the following settings: Field Connection Type Source server Source domain Use the ports Usage Priority Destination server Destination domain Optional network address Setting Local Area Network (default) Hierarchical name of the Catalog server (default). For example: catalog/certifiername Name of the Domino domain (e.g., DomainName) Click Choose Ports, highlight TCPIP, and click OK Normal (default) Hierarchical name of the Session server (e.g., session/certifiername) Name of the Domino domain (e.g., DomainName) Fully qualified host name of the Session server (e.g., session.example.com) 4. On the Schedule tab, set these fields to the following settings: Field Schedule Connect at times Repeat interval of Days of week 5. Click Save and Close. 6. Press ESCAPE to close the Domino Directory. Note This is the end of the OPTION 1 instructions. Setting ENABLED (default) 12:00 AM - 11:59 PM 15 minutes Sun, Mon, Tue, Wed, Thu, Fri, Sat (default) 1-13
OPTION 2: Configure Directory Assistance for access to an external LDAP directory server Note If you are required to connect to your external LDAP directory server using SSL encryption, DO NOT FOLLOW THESE STEPS. Please contact IBM Lotus Virtual Classroom support for configuration assistance. While still in the Lotus Notes client, follow these instructions: 1. From the File menu, choose Database.. New. 2. In the New Database dialog box: At the end of the Server field, click the downward pointing triangle. Click the hierarchical name of the Catalog server s Domino server (e.g., catalog/certifiername). In the Title field, enter Directory Assistance. Change the File Name field to da.nsf. Click Template server then click the downward pointing triangle. Click the hierarchical name of the Catalog server s Domino server (e.g., catalog/example). Click OK. Select Show advanced templates. In the list of templates, scroll down and highlight the Directory Assistance template. If you have the right template, da50.ntf appears next to the About button. Click OK. Wait while the Directory Assistance database is created and opened. Since this is the first time you have opened this new database, a window with About Directory Assistance appears. Press ESCAPE to close this window. 3. In the Action Bar, click Add Directory Assistance. 1-14 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
4. On the Basics tab, set these fields to the following settings: Field Domain Type Domain Name Company Name Search Order Make this domain available to Group Authorization Nested group expansion Enabled Setting LDAP LDAPlookup The name of your company (e.g., Example) 1 Check both Notes Clients & Internet Authentication/Authorizat ion and LDAP Clients Yes (This field appears when you set Domain Type to LDAP) Yes (This field appears when you set Group expansion to Yes) Yes 5. On the Rules tab, for NC 1, set the Trusted for Credentials field to Yes. 1-15
6. On the LDAP tab, set these fields to the following settings: Field Hostname Optional Authentication Credential Username Password Base DN for search Channel encryption Setting Fully qualified host name of your LDAP server (e.g., ldap.example.com) Leave blank if possible; if not, enter a valid username from your directory in LDAP format: e.g., cn=john doe,o=example Leave blank if possible; if not, enter the password that goes with the Username Enter the base distinguished name for your users in LDAP format: e.g., o=example,c=us Choose None. You get a pop-up message that states Warning! You should not disable the SSL port and still have a rule which is trusted for credentials. Click OK. The Port field value changes from 663 to 389. These fields disappear: Accept expired SSL certificates, SSL protocol version, Verify server name with remote server s certificate. Port 389 Timeout 60 seconds Maximum number of entries 100 returned Dereference Alias on search Always Preferred mail format Internet Mail Address Attribute to be used as Notes Leave blank. Distinguished Name Type of search filter to use Standard LDAP 1-16 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
7. Click Save and Close. You get the pop-up message again because Trusted for Credentials is set to Yes, while Channel encryption is set to None. Click OK. 8. Press ESCAPE to close the Directory Assistance database. 9. From the File menu, choose Database.. Open. 10. In the Open Database dialog box: At the end of the Server field, click the downward pointing triangle. Click the hierarchical name of the Catalog server s Domino server (e.g., catalog/certifiername). In the Database list, highlight the DomainName s Directory. If you have the right database, the Filename field displays names.nsf. Click Open. 11. Click Configuration in the left-hand column. A list of sub-categories appears. Click Server. Click All Server Documents to open to the Server\Servers view. You should see lines for both computers (e.g., catalog/certifiername and session/certifiername). 12. Double-click the Server document for the Catalog server (e.g., catalog/certifiername). 13. On the Action Bar, click Edit Server. 14. On the Basics tab, in the Directory Assistance database name field, enter da.nsf. 15. On the Action Bar, click Save and Close. 16. Press ESCAPE to close the Domino Directory. Note This is the end of OPTION 2 instructions. Close the Lotus Notes client (File.. Exit Notes). Transfer the server ID file to the Session server (e.g., session.example.com). It doesn t matter whether you use a diskette, FTP it in binary mode, or copy it via a network share. 1-17
Install Team Workplace Stop the Catalog server s Domino server. In the Domino server console window, type quit and press ENTER. When the Domino server has completely stopped, the window disappears. Start the Team Workplace installation program (i.e., SETUP.EXE). 1. Software License Agreement screen Select Accept. 2. Welcome screen 3. Choose Destination Location screen The installation program should have correctly set the Destination Folder to the Domino program directory (e.g., C:\Lotus\Domino). If the directory is incorrect, click Browse and fix it. 4. Start Copying Files screen Review the choices you have made. Wait while the installation program copies files. 5. Team Workplace Server Configuration screen 6. Specify name and password screen Enter a user name (e.g., qpadmin). Enter a password. Reenter the password. Note This account is only for administration of the Team Workplace server. It cannot be used by a Virtual Classroom participant, moderator, or administrator. 7. Congratulations screen Leave the check box blank. Click Finish. Start the Domino server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). Wait until you see the following messages: QuickPlace Server started HTTP Web Server started 1-18 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
Install Virtual Classroom on the Catalog server Stop the Catalog server s Domino server. In the Domino server console window, type quit and press ENTER. When the Domino server has completely stopped, the window disappears. Start the Virtual Classroom installation program (i.e., SETUP.EXE). 1. Software License Agreement screen Read the license agreement. Click Accept. Note After installation is finished, you can find copies of the license agreement in various languages in the LVC\license folder (e.g., C:\Lotus\LVC\license). 2. Welcome screen 3. Type of Installation screen Keep the default setting of Catalog and Content Server. 4. Password for Administrator ID screen Enter the password for the initial Virtual Classroom administrator ID. 5. Domino server ID screen If the default value (C:\Lotus\Domino\Data\server.id) is not the full file name of your Domino server s ID file, correct it. 6. Catalog Server DNS Name screen Enter the fully qualified host name for the Catalog server (e.g., catalog.lotus.com). 7. Directory Type screen Did you follow the optional instructions to Configure Directory Assistance for access to an external LDAP directory server? NO: Keep the default setting of Local directory, used only by Virtual Classroom. YES: Select Corporate LDAP directory. In the Server name field, enter the fully qualified host name of the external LDAP directory server (e.g., ldap.example.com). In the Port number field, enter 389. Leave the User name and Password fields blank unless your external LDAP server requires them for access. 1-19
8. 9. E-mail Client screen Select the most common mail system your users use. 10. Start-up Method screen Select the method that matches the way the Domino server starts. Note You must start the Domino server and Virtual Classroom the same way either manually using the Start menu or automatically as a service. 11. Select Program Folder screen If you want, change the default folder name from Lotus Applications. 12. Start Copying Files screen Review the choice you have made. Wait while the installation program copies files to a new folder at the same level as the Domino Program Folder (e.g., C:\Lotus\LVC). 13. Setup Complete screen Click Finish. Start the Domino server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). Wait until you see the message HTTP Web Server started. Configure Team Workplace server settings Open a Web browser and follow these instructions The browser can be on the Catalog server (e.g., catalog.example.com), but does not have to be. 1. Go to http://<catalog.server.name>/quickplace (e.g., http://catalog.example.com/quickplace). 2. Click Sign In. 3. In the Login box, type the Team Workplace administrator s name you specified during the installation of Team Workplace (e.g., qpadmin). 4. In the Password box, type the password you specified during the installation of Team Workplace. 5. Click Server Settings. 6. Click User Directory. 7. Click either of the two Change Directory buttons. 1-20 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
8. In the Type box, select LDAP Server. Do this even if you do not have an external LDAP directory server. Note The Team Workplace server talks to the underlying Domino server s LDAP server task. 9. In the Name field, enter the fully qualified host name of the Catalog server (e.g., catalog.example.com). 10. Leave all of the other fields the way they are. 11. Click either of the two Next buttons. 12. Click Sign Out. 13. When the pop-up message asks Are you sure you want to sign out?, click OK. 14. When you see the Team Workplace Message You have successfully signed out of the place. To secure this browser before others use it, you should also clear the browser cache., close the browser. Note If you receive a Security Warning pop-up message asking if you want to install applets from Iris Associates and/or International Business Machines Corporation, click the Yes button. Optional: Configure Virtual Classroom for external LDAP directory server settings If you are using an external LDAP directory server, follow these instructions to configure Virtual Classroom on the catalog server to match the external LDAP directory server schema. The following table is a list of optional notes.ini variables that correspond with attribute values on an external LDAP directory server. It is only necessary to add these variables to the notes.ini file on the catalog server if your LDAP directory attributes do not match the default value listed in the table. 1-21
Sample LDAP user record for reference: dn: cn=john Doe,ou=R&D,o=Acme,c=US objectclass: person objectclass: organizationalperson objectclass: top ou: R&D o: Acme c: US cn: John Doe cn: John I. Doe cn: John givenname: John sn: Doe uid: jdoe acmeid: j005 mail: jdoe@acme.com 1-22 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
Notes.ini variable Description Example Attribute Names Default value $LVCLDAPUserPrefix=cn The LDAP user prefix appropriate dn: cn=john for your LDAP server Doe,ou=R&D,o=Acme,c=US $LVCLDAPUserSuffix=ou The LDAP user suffix appropriate dn: cn=john for your LDAP server Doe, ou=r&d,o=acme,c=us $LVCLDAPUserDisplayName The LDAP Display Name cn=john Doe =cn appropriate for your LDAP server givenname=john $LVCLDAPUserLogin=cn The LDAP Login Name cn=john Doe appropriate for your LDAP server uid=jdoe acmeid=j005 $LVCLDAPUserFirstName=c The LDAP User's First Name cn=john Doe n appropriate for your LDAP server $LVCLDAPUserLastName=sn The LDAP User's Last Name sn=doe appropriate for your LDAP server $LVCLDAPUserEmail=mail The LDAP email address mail=jdoe@acme.com appropriate for your LDAP server emailaddress=jdoe@acme.co m $LVCLDAPGroupPrefix=cn The LDAP group prefix cn=john Doe appropriate for your LDAP server $LVCLDAPGroupSuffix=ou= The LDAP group suffix cn=groups Groups appropriate for your LDAP server ou=groups $LVCLDAPUserObjectClass= The LDAP user object class objectclass=person person appropriate for your LDAP server objectclass=inetorgperson $LVCLDAPGroupObjectClass The LDAP group object class Objectclass=groupOfNames =groupofnames appropriate for your LDAP server objectclass=groupofunique Names $LVCLDAPGroupMember=m The LDAP group member attribute member=cn=john ember name appropriate for your LDAP Doe,ou=R&D,o=Acme,c=US server uniquemember=cn=john Doe,ou=R&D,o=Acme,c=US $LVCLDAPGroupMinimumA If a group contains more members ttributes=100 than the number defined in this variable, the user will not be allowed to add this group (performance considerations) $LVCLDAPUserMinimumAtt ributes=100 When searching for LDAP users, the user will be required to narrow their search criteria if the current search returns more results than the number defined in this variable (performance considerations) Note Some LDAP directories are case sensitive. All default LDAP attribute values are lowercase. If an LDAP directory is case sensitive, it will be necessary to add the notes.ini variable values in uppercase (ex, $LVCLDAPUserPrefix=CN). 1-23
Start Virtual Classroom on the Catalog server Restart the computer. If you set the Domino server and Virtual Classroom to start automatically when the computer starts, after you log in you should see the Domino server console and two additional command prompt windows: LVC Engine This window has an interactive command console. LVC Connector This window displays status messages. If you set the Domino server and Virtual Classroom to start manually, start Domino. Wait until you see the message HTTP server started. Start Virtual Classroom using the Start menu (Start.. Programs.. Lotus Applications.. Virtual Classroom.. Start Virtual Classroom). You should see four additional Command Prompt windows: LVC Engine This window has an interactive command console. LVC Connector This window displays status messages. LVC Server Manager (also known as the Net Manager) This window represents the communications layer. LVC Log Server This window displays the message log. 1-24 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
Install the additional Domino server On the Session server (e.g., session.example.com), start the Lotus Domino 6.5.2 installation program (i.e., SETUP.EXE). 1. Welcome screen 2. License Agreement screen Read the license agreement. Click Yes. 3. Name and Company name screen Enter your name and company name. Do NOT check Partitioned Server Installation. 4. Program Folder and Data Folder screen If you change the default Program Folder installation directory from C:\Lotus\Domino, do NOT specify the same directory for both the Program Folder and Data Folder. 5. Setup type screen Keep the default setting of Domino Enterprise Server. 6. Program Folder screen If you want, change the default folder name from Lotus Applications. Wait while the installation program copies files. When the installation is complete, click Finish. If you want, set the Domino server to start automatically when the computer starts: Start Services (for Windows NT, it s Start.. Control Panel.. Services; for Windows 2000, it s Start.. Programs.. Administrative Tools.. Services). Double-click Lotus Domino Server. Set the Startup type to Automatic. Click OK. Close Services. In the Domino Program directory (e.g., C:\Lotus\Domino directory), rename KVOOP.EXE to KVOOP.EXE-OFF. 1-25
When the follow message appears: If you change a file name extension, the file may become unusable. Are you sure you want to change it? Answer Yes. Set up the additional Domino server On the Session server (e.g., session.example.com), start the Lotus Domino Server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). The Server setup begins. 1. Lotus Domino is installed as a Windows service screen Choose how you want Domino to start. Click OK. 2. Welcome to Domino Setup screen. 3. First or additional server screen Select Set up an additional sever. 4. Where is the ID file for this additional Domino server screen Select The server ID is stored on a floppy disk, CD, or network drive. Click Browse to specify the path to the ID file. 5. 6. Provide the registered name of this additional Domino server screen Verify the hierarchical name for the Session server's Domino server (e.g., session/cetifiername). 7. What Internet services should this Domino server provide screen Select Web Browsers (HTTP services) and deselect the third option, Directory Services (LDAP services). 8. Domino network settings screen Click Customize... To modify your network settings. 9. Advanced network settings screen On the line for the TCPIP port, make sure the Net Address field contains the Session server's fully qualified domain name (e.g., session.example.com). Make sure TCP/IP is selected and the other check boxes are not selected. Make sure Port driver will be enabled is selected. Make sure the fully qualified Internet host name for this Domino server is correct (e.g., session.example.com. Click OK. Then click Next. 1-26 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
10. Provide the system databases for this Domino server screen In the Other Domino server name field, enter the hierarchical name of the catalog server's Domino server (e.g., catalog/certifier Name). In the optional network address field, enter the fully qualified domain name (e.g., catalog.example.com). Leave the default choices for all other entries. 11. Specify the type of Domino Directory for this server screen Select Set up as a primary Domino Directory. 12. Secure your Domino server screen Deselect Prohibit Anonymous access to all databases and templates and select Add LocalDomainAdmins group to all databases and templates. 13. Please review and confirm your chosen server setup options screen Click Setup. Domino proceeds with setup. 14. Setup summary screen. Click Finish. 15. Start the Domino server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). The Domino server console window (a Command Prompt window) appears. Wait until you see the message HTTP server started. 16. To force replication with the catalog server, click in the session server console window and type: replicate catalog/certifiername names.nsf where catalog/certifiername is the hierarchical name of the catalog server's Domino server. 1-27
Install Instant Messaging and Web Conferencing Stop the additional Session server s Domino server. Go to the Domino server console window, type quit and press ENTER. When the Domino server has completely stopped, the window disappears. Start the Instant Messaging and Web Conferencing installation program (e.g., Server\SETUP.EXE). 1. Software License Agreement screen Read the license agreement. Click Accept. 2. If you see the pop-up message Your machine has less than 512 MB of memory. It is recommended to run the Sametime server with a minimum of 512 MB of memory., click OK. Note The performance of the Sametime server will be poor if you have less than 1GB of memory. 3. Welcome screen 4. Question screen In response to the pop-up message An existing version of Domino was found at Domino Program Folder. Would you like to install Instant Messaging and Web Conferencing as part of Domino? If yes, make sure you stop the Domino server., click Yes. 5. Start Copying Files screen Review the choice you have made. Wait while the installation program copies files. 6. Installation Complete screen Click Finish. 7. Set Up on a Domino server screen Enter the full path to the Session server s Domino server ID (e.g., C:\Lotus\Domino\Data\session.id). 1-28 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
8. Select the Directory Type screen If you previously chose OPTION 1 to schedule replication, in the What type of directory do you want to use? field, keep the default setting of Domino Directory. If you previously chose OPTION 2 to configure Directory Assistance for access to an external LDAP directory server, in the What type of directory do you want to use? field, choose LDAP directory. In the LDAP Server Name field, enter the fully qualified host name of your external LDAP directory server. In the Port number for LDAP field, keep the default value of 389. 9. Sametime Server Connectivity screen If all of your participants will attend the online classes from within your corporate network, keep the check box empty for Allow HTTP Tunneling on a Sametime server with a single IP Address. Sametime services will listen on port 80. HTTP server will listen on port 8088. If any of your participants will be outside the corporate firewall and your network environment blocks TCP/IP port 1533, check the check box. 10. Will this Sametime server be used as a Enterprise Meeting Server? Screen Leave this check box unchecked. Wait while Sametime Server Setup configures some settings. 11. Setup Finished screen Click OK. Close the command window. Start the Domino server (Start.. Programs.. Lotus Applications.. Lotus Domino Server). Wait until you see the message Sametime Server: Running. (Please be patient.) 1-29
Install Virtual Classroom on the Session server Stop the Session server s Domino server. Go to the Domino server console window, type quit and press ENTER. When the Domino server has completely stopped, the window disappears. Start the Virtual Classroom installation program (i.e., SETUP.EXE). 1. Software License Agreement screen Read the license agreement. Click Accept. Note You can find copies of the license agreement in various languages in the LVC\license folder (e.g., C:\Lotus\LVC\license). 2. Welcome screen 3. Type of Installation screen Choose Session Server. 4. Domino Server ID screen If the default value (e.g., C:\Lotus\Domino\Data\session.id) is not the full file name of your Domino server s ID file, correct it. 5. Catalog Server Host Name screen Enter the short host name for the Catalog server (e.g., catalog). 6. DNS Name Enter the fully qualified host name for the Session server (e.g., session.example.com). 7. Start-up Method screen Select the method that matches the way the Domino server starts. Note You must start the Domino server and Virtual Classroom V1.1.2 the same way either manually via the Start menu or automatically as a service. 8. Select Program Folder screen If you want, change the default folder name from Lotus Applications. 1-30 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
9. Start Copying Files screen Review the choice you have made. Wait while the installation program copies files to a new folder at the same level as the Domino Program Folder (e.g., C:\Lotus\LVC). 10. Setup Complete screen Click Finish. Start Virtual Classroom on the Session server Restart the computer. If you set the Domino server and Virtual Classroom to start automatically when the computer starts, you should see the Domino server console and one additional command prompt window, the LVC Connector, which displays status messages. If you set the Domino server and Virtual Classroom to start manually, on the Session server, start the Domino server again (Start.. Programs.. Lotus Applications.. Lotus Domino Server). Wait until you see the message Sametime Server: Running. (Please be patient.) Start Virtual Classroom using the Start menu (Start - Programs - Lotus Applications.. Virtual Classroom.. Start Virtual Classroom). In addition to the Domino server console window, you should see one command prompt window, the LVC Connector, which displays status messages. Congratulations! You have now completed all of the installation tasks for Virtual Classroom. Accessing Virtual Classroom Open a Web browser on any computer. Go to the Learning Home at http://<catalog.server.name>/lvc(e.g., http://catalog.example.com/lvc). Login as: lvcadministrator The password is: XXX (where XXX is the password you specified when you installed Virtual Classroom on the catalog server. The password is case sensitive) Register participants, moderators, and, optionally, additional administrators. See Adding site administrators and Adding users in the Virtual Classroom Administrator's Help. 1-31
Notes Moderators and administrators are also participants. Only an administrator can promote participants to be moderators and/or additional administrators. An administrator can also demote users. Site Administrators have access to everything that's available to an administrator as well as the tools for managing servers, directory settings, and site settings. A site administrator can add another site administrator to Virtual Classroom and can also promote any registered user to site administrator by editing his or her profile. The lvcadministrator is the site administrator. A site administrator can also enableself-registration. For sites using an internal Virtual Classroom directory, this setting adds the New User button to the Please Sign In page. After you have at least one registered moderator, that user can: Create courses Develop outlines Schedule sessions Starting and stopping your Virtual Classroom deployment To start the Virtual Classroom deployment manually: 1. Start the Domino server on the Catalog server (e.g., catalog.example.com) with Start.. Programs.. Lotus Applications.. Lotus Domino Server. Wait until you see the message HTTP Web server started. 2. Start Virtual Classroom on the Catalog server with Start.. Programs.. Lotus Applications.. Virtual Classroom.. Start Virtual Classroom. 3. Start the Domino Server on the Session server (e.g., session.example.com) with Start.. Programs.. Lotus Applications.. Lotus Domino Server. Wait until you see the message Sametime Server: Running. (Please be patient.) 4. Start Virtual Classroom on the Session server with Start.. Programs.. Lotus Applications.. Virtual Classroom.. Start Virtual Classroom. To stop the Virtual Classroom deployment manually: 5. Stop Virtual Classroom on the Session server with Start.. Programs.. Lotus Applications.. Virtual Classroom.. Stop Virtual Classroom. A new Command Prompt window appears. Wait until both it and the Virtual Classroom window disappear. 1-32 IBM Lotus Virtual Classroom V1.1.2 Installation Guide
6. Stop the Session server s Domino server by going to the Domino server console window, typing quit, and pressing ENTER. When the Domino server has completely stopped, the window disappears. 7. Stop Virtual Classroom on the Catalog server with Start.. Programs.. Lotus Applications.. Virtual Classroom.. Stop Virtual Classroom. A new Command Prompt window appears. Wait until it and the four Virtual Classroom windows disappear. 8. Stop the Catalog server s Domino server by going to the Domino server console window, typing quit, and pressing ENTER. When the Domino server has completely stopped, the window disappears. 1-33
Chapter 2 Expanding Virtual Classroom This chapter contains important information that you should read before expanding your deployment of the Virtual Classroom. About this chapter This chapter provides information about the following: Supported configurations System requirements Installation procedures In addition, refer to Chapter 1 Installing Virtual Classroom and the online Help for information. Supported configurations You expand your deployment of Virtual Classroom V1.1.2 by adding an additional Session server (called session2.example.com in this document) to handle the workload of simultaneously scheduled course sessions. System requirements Each additional computer you add to the deployment must meet the server hardware and server software prerequisites for a Session server. The computer s configuration does not need to be identical to the existing computers, but they must be set to the same time zone and date/time format. Installation procedure Installation overview On the existing Catalog server (e.g., catalog.example.com), pre-register an additional Domino server (e.g., session2/certifiername). On the additional computer (e.g., session2.example.com): 1. Install Lotus Domino 6.5.2. 2. Install IBM Lotus Instant Messaging and Web Conferencing 6.5.1 (formerly Sametime). 3. Install Virtual Classroom V1.1.2 Session server. 4. (Optional) Set up Virtual Classroom for invited servers. 2-1