Skip to main content
pdf?stylesheet=default
Blackboard Help

Run the Pre-Update Change Report

If you are a Managed Hosting customer, this topic doesn't apply to you.
 

The Pre-Update Change Report reviews the currently installed system to ensure that it meets the requirements for the upgrade. It then reports its findings and a list of all the file changes that will occur when the Installer is run.

Run the pre-update change report on Windows

  1. Double-click the Installer. Alternatively, open a command line prompt and navigate to the directory that contains the Installer.
  2. Run the following command to launch the Installer graphical interface:

    C:\bb_installer>java –jar installer_file

    Alternatively, run the following command to launch the Installer command line interface:

    C:\bb_installer>java –jar installer_file -text

    Remember that the rest of these steps assume that the graphical interface is being used.

  3. After reading the welcome message, press ENTER to continue.
  4. The first page asks where the Blackboard Installation Directory is found. Select Next to accept the defaults or provide new values and then select Next. If Blackboard Learn is not found in the directory provided, the Installer will attempt to install at the given location.
  5. On the next page, select Pre-Update Change Report and select Next.

    The update-report.log file will appear in the Installer directory. This file includes important information about what changes will occur when the Installer is run.


Run the pre-update change report on UNIX

  1. Open a command-line prompt and navigate to the directory that contains the Installer.
  2. Execute the root user login profile:

    ./su -root

  3. Run the following command to launch the Installer:

    $JAVA_HOME/java –jar installer_file

  4. After reading the welcome message, press ENTER to continue.
  5. The first page asks where the Blackboard Installation Directory is found. Press ENTER to accept the defaults or provide new values and then select Next. If Blackboard Learn is not found in the directory provided, the Installer will attempt to install at the given location.
  6. At the next prompt, select Pre-Update Change Report and select Next.

    The update-report.log file will appear in the Installer directory. This file includes important information on what changes will occur when the Installer is run.

Port error

On running the Pre-Update Change Report there may be an error relating to port conflicts with the Collab service:

Port 8443 for property bbconfig.appserver.https.portnumber conflicts with bbconfig.collabserver.portnumber.ssl.default. Configure a non-conflicting port, ideally the default value: 8443

If this issue occurs:

  1. Navigate to ..\blackboard\config\ and make a backup copy of bb-config.properties.
  2. Open bb-config.properties in a text editor such as vi or Notepad.
  3. Locate the collaboration server configuration settings section and change the portnumber.ssl.default to 8012

    bbconfig.collabserver.portnumber.ssl.default=8012

  4. Save the bb-config.properties file.