IBM G210-1784-00 - Manuals

Determining the correct SSO settings for the Learning Management System................................................................ 96 Chapter 19 Special Installation Issues ...................................................................................................99 Using SSL with the L...

Chapter 1 About the IBM Lotus Learning Management System Introduction This document provides information on the IBM® Lotus® Learning Management System installation process as well as information on packaging and layout. The intended audience for this document is system administrators, developers, an...

Relational database management system The Learning Management System stores user, course, and assessment data in a relational database, which consists of a series of tables. The database management software can reside on the same machine as the Learning Management System software for a small install...

Chapter 2 Learning Management System Requirements The Learning Management System is supported on a specific set of hardware and software components. Whether you are installing the Learning Management System for the first time on a server or upgrading from an earlier release of LearningSpace ® , you ...

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

Chapter 3 Learning Management System Installation Overview The following information provides an outline of the Learning Management System installation process. Packaging overview The functional components of the Learning Management System product are J2EE™ web applications. J2EE provides the packag...

Updater then creates two update SQL scripts - one for the Learning Management System server ( updateLMM.sql ) and one for the Delivery Server ( updateDS.sql ). These scripts are then run to change the respective databases. You can change settings through the user interface at any time. Since virtual...

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 factor in operating the Learning Management System. Many aspects of the Learning Management System operation require that directory path expressions be...

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 USER table and represents the only rostered user when the application starts. For more information, refer to “Chapter 9 Installing and configuring data...

For more information, refer to “Chapter 14 Deploying the Learning Management Server application “ and “Chapter 16 Deploying the Learning Management System and DS components onto separate WAS App Servers.” 12. Deploy the Learning Management System Delivery Server (DS) application The Learning Managem...

Chapter 4 Identifying Learning Management System Hardware Assets The Learning Management System can be installed on various types and configurations of servers. The expected capacity of the installation is the key factor in determining the requirements for servers. The install process described in t...

Learning Management System Hardware requirements For the most up-to-date hardware requirements, refer to the README.TXT file and the Release Notes shipped with this product. 12 IBM Lotus LMS Release 1 Installation Guide

Chapter 5 Installing the WebSphere Core To successfully run the Learning Management System, you are required to have the WAS (WebSphere Application Server) Core installed on the desired systems. This can be a single server or multiple servers. The following instructions explain how to install this c...

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 installer completes, the First Steps window will open. Select “Verify Installation” to launch the Installation Verification Tool (IVT). Its output will b...

• Expand the Security panel on the left side. • Expand Authentication Mechanisms. • Click LTPA. • Enter the password for LTPA (for example, wasadmin ) • Click Save. • On the LTPA panel, click Single Sign On at the bottom of the panel. • Check that SSO is enabled. • Enter the domain name (for example...

Chapter 6 Installing or Identifying the LDAP Directory The Learning Management System requires an LDAP directory for product operation. Either an IBM Directory Server 4.1 directory is installed or configured, or a pre-existing LDAP directory is identified. Also, at least two user-names that are reco...

• 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, ensure that all three options are selected, and then click Next. 11. If you elected to install the IBM HTTP server, enter a user id, password, and passwor...

• Click Update. You should see your suffix appear in the list of suffixes known to the directory server. Note: The Web administration interface for Directory Server is also not supported on Linux. Refer to the Special Installation Issues chapter in this guide for a workaround for this issue. 4. Rest...

Creating WebSphere and Learning Management System Administrator Accounts You need at least two accounts in the LDAP directory to complete the installation of the IBM Lotus Learning Management System: an account for the WebSphere administrator and an account for the Learning Management System adminis...

Chapter 7 Installing the Learning Management System Server Application Files Before deploying the complete Learning Management System, the Learning Management System Server files should first be installed on the Application Server. Note: If you are installing and deploying the Learning Management Sy...

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 applications to different machines. Since some of the settings are used for both the Learning Management System Server and Delivery Server (LDAP settings...

Note: The text on the LDAP Settings screen is incorrect; instead of "LDAP User ID" it should read "LDAP User Distinguished Name (DN)." • LDAP Password – Enter the password used for accessing and further authenticating you to the LDAP provider. • LDAP Provider – Select the LDAP provid...

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. During the install of the DS Server, the Learning Management System username and password is asked again. Make sure that you provide there the same Lear...

Select the Administrator settings 15. Select the Administrator Role Type for the Learning Management System Server. User is the default value. If you select the User setting, enter the corresponding Administrators LDAP User ID. An example of this user name is: jsmith. 16. If you wish to have Group a...

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 directory. • FTP User Name for Deploying Content – Enter a user name for accessing the FTP server(s) that will manage course content. This is the account t...

22. Click Next to install the Learning Management System Server software as specified by your selected options. A Progress screen will let you monitor the progress being made while the Learning Management System installs. 23. Enter the appropriate information in the product Registration screen as th...

Chapter 8 Installing the Delivery Server (DS) Application Files Before deploying the complete system, the Delivery Server files should first be installed on the Application Server. Note: If you are installing and deploying the Learning Management System Server and the Delivery Server onto separate W...

Installing the Delivery Server application software 1. Start the Installer. 2. At the Language Selection Installer screen, select the language to be used by the Installer from the drop down list. 3. Click OK to continue. 4. At the Welcome screen, click Next. 5. Read the license agreement and click A...

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 Test LDAP Connection button. If you have entered valid settings you will receive a message box stating that you have a successful connection otherwise you will b...

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 to enter all the necessary information for accessing the Delivery Server. Select the Delivery Server settings 15. Enter the following Delivery Server Settin...

16. Click Next to continue. You are now shown the Web Server Settings screen. Select the Web Server settings 17. Enter the following Web Server Settings for your server configuration. These settings provide the basic information about the Web Server used for deploying course content. All of these fi...

18. Click Next to continue. You are now shown the Content Deployment Settings screen. This screen lets you define the content deployment servers. For any server you can choose between FTP and File system as a deployment type. If you choose FTP, then the Content Manager will deploy content to the FTP...

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 section below to continue with the installation instructions. Select the Content Deployment settings for file system deployment 23. If you selected File...

Select the installation destination and complete the installation 27. Click Next to install the Delivery Server to the default directory or click Browse to select and install to a different directory. 28. Before the installation begins you are shown a Summary screen displaying all of your selected i...

Chapter 9 Installing and Configuring Database Servers and Schema The Learning Management System requires a number of different logical database schemas to function. These are the following: • LMM database – this database resides on the Learning Management System Server and stores all information abo...

Be sure to follow your database software’s guidelines for sizing the installation and configuring an efficient physical architecture for the database. You may need to take extra action, for example, to create separate table spaces. You may also need to edit the provided database scripts before execu...

This specifies the maximum number of open files, system-wide, to 32K. Database creation details The following procedures provide detailed instructions on installing and creating the necessary DB2 databases for use with the Learning Management System: Creating an Audit database 1. Copy the script fil...

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 database named lmm , and creates the buffer pools required for any Learning Management System schema. 5. If desired, edit the lmm_db2.sql script for file...

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 you whether the installation was successful. 7. Highlight OK when finished and click Enter. 8. If errors are found check the DB2 error log on /tmp. Us...

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_INSTALL_PATH/java12/usejdbc2 where /$DB2_INSTALL_PATH is the actual path where DB2 is installed on the machine, NOT an environment variable. Note: You shoul...

9. Enter the Database alias (for example, Learning2). 10. Click Next. 11. Unselect Register this database for ODBC and click Next. 12. Click Next on Step for Add Database Wizard. 13. Check Configure security options and click Next. 14. Click Finish and test your connection. 15. Repeat for this proce...

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 cr_oraown_aud.sql script and then running it. . (The script actually creates two users: lmm, which designates the database owner, and lmm_app, which you...

• 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 is the server alias you created with the “client network utility.” • The “-e” option should be omitted unless you are debugging installation problems. •...

• 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 have been provided. There is one script for each database. These files should be read and edited before executing them. • Both the DOS and UNIX scripts have...

Chapter 10 Installing the Network Deployment (ND) Module You are required to have the WAS (WebSphere Application Server) Core installed on the desired systems. This can be a single server or multiple servers. If multiple servers are used, you must install the Network Deployment module. The Network D...

13. Enable SSO by doing the following: • Expand the Security panel on the left side. • Expand Authentication Mechanisms. • Click LTPA. • Enter the password for LTPA (for example, wasadmin ). • Click Save. • On the LTPA panel, click Single Sign On at the bottom of the panel. • Check that SSO is enabl...

The following provides a graphical representation of the WAS nodes, servers, and applications when WAS Core and Network Deployment (ND) are deployed on the same machine: Single Physical Host *server1 will still be present (but should NOT be started) if y ever D. a WAS Base node was migrated to ND af...

Chapter 11 Configuring JDBC Data Sources After the WebSphere Application Server (WAS) is installed, but before the Learning Management System application is deployed, resources must be configured. There are two types of resources that apply to the Learning Management System: • environment entries • ...

Defining the JDBC provider The first step is to define the overall JDBC Provider. This corresponds to the specific driver and database vendor. Defining the JDBC provider for a DB2 database In the following example, you are shown how to configure a provider named “DB2 JDBC Provider.” This provider is...

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 OK to continue. Chapter 11: Configuring JDBC Data Sources 55

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 Admin console, navigate to Environment -Manage WebSphere Variables and locate the variable referenced by the classpath in the JDBC Providers Configuratio...

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 LMM and DS. If you don't have the MSSQL jars, you can get them from the Microsoft site. The URL for the SP2 drivers is: http://www.microsoft.com/downlo...

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. 4. Click Browse Nodes. 5. Select Node. 6. Click Apply. The changes will apply only at the node level. 7. Click New. 8. From the JDBC providers drop down...

13. Enter the following information: • Name: dbname (for example, lmm, ds, audit) • JNDI name: jdbc/ dbname • Statement Cache Size: 0 • Component-managed Authentication Alias: $hostnameManager/ db_name • Container -managed Authentication Alias: $hostnameManager/ db_name 14. Click Apply. 15. Change t...

• 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 on Custom Properties. 4. Depending on the database type you may change the following properties. The entries presented are for example purposes only. • D...

• The databaseName property has been selected and you are shown the following screen to change this custom property. This property provides the database alias used when cataloging the remote database. The value used in the following example for databaseName is “lmm.” • For Oracle databases, you may ...

Chapter 12 Configuring Environment Entries After the WebSphere Application Server (WAS) is installed, but before the Learning Management System application is deployed, resources must be configured. There are two types of resources that apply to the Learning Management System: • environment entries ...

2. Enter the provider information a. Enter the name, for example, “LMS Provider,” and an optional description for the provider. b. Click OK. A new provider appears in the list of defined providers. 64 IBM Lotus LMS Release 1 Installation Guide

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 details. 4. Configure the Referenceable Before environment-entries can be made, a Referenceable must be defined. A Referenceable is a class of object that is...

c. For Factory Classname, enter com.lotus.elearn.naming.StringObjectFactory. d. For Classname, enter java.lang.String. e. Click OK. 5. Configure the Resource Environment entries After the Referenceable has been defined, the specific environment entries need to be defined. a. Go back to the Provider ...

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 bring you back to the Env-Entries list page. You now need to define properties for the new entry. Chapter 12: Configuring Environment Entries 67

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 Management System should store application log files, for example, C:\lms_logs. Note: You need to create this directory by hand as the application won’t ...

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 Name to LMS_FALSE. 19. Click OK. 20. Click LMS_FALSE. 21. Click Custom Properties. 22. Click New. 23. Set Name to value. 24. Set Value to false. 25. Click ...

Configure the LDAP directory for use with the Learning Management System The following steps show how to configure WAS security to use an LDAP directory: 1. Launch the WAS Administrative Console and go to Security - User Registries. 2. Click on the LDAP link. The LDAP User Registry page is displayed...

Enable WAS Global Security 1. Launch the WAS Administrative Console and go to Security – Global Security. 2. Check the Enabled checkbox and (if it isn’t automatically checked when security is enabled) the Enforce Java 2 Security checkbox. 3. Assuming that you followed the steps for enabling Single S...

Chapter 14 Deploying the Learning Management System Server Application A pplication deployment refers to the process where an application package has been installed and is then configured on an application server to create a running instance of that application. The important unit of packaging in th...

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 “Preparing for application installation” screen is displayed. You can make selections here that change how the next steps are performed. You should accept the d...

3. Provide options to perform the installation At the next screen, select some options for the application deployment; for example you can pre-compile all JSPs. With the exception of the Application Name, accept the defaults. Caution The Application Name should not include spaces, because the Learni...

4. Map resources references to resources At the following screens, you map the resource references that are specified in the .ear file to actual resources you configured in WAS. Check the first entry for the Learning Management System data (jdbc/LMS_Default) and select “jdbc/lmm” from the “Specify e...

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 data source referenced in the .ear file, an entry is displayed. Clicking the IBM Lotus Learning Management System checkbox and then specifying select “jd...

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 servers. For example, by default, the server runs the admin host on port 9090 and the default host on port 9080. Accept the default value. When finished...

8. Map security roles to users/groups In this step, map references to security roles in the application to specific user registry groups or application server special subjects. The .ear file already contains a default security binding. Accept the default value (ALL_AUTHENTICATED) by clicking Next to...

9. View summary and confirmation information When you have completed these steps, you are shown a summary of the options you have selected. Review them and if they are correct, click Finish to continue. 82 IBM Lotus LMS Release 1 Installation Guide

The application performs some final processing to finalize all the selections. Status information on this process is printed to the console. When complete processing is complete, you are presented with a link to save the new configuration. It is recommended you perform the Save at this time. 10. Sta...

Chapter 15 Deploying the Delivery Server (DS) Application For complete information on the process of deploying the Delivery Server application portion of the Learning Management System installation, follow the same steps outlined in “Chapter 14 Deploying the Learning Management System Server applica...

Chapter 16 Deploying the Learning Management System and DS Components onto Separate WAS Application Servers By default, new Application Servers created in the WAS Admin Console generate their own unique HTTP ports. WAS assigns ports incrementally, beginning with port 9080, which is usually assigned ...

1. In the WAS Admin Console, navigate to Servers and click on Application Servers. 2. Click on the Application Server. 3. In the Application Server’s screen, click Web Container. 4. In the Web Container screen, click on HTTP Transports. 5. In the HTTP Transports screen, click on the asterisk associa...

Chapter 17 Starting the Applications At this point, the Learning Management System applications are ready to start. The WAS admin console is used to start these applications. Both the WAS logs and Learning Management System logs should be examined to verify correct initialization. At this point, the...

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 displays the About box. Regenerating the web server plug-in With J2EE servers such as WebSphere, high-volume deployments (such as the Learning Management...

Chapter 18 Post-Installation Tasks After you have installed the Learning Management System, there are other tasks that must be completed to make full use of your installation. These include the following: • Configuring on-line help • Adding the Delivery Server to the Learning Management System appli...

Deploying the Offline Learning Client The Learning Management System allows students to take courses without being connected to the network. When working on a course offline, all course prerequisites and navigation features are fully functional for the student. The Offline Learning Client lets you a...

CLIMP allows you to import SCORM 1.2 course package files into the Learning Management System, making them available for deployment. Course package files can contain new courses, or updates to previously-deployed courses. Course packages are created by content vendors using the Learning Management S...

# 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 different run-level, be sure to match it when you set up the soft link in the next step. 6. Create soft link: ln -s /etc/init.d/xvfb /etc/rc3.d/S75xvfb This ex...

Chapter 19 Special Installation Issues For information on special issues related to this release of the Learning Management System, refer to the ReadMe.html and ReleaseNotes.html files that ship with this version of the product. Using SSL with the Learning Management System Use of the Secure Sockets...

Chapter 20 Removing the IBM Lotus Learning Management System The Learning Management System does not include an automated uninstall program. To remove the Learning Management System component technologies (IBM Directory Server, IBM DB2 7.2, and IBM WebSphere Application Server 5), use the Windows Ad...

Appendix A LMS Performance and Fine-tuning Information This chapter discusses post-installation tasks related to the running, maintenance, and fine-tuning of LMS operations. These tasks are not necessary to get LMS running, but are recommended for improving and correcting system performance. The app...

5. Edit the WebSphere plug-in configuration file ( plugin-config.xml ) and search for the following line: <Uri AffinityCookie="JSESSIONID" Name="/lms-lmm/*"/> Replace this line by the following lines: <Uri AffinityCookie="JSESSIONID" Name="/lms-lmm"/> <...

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

4. There are several user attributes that are used quite often when searching for users (first name, last name, organization, etc.). For a faster response, you can index these attributes in the LDAP server’s database. Indexing LDAP attributes Every vendor provides different ways on how to index the ...

• IBM DB2 tuning parameters: WebSphere Application Server http://publib7b.boulder.ibm.com/wasinfo1/en/info/ae/ae/rprf_db2parameters.html • IBM Redbook SG24-6417: DB2 UDB/WebSphere Performance Tuning Guide http://publib-b.boulder.ibm.com/Redbooks.nsf/RedbookAbstracts/SG246417.html • IBM Redbook SG24-...

TcpNumConnections This parameter defines the maximum number of simultaneous TCP connections and should be set higher than the expected number of simultaneous connections. Recommended value: 150-200% of your expected number of concurrent users Note: Instead of using the registry editor, you can creat...

Sun Solaris servers Adjust the following TCP/IP parameters to tune performance in Solaris: tcp_time_wait_interval This parameter tells Solaris how long in milliseconds to keep a socket that was closed before releasing it for re-use. Recommended value: 30000 (= 30 seconds) To see the current value, u...

Tuning the Sun ONE Web server, Enterprise Edition - Solaris The default configuration of the Sun ONE Web server, Enterprise Edition provides a single-process, multi-threaded server. Adjusting the Active Threads parameter After the server reaches the limit set with this parameter, the server stops se...

Use the registry editor to set the ListenBackLog parameter located at: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\InetInfo\Parameters\ListenBackLog The recommended value is 200. MaxPoolThreads and PoolThreadLimit parameter The MaxPoolThreads parameter controls the number of threads per CPU...

• Time per request When testing different parameter settings for the httpd.conf, use these values to compare and find the best configuration setting for your system. MaxRequestsPerChild The MaxRequestsPerChild directive sets the limit on the number of requests that an individual child server process...

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 with a size of 100, then increase as necessary. An HTTP error message of type 503 (a refused connection) is a good indicator for the need to increase the...

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_directory/conf . 2. Change the value of the parameter. 3. Save the changes and restart the IBM HTTP server. The recommended value is 250000. HTTP Logging Th...

• Web container thread pool • Web container MaxKeepAliveConnections • Web container MaxKeepAliveRequests • JDBC Data Source Connection Pool size • JDBC Data Sources properties (to correct content deployment issues) Adjusting JVM Heap size The JVM heap size parameter specifies how often and how long ...

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 compiler When a JVM JIT (Just-In-Time) compiler is present and enabled, the Java Virtual Machine performs differently. After reading in a .class file for in...

• 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 planned for the LMS server. Use the maximum thread size parameter to specify the maximum number of threads that can be pooled to handle requests sent to th...

Adjusting the JDBC Data Source Connection Pool size When accessing any database, the initial database connection is an expensive operation. Connection pooling and connection reuse reduces the number of these operations significantly. Only two parameters should be changed here: Min connections and Ma...

• Set the Logging level to warn Tracking Log: • Click Settings - LMM Server - System Logging - Tracking Log • Set the Logging level to warn Archiving the LMS log files LMS log files should be archived on regular basis. Otherwise, the files could continue to grow until no space is left on the hard dr...

Oracle PROCESSES Parameter (Oracle server only) This parameter must be changed on the Oracle server. Increasing this parameter from the default value of 150 to 600 can improve performance. Use the following procedures to change this parameter. 1. Find the SPFILEORACLE.ORA file on the Oracle server. ...

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, 89 Authoring Tool, 93 Authoring Tool installing, 93 Command Line Import Utility (CLIMP), 93 installing, 93 database creation and configuration, 38 data...