Upgrade Caveats

The following items provide key information about upgrading with this software version.

Upgrading from 5.2 to 6.4

The nokogiri 1.8.4 gem installation failed during ISR 5.2 to 6.4 upgrade using the Dashboard.

Workaround: When the error occurs, run the following commands:
sudo yum install -y gcc ruby-devel libxml2 libxml2-devel libxslt libxslt-devel
bundle config build.nokogiri --use-system-libraries
Then run configIsr.sh to install the remaining gems.

Dashboard Rack Issue

A Dashboard rack issue has been observed during ISR 6.0.5 to 6.4 upgrade.

Workaround: Stop the puma server, using the service puma stop command, before running upgradeIsr.sh. Execute the gem uninstall rack and gem uninstall nio4r commands to uninstall the rack and nio4r gems, then execute the upgradeIsr.sh and configIsr.sh scripts.

Conversion Errors

An upgrade from 5.2 to 6.x likely results in conversion failures until each Location has been updated to properly reflect connections to the Converter using the Data Network. Log into the Dashboard and update each Location in the "Recording Converter" section by setting the "Converter IP Address" field to the Converter's data network IP address. You may confirm the Converter data IP in the "Converter Server Configurations" accordion of the corresponding RSS.