IBM G210-1784-00 User Manual

Lotus®Learning Management System R1Installation Guide Version 1.0.4 March 2004 G210-1784-00 

Chapter 2 Learning Management System Requirements The Learning Management System is supported on a specific set of hardware and software components.

Deploying the Offline Learning Client The Learning Management System allows students to take courses without being connected to the network. When wor

CLIMP allows you to import SCORM 1.2 course package files into the Learning Management System, making them available for deployment. Course package fi

• If you don't have this file, proceed with step 2. 2. Download the XVFB file from the following link to a directory on the Linux machine: ftp

# 5 - X11 # 6 - reboot (Do NOT set initdefault to this) # id:5:initdefault: Change id:5:initdefault: to id:3:initdefault: Note: If you use a differe

Management System and SSO refer to Chapter 5 Managing Users in the Administrator's Guide and the Installing the WebSphere Core chapter in this gu

98 IBM Lotus LMS Release 1 Installation Guide

Chapter 19 Special Installation Issues For information on special issues related to this release of the Learning Management System, refer to the Read

100 IBM Lotus LMS Release 1 Installation Guide

Chapter 20 Removing the IBM Lotus Learning Management System The Learning Management System does not include an automated uninstall program. To remo

102 IBM Lotus LMS Release 1 Installation Guide

Client hardware requirements For the most up-to-date client hardware requirements, refer to the README.TXT file and the Release Notes shipped with thi

Appendix A LMS Performance and Fine-tuning Information This chapter discusses post-installation tasks related to the running, maintenance, and fine-t

5. Edit the WebSphere plug-in configuration file (plugin-config.xml) and search for the following line: <Uri AffinityCookie="JSESSIONID"

<Uri AffinityCookie="JSESSIONID" Name="/lms-ds/*.jsv"/> <Uri AffinityCookie="JSESSIONID" Name="/lms-ds/*.j

4. There are several user attributes that are used quite often when searching for users (first name, last name, organization, etc.). For a faster res

• IBM DB2 tuning parameters: WebSphere Application Server http://publib7b.boulder.ibm.com/wasinfo1/en/info/ae/ae/rprf_db2parameters.html • IBM Redbo

TcpNumConnections This parameter defines the maximum number of simultaneous TCP connections and should be set higher than the expected number of simul

Sun Solaris servers Adjust the following TCP/IP parameters to tune performance in Solaris: tcp_time_wait_interval This parameter tells Solaris how lon

Tuning the Sun ONE Web server, Enterprise Edition - Solaris The default configuration of the Sun ONE Web server, Enterprise Edition provides a single-

Use the registry editor to set the ListenBackLog parameter located at: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InetInfo\Parameters\Listen

• Time per request When testing different parameter settings for the httpd.conf, use these values to compare and find the best configuration setting

Chapter 3 Learning Management System Installation Overview The following information provides an outline of the Learning Management System installati

2. Change the value of the parameter by starting with 100. 3. Save the changes and restart the IBM HTTP server. The recommended method is to start w

Use the following procedure to change this parameter: 1. Edit the IBM HTTP Server file httpd.conf located in the directory IBM_HTTP_Server_root_direc

• Web container thread pool • Web container MaxKeepAliveConnections • Web container MaxKeepAliveRequests • JDBC Data Source Connection Pool size •

2. View or adjust the Maximum Heap Size and set the Initial Heap Size to the same value. 3. Stop and re-start the application. Enabling the JIT comp

• Maximum size - Specifies the maximum number of threads to allow in the pool. This value should be set to 50% of the number of concurrent users plan

Adjusting the JDBC Data Source Connection Pool size When accessing any database, the initial database connection is an expensive operation. Connection

• Set the Logging level to warn Tracking Log: • Click Settings - LMM Server - System Logging - Tracking Log • Set the Logging level to warn Archiv

Oracle PROCESSES Parameter (Oracle server only) This parameter must be changed on the Oracle server. Increasing this parameter from the default value

Appendix A: LMS Performance and Fine-tuning Information 121

Index Application Servers deploying Learning Management System components to separate, 87 applications starting, 89 starting from WAS Admin console, 8

Updater then creates two update SQL scripts - one for the Learning Management System server (updateLMM.sql) and one for the Delivery Server (updateDS.

regenerating, 90 WebSphere, 13, 41 WebSphere Application Server security, 71 configuring, 71 WebSphere Core installing, 13 XVBF installing, 94 Index

Printed in USA

the WebSphere and the Learning Management System administrator (who may be one and the same person). The organization of the LDAP directory is a key f

At this time you should also identify the LDAP username for the Learning Management System administrator. This value is used to make an entry in the U

For more information, refer to “Chapter 14 Deploying the Learning Management Server application “ and “Chapter 16 Deploying the Learning Management Sy

10 IBM Lotus LMS Release 1 Installation Guide

Chapter 4 Identifying Learning Management System Hardware Assets The Learning Management System can be installed on various types and configurations

Learning Management System Hardware requirements For the most up-to-date hardware requirements, refer to the README.TXT file and the Release Notes sh

Copyrights Disclaimer THIS DOCUMENTATION IS PROVIDED FOR REFERENCE PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF T

Chapter 5 Installing the WebSphere Core To successfully run the Learning Management System, you are required to have the WAS (WebSphere Application

5. For Windows users, choose to run both WebSphere Application Server and IBM HTTP Server as services. 6. Do not register the product. 7. Once the

• Expand the Security panel on the left side. • Expand Authentication Mechanisms. • Click LTPA. • Enter the password for LTPA (for example, wasadm

16 IBM Lotus LMS Release 1 Installation Guide

Chapter 6 Installing or Identifying the LDAP Directory The Learning Management System requires an LDAP directory for product operation. Either an IB

• DB2 V7.2 (if necessary) • GSKit5 • IBM HTTP Server 1.3.19 (if necessary) 9. Click Next. 10. In the ‘Select the components to configure’ window,

• Click Update. You should see your suffix appear in the list of suffixes known to the directory server. Note: The Web administration interface for D

Creating WebSphere and Learning Management System Administrator Accounts You need at least two accounts in the LDAP directory to complete the installa

Chapter 7 Installing the Learning Management System Server Application Files Before deploying the complete Learning Management System, the Learning M

Note: You can install the Learning Management System Server and Delivery Server application files at the same time, even if you plan to deploy the app

Netscape and Netscape Navigator are registered trademarks of Netscape Communications Corporation in the United States and other countries. Oracle is a

Note: The text on the LDAP Settings screen is incorrect; instead of "LDAP User ID" it should read "LDAP User Distinguished Name (DN).&

communicates with the Delivery Server. The user name and password are arbitrary: they don’t need to identify an actual user in your LDAP directory. Du

Select the Administrator settings 15. Select the Administrator Role Type for the Learning Management System Server. User is the default value. If yo

packages will be stored on the LMM server in the specified directory without adding the LMM's ear file installation path to the beginning of the

22. Click Next to install the Learning Management System Server software as specified by your selected options. A Progress screen will let you monito

28 IBM Lotus LMS Release 1 Installation Guide

Chapter 8 Installing the Delivery Server (DS) Application Files Before deploying the complete system, the Delivery Server files should first be insta

Installing the Delivery Server application software 1. Start the Installer. 2. At the Language Selection Installer screen, select the language to be

10. After you have entered all of the LDAP settings, validate them to make sure they are correct. 11. To test these settings, click on the Tes

14. Click Next to continue after you have entered all of the settings. You are now shown the Delivery Server Definition screen. Use this screen

Contents Chapter 1 About the IBM Lotus Learning Management System...1 Introduction ...

16. Click Next to continue. You are now shown the Web Server Settings screen. Select the Web Server settings 17. Enter the following Web Serve

18. Click Next to continue. You are now shown the Content Deployment Settings screen. This screen lets you define the content deployment serv

22. Click Next to continue when you have added all of your servers. You are now shown the System Administrator E-mail Settings screen. Skip to that s

Select the installation destination and complete the installation 27. Click Next to install the Delivery Server to the default directory or click Br

Chapter 9 Installing and Configuring Database Servers and Schema The Learning Management System requires a number of different logical database schem

Be sure to follow your database software’s guidelines for sizing the installation and configuring an efficient physical architecture for the database.

set msgsys:msginfo_msgmap=0x102 set msgsys:msginfo_msgmni=0xFF set msgsys:msginfo_msgssz=0x10 set msgsys:msginfo_msgtql=0x400 set shmsys:shminfo_shmm

This specifies the maximum number of open files, system-wide, to 32K. Database creation details The following procedures provide detailed instructions

4. Open an DB2 command window and run the cr_db2db_lmm.bat or cr_db2db_lmm.sh file. For example: cr_db2db_lmm.bat > lms_db.log. This creates a dat

5. Create a password for db2inst1. 6. Select OK. The installation may take up to 15 minutes. When installation has completed a notice window informs

DB2 database creation and configuration for the Learning Management System: an example...38 Oracle database creation f

1. Log in as the DB2 instance owner (for example, db2inst1). 2. Type cd $HOME/sqllib 3. Add the following line to the file userprofile: . /$DB2_IN

9. Enter the Database alias (for example, Learning2). 10. Click Next. 11. Unselect Register this database for ODBC and click Next. 12. Click Next

sqlplus lmm/lmm@<database> @lmm_oracle.sql Creating an Audit schema 1. Create a user to be the database owner. You can do this by editing the

• The “-S” server name option can be omitted if the script is being run on the database server itself. • The name that you will give for the server

• To meet the need for UNIX script files for DB2 that accomplish the same thing that the provided DB2 DOS batch files do, ".sh" scripts hav

48 IBM Lotus LMS Release 1 Installation Guide

Chapter 10 Installing the Network Deployment (ND) Module You are required to have the WAS (WebSphere Application Server) Core installed on the desir

13. Enable SSO by doing the following: • Expand the Security panel on the left side. • Expand Authentication Mechanisms. • Click LTPA. • Enter t

The following provides a graphical representation of the WAS nodes, servers, and applications when WAS Core and Network Deployment (ND) are deployed o

52 IBM Lotus LMS Release 1 Installation Guide

Determining the correct SSO settings for the Learning Management System...96 Chapter 19 S

Chapter 11 Configuring JDBC Data Sources After the WebSphere Application Server (WAS) is installed, but before the Learning Management System applica

Defining the JDBC provider The first step is to define the overall JDBC Provider. This corresponds to the specific driver and database vendor. Defini

4. Click OK to continue. 5. At the Configuration - General Properties screen for the JDBC Provider, note the value in the Classpath field and click

The classpath uses an environment variable that must be verified or set. Use the following procedure to do this: • From the starting screen of the Ad

Defining the JDBC provider for a SQL Server database 1. Install SQL Server 2000 Driver for JDBC Service Pack 2 on the WAS node(s) that will host the

Create the data sources 1. Expand Resources on the WAS console left panel. 2. Click JDBC Providers. 3. On the right panel, erase the entry on Node.

13. Enter the following information: • Name: dbname (for example, lmm, ds, audit) • JNDI name: jdbc/dbname • Statement Cache Size:

• Click Apply. 16. Repeat this procedure for the two remaining databases. 60 IBM Lotus LMS Release 1 Installation Guide

Change the Custom Properties for each data source depending on the database type 1. Go to Data Sources. 2. Click on the desired db_name. 3. Click o

• The databaseName property has been selected and you are shown the following screen to change this custom property. This property provides the datab

vi IBM Lotus LMS Release 1 Installation Guide

Chapter 12 Configuring Environment Entries After the WebSphere Application Server (WAS) is installed, but before the Learning Management System appl

2. Enter the provider information a. Enter the name, for example, “LMS Provider,” and an optional description for the provider. b. Click OK

3. Enter the provider details a. Click the name of the newly entered provider to go to the details page of that provider. b. Enter the desired detai

c. For Factory Classname, enter com.lotus.elearn.naming.StringObjectFactory. d. For Classname, enter java.lang.String. e. Click OK. 5. C

c. Click New to go to the page to define an entry. Enter LMS_LOG as both the name and JNDI name for the new entry. d. Click OK. This will bri

e. Click that link and define a new Custom Property with the name LMS_LOG_PATH . For the value, enter the name of the directory where the Learning Ma

13. Set Value to true. 14. Click OK 15. Click the Resource Env Entries link in the trail. 16. Click New. 17. Set Name to LMS_FALSE. 18. Set JNDI

70 IBM Lotus LMS Release 1 Installation Guide

Chapter 13 Configuring WebSphere Application Server Security The Learning Management System assumes that the WebSphere Application Server (WAS) is co

Configure the LDAP directory for use with the Learning Management System The following steps show how to configure WAS security to use an LDAP direct

Chapter 1 About the IBM Lotus Learning Management System Introduction This document provides information on the IBM® Lotus® Learning Management Syste

12. Click Apply. Note that a Message(s) section appears at the top of the page and indicates that you’ll need to Save these changes. 13. Click the A

Enable WAS Global Security 1. Launch the WAS Administrative Console and go to Security – Global Security. 2. Check the Enabled checkbox

Chapter 14 Deploying the Learning Management System Server Application Application deployment refers to the process where an application package has

2. Prepare for application install It sometimes takes a few minutes for WAS to read and validate an .ear file. When this has completed, the “Preparin

3. Provide options to perform the installation At the next screen, select some options for the application deployment; for example you can pre-compil

4. Map resources references to resources At the following screens, you map the resource references that are specified in the .ear file to actual reso

This list is populated with the names of data source definitions that have been defined and lets you resolve JDBC data source references. For each dat

6. Map virtual hosts to web modules In this step, you map web modules to different virtual hosts. The application server can run multiple, separate s

8. Map security roles to users/groups In this step, map references to security roles in the application to specific user registry groups or applicati

9. View summary and confirmation information When you have completed these steps, you are shown a summary of the options you have selected.

Relational database management system The Learning Management System stores user, course, and assessment data in a relational database, which consists

The application performs some final processing to finalize all the selections. Status information on this process is printed to the console. When co

84 IBM Lotus LMS Release 1 Installation Guide

Chapter 15 Deploying the Delivery Server (DS) Application For complete information on the process of deploying the Delivery Server application portio

86 IBM Lotus LMS Release 1 Installation Guide

Chapter 16 Deploying the Learning Management System and DS Components onto Separate WAS Application Servers By default, new Application Servers creat

1. In the WAS Admin Console, navigate to Servers and click on Application Servers. 2. Click on the Application Server. 3. In the Application Serve

Chapter 17 Starting the Applications At this point, the Learning Management System applications are ready to start. The WAS admin console is used to

7. To verify that the Delivery Server is running properly, you can enter the following URL in a browser: http://xyz.acme.com/lms-ds/about.ds. This di

Chapter 17: Starting the Applications 91

Chapter 18 Post-Installation Tasks After you have installed the Learning Management System, there are other tasks that must be completed to make full