Page 2 - Copyrights; Disclaimer; All rights reserved.; List of Trademarks
Copyrights Disclaimer THIS DOCUMENTATION IS PROVIDED FOR REFERENCE PURPOSES ONLY. WHILE EFFORTS WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THIS DOCUMENTATION, THIS DOCUMENTATION IS PROVIDED "AS IS" WITHOUT ANY WARRANTY WHATSOEVER AND TO THE MAXIMUM EXTE...
Page 4 - Contents; Table of Contents iii
Contents Chapter 1 About the IBM Lotus Learning Management System ............................................................1 Introduction ..................................................................................................................................................................
Page 5 - iv IBM Lotus LMS Release 1 Installation Guide
DB2 database creation and configuration for the Learning Management System: an example................................... 38 Oracle database creation for the Learning Management System ..................................................................................... 44 MS SQL Server database cre...
Page 6 - Table of Contents v
Determining the correct SSO settings for the Learning Management System................................................................ 96 Chapter 19 Special Installation Issues ...................................................................................................99 Using SSL with the L...
Page 7 - vi IBM Lotus LMS Release 1 Installation Guide
Page 8 - Learning Management System components; Chapter 1: About IBM Lotus Learning Management System 1
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...
Page 9 - Relational database management system; IBM Lotus LMS Release 1 Installation Guide
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...
Page 10 - System can function on that machine.; Database server requirements; Hardware requirements; Collaboration servers may use different time zones; Learning Management System client requirements; Chapter 2: LMS System Requirements 3
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 ...
Page 11 - 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 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...
Page 12 - Packaging overview; Chapter 3: LMS Installation Overview 5
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...
Page 13 - An outline of the installation process; Identify hardware assets; Oracle; Install WebSphere core; IBM Lotus LMS Release 1 Installation Guide
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...
Page 14 - Chapter 3: LMS Installation Overview 7
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...
Page 15 - files for the Learning Management System Server and the; IBM Lotus LMS Release 1 Installation Guide
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...
Page 16 - Start the applications; Administrator’s Guide; Chapter 3: LMS Installation Overview 9
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...
Page 17 - 0 IBM Lotus LMS Release 1 Installation Guide
Page 18 - Allocating server responsibilities; Creating a new database or upgrading an existing database; Migration Guide; Chapter 4: Identifying LMS Hardware Assets 11
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...
Page 19 - Learning Management System Hardware requirements; 2 IBM Lotus LMS Release 1 Installation Guide
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
Page 20 - Important Note for AIX and Linux users:; Chapter 5: Installing the WebSphere Core 13
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...
Page 21 - Enabling SSO in WebSphere; 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 22 - wasadmin; DeploymentManager; Chapter 5: Installing the WebSphere Core 15
• 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...
Page 23 - 6 IBM Lotus LMS Release 1 Installation Guide
Page 24 - Installing the IBM Directory Server LDAP Directory: an example; Installation Steps; Chapter 6: Installing or Identifying the LDAP Directory 17
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...
Page 25 - Directory Configuration Steps; Administering the directory; 8 IBM Lotus LMS Release 1 Installation Guide
• 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...
Page 26 - Chapter 6: Installing or Identifying the LDAP Directory 19
• 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...
Page 27 - significantly; 0 IBM Lotus LMS Release 1 Installation Guide
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...
Page 28 - Installer program information; The actual; Chapter 7: Installing the LMS Server Application Files 21
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...
Page 29 - Select the Learning Management System features to install; 2 IBM Lotus LMS Release 1 Installation Guide
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...
Page 30 - Click Next to continue.; Select the Learning Management System Server settings; Chapter 7: Installing the LMS Server Application Files 23
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...
Page 31 - 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 32 - Path to Imported Course Packages – Enter; the local directory on the LMM server's file system; Chapter 7: Installing the LMS Server Application Files 25
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...
Page 33 - Click Next to continue. You are now shown the Destination screen.; 6 IBM Lotus LMS Release 1 Installation Guide
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...
Page 34 - Click Finish to exit the Installer.; Starting the Learning Management System Server application; Chapter 7: Installing the LMS Server Application Files 27
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...
Page 35 - 8 IBM Lotus LMS Release 1 Installation Guide
Page 36 - ear; Chapter 8: Installing the Delivery Server (DS) Application Files 29
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...
Page 37 - Installing the Delivery Server application software; Start the Installer.; At the Features Screen, select the Delivery Server.; The information you enter in the screens that follow; Select the correct LDAP settings and test the LDAP connection; 0 IBM Lotus LMS Release 1 Installation Guide
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...
Page 38 - Chapter 8: Installing the Delivery Server (DS) Application Files 31
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...
Page 39 - Select the Delivery Server settings; Server ID – Enter your server ID. This is; a unique name that you will use to refer to this Delivery; An example setting would be:; 2 IBM Lotus LMS Release 1 Installation Guide
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...
Page 40 - Select the Web Server settings; Chapter 8: Installing the Delivery Server (DS) Application Files 33
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...
Page 41 - Select the Content Deployment settings for FTP deployment; FTP Host – Enter the URL of the FTP host where the content is located.; 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 42 - Select the System Administrator E-mail settings; Chapter 8: Installing the Delivery Server (DS) Application Files 35
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...
Page 43 - Starting the Delivery Server application; 6 IBM Lotus LMS Release 1 Installation Guide
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...
Page 44 - not; Database Creation Overview
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...
Page 45 - Installation Requirements; 8 IBM Lotus LMS Release 1 Installation Guide
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...
Page 47 - Database creation details; Creating an Audit database; 0 IBM Lotus LMS Release 1 Installation Guide
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...
Page 48 - lmm; AND; ds; db2 –tvf; Connecting the DB2 client to a remote database; Installing the DB2 client; IBM DB2 Universal Database for Unix Quick Beginnings; db2setup
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...
Page 49 - 2 IBM Lotus LMS Release 1 Installation Guide
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...
Page 50 - Catalog the remote databases; db2node
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...
Page 51 - Oracle database creation for the Learning Management System; Installation requirements; Creating a Learning Management System schema; 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 52 - Creating an Audit schema; JDBC driver information
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...
Page 53 - JDBC Driver information; 6 IBM Lotus LMS Release 1 Installation Guide
• 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. •...
Page 54 - DB2 users; but are commented out; Oracle users; scripts have been provided. These scripts run all commands to
• 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...
Page 55 - 8 IBM Lotus LMS Release 1 Installation Guide
Page 56 - Chapter 10: Installing the Network Deployment (ND) Module 49
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...
Page 57 - 0 IBM Lotus LMS Release 1 Installation Guide
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...
Page 58 - Additional guidelines regarding the use of ND; Chapter 10: Installing the Network Deployment (ND) Module 51
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...
Page 59 - 2 IBM Lotus LMS Release 1 Installation Guide
Page 60 - Data source overview; Chapter 11: Configuring JDBC Data Sources 53
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 • ...
Page 61 - Defining the JDBC provider; Defining the JDBC provider for a DB2 database; Select DB2 JDBC Provider.; 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 62 - Click OK to continue.; Chapter 11: Configuring JDBC Data Sources 55
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
Page 63 - 6 IBM Lotus LMS Release 1 Installation Guide
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...
Page 64 - Defining the JDBC provider for a SQL Server database; Defining the JDBC data sources; Create the J2C Authentication Data Entries; J2C Authentication Data; Chapter 11: Configuring JDBC Data Sources 57
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...
Page 65 - Create the data sources; 8 IBM Lotus LMS Release 1 Installation Guide
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...
Page 66 - Chapter 11: Configuring JDBC Data Sources 59
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...
Page 67 - Repeat this procedure for the two remaining databases.; 0 IBM Lotus LMS Release 1 Installation Guide
• Click Apply. 16. Repeat this procedure for the two remaining databases. 60 IBM Lotus LMS Release 1 Installation Guide
Page 68 - Chapter 11: Configuring JDBC Data Sources 61
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...
Page 69 - Note; Make sure that Select Method is set to; cursor; Repeat this process for the other two databases.; 2 IBM Lotus LMS Release 1 Installation Guide
• 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 ...
Page 70 - environment entries; Configuring an environment entry for the log file location; Create the Resource Environment Provider; Click “New” to begin configuring a new provider.; Chapter 12: Configuring Environment Entries 63
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 ...
Page 71 - Enter the provider information; Click OK. A new provider appears in the list of defined providers.; 4 IBM Lotus LMS Release 1 Installation Guide
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
Page 72 - Enter the provider details; Enter the desired details.; Configure the Referenceable; Before environment-entries can be made, a; Chapter 12: Configuring Environment Entries 65
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...
Page 73 - Configure the Resource Environment entries; Go back to the Provider Details page.; 6 IBM Lotus LMS Release 1 Installation Guide
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 ...
Page 74 - Chapter 12: Configuring Environment Entries 67
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
Page 75 - 8 IBM Lotus LMS Release 1 Installation Guide
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 ...
Page 76 - Chapter 12: Configuring Environment Entries 69
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 ...
Page 77 - 0 IBM Lotus LMS Release 1 Installation Guide
Page 79 - 2 IBM Lotus LMS Release 1 Installation Guide
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...
Page 81 - Enable WAS Global Security; Select LDAP In the Active User Registry drop-down box.; 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 82 - Chapter 14: Deploying the LMS Server Application 75
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...
Page 83 - Prepare for application install; 6 IBM Lotus LMS Release 1 Installation Guide
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...
Page 84 - Provide options to perform the installation; With the exception of the Application Name, accept the defaults.; Caution; Chapter 14: Deploying the LMS Server Application 77
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...
Page 85 - Map resources references to resources; 8 IBM Lotus LMS Release 1 Installation Guide
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...
Page 86 - Map resource env (environment) entry references to resources; Chapter 14: Deploying the LMS Server Application 79
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...
Page 87 - 0 IBM Lotus LMS Release 1 Installation Guide
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...
Page 88 - Chapter 14: Deploying the LMS Server Application 81
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...
Page 89 - View summary and confirmation information; Review them and if they are correct, click Finish to continue.; 2 IBM Lotus LMS Release 1 Installation Guide
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
Page 90 - Starting the application and regenerating web server plug-in; Chapter 14: Deploying the LMS Server Application 83
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...
Page 91 - 4 IBM Lotus LMS Release 1 Installation Guide
Page 92 - Starting the application and regenerating web server plug-in; Chapter 15: Deploying the Delivery Server (DS) Application 85
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...
Page 93 - 6 IBM Lotus LMS Release 1 Installation Guide
Page 94 - , ConnectionIOTimeOut
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 ...
Page 95 - ConnectionIOTimeOut; 8 IBM Lotus LMS Release 1 Installation Guide
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...
Page 96 - Click the Learning Management System Server checkbox.; Click the Delivery Server checkbox.; Chapter 17: Starting the Applications 89
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...
Page 97 - Regenerating the web server plug-in; Running the Updater; 0 IBM Lotus LMS Release 1 Installation Guide
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...
Page 98 - Chapter 17: Starting the Applications 91
Page 99 - Configuring on-line help; 2 IBM Lotus LMS Release 1 Installation Guide
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...
Page 100 - Planner mode; Installing the Command Line Import Utility (CLIMP)
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...
Page 101 - capabilities to import courses that CLIMP does.; Migrating LearningSpace data; Learning Management System Migration; Installing XVFB on UNIX platforms to enable reporting; XVFB installation and configuration differs for Linux and AIX.; Installing XVFB on Linux; 4 IBM Lotus LMS Release 1 Installation Guide
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...
Page 103 - Installing XVFB on AIX; Set DISPLAY by adding the following line to .profile:; 6 IBM Lotus LMS Release 1 Installation Guide
# 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...
Page 105 - 8 IBM Lotus LMS Release 1 Installation Guide
Page 106 - Using SSL with the Learning Management System; Manually add the new suffix below the following line:; Chapter 19: Special Installation Tasks 99
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...
Page 107 - 00 IBM Lotus LMS Release 1 Installation Guide
Page 108 - Removing the installed Learning Management System files; Delete the lms folder.; Removing the Learning, DS, and Audit databases; Back up the database.; Chapter 20: Removing the IBM Lotus Learning Management System 101
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...
Page 109 - 02 IBM Lotus LMS Release 1 Installation Guide
Page 110 - Moving static LMS elements to the Web Server; Installing static files for the Learning Server user interface; Appendix A: LMS Performance and Fine-tuning Information 103
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...
Page 111 - Installing static files for the Delivery Server user interface; Install a program on the HTTP server for decompressing zip files.; 04 IBM Lotus LMS Release 1 Installation Guide
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"/> <...
Page 112 - style sheets to the appropriate directories on the HTTP servers.; Tuning LDAP performance; LDAP tuning guidelines; Appendix A: LMS Performance and Fine-tuning Information 105
<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="/...
Page 113 - Tuning database server performance; 06 IBM Lotus LMS Release 1 Installation Guide
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 ...
Page 114 - Tuning TCP/IP settings on LMS servers; Microsoft Windows 2000 servers; TcpTimedWaitDelay; Recommended value; MaxUserPort; Appendix A: LMS Performance and Fine-tuning Information 107
• 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-...
Page 115 - TcpNumConnections; 50-200% of your expected number of concurrent users; Linux servers; To see the current value, use this command:; man no; 08 IBM Lotus LMS Release 1 Installation Guide
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...
Page 116 - Sun Solaris servers; Tuning HTTP servers; parameter defined in; Appendix A: LMS Performance and Fine-tuning Information 109
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...
Page 117 - Tuning the Sun ONE Web server, Enterprise Edition - Solaris; WaitingThreads; Tuning the Microsoft Internet Information Server (IIS); 10 IBM Lotus LMS Release 1 Installation Guide
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...
Page 118 - Tuning the IBM HTTP Server; MinSpareServers, MaxSpareServers, StartServers, and MaxClients; Appendix A: LMS Performance and Fine-tuning Information 111
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...
Page 119 - Tuning the IBM HTTP Server in Windows 2000; Use the following procedure to change this parameter:; 12 IBM Lotus LMS Release 1 Installation Guide
• 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...
Page 120 - Appendix A: LMS Performance and Fine-tuning Information 113
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...
Page 121 - HTTP Logging; common; AfpaEnable; 14 IBM Lotus LMS Release 1 Installation Guide
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...
Page 122 - Adjusting JVM Heap size; vmstat; Appendix A: LMS Performance and Fine-tuning Information 115
• 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 ...
Page 123 - 16 IBM Lotus LMS Release 1 Installation Guide
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...
Page 124 - Adjusting the Web container MaxKeepAliveConnections; Adjusting the Web container MaxKeepAliveRequests parameter; To view or change this parameter, use the following procedure:; Appendix A: LMS Performance and Fine-tuning Information 117
• 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...
Page 125 - Adjusting the JDBC Data Source Connection Pool size; select method; Tuning the LMS applications; Adjusting LMS logging; Application Log; Database Log; warn; 18 IBM Lotus LMS Release 1 Installation Guide
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...
Page 126 - Archiving the LMS log files; SendProgressTask; Appendix A: LMS Performance and Fine-tuning Information 119
• 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...
Page 127 - Oracle PROCESSES Parameter (Oracle server only); Find the SPFILEORACLE.ORA file on the Oracle server.; 20 IBM Lotus LMS Release 1 Installation Guide
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. ...
Page 128 - Appendix A: LMS Performance and Fine-tuning Information 121
Appendix A: LMS Performance and Fine-tuning Information 121
Page 129 - Index; deploying Learning Management System; 22 IBM Lotus LMS Release 1 Installation Guide
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...