IBM G210-1784-00 manual

Lo t u s ® Learning Management System R1 Installation Guide Version 1.0.4  March 2004 G210-1784-00 [...]

Copyrights Disclaimer THIS DOCUMENTATION IS P ROVIDED FOR REF ERENCE PURPO SES ONLY. WHILE EFFORT S WERE MADE TO VERIFY THE COMPLETENESS AND ACCURACY OF THE INFORMATION CONTAINED IN THI S DOCUMENTATION, THIS DOCUMENTATION I S PROVIDED "AS I S" WITHOUT ANY WARRANTY WHATSOEVER AND TO THE MAXIMUM EXTENT PERMITTED, IBM DI SCLAIMS ALL IMPLIED [...]

Netscape and Netsc ape Navigator are registere d tradem arks of Net scape Communications Corporation in the United States and other countries. Oracle is a regist ered trade mark of Orac le Corporation in t he United St ates, other countr ies, or bot h. PKZIP is a registered tradem ark of PKWARE, Inc. in the United States, other countries, or both. [...]

Contents Chapter 1 About the IBM Lotus Learning Management System ............................................................1 Introduction ............................................................................................................................................................................... 1 What is the Learning Management[...]

DB2 database creat ion and configur ation for the Le arning Managem ent System: an exam ple ................................... 38 Oracle database creation for the Learni ng Management System ..................................................................................... 44 MS SQL Server database creation for the Learning Management System ..[...]

Determining the correct SSO settings for the Learning Mana gement System ................................................................ 96 Chapter 19 Special Installation Issues ...................................................................................................99 Using SSL with the Learn ing Management System .....................[...]

vi IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 1 About the IBM Lotus Learning Management System Introduction This document provides in formation on the IBM® Lotus® Learning Managem ent System installation process as well as inform ation on packaging and layout. The intended aud ience for this d ocument is system administ rators, developers, and other users who wish to install the Le a[...]

Relational database management system The Learning Management System stores user, course, an d assessm ent data in a relational d atabase, which consists of a series of table s. The database management softwa re can reside on the same machine as the Learnin g Management System software for a small installation, but generally resides on a separate m[...]

Chapter 2 Learning Management System Requirements The Learning Management System is supported on a spec ific set of hardware and software components. Whether you are instal ling the Learning Management Syst em for the first time on a server or upgrading from an earlier release of LearningSpace ® , you may nee d to upgrade hardw are and/or softwar [...]

Client hardware requirements For the most up-to-date client hardware requir ements, re fer 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 shipped with this product. Audio and video requiremen[...]

Chapter 3 Learning Management System Installation Overview The following informat ion provides an outline of the Learning Management System installat ion process. Packaging overview The functional components of the Learning Manageme nt System product are J2EE™ web app lications. J2EE provides the packaging fo r these components as a standard. The[...]

Updater then creates two update SQL scripts - one for the Learning Management System server ( update LMM.sql ) and one for the Delivery Server ( upda teDS.sql ). These scripts ar e then run to change the respective dat abases. You can change settings through the user interface at any time. Since virtual ly all required application s ettings can be [...]

the WebSphere and the Learnin g 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. M any aspects of the Learning Management System operation requir e that direct or y path expressions be specified. An example is rostering. While us[...]

At this time you should also identify the LDAP username for the Learn ing Management System administrator. This value is used to make an entry in t he USER table and represents the only r ostered user when the applic ation starts. For more information, refer to “Ch apter 9 Instal ling and configu ring database servers and schema”. 7. Install th[...]

For more informat ion, refer to “Ch apter 14 Deplo ying the Learning Management Server applic ation “ and “Chapter 16 Deploying the Learni ng Management System and DS components onto separa te WAS App Servers.” 12. Deploy the Learning Management Sy st em Delivery Server (DS) application The Learning Management System Deli very Server (DS) a[...]

10 IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 4 Identifying Learning Management System Hardware Assets The Learning Management System can be instal led on various type s and configurations of servers. The exp ected capacity of the installa tion is the key factor in dete rmining the requirements for servers. The install process described in this document assumes that the desired server [...]

Learning Management System Hardware requirements For the most up-to-date hardware re quirements, 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 L earning Mana gement System, you are required to have the WAS (WebSphere A pplication Server) Core installed on the desired systems. This can be a single server or m ultiple servers. T he following instructions explain how to instal l this component. Note: For more complete informatio[...]

5. For Windows users, ch oose to run both WebSphere Applicati on 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 Install ation” to launch the Installation Veri fication Tool (IVT). Its output will be written to the terminal (or command) win[...]

• Expand the Security panel on the left side. • Expand Authentication Mechanisms. • Click LTPA. • Enter the password for LTPA (for exam ple, 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, acme.com). 4. Enable Sec urity [...]

16 IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 6 Installing or Identifying the LDAP Directory The Learning Management Syst em requires an LDAP directory for product operation. Either an IBM Directory Server 4.1 dir ectory is installe d or configured, or a pre-ex isting LDAP directory is identified. Al so, at least t wo user-nam es that are reco rded in the d irectory must be identified.[...]

• DB2 V7.2 (i f necessary) • GSKit5 • IBM HTTP Server 1.3.19 (if necessary) 9. Click Next. 10. In the ‘Select the components to configure’ window, en su re that all three options are selected, and then click Next. 11. If you e lected to install the IBM HTTP server, enter a user id, password, and pa ssword confirmation. 12. In the ‘Enter[...]

• Click Update. You sho uld see your suffix appear in the list of suffixe s known to the directory s erver. Note: The Web administration interface for Director y Serv er is also not supported on Linux. Refer to the Special Installation Issu es chapter in this guide for a workaround for this issue. 4. Restart the di rectory server by choosing Curr[...]

Creating WebSphere and Learning Manage ment 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 admini strator and an account f or the Learning Management System administrator. To create these accounts, you can eithe[...]

Chapter 7 Installing the Learning Management System Server Application Files Before deploying the com plete Learning Management System , the Learning Management System Server files should first be instal led on the Applicat ion Server. Note: If you are in stalling and deploying th e Learning Man a gement System Server and the Delivery Server o nto [...]

Note: You can inst all the Learn ing Management System Server an d Delivery Se rver applicat ion files at th e same time, even if you plan to deploy the applications to diffe rent machines. Since some of the settings are used for both the Le arning Manage ment Sys tem Ser ver and Delivery Server (LDAP settings, for example), installing both applica[...]

Note: The text on the LDAP Settings screen is incorre ct; inste ad of "LDAP User I D" it should read "LDAP User Distinguish ed Name (DN)." • LDAP Password – Enter the password used for accessi ng and further authenticating you to the LDAP provider. • LDAP Provider – Select the LDAP provider that you use from the drop dow[...]

communicates with the Delivery Server. The user name and password are arbitrary: they don’t need to identify an ac tual user in y our LDAP direct ory. During the install o f the DS Server, the Learn ing Management System username and password is asked again. Make sure that you provide there the same Learning Management System Server password that[...]

Select the Administrator settings 15. Select the Administrator Role Type for the Learni ng Mana gement System Server. User is the default value. If you select the User setting, enter the corresponding Admi nistrators LDAP User I D. An example of this u ser name is: jsmith. 16. If you wish to have Group as your role type, select Group an d enter the[...]

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 FT P server(s) th at will manage course content. This is the account that the Content Manager will use to acc[...]

22. Click Next to install the Le arning Management Sy stem Se rver software as specified by your selected optio ns. A Progress screen will let you monitor th e progress being made while the Lear ning Management System installs. 23. Enter the appropriate information in the product Registra tion screen as the installation completes. When the install [...]

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 fi les should first be instal led on the Applicatio n Server. Note: If you are in stalling and deploying th e Learning Man a gement System Server and the Delivery Server o nto separate WAS servers, re fer also to Chapter 16 Depl[...]

Installing the Delivery Server application software 1. Start the Installer. 2. At the Langu age Selection Instal ler screen, select the lang uage to b e used by the Installer from the drop down list. 3. Click OK to co ntinue. 4. At the Welcome screen, click Next. 5. Read the license agreement and click Accept if you agr ee to its term s. Translated[...]

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 Connect ion button. If you have entered valid settings you will receive a messag e box stati ng that you h ave a successful conn ection otherwise yo u will be in formed that yo u connection has failed.[...]

14. Click Next t o continue after you have entered all o f the settings. You are now shown the Delivery Server Definition screen. Use this screen to enter all the necessa ry information for accessing the Delivery Server. Select the Delivery Server settings 15. Enter the fo llowing Delivery Server Settings for your se rver configuration. Thes e sett[...]

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 serv er configuration. These settings provide the basic information about the Web Server used for deploying course content. All of these fields except for Description must contain a value.[...]

18. Click Next to continue. You are now shown the Content Deployment Settings screen. Th is screen lets you define the content deployment servers. For any serv er you c an choose between FTP and File system as a deployment type. If you choose FTP , then the Conten t Manager will deploy content to the FTP Host you specify, in the location you specif[...]

22. Click Next t o continue when you have added all o f your servers. You are now sh own the System Administrator E-mail Settings screen. Sk ip to that se ction below to continue with the installat ion instructions. Select the Content Deployment settings for file system deployment 23. If you se lected File Sy stem from the Deployment Ty pe drop-dow[...]

Select the installation destination and complete the installation 27. Click Next to install the Delivery Server to the defaul t directory or click Browse to select and install to a different directory. 28. Before th e installation be gins you are shown a Summ ary screen display ing all of your selected installation options. 29. Click Next to instal[...]

Chapter 9 Installing and Configuring Database Servers and Schema The Learning Management System requires a number of di fferent lo gical database schemas to function. These are the following: • LMM database – this database resides on the Lear ning Management System Server and stores all information about courses, users, progre ss, resources, de[...]

Be sure to follo w your database soft ware’s guideline s for si zing the installation and configuring an efficient physic al 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 sc ripts before execution. For more information on the Learnin [...]

set msgsys:msginfo_msgmap=0x102 set msgsys:msginfo_msgmni=0xFF set msgsys:msginfo_msgssz=0x10 set msgsys:msginfo_msgtql=0x400 set shmsys:shminfo_shmmax=0x20000000 set shmsys:shminfo_shmseg=0x32 set shmsys:shminfo_shmmni=0x12C set semsys:seminfo_semmni=0x400 set semsys:seminfo_semmap=0x400 set semsys:seminfo_semmns=0x800 set semsys:seminfo_semmnu=0x[...]

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

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 databa se named lmm , and creates the buffer pools required for any Le arning Management System schema. 5. If desired, edit the lmm_db2.sql script for file size and plac ement. From a D B2 command win d[...]

5. Create a password for db2inst 1 . 6. Select OK. Th e installation may take up to 1 5 minute s. When in stallation has completed a notice window informs you whether the inst allation w as successful. 7. Highlight OK when f inished and click E nter. 8. If errors are found chec k the DB2 error log on /tmp. Use the following instructions to inst all[...]

1. Log in as the DB2 instance owner (for example, db2in st1). 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 wh ere DB2 is installed on t he machine, NOT an environment variable. Note: You should update each user account pr ofile for your da[...]

9. Enter the Database alias (for examp le, Learning2). 10. Click Next. 11. Unselect Register this dat abase for ODB C and click Next. 12. Click Next on Step for Add Datab ase Wizard. 13. Check Configure secur ity options and click Next. 14. Click Fin ish and test yo ur connection. 15. Repeat for this procedure for the DS and Audit databases. Oracle[...]

sqlplus lmm/lmm@<database> @lmm_oracle.sql Creating an Audit schem a 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. . (T he script actually creates two users: lmm, which designate s the database owne r, and lmm_app, which you can ignore.) To run the script from the sqlpl[...]

• The “-S” server name optio n can be omitted if the scr ipt is being run on the d atabase server itself. • The name that you will give for the server is the serv er alias you created with the “client network utility.” • The “-e” option should be omitted unless you are d ebugging installation problems. • If you have DB2 installe[...]

• To meet the need for UNIX script files fo r DB2 that accomplish the same thing that the provided DB2 DOS batch files do, ".sh" scripts have been provided. Ther e is one script for each database. These files should be read and edited before exe cuting them. • Both the DOS and UNIX scripts have comment s in them to provide some instru[...]

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 ed systems. This can be a single server or m ultiple servers. If multiple servers are used, you mu st install the Network Deployment mo dule. The Network Deployment (ND) module configures and controls[...]

13. Enable SSO b y doing the f ollowing: • Expand the Security panel on the left side. • Expand Authentication Mechanisms. • Click LTPA. • Enter the password for LTPA (for exam ple, 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 (fo[...]

The following provides a graphic al representation of the WA S nodes, servers, and applicat ions when WAS Core and Network Deployment (ND) are deployed on the sam e 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 after it had alread been started. Server1 will n[...]

52 IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 11 Configuring JDBC Data Sources After the WebSphere Application Server (WAS) is inst alled, but before the Learning Managem ent System application is deploy ed, resources mu st be configured. Ther e are two types of resources that apply to the Learning Management System: • environment entries • JDBC data sources Configuration of t hese[...]

Defining the JDBC provider The first step is to define the overall JDBC Provider. This corresponds to the spec ific driver and dat abase vendor. Defining the JDBC provider for a DB2 database In the following example, you are show n how to configure a provider named “DB2 JDBC Provider.” This provider is for the DB2 database ser ver. 1. Using the[...]

4. Click OK to co ntinue. 5. At the Configuration - Gen eral Properties screen for t h e 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 v ariable that mu st be verified or set. Use the follow ing procedure to do this: • From the starting screen o f the Admin console, nav i gate to Environment -Manage Web Sphere Variables and locate the variable ref erenced by the classpath in the JDBC Providers Configurat ion screen. In this example, it is DB2_JD[...]

Defining the JDBC provider for a SQL Server database 1. Install SQL Server 2000 Dr iver for JDBC Serv ice 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/downloads/details.aspx?FamilyID=9f1874b6-f8e1-4bd[...]

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 chang es will apply only at the node level. 7. Click New. 8. From the JDBC providers d rop down, select yo u dat abase provider (DB2 for this[...]

13. Enter the fo llowing informat ion: • 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 Alia s: $hostnameMan ager/ db_name 14. Click Apply. 15. Change the database Max connection pool size[...]

• Click Appl y. 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 dat abase type you may change the following properties. The entries pr esented are for example purposes only. • DB2 databases: • databaseNam e: db_name - thi[...]

• The databaseName property has been se lected and you are shown the follow ing screen to change this custom property. This property provides the da t abase alias used when cat aloging the remote database. The va lue used in the following example for databaseNa me is “lmm.” • For Oracle databases, you may see the following properties: • U[...]

Chapter 12 Configuring Environment Entries After the WebSphere Application Server (WAS) is inst alled, but before the Learning Managem ent System application is deploy ed, resources mu st be configured. Ther e are two types of resources that apply to the Learning Management System: • environment entries • JDBC data-sources Configuration of t he[...]

2. Enter the provider information a. Enter the name, for example, “LMS Provider,” and an option al description for the provider. b. Click OK. A new provider appears in the list of de fined 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 able to handle bindin gs for specific reference v[...]

c. For Factory Classname, enter com.lot us. elearn.n aming.StringObjectFactory. d. For Classnam e, enter java.lang. String. e. Click OK. 5. Configure the Resource Environment entries After the Referenceable ha s been defined, the spec ific environment entries need to be defined. a. Go back to the Provider Details page. b. Click Resource Environment[...]

c. Click New to go to the page to define an entry. En ter LMS_LOG as both the name and JNDI name for the new entry. d. Click OK. This will bring you back to the Env-Entr ies list page. You now ne ed to define properties for the new entry. Chapter 12: Configuring Enviro nment Entries 67[...]

e. Click that link a nd define a new Custom Property with the name LMS_LOG_PATH . For the value, enter the name of the directory where the Learning Manageme nt System should stor e application log files, for example, C: lms_logs. Note: You need to create this d irectory by hand as th e applicat ion won’t do it for you and will not st art properl[...]

13. Set Value to true. 14. Click OK 15. Click th e Resource Env En tries 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_FA LSE. 21. Click Custom Properties. 22. Click New . 23. Set Name to value. 24. Set Value to false. 25. Click OK. 26. Save your wo rk. Chapter 12: Configur[...]

70 IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 13 Configuring WebSphere Application Server Security The Learning Management System assu mes that the WebSphere Application Se rver (WAS) is configured t o use LDAP authentication. The WAS Administrati ve Console is used to configure LDAP as the active use r registry an d to specify the LDAP settings as part of setting up WAS Security . Bef[...]

Configure the LDAP directory for use with the Learning Management System The following steps show how to configure WAS security to use an LDAP dir ectory: 1. Launch the WAS Admin istrative Console an d go to Security - User Registries. 2. Click on the LDAP link. The LDAP Us er Registry page is d isplayed. 3. Enter the Server Use r ID (for example, [...]

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 Advanced LDAP Set tings link. Yo u’ll see the Advanc ed LDAP Settings page. If your LDAP directory h as been customized you may n eed to change the User Filter, the User ID Map, the Group Filter or t[...]

Enable WAS Global S ecurity 1. Launch the WAS Administrative Console and go to Security – Global Security. 2. Check the Enabled checkbox and (if it isn’t automa ticall y checked when security is en abled) the Enforce Java 2 Security checkbox. 3. Assuming that you followed t he steps for enab ling Single Sign-On (SSO) outl ined in “Chapter 1 0[...]

Chapter 14 Deploying the Learning Management System Server Application A pplication deployment refers to the process wher e an applicatio n package has been inst alled and is then configured on an application serv er to create a running instance o f that app lication. The important unit of pac kaging in th e Learning Management System applicat ion [...]

2. Prepare for application install It sometimes takes a few minutes for WAS to read and validate an .ear file. Whe n this has co mpleted, the “Preparing fo r application installation” sc reen is displayed. You can make selections h ere that change how the n ext steps are performed. Y ou should accept the defaul ts. When finished, click Next t o[...]

3. Provide options to perform the installation At the next screen, select so me options for the applic ation deployment; for example yo u can pre-compile all JSPs. With the exception of the Application Name, accept the defaults. Caution The Application Name should not include spac es, because the Learnin g Management System Installer generates a WA[...]

4. Map resources references to resources At the following scre ens, you map the resource references th at are speci fied in the .e ar file to act ual resour ces you configured in WAS. Check the first entry for the Learning Management Syst em data (jdbc/LMS_Default) and sele ct “jdbc/lmm” from the “Specify existing Resource JN DI name" dr[...]

This list is populated with the names of data source de finitions that have been def ined and lets you resolve JDBC data source refer ences. For each d ata source refere nced in the .e ar file, an entry is displayed. Cl icking the IBM Lotus Learning Management System checkbox and then specifying select “jdbc/lmm ” from the “Specify existing R[...]

6. Map virtual hosts to web modules In this step, you map web modules to d ifferent virtual host s. The application se rver can run multiple, separate servers. For exam ple, by default, the server runs the admin host on port 9090 and the default host on port 9080. Accept the default value. When finished, click Next t o continue. 7. Map modules to a[...]

8. Map security roles to users/groups In this step, map re ferences to security roles in the applicati on to specific user registry gro ups or application server special subjects. The .ear file already contains a default security binding. Accept the default value (ALL_AUTHENTICATED ) by clicking Next to conti nue. Chapter 14: Deploying the LMS Serv[...]

9. View summary and confirmation information When you have completed these steps, y ou are sh own a summary of the options you have selected. Review them and if they are correct, click Fin ish to continue. 82 IBM Lotus LMS Release 1 Installation Guide[...]

The application performs some final proc essing to fin alize all the se lections. Stat us informatio n on this process is printed to the console. When complete processing is complete, you are pre sente d with a link to save the new configuration. It is recommended you perform the Save at this time. 10. Starting the application and regenerating web [...]

84 IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 15 Deploying the Delivery Server (DS) Application For complete information o n the process of dep loying the Delive ry Server applic ation portion of the Le arning Management System installation, follow the same step s outlined in “Chapter 14 Deploying the Learnin g Management System Serv er application. ” The only difference for de plo[...]

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, ne w Application Servers cre ated in the WAS Admin Console generate their own unique HTTP ports. WAS assigns ports incrementally, beginning w ith port 9080, which is usually assigned to the Application Server server1. Subsequent s[...]

1. In the WAS Admin Conso le, navigate to Servers and click on Appl ication Servers. 2. Click on the Applic ation Server. 3. In the Application Server’s screen, click Web Container. 4. In the Web Container scre en, click on HTTP Transports. 5. In the HTTP Transports sc reen, click on the asterisk asso ciated w ith the port for which “SSL enable[...]

Chapter 17 Starting the Applications At this point, the Learning Management System a pplicatio ns are ready to start. The WAS adm in console is used to start these ap plications. Bo th the WAS l ogs and Learning Management System logs shou ld be exam ined to verify correct initialization. At this point, the applications can be accessed via browser [...]

7. To verify that the Delivery Server is running properly, yo u can enter the followin g 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 deploy ments (s uch as the Le arning Ma nagemen t System) tha t have static HTTP assets (fo [...]

Chapter 17: Starting the Applications 91[...]

Chapter 18 Post-Installation Tasks After yo u have in stalled the Lear ning Mana gement Sy stem, there are other tasks tha t must be completed to make full use of yo ur installatio n. These include t he following: • Configuring on-line help • Adding the Delivery Server to the Lear ning Management System application • Deploying the Offlin e Le[...]

Deploying the Offline Learning Client The Learning Management System allows students t o take courses without be ing connected to the network. When working on a course of fline, all course pr erequisites and navigation features are fully function al for the student. The Offline Learning Clien t lets you access the disconnected use feature. To pro p[...]

CLIMP allows you t o import SCORM 1. 2 course package file s into the Learnin g Management System, making them available for deployment. Course packag e files can contain new courses, or upd ates to previously-deploye d courses. Course packages are created by content vendors using th e Learning Management Syst em Authoring Tool, or by using some ot[...]

• If you don't have this file, proceed with step 2. 2. Download the XVFB file from the fol lowing link to a directory on the Linux machine: ftp://ftp.xfree86.org/pub/XFree86/4.2.0/binaries/Linux-ix86-glibc22/ 3. Extract the file with the following commands: chmod +x extract mkdir /etc/X11 ./extract -C /usr/X11R6 Xvfb 4. Generate a script fil[...]

# 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 st ep. 6. Create soft link: ln -s /etc/init.d/xvfb /etc/rc3.d/S75xvfb This example uses r un-level 3. I f you intend to u se [...]

Management System and SSO re fer to Chapter 5 Managing User s in the Admin istrat or's G uide and the Installing the WebSphere Core chapter in this g uide. Chapter 18: Post-Installation Tasks 97[...]

98 IBM Lotus LMS Release 1 Installation Guide[...]

Chapter 19 Special Installation Issues For informati on on special issues related to this r elease of the Learning Man agement System, r efer to the ReadMe.html and Release Notes.html fi les that ship with this version of the product. Using SSL with the Learning Management System Use of the Secure Sockets Layer for the Learning Management System is[...]

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 remove the Learning Management System component technologies (IBM Direct ory Server, IBM DB2 7.2, and IBM WebSphere Application Server 5), use the Window s Add/Remove Programs util ity in the Cont rol Panel[...]

102 IBM Lotus LMS Release 1 Installation Guide[...]

Appendix A LMS Performance and Fine-tuning Information This chapter discusse s post-installation tasks related to the running, maintenance, and fine-tuning of LMS operations. These tasks are not necessary to get LMS ru nning, but are recommended fo r improving and correcting system performance. The appendix contains t he following sections: • Mov[...]

5. Edit the WebSphere plug-in configur ation file ( plugin- config. xml ) and search for t he following line: <Uri AffinityCookie="JSESSIONID" Name="/lms-lmm/*"/> Replace this l ine by the following lines: <Uri AffinityCookie="JSESSIONID" Name="/lms-lmm"/> <Uri AffinityCookie="JSESSIONID&q[...]

<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="/lms-ds/services/*"/> <Ur[...]

4. There are several user attributes that are use d quite often when searching for users (first n ame, last name, organization, etc.). For a faster response, you can in dex these attributes in the LDAP server’s database. Indexing LDAP attributes Every vendor provides different ways on how to inde x the in formation in their LD AP directory. In th[...]

• IBM DB2 tuning parameters: We bSphere Application Server http://publib7b.boulder.ibm.com/wasinfo1 /en/info/ae/ae/rprf_db2parameters.html • IBM Redbook SG24-6417: DB2 UDB/WebS phere Performance Tuning Guide http://publib-b.boulder.ibm.com/Redbook s.nsf/RedbookAbstracts/SG246417.html • IBM Redbook SG24-6012: DB2 UDB V7.1 Performance Tuning Gu[...]

TcpNumConnections This parameter defines the maximum numb er of simultaneous TCP connections and should be set h igher than the expected number of simultaneous connections. Recommended value: 150-200% of your ex pected number of concurrent users Note: Instead of using the registry editor, you c an create a text file with the extension .reg using No[...]

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 r eleasing it for re-use. Recommended value: 30000 (= 30 seconds) To see the current value, use this command: /usr/sbin/ndd –get /dev/tcp t[...]

Tuning the Sun ONE Web server, Enterprise Edition - Solaris The default configur ation of the Sun O NE Web server, Enterpr ise Edition provides a single-p rocess, multi-threaded server. Adjusting th e Active Thre ads paramet er After the server reaches the limit set with this parameter, the server stops servicin g new connections until it finishes [...]

Use the registry editor to set the ListenBackLog parameter located at: HKEY_LOCAL_MACHINESYSTEMCurrentControlSetServicesInetInfoParametersListenBack Log The recommended value is 200. MaxPoolThreads and PoolThreadL imit parameter The MaxPoolThreads p arameter controls the number of threads per CP U in the thread pool availab le for IIS to run [...]

• Time per request When testing different parameter settings for the httpd. conf, use these values to compare and find the best configuration sett ing for your system. MaxRequest sPerChild The MaxRequestsPerChild directive se ts the limit on the numb er of requests that an ind ividual child serv er process handles. After the number of reques ts r[...]

2. Change the value of the parameter by starting with 100. 3. Save the chan ges and rest art the IBM HTTP server. The recommended method is to start with a size of 100, then incre ase as necessar y. An HTTP error message of type 503 (a refuse d connection) is a good indicator for the need to increase the value. There are two ways to find how many t[...]

Use the following procedure to change this parameter: 1. Edit the IBM HTTP Server file httpd.conf located in th e directory IBM_HTTP_Server_root_directory/conf . 2. Change the value of the pa rameter. 3. Save the chan ges and rest art the IBM HTTP server. The recommended value is 250000. HTTP Logging This parameter enables logging for th e HTTP ser[...]

• 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 the J ava Virtual Machine sp ends collec[...]

2. View or adj ust the Max imum Heap S ize and set t he Initial He ap Size to t he same val ue. 3. Stop and re- start the appl ication. Enabling the JIT compiler When a JVM JIT (Just -In-Time) compiler is present and enab led, the Java Virtual Ma chine performs differently. After reading in a .class file for interpretation, the JVM hands the .class[...]

• 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 LM S server. Use the maximum thread size parameter to specify the maxi mum number of threads tha t can be pooled to handle requests sent to the Web container. Requests are sent to the Web[...]

Adjusting the JDBC Data Source Connection Pool size When accessing any database , the initial database connection is an expensive op eration. Connection pooling an d connection reuse reduces t he number of these operations significan tly. Only two parameters should be changed here: Min connect ions and Max connections. Al l ot her parameters should[...]

• Set the Logging level to warn Tracking Log: • Click Settings - LMM Server - System Lo gging - Tracking Lo g • Set the Logging level to warn Archiving the LMS log files LMS log files should be archived on regular basis. Otherwise , the file s could continue to grow until no space is left on the hard drive. Setting the size and frequency of t[...]

Oracle PROCESSES Parameter (Oracle server only) This parameter must be ch anged on the Oracle server. Increa sing this parameter from the default value of 150 to 600 can improve performance. Use the following procedures to change this parameter. 1. Find the SPFI LEORACLE.ORA file on the Orac le server. 2. Open it for ed iting. 3. Find the PRO CESSE[...]

Appendix A: LMS Performance and F ine-tuning Information 121[...]

Index Application Servers deployi ng Learni ng Manageme nt 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 configurati on, 38 database schemas, 37 Delivery Server adding to th[...]

regenerating, 90 WebSphere, 13, 41 WebSphere Application Server sec urity, 71 configuring, 71 WebSphere Core installing, 13 XVBF installing, 94 Index 123[...]

Printed in USA[...]