• Blackboard 6.3 or above
• Java 5.0 or above

• For information on new features and/or bugs fixed in this version, please read the release notes.
• If upgrading from a 2.8.x version of Podcast LX, be sure to run the "Archive tool links" administration task PRIOR to uninstalling Podcast LX. For more step-by-step instructions, see the "Update/Upgrade" section below.

Due to an issue in Blackboard, you may experience a "PermGen space" error when installing or activating Campus Pack. The PermGen space is a special area of the Java memory map, called the permanent generation heap, used to hold class files and related data. Repeatedly installing building blocks tends to leak memory in this heap. When the heap becomes full, building blocks may fail. Sometimes they fail when they are activated (made available); other times they fail during use. Typically, restarting Blackboard (or just Tomcat) will resolve the error, as all old classfiles will be eliminated. Deployments that perform nightly Blackboard restarts rarely see this problem; on the other hand, deployments that have not restarted in some time are quite likely to see it.

As of Blackboard 7.2, 256 MB is allocated to the permanent generation heap. This is sufficient for many building block installations. Earlier versions of Blackboard allocated only 64 MB which is not sufficient to support installing many building blocks. On such systems it may be necessary to increase the PermGen space to prevent the out-of-memory error from occurring. To do so, perform the following steps:

1. Edit the file blackboard/config/bb-config.properties. Note that this file may use UNIX line feeds which are hard to edit under Windows; it will appear as one long line with square characters instead of new lines. Please do your best to edit it anyway.
2. Search for the bbconfig.jvm.options.extra.tomcat setting (you can typically just run a Find for "extra").
3. Add the following value after the = character:
   -XX:MaxPermSize=256m -XX:PermSize=64m
   This will increase the heap size from 64 MB to 256 MB.
4. Run the blackboard/tools/admin/PushConfigUpdates script and wait for it to complete. If you have a load-balanced system with shared configuration then you will need to bounce Tomcat on your other appservers; otherwise repeat this process on each appserver.

Note that you should only perform this process if you are familiar with, and comfortable running, the PushConfigUpdates script. For further information or assistance, please contact support@learningobjects.com.

• For information on new features and/or bugs fixed in this version, please visit the support section of our web site.
• As of the 2.8.x releases, Podcast LX will have the same release numbers as the other applications in Campus Pack. If you are upgrading from a 1.1 or earlier release of Podcast LX, no additional steps are needed to upgrade to Podcast LX 2.8.x.

1. Download the loi-podcastlx-2.8.x.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.
6. Click on the Browse button, and find and select the saved loi-podcastlx-2.8.x.x war file.
7. Click the Submit button on the web page. The file will then upload.
8. Click on the OK button on the receipt page to return to the Manage Building Blocks page.
9. Change the status of Podcast LX to Available. In Blackboard versions prior to 7.2, availability is set only for the entire institution. In Blackboard 7.2, the availability must be set for both the system and courses/orgs. Note: If the Podcast LX Building Block is not enabled here for all courses and organizations, then Podcast LX must be enabled individually in each course by the instructor.
10. Click on the OK button on the Make Building Block Available page.
11. 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 Podcast LX link under Tools.
4. Click on the Register your extension link.
5. Complete the form on the Register Podcast 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 Podcast 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.

• Internet Explorer 6.0 and above on Windows
• Firefox 1.0 and above on Windows, Macintosh, and Linux
• Mozilla 1.3 and above on Windows, Macintosh, and Linux
• Netscape 7.1 and above on Windows and Macintosh
• Safari 3.0 and above on Windows and Macintosh

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 Podcast LX or Oscelot Podcaster 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 Podcast LX or Oscelot Podcaster.

1. Navigate to the Admin Panel and select the Manage Podcast LX link.
2. Select the "Administration Tasks" link.
3. Select the "Execute" button for the "Archive tool links" task.
4. When the archive task is complete, the state will be listed as "ok." Once the task is complete, uninstall the Podcast LX Building Block and install the new version.
5. Install the new version of Podcast LX and make it available.
6. After installation is complete, navigate back to the "Administration Tasks" page.
7. Select the "Execute" button for the "Restore tool links" task.
8. When the archive task is complete, the state will be listed as "ok" and all tool links to the podcast tool will be restored.

• All Podcast LX or Oscelot Podcaster content remains in the system during an upgrade. There is no need to do anything to any Podcast content.
• If a link to the Podcast LX tool existed in the course menu prior to upgrade, the link must be re-created after upgrade. The content that existed in the tool prior to upgrade will be accessible after re-creating the link.
• If the Podcast LX course tool was disabled, it must be re-disabled after the update.
• When upgrading to Podcast LX from a beta version of Podcast LX or from Oscelot Podcaster, you must register the Podcast LX and install a license key that is subsequently sent from Learning Objects. If you are upgrading from Podcast LX 1.0.2 or subsequent Podcast releases, registration is not necessary.

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 Podcast LX logs.

1. Login to the Blackboard server as an administrator.
2. Click on the System Admin tab.
3. Click on Manage Podcast 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 Podcast 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.
8. 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.