VB288 Objective QoE Content Extractor 5.2.X-X

<h1>VB288 Objective QoE Content Extractor 5.2.X-X</h1>

<h2>First-time Installation</h2>

<p>Use the CD or USB images for first-time installation. Please refer to the
first-time installation instructions included there for more information.</p>

<h2>Upgrading from 5.1.0-0 or later</h2>

<p>You can upgrade the system by uploading the supplied .tea file: Select the
"Data" tab and then the "Software" sub-tab in the user interface, upload the
.tea file, click "Go!" and follow the on-screen prompts.</p>

<p>Please note that there are different .tea files depending on whether you are
upgrading from a 5.1.0 version or from a 5.2.0 version, due to some
architectural changes between the two versions.</p>

<h2>Upgrading from a version prior to 5.1.0-0</h2>

<p>When upgrading from a version prior to 5.1.0-0, some additional software
packages needs to be installed. You can either re-install the system as
mentioned below, or by running the provided upgrade script.</p>

<p>The upgrade script will install these packages as necessary. If
you have updated your system over the Internet after the initial
installation, you may need to have an Internet connection available to run
the upgrade script.</p>

<p>Copy the installation script to the system, log in as root and issue the
following command:</p>

<pre><code>./vb288-upgrade.run
</code></pre>

<p>If the installation fails, try re-installing the system as described below.</p>

<p>NOTE: If you are running on Red Hat Enterprise Linux 7 beta, you must
re-install the system.</p>

<h2>Upgrading by re-installing the system</h2>

<p>If you want to re-install the system from scratch, please follow these
steps:</p>

<ol>
<li>Backup the system configuration (Data - Configuration - Full configuration).
Log in to the system as root and copy the file
<code>/opt/btech/etc/btech.xmlcfg1e</code> to a safe location (off the system).</li>
<li>Export the current license ("About" - "License" - "Export current license
and software support keys"; 5.1.0 or later) or write down the license key
("About" - "License").</li>
<li>Possibly back up the system network configuration by logging in to the
machine and copying any files matching the wildcard
<code>/etc/sysconfig/network-scripts/ifcfg-*</code> to a safe location (off the system).</li>
<li>If you have uploaded custom images for the Remote Video Wall, make sure
you have copies of these available so that you can re-upload those
separately.</li>
<li>Re-install the system as described above.</li>
<li>Using the Software Activation page import the previous license key (under
"More options"; or re-enter it using the activation page) and activate
the software.</li>
<li>Import the configuration from Data - Configuration - Import configuration XML.</li>
</ol>

<p>If importing the old configuration fails with an error, please follow these
steps:</p>

<ol>
<li>Log in to the system as root and issue the command
<code>systemctl stop vb288.ewe</code></li>
<li>Restore the backup configuration file you made above to
<code>/opt/btech/extractor/etc/btech.xmlcfg1e</code> (note the changed path).</li>
<li>Issue the command <code>systemctl start vb288.ewe</code></li>
</ol>

<h2>Importing OTT channel list from a probe</h2>

<p>When importing a list of OTT channels from a probe, make sure to select the
"OTT configuration without thresholds" export, available in 5.1.0 software
and later. If importing from an earlier version you may need to open the
downloaded XML file and remove the lines from <code>&lt;ottThresholdPresets&gt;</code> to
<code>&lt;/ottThresholdPresets&gt;</code>. You must also remove the "crc" attribute of the
<code>&lt;ewe&gt;</code> element.</p>

<h2>Running the system</h2>

<p>When the installation is finished and the system has rebooted, the system
should come up automatically. Use a web browser and connect to
<code>http://address/</code>, where "address" is replaced by the IP address or DNS name
of the machine. All further configuration is performed from the web browser.</p>

<p>Please refer to the VB288 Objective QoE Content Extractor manual for details
on how to configure the system.</p>

<h2>License</h2>

<p>When first installed, the VB288 comes with a 30-day trial license. To use it
beyond this time, a license key is required. To generate the license code, you
will need to provide the hardware key, which can be found under "About",
"License".</p>

<p>If the system does not start up with a correct trial license, try rebooting
the machine.</p>

<h2>Known Issues</h2>

<ul>
<li><p>VBC version 5.1.0-4 or later is required to correctly display all the
alarms reported by the VB288.</p></li>
<li><p>When displaying the media window widget for probes running 5.1.0-5 or
earlier, or 5.0.2-4 or earlier, the threshold colorization does not
completely reflect what is seen on the probe.</p></li>
<li><p>Importing a configuration file exported from the system may fail with a
CRC error under certain circumstances. This problem can most often be fixed
by opening the exported configuration file in a text editor and removing the
<code>crc</code> attribute from the first line of the file.</p></li>
</ul>

<h2>Problems</h2>

<p>Please report any problems, bugs or issues that you find. Please provide us
with a copy of the output provided from "Data", "Configuration", "Debug data"
to aid us in tracking the problem down.</p>