Install Guides

 

Release 3.0.13.bb9

January 26, 2010

 

• Blackboard 9.0

NOTES: 

·         For information on new features and/or bugs fixed in this version, please view the release notes on our web site.

·         If Teams LX and/or Journal LX are also installed on your Blackboard server, you must first upgrade Expo LX to v3.0.x after inactivating Teams LX and/or Journal LX. Also, it is important that Expo LX, Teams LX and Journal LX are all upgraded to 3.0.x.

 

1.       Download the loi-expolx-3.0.x.war file from the download site and save it to your desktop.

2.       Navigate to the System Admin tab in Blackboard.

3.       Click on Manage Building Blocks.

4.       Click on Install Building Block.

5.       Click on the Browse button, and find and select the saved loi-expolx-3.0.x.war file.

6.       Click the Submit button on the web page. The file will then upload.

7.       Click on the OK button on the receipt page to return to the Manage Building Blocks page.

8.       Change the status of Expo LX to Available.

9.       Click on the OK button on the Make Building Block Available page.

10.   The extension is now installed.

1.       Login to the Blackboard server as an administrator.

2.       Click on the System Admin tab.

3.       Click on Manage Expo LX link under Tools.

4.       Click on the Register your extension link.

5.       Complete the form on the Register Expo LX page and accept the license. If you do not have a promotional code, leave that field blank.

6.       Click submit on the form.

7.       Click OK on the receipt page.

Within 24 hours, a registration key will be emailed to the address entered in the form.

8.       Return to the Expo LX License page.

9.       Click on the Install your key link.

10.   Copy the key from your email into the text box.

11.   Accept the license.

12.   Click submit on the form.

13.   The extension is now registered.

1.       Login to the Blackboard server as an administrator.

2.       Click on the System Admin tab.

3.       Click on the Manage Tabs link under Portal System - Management.

4.       Click on the Modify button associated with the My Institution tab.

5.       Click on the Default Content link.

6.       Find the Expo Sites portal module.

7.       Check both the Displayed and Required boxes.

8.       Click submit.

9.       The portal module is now available to all users.

1.       Login to the Blackboard server as an administrator.

2.       Click on the System Admin tab.

3.       Click on the Manage Expo LX link under Admin Tools.

4.       Click on the Manage Settings link.

5.       Update the storage location of Expo sites.

6.       Update the information the users are allowed to make publicly available.

7.       Update the name of the tab that the Expo LX portal module is on.

8.       Update the name of Expo LX.

9.       Click submit.

A full list of known issues is in the Campus Pack release notes

1.       Login to the Blackboard server as an administrator.

2.       Click on the System Admin tab.

3.       Click on Manage Building Blocks.

4.       Change the status of Expo LX to Inactive.

5.       Click on the OK button on the receipt page to return to the Manage Building Blocks page.

6.       Return to the Manage Building Blocks page.

7.       Click on the remove button for Expo LX.

If a previous release of Expo LX is installed, it must be uninstalled by following the uninstall instructions (above), and then installing the newer release.

• All Expo LX content remains in the system during an upgrade. There is no need to do anything to any Expo sites or their content.
• If there was a link to the Expo tool in the Tool panel, that link must be re-created after the upgrade. Likewise, if a tool tab was created for the Expo tool, the tab must be re-created after the upgrade.
• If a license key was installed with the previous release, it will continue to function with the newer release. The license does not need to be reapplied.
• If you are on Blackboard 7 or later, a Migrate Filenames script will automatically be run upon installation of the 2.8.x build in order to avoid corruption of Expo sites due to a bug in Blackboard 7. To review the status of this script, navigate to the Manage Expo LX area in the Administrator Panel and select the "Administration Tasks" link. The "Migrate old-format filenames" task will indicate the progress of this script. If the script has not fully executed, you may select the "Execute" button for this task in order to execute the script manually.
  Note: In previous versions of Expo LX, adminstrators were required to run the Migrate Filenames script. This is the same script, but the administrator is no longer required to manually initiate the script.

If you have a load-balanced configuration, special care must be taken when upgrading to be sure that all of the application servers properly reload the new version. The best way to ensure this is to restart each application server after upgrading each of the Campus Pack applications. If you are unable to restart your application servers, please wait 2 to 5 minutes after removing the old versions before attempting to install the new ones.

You can check to be sure that each of the application servers upgraded correctly by viewing the Expo LX logs.

1.       Login to the Blackboard server as an administrator.

2.       Click on the System Admin tab.

3.       Click on Manage Expo LX.

4.       Click Download Logs.

5.       When prompted, save the log archive to a temporary location.

6.       Open the ZIP file and view each of the included Expo LX log files. There should be one for each application server.

7.       Look in each log for a message showing that the old version stopped, and a following message showing that the new version started.
Example:

2009-06-22 14:50:42|INFO: Expo LX v2.8.0.4487 stopped [com.learningobjects.util.ExtensionUtil.destroy]

2009-06-22 14:58:41|INFO: Logging at level INFO [com.learningobjects.util.ExtensionUtil.initLogging]

2009-06-22 14:58:41|INFO: Expo LX vx.x.x.x started on Blackboard v7.1.1.374 [com.learningobjects.util.ExtensionUtil.init]

1.       If any application server is missing these messages, restart Tomcat on that server to force it to reload the application. After it finishes restarting, check the log for that host again to ensure that the correct version is running.