Upgrading blackboard academic_suite_to_blackboard_learn_release_9

2,772 views

Published on

Published in: Technology, Education
0 Comments
0 Likes
Statistics
Notes
  • Be the first to comment

  • Be the first to like this

No Downloads
Views
Total views
2,772
On SlideShare
0
From Embeds
0
Number of Embeds
41
Actions
Shares
0
Downloads
11
Comments
0
Likes
0
Embeds 0
No embeds

No notes for slide

Upgrading blackboard academic_suite_to_blackboard_learn_release_9

  1. 1. Version 9.0Upgrading Blackboard Academic Suite to Blackboard Learn ©2008 Blackboard Inc. Proprietary and Confidential
  2. 2. Publication Date: January 2009 Worldwide Headquarters International Headquarters Blackboard Inc. Blackboard International B.V. 650 Massachusetts Avenue N.W. Dam 27 2nd Floor Sixth Floor 1012 JS Amsterdam Washington, DC 20001-3796 The Netherlands 800-424-9299 toll free US & Canada +1-202-463-4860 telephone +31 20 5206884 (NL) telephone +1-202-463-4863 facsimile +31 20 5206885 (NL) facsimile www.blackboard.com www.blackboard.comBlackboard, the Blackboard logo, Blackboard Academic Suite, Blackboard Learning System,Blackboard Learning System ML, Blackboard Community System, Blackboard TransactionSystem, Building Blocks, and Bringing Education Online are either registered trademarks ortrademarks of Blackboard Inc. in the United States and/or other countries. Microsoft and Windowsare registered trademarks of Microsoft Corporation in the United States and/or other countries.Java is a registered trademark of Sun Microsystems, Inc. in the United States and/or othercountries. Macromedia, Authorware and Shockwave are either registered trademarks ortrademarks of Macromedia, Inc. in the United States and/or other countries. Real Player and RealAudio Movie are trademarks of RealNetworks in the United States and/or other countries. Adobeand Acrobat Reader are either registered trademarks or trademarks of Adobe SystemsIncorporated in the United States and/or other countries. Macintosh and QuickTime areregistered trademarks of Apple Computer, Inc. in the United States and/or other countries.WebEQ is a trademark of Design Science, Inc. in the United States and/or other countries. JSpellis a trademark of The Solution Café in the United States and/or other countries. Other productand company names mentioned herein may be the trademarks of their respective owners. U.S.Patent No. 6,988,138. Patents pending.No part of the contents of this manual may be reproduced or transmitted in any form or by anymeans without the written permission of the publisher, Blackboard Inc.Upgrading Blackboard Academic Suite to Blackboard Learn Page 2©2009 Blackboard Inc. Proprietary and Confidential
  3. 3. Table of ContentsIntroduction .........................................................................................5 About this document......................................................................................5 What does it contain?.....................................................................................5Reference Materials................................................................................6 Upgrade Kit Documents ..................................................................................6 Other Reference Materials...............................................................................6Compatibility Matrixes .......................................................................... 10 Overview.................................................................................................. 10 Server Compatibility Matrix.................................................................. 11 Server Compatibility .................................................................................... 11 Updating the Operating System or Database Version.............................................. 11 Certified Server Configurations for the Blackboard Learn........................................ 12 Compatible Server Configurations for the Blackboard Learn..................................... 12 Certified Server Configurations for Blackboard Learn - Course Delivery, Basic Edition...... 13 Compatible Server Configurations for Blackboard Learning System – Basic Edition .......... 13 End User Configuration Matrix .............................................................. 14 End User Configuration Guidelines ................................................................... 14 Supported Paths for Importing and Restoring Courses ................................. 15 Supported Paths for Blackboard Learn Release 9 .................................................. 15 Supported Update Paths ...................................................................... 16Performance and Scalability in Blackboard Learn 9 ...................................... 17 See Also ................................................................................................... 17 Performance Improvements for Blackboard Learn 9 ................................... 18 Processing ................................................................................................ 18 Module Pages............................................................................................. 18 Discussion Board, Assessments, and the Grade Center............................................ 18 Server Caching ........................................................................................... 18 Performance Comparison..................................................................... 19 Chart 1 .................................................................................................... 20 Chart 2 .................................................................................................... 21 Recommended Deployment Configurations .............................................. 22 See Also ................................................................................................... 22Update Instructions from Release 8 for Windows ......................................... 23 Overview.................................................................................................. 23Upgrading Blackboard Academic Suite to Blackboard Learn Page 3©2009 Blackboard Inc. Proprietary and Confidential
  4. 4. Run the Updater on a Load-Balanced System....................................................... 23 Run the Updater on Windows ......................................................................... 23 Troubleshooting the Updater.......................................................................... 24 Language Pack Changes ................................................................................ 25 Update Failure due to Strict Password Requirements (SQL Server) ............................. 25Update Instructions from Release 8 for UNIX............................................... 26 Overview.................................................................................................. 26 Run the Updater on a Load-Balanced System....................................................... 26 Run the Updater on UNIX .............................................................................. 26 Troubleshooting the Updater.......................................................................... 27 Language Pack Changes ................................................................................ 27Upgrading Blackboard Academic Suite to Blackboard Learn Page 4©2009 Blackboard Inc. Proprietary and Confidential
  5. 5. IntroductionAbout this documentThis document provides Administrators with the information needed for a successful installation.This includes information on running the Updater, product and browser compatibility, andchanges to the system from the previous release.This document provides Instructors with information about new features and enhancements. Thisincludes information on browser compatibility, new feature descriptions, and changes to thesystem from the previous release.What does it contain?This document contains the following sections: • Reference materials – Lists and describes reference manuals available for this release. • Compatibility Matrixes – Explains dependencies between the new application and existing Blackboard applications in the field. Included is information on which server configurations are supported with this release, and which end user browsers and operating systems are supported. • Performance and Scalability in Release 9 – Outlines the improvements in performance and scalability in Blackboard Learn Release 9. • Update Instructions for Windows – Describes general information about the Blackboard Learn Updater for Windows and the steps for running the Updater. • Update Instructions for UNIX – Describes general information about the Blackboard Learn Updater for UNIX and explains steps for running the Updater.Resolved Issues from previous releases and Known Issues in the current release can be found inseparate reports. Please check Behind the Blackboard for more information. Warning: Obtain a license key that is meant for Blackboard Learn Release 9 before attempting to install the software.Upgrading Blackboard Academic Suite to Blackboard Learn Page 5©2009 Blackboard Inc. Proprietary and Confidential
  6. 6. Reference MaterialsUpgrade Kit DocumentsTo assist in the upgrade process, Blackboard has produced an Upgrade Kit comprised ofdocumentation resources. • Understanding the Change – Materials designed to help the user transition from Academic Suite 8 to Blackboard Learn. • Upgrading Academic Suite 8 to Blackboard Learn 9 – This document includes specific instructions for administrators. • Blackboard Learn Setup Manual – This document outlines the specific procedures necessary to install Blackboard Learn. • Blackboard Learn Supported Server and Client Configurations – Comprehensive matrices that present the operating systems, databases, and web browsers that are supported by Blackboard. • Hardware Sizing Guides – These materials are designed to help clients achieve high service levels and reduce risk by properly configuring and sizing the implementation of Blackboard Learn on Dell or Sun application and database servers. • Known Issues Report– A report detailing the known issues in Blackboard Learn.Other Reference MaterialsA full suite of reference materials is available for Blackboard Learn. All materials are located inthe Reference Center at http://behind.blackboard.com. These materials include the following: Re so ur ce Na me Descript ion Blackboard Learn Hardware/Software Guide Performance and Capacity Planning Guide Helps Administrators achieve the best performance for their implementation of Blackboard Learn. Hardware Sizing Guide Helps Administrators plan their hardware needs for running the Blackboard Learn. Supported Client Configurations Outlines the Web Browsers and Java Virtual Machine versions that are supported for Blackboard Learn. Supported Server Configurations Details the Operating Systems, Databases, and Java Virtual Machine versions that are supported for use on servers hosting Blackboard Learn. Blackboard Learn Installation Guide Setup Manual Installing Blackboard Learn.Upgrading Blackboard Academic Suite to Blackboard Learn Page 6©2009 Blackboard Inc. Proprietary and Confidential
  7. 7. Re so ur ce Na me Descript ion Blackboard Learn Administrator Guides and Manuals System Administrator Manual Reference manual detailing the tools and functions available through the System Administrator Panel. Server Administration Manual Background information, specific instructions, and resources covering different types of end-user authentication, application architecture, Virtual Installations, and SSL. Advanced Integration and Data Management Background information on integration and Manual instructions for using integration tools included in Blackboard Learn. Outcomes Manual This provides information and instructions on the usage and capabilities of the Outcomes System. Blackboard Learn API Specifications and Building Blocks Introduction to the Building Blocks APIs and Reference material about the Building Block Runtime APIs and Runtime for developers creating Building Blocks. System Extension Developers Guide An overview of the Building Block framework and a quick start reference to begin creating Building Blocks. Module Developers Guide A quick start reference to create Building Block modules. Building Block API Specifications The Building Block API JavaDoc; this serves as the authoritative reference for developers creating Building Blocks for the Blackboard Learning System and the Blackboard Community System. Administrative API Specifications The Snapshot API JavaDoc; this serves as the authoritative reference for Administrators using the snapshot tool. Blackboard Learn End User Manuals User Manual Reference manual detailing the tools and functions included in the platform from the general user perspective. This manual includes information on Blackboard Learn. Instructor Manual Reference manual providing detailed information about building and managing Courses and Organizations. This manual includes information on Blackboard Learn.Upgrading Blackboard Academic Suite to Blackboard Learn Page 7©2009 Blackboard Inc. Proprietary and Confidential
  8. 8. Re so ur ce Na me Descript ion Blackboard Content System API Specifications and Building Blocks Blackboard Learning Content Building Blocks The Building Block API JavaDoc for the API Specifications Blackboard Content System; this serves as the authoritative reference for developers creating Building Blocks for the Blackboard Content System. Blackboard Learning Content End User Manuals User Manual Reference manual detailing the tools and functions included in the system for all end users. This manual includes information on Blackboard Learning Content. Understanding the Change Understanding the Change from Blackboard This document is designed to give the users Academic Suite Release 8 to Blackboard a comprehensive look at the features and Learn functions of Blackboard Learn, Release 9, and how they compare to the Blackboard Academic Suite, Release 8. Understanding the Change from CE 4 to This document is designed to give the users Blackboard Learn a comprehensive look at the features and functions of Blackboard Learn, Release 9, and how they compare to the Blackboard Learning System – CE, Release 4. Understanding the Change from CE 8 to This document is designed to give the users Blackboard Learn a comprehensive look at the features and functions of Blackboard Learn, Release 9, and how they compare to the Blackboard Learning System – CE, Release 8. Online Resources EduGarage EduGarage is the home of the Blackboard Developer Community, an innovative group of over 2000 technical experts with a passion for using technology to enhance teaching and learning. There are a variety of resources available: documentation, tutorials, developer forums, and many others. www.edugarage.com Maintenance Center The Blackboard Maintenance Center provides up-to-date information about releases to help you make informed decisions about the maintenance of Blackboard Learn and supported technologies. Access this resource by logging into Blackboard Support using a valid username and password. support.blackboard.comUpgrading Blackboard Academic Suite to Blackboard Learn Page 8©2009 Blackboard Inc. Proprietary and Confidential
  9. 9. Re so ur ce Na me Descript ion Reference Center The Reference Center contains a large number of documentation resources for the latest version as well as past versions. Access this resource by logging into Blackboard Support using a valid username and password. support.blackboard.comUpgrading Blackboard Academic Suite to Blackboard Learn Page 9©2009 Blackboard Inc. Proprietary and Confidential
  10. 10. Compatibility MatrixesOverviewThis section of the document includes information on the following: • Server Compatibility Matrix – Explains which server configurations are supported with this release. The required versions of databases and operating systems are included here. • End User Compatibility Matrix – Reviews which end-user browsers and operating systems are supported with this release. • Supported Paths for Importing and Restoring Courses – Details the supported paths for import and restore of courses from earlier releases. • Supported Update Paths – Outlines the supported update paths from earlier releases to Blackboard Learn. Note: Refer to the Blackboard Learn Release Maintenance Center or the Faculty Support Resource Center for up-to-date configurations and compatibility matrixes.Upgrading Blackboard Academic Suite to Blackboard Learn Page 10©2009 Blackboard Inc. Proprietary and Confidential
  11. 11. Server Compatibility MatrixServer CompatibilityServer software must meet certain requirements before installing Blackboard Learn, Release 9.The following are important to keep in mind when setting up the server software: • The database is run on a separate server when using two or more servers. Thus, appropriate client tools for the database must be installed on the Application server or servers when using a configuration with two or more servers. • Certified configurations are fully tested and supported. • Compatible configurations are partially tested but should function properly. • Windows users: When installing the Java SE Development Kit (JDK), make sure that both the JDK and the JRE components are installed to different locations. Also, ensure that there are no spaces in the path name to either the JDK or the JRE. • Solaris users: ensure that the Swap space for the operating system is at least twice the amount of physical RAM on the server. Note: Clients running the Blackboard Learn on a Windows Operating System must install the .NET framework if they plan on using .NET Building Blocks.Updating the Operating System or Database VersionWhen installing an update to the operating system or database to support a new version of theBlackboard Learn, always update the Blackboard Learn and then make the updates to thedatabase and operating system. Installing the database or operating system on an earlier versioncreates the risk of destabilizing the existing, earlier version. Please take care to back up thedatabase and file system and test the restore process before installing an update. Warning: Before installing or upgrading to Blackboard Learn Release 9, upgrade to SQL Server 2005 Service Pack 2. Otherwise the install/update will fail.Upgrading Blackboard Academic Suite to Blackboard Learn Page 11©2009 Blackboard Inc. Proprietary and Confidential
  12. 12. Certified Server Configurations for the Blackboard Learn W in dow s S u n So la r is Red Hat E nt er pr i se L i nu x Microsoft® Windows® 2003 Sun® Solaris™ 10 Red Hat® Enterprise Server SP1 (32-bit) 64-Bit SPARC Linux® 4.0 • Microsoft® SQL Server 2005 Enterprise • Oracle 10g R2 • Oracle 10g R2 Edition or Microsoft® SQL Server 2005 version 10.2.0.3 version 10.2.0.3 Standard Edition SP2 • Java SE • Java SE • Microsoft® Internet Information Server Development Kit Development Kit (IIS) 6 (not included with Blackboard) (JDK) 5 (JDK) 5 • Java SE Development Kit (JDK) 5Compatible Server Configurations for the Blackboard Learn W in dow s S u n So la r is Red Hat E nt er pr i se L i nu x Microsoft® Windows® 2003 Sun® Solaris™ 10 Red Hat® Enterprise Server SP1 (32-bit) Update 2 Linux® 4.0 Red Hat Enterprise Server 5, 32-Bit Red Hat Enterprise Server 5, 64-Bit • Microsoft® SQL Server 2005 Enterprise • Oracle 10g R2 • Oracle 10g R2 Edition or Microsoft® SQL Server 2005 version 10.2.0.2 version 10.2.0.2 Standard Edition SP2 • Java SE • Java SE • Microsoft® Internet Information Server Development Kit Development Kit (IIS) 6 (not included with Blackboard) (JDK) 5 (JDK) 5 • Java SE Development Kit (JDK) 5 • Mixed mode compatible: 32-bit application servers with a dedicated, 64-bit database serverUpgrading Blackboard Academic Suite to Blackboard Learn Page 12©2009 Blackboard Inc. Proprietary and Confidential
  13. 13. Certified Server Configurations for Blackboard Learn - Course Delivery,Basic Edition W in dow s S u n So la r is Red Hat E nt er pr i se L i nu x Microsoft® Windows® 2003 Sun® Solaris™ 10 Red Hat® Linux® Server SP1 (32-bit) Update 2 Enterprise Linux 4.0 • Microsoft® SQL Server 2005 Enterprise • Small-scale Oracle • Small-scale Oracle Edition or Microsoft® SQL Server 2005 10g R2 version 10g R2 version Standard Edition SP2 10.2.0.2 10.2.0.2 • Microsoft® Internet Information Server • Java SE • Java SE (IIS) 6 (not included with Blackboard Development Kit Development Kit Learn) (JDK) 5 (JDK) 5 • Java SE Development Kit (JDK) 5Compatible Server Configurations for Blackboard Learning System –Basic Edition W in dow s S u n So la r is R e d H at L in ux Microsoft® Windows® 2003 Sun® Solaris™ 10 Red Hat® Enterprise Server SP1 (32-bit) Updater 2 Linux® 4.0 • Microsoft® Internet Information Server • Small-scale Oracle • Small-scale Oracle (IIS) 6 (not included with Blackboard 10g R2 version 10g R2 version Learn) 10.2.0.2 10.2.0.2 • Java SE Development Kit (JDK) 5 • Java SE • Java SE Development Kit Development Kit (JDK) 5 (JDK) 5Non-English applications, both operating systems and databases (such as a Chinese-languageversion of Oracle), are considered compatible with Blackboard Learn Release 9. These systemshave not undergone official Blackboard Product Development testing.Upgrading Blackboard Academic Suite to Blackboard Learn Page 13©2009 Blackboard Inc. Proprietary and Confidential
  14. 14. End User Configuration MatrixEnd User Configuration GuidelinesEnd users must use a certified or compatible operating system and browser configuration with theBlackboard Learn. All configurations marked as Compatible and have undergone a limitedengineering analysis to test areas of the Blackboard Learn that may have browser issues. B row ser W in dow s W in dow s Mac OS Mac OS Mac OS XP Vista 1 0 .3 1 0 .4 1 0 .5 De skt op Microsoft Compatible Certified Not Tested Not Tested Not Tested Internet Explorer 7 Mozilla Certified Certified Not Tested Certified Certified Firefox 3.0.3 Apple Not Tested Not Tested Not Tested Compatible Certified Safari 2 Apple Not Tested Not Tested Not Tested Certified Certified Safari 3 Ke y Certified This configuration has been fully tested and is fully supported by Blackboard. Compatible This configuration has had key application areas tested and is fully supported by Blackboard. There may be unknown issues present. Not tested The specified browser is not supported for the Operating System. Not Supported This configuration is not supported by Blackboard.Upgrading Blackboard Academic Suite to Blackboard Learn Page 14©2009 Blackboard Inc. Proprietary and Confidential
  15. 15. Supported Paths for Importing and Restoring CoursesSupported Paths for Blackboard Learn Release 9The table below identifies the supported paths for importing or restoring a Course that wasexported or archived from an earlier version. Certified paths are fully tested and supported byBlackboard. Compatible paths are not fully tested but should function correctly based on pastperformance. Source* Su pp ort Academic Suite Release 8 Certified Academic Suite Release 7 Certified Academic Suite Release 6 Certified Blackboard ML Certified Blackboard 5.5** Certified Blackboard 5.0** Compatible CourseInfo 4 Not Supported*Paths for Importing and Restoring Courses are not backward compatible. Courses may beImported or Restored to a newer version, but Courses from a newer version may not be Importedor Restored to an earlier version.**Blackboard 5 and Blackboard 5.5 did not include an Archive and Restore function. Coursesfrom these releases may be imported but Courses cannot be restored with user data andinteractions intact.Upgrading Blackboard Academic Suite to Blackboard Learn Page 15©2009 Blackboard Inc. Proprietary and Confidential
  16. 16. Supported Update PathsThe table below outlines the update paths for Release 8. P r e vi o u s V e r s io n D irect U pda te to 9? Details 8.0 SP4 Yes 8.0 SP3 No Must upgrade to SP4. This is a direct update. 8.0 SP2 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn. 8.0 SP1 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn. 8.0 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn. 7.3 SP2 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn. 7.3 SP1 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn. 7.3 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn. 7.2 SP1 No Must upgrade to 8.0 SP4 before upgrading to Blackboard Learn.Upgrading Blackboard Academic Suite to Blackboard Learn Page 16©2009 Blackboard Inc. Proprietary and Confidential
  17. 17. Performance and Scalability inBlackboard Learn 9This section on performance and scalability provides an overview of performance enhancementsand resolved issues. Blackboard continuously invests in making Blackboard Learn moreresponsive and able to handle greater volumes of user traffic.Performance issues are defined as issues in which application responsiveness for a system notunder load fails to meet user expectations. Scalability issues are defined as issues in whichapplication responsiveness or stability of a page request for a system under load fails to meetuser expectations.Issues are identified from previous releases by clients through our traditional support channels.Issues are also identified from an array of performance and scalability exercises performed aspart of the standard release.See Also • Performance Improvements for Blackboard Learn 9 • Recommended Deployment ConfigurationsUpgrading Blackboard Academic Suite to Blackboard Learn Page 17©2009 Blackboard Inc. Proprietary and Confidential
  18. 18. Performance Improvements for Blackboard Learn 9A major theme of Blackboard Learn, Release 9 is page responsiveness. The user interface wasredesigned using client-rich technologies to enhance the processing efforts to display a page.Improvements have been made regarding the number of clicks or page requests for a user toperform an operation in the system. Navigation has been improved with a more robust coursemanagement area in the navigation bar. Users may customize their navigation menu from a listview to a folder view; a floating navigation menu is also available. Content authoring has beenimproved from a click-through perspective. The user interface now provides a context menu toperform child actions from the current page, rather than navigating a management orconfiguration page to perform a secondary operation.ProcessingIn previous releases, processing efforts were driven by the application and databasecomponents. In Release 9, the distribution of processing includes client-side browser processingas well as processing requirements from the application and database components. Perceivedresponse time for a page to load will improve as page elements are loaded asynchronously.Module PagesModule pages such as the My Institution page, Course Home page, Group Home page andSystem Administration page are configured by default to load asynchronously by default. Thismeans that each module is rendered upon request and the data for each module loadsasynchronously. This feature existed in previous releases, but was not enabled by default. Aspart of the installer or updater process, modules capable of loading asynchronously are nowconfigured to load asynchronously.Discussion Board, Assessments, and the Grade CenterPerformance enhancements were made to the Discussion Board and Assessment engine toimprove query performance and responsiveness for such activities as reading discussion threads,as well as executing a quiz or test. These changes remove the dependency for a cross-referencetable (X-table) to traverse the parent-child relationship tree of these types of entities. The overallnumber of logical I/O operations to obtain the result set for the user has been decreased.Performance enhancements were also made to the Grade Center for courses with largeenrollment and/or item counts. Enhancements were made to the default grid view to reduce theamount of data sent to the users browser. This reduces the memory footprint on the client, aswell as the response time to load the Grade Center. Additional changes were made to the GradeCenter View Grade History page to avoid Out of Memory exceptions occurring on courses with alarge amount of audit records (greater then 1000).Server CachingA new server-side caching architecture was introduced in this release to reduce round-trippingrequests to the database for cases where the data will not change during the course of a userssession. Each of these caching structures is configured within the bb-config.properties fileand can be adjusted on a case-by-case basis.Upgrading Blackboard Academic Suite to Blackboard Learn Page 18©2009 Blackboard Inc. Proprietary and Confidential
  19. 19. Performance ComparisonBlackboard Learn, Release 9 is the quickest and most scalable release to date. Performancetesting and benchmarking exercises have not only yielded improved response times andworkload capacity, but also the greatest amount of stability of a transaction under load.The charts below provide a caption of the performance and scalability difference betweenRelease 8, Application Pack 4 and Release 9. Each chart is focused on a different data point.In the first chart, the data point presented is active sessions. An active session represents anauthenticated user in the application. The data is based on a single Java Virtual Machine (JVM).The application can scale beyond a single JVM as noted in the recommended configuration topic,as well as the Hardware Sizing Guides available Behind the Blackboard. In release 8, a singleJVM could sustain roughly 750 to 1000 active sessions with exceptional response times. Anexceptional response time is defined at 90% of all transactions faster then 2 seconds, 9 percentbetween 2 and 10 seconds and 1 percent greater then 10 seconds (none greater then 30seconds). In release 9, a single JVM could sustain 1150 to 1500 active sessions with exceptionalresponse times.The second chart provides a response time summary for five critical transactions in the system.The response time mean (average) has been identified for a calibrated workload. A calibratedworkload is defined as an appropriate workload for performance testing in which exceptionalresponse times can be achieved. As noted below, response time improvements are achieved inRelease 9 for all 5 of the identified transactions: • Login to the application • Accessing the Course Home page • Launching an Assessment of 25 Questions (Quiz or Test) • Reading a Discussion Post (~350 words) • Opening a Grade Center (50 students and 50 items)Transaction response times can vary based on the volume of data the user interacts with, as wellas the condition of the system at the time the transaction is being performed. The transactionspresented below are based on response time means for average size content. Response timebehavior should remain relatively similar regardless of operating system deployments. Note: The data presented is not a service level agreement about sizing the application. If a configuration is unable to achieve an expected workload, configuration changes may be necessary to meet workload requirements.Upgrading Blackboard Academic Suite to Blackboard Learn Page 19©2009 Blackboard Inc. Proprietary and Confidential
  20. 20. Chart 1Upgrading Blackboard Academic Suite to Blackboard Learn Page 20©2009 Blackboard Inc. Proprietary and Confidential
  21. 21. Chart 2Upgrading Blackboard Academic Suite to Blackboard Learn Page 21©2009 Blackboard Inc. Proprietary and Confidential
  22. 22. Recommended Deployment ConfigurationsBlackboard Learn, Release 9 has a flexible deployment architecture. Clients may deploy theapplication in a traditional horizontal manner in which separate physical application servers cansupport an installation of the application. The overall environment would use a shared file systemfor content.Clients may also make use of virtualization technologies such as VMWare, Xen, or Solaris Zonesthat support the identical platform technologies certified and supported for this release.A third deployment option is to make use of clustering at the application layer. This allows asingle installation to load-balance from the web server to multiple JVMs. All three configurationsare designed to make the best use of available hardware resources. It is recommended that anyor a combination of two or three of these options be used for deployment purposes.See AlsoFor more information about deploying Blackboard Learn, refer to the Hardware Sizing Guides(for Dell and Sun) found on Behind the Blackboard.Upgrading Blackboard Academic Suite to Blackboard Learn Page 22©2009 Blackboard Inc. Proprietary and Confidential
  23. 23. Update Instructions from Release 8 for WindowsOverviewBefore running the updater, please backup the system and make sure it can be restored. Note: It is strongly recommended to turn off various utilities that may conflict with the update process, such as Firewalls, Virus Scanners, and Backup Utilities.Run the Updater on a Load-Balanced SystemThe Updater must be run on each Application server and the Collaboration server on aload-balanced system. After running the Updater the first time, choose the Update an App Serverfor all other Application servers and the Collaboration server. This option will update theapplication files without making any of the database changes. If .NET Building Blocks are used inthe system, please see the troubleshooting section below for an important step to ensure that.NET Building Blocks function correctly in a load-balanced system.Run the Updater on WindowsFollow these steps to run the Updater on Windows: 1. Make sure that the Java environment variable is properly set. 2. Click on the Updater file to launch it. 3. A welcome message will appear with a reminder to read the release notes and the installations instructions completely before updating. Click Next to continue. 4. The first updater page confirms the auto-detected install and content directories. Click Next to accept the defaults or enter new values and then click Next. Load-Balanced users should use the mapped UNC path. 5. The next prompt presents several options. The options are Update, Provide new License file, Uninstall Blackboard Learn, and Uninstall Application Server. Select the appropriate option and click Next. The Update option will use the license file already configured and Provide new license file will update the system and apply the new license. 6. A message will appear that displays the changes that will be made when the Updater is run. Click Next to start the update. If the Updater was launched from the command line, do not close the command line window or any of the other windows that pop-up during the update.Upgrading Blackboard Academic Suite to Blackboard Learn Page 23©2009 Blackboard Inc. Proprietary and Confidential
  24. 24. Troubleshooting the UpdaterThe Updater logs are an important source of information when troubleshooting issues that ariseduring an update. The Updater writes the following logs:blackboardlogsbb-installer-log.txtIf the installer log file does not identify the problem, the update tool log most likely contains thecause of any installation errors:blackboardlogsupdate-toolsupdate-tool-log.txtAlso check:blackboardlogsinstallblackboardlogsinstalldb-install-errors-log-bb_bb60.txtblackboardlogsinstalldb-install-errors-log-bb_bbadmin.txtblackboardlogsinstalldb-install-info-log-bb_bb60.txtblackboardlogsinstalldb-install-info-log-bb_bbadmin.txtMicrosoft .NET Building Blocks on load-balanced configurationsAfter running the update, an error message may appear in the system when attempting to launcha Building Block built using Microsoft .NET. The system reports a Parser Error Message. Toresolve the problem, copy the Webapp directory for any Building Blocks created using Microsoft.NET to each application server so that the directories may be accessed locally. Here is anexample of the Webapp directory for a Building Block .NET directory on the UNC share:UNC_server_namebb_contentvibb_bb60pluginsname_of_building_blockwebappAfter copying the Building Blocks directories to each application server, follow these steps toremap the virtual directory in IIS on each application directory to point to the local directory: 1. Open Start. Select Programs. Select Administrative Tools. Select Microsoft .NET Framework 1.1 Configuration. 2. Expand Runtime Security Policy. Select Machine. Select Code Groups. Select All_Code. 3. Right-click All_Code. Select New... 4. Create a code group name, for example dotNETB2, and then choose Next. 5. Set condition type to URL. 6. In the URL field, enter: file:////[local_server_name][sharename] for example: file:////bb_app_server_01bb_contentvi* 7. Restart IIS.Upgrading Blackboard Academic Suite to Blackboard Learn Page 24©2009 Blackboard Inc. Proprietary and Confidential
  25. 25. Language Pack ChangesTo ensure consistency across releases, the Blackboard Learn Updater will compare the existingen_US language pack against the version that is being installed. The differences are noted andoutput in a file called bundle_diff.txt. This file is added to theblackboard/backups/<updater_time_stamp> directory. Use this file to review the text differencesbetween releases and make updates to any custom Language Packs.Update Failure due to Strict Password Requirements (SQL Server)On an update with SQL Server, the installation may fail due to the strict parameters for passwordrequirements. The user will receive the following message:Password validation failed. The password does not meet Windows policy requirementsbecause it is too short.To override or reset the password requirements run the installer as follows (text in caps should befilled in as appropriately): java -jar bb-as-PLATFORM-VERSION.jar -configmycustom.propertiesUpgrading Blackboard Academic Suite to Blackboard Learn Page 25©2009 Blackboard Inc. Proprietary and Confidential
  26. 26. Update Instructions from Release 8 for UNIXOverviewBefore running the updater, please backup the system and make sure it can be restored. Solarisusers: ensure that the Swap space for the operating system is at least twice the amount ofphysical RAM on the server. Note: It is strongly recommended to turn off various utilities that may conflict with the update process, such as Firewalls, Virus Scanners, and Backup Utilities.Run the Updater on a Load-Balanced SystemThe Updater must be run on each Application server and the Collaboration server on a load-balanced system. The method is similar to the Installer—the Updater is run on each Applicationserver in sequential order and then run on the Collaboration server (if the Collaboration serverresides on a separate server). After running the Updater the first time, choose the Update an AppServer for all other Application servers and the Collaboration server. This option will update theapplication files without making any of the database changes.Run the Updater on UNIXFollow these steps to run the Updater on UNIX. 1. Open a command-line prompt and navigate to the directory that holds the Updater. 2. Run the following command to launch the Updater: $JAVA_HOME/bin/java -jar <updater_file> If Xwindows or a similar GUI is running and the DISPLAY variable is properly configured, the Updater will launch in GUI mode (remember that the following steps assume that the command line Updater is used) A welcome message will appear with a reminder to read the release notes and the installations instructions completely before updating. Hit ENTER to continue. 3. Instructions will appear for navigating through the Updater prompts. The Updater, in most cases, will provide a default value in brackets. Hit ENTER to accept the default and continue or enter a different value. Hit ENTER to continue after entering a new value. 4. The first Updater prompt asks for the directory where Blackboard will be found. Hit ENTER to accept the default or enter a new value and then hit ENTER. If The Blackboard Learn is not found in the directory provided, the Updater will attempt to install at the given location. 5. The next prompt presents several options. The options are Update, Provide new License file, Uninstall Blackboard Learn, and Uninstall Application Server. Enter 1 and click ENTER to select Update. 6. A message will appear that displays the changes that will be made when the Updater is run. Hit ENTER to start the update.Upgrading Blackboard Academic Suite to Blackboard Learn Page 26©2009 Blackboard Inc. Proprietary and Confidential
  27. 27. Troubleshooting the UpdaterThe Updater logs are an important source of information when troubleshooting issues that ariseduring an update. The Updater writes the following logs:/blackboard/logs/bb-installer-log.txtIf the installer log file does not identify the problem, the update tool log most likely contains thecause of any installation errors:/blackboard/logs/update-tools/update-tool-log.txtAlso check:/blackboard/logs/install//blackboard/logs/install/db-install-errors-log-bb_bb60.txt/blackboard/logs/install/db-install-errors-log-bb_bbadmin.txt/blackboard/logs/install/db-install-info-log-bb_bb60.txt/blackboard/logs/install/db-install-info-log-bb_bbadmin.txtLanguage Pack ChangesTo ensure consistency across releases, the Blackboard Learn Updater will compare the existingen_US language pack against the version that is being installed. The differences are noted andoutput in a file called bundle_diff.txt. This file is added to theblackboard/backups/<updater_time_stamp> directory. Use this file to review the text differencesbetween releases and make updates to any custom Language Packs.Upgrading Blackboard Academic Suite to Blackboard Learn Page 27©2009 Blackboard Inc. Proprietary and Confidential

×