Table Of Contents
Release Notes for Cisco TV CDS 2.2.1
These release notes cover Cisco TV CDS Release 2.2.1.Revised: October 2011 OL-21788-02
The following information is in the release notes:
Release 2.2.1 of the Cisco TV CDS introduces the following new features:
Multi-Screen Video Support
Release 2.2.1 offers Multi-Screen Video (MSV) support for ISA environments with VVI and Shared Content Store. An MSV Asset Deletion script runs periodically, nightly by default. The script identifies the VOD assets that were removed by the backoffice and deletes them from the Vaults. If the asset is found in any one of the video hub offices (VHOs), the asset is not deleted. Only when the asset is not found in all VHOs is the asset deleted from the Vaults. The MSV Asset Deletion script runs by way of a cronjob.
The cronjob needs to be manually entered after upgrading the software on the Vault. To add the cronjob, do the following:
Step 1 Log in to each Vault as root.
Step 2 Edit the crontab.crontab -e30 05 * * * su - isa -c "cd Asset;./clean_orphaned_contents >& run.log&"
Step 3 Make sure the job is printed out.crontab -l
In previous TV CDS releases, there were minimal SNMP traps. In Release 2.2.1, the following SNMP traps have been added:
Dual Conditional Access System Support
Release 2.2.1 supports dual Conditional Access Systems (CASs) for ISA environments: Cisco/Scientific Atlanta Power Key Encryption System (PKES) and Motorola's OffLine Encryption Station (OLES). A new field has been added to the Monitor Completed Ingests page that indicates whether the ingested content is encrypted or not. Both clear and encrypted content can be ingested.
Bulk Configuration provides a method of configuring common parameters for all the servers at one time by using an XML file. Following are the CDSM GUI configuration pages that offer bulk configuration:
Table 1 describes the enhancements to TV CDS 2.2.1.
Release 2.2.1 of the Cisco TV CDS supports the following environments and associated backoffice integrations:
–Tandberg OpenStream backoffice
–SeaChange Axiom backoffice (NGOD architecture)
The Cisco TV CDS Release 2.2.1 runs on the CDE110, CDE220, and CDE420. See the Cisco Content Delivery Engine110 Hardware Installation Guide, and the Cisco Content Delivery Engine 205/220/420 Hardware Installation Guide.
The Cisco TV CDS Release 2.2.1 also runs on the CDE100, CDE200, CDE300, and CDE400 hardware models that use the Lindenhurst chipset. See the Cisco Content Delivery Engine CDE100/200/300/400 Hardware Installation Guide for set up and installation procedures.
Release 2.2.1 does not support the CDEs with the ServerWorks chipset. All CDEs with the ServerWorks chipset need to be replaced with the CDEs with the Lindenhurst chipset or the Next Generation Appliances (CDE110, CDE220, andCDE420) before upgrading to Release 2.2.1.
See the "Related Documentation" section for links to the documentation online.
Limitations and Restrictions
There are no limitations nor restrictions in Release 2.2.1.
There is a new driver for the new solid-state drives (SSDs) that also addresses an issue with the old SSDs.
Old SSD Issue
When an abrupt power loss occurs on an older SSD while the SSD is under load, which can also happen when the SSD is being written to and a power-off shutdown occurs, the result is that the SSD may become corrupted and unusable. If an SSD becomes corrupted in this way it must be replaced.
This driver update provides a fix to prevent the corruption of the SSD when the system is being shutdown. When the system is being shutdown the driver sends a command to the SSD to stop all activity and therefore is protected from corruption.
Note We recommend that this driver update be installed on all systems with SSDs. The driver update is compatible with both the older PV SSDs and the newer PVR SSDs.
New solid-state drives (SSDs) used in the following CDE models require a device driver update for the TV CDS software to recognize the drives:
A new Generation 2 SSD drive could occur in one of the above newly manufactured CDEs or as a returned merchandise authorization (RMA) SSD drive replacement.
The new SSDs replace the end-of-life (EOL) external 160 GB SSDs. A new SSD drive is a Generation 2 front-mounted SSD. The new SSD model is identified by the title "Intel SSD 320 Series" on the label and has the model number: SSDSA2BW160G3. For more information, see Field Notice 63438 at: http://www.cisco.com/en/US/products/ps7126/prod_field_notices_list.html.
The new driver prevents the corruption of the existing SSDs in the field when a system is shutdown. In the case of receiving any new model of SSDs, the driver must be installed.
Note The new driver is 100 percent backward-compatible with older, pre-existing SSD drives. We recommend that a proactive upgrade of the SSD driver is a good best-practice.
For more information, see the "Updating the Device Drivers for new SSDs" section.
This release contains the following open caveats:
Some CDSM GUI commands are not processed properly. In this case the Reload Service Group command needs to reach the name server through DNS search.
If the resolv.conf file is not set up manually on the CDSM CDE100 hardware, the Reload Service Group command does not complete and streaming to service groups could be affected.
Make sure DNS search is setup in resolv.conf and resubmit the Reload Service Group command through the CDSM GUI.
Reimaging a server to RHEL5 causes the first sector on the drive to be overwritten.
This issue happens when reinstalling the OS on a Streamer, Vault, or Caching Node.
Remove the front-mounted drives from the server before reimaging.
Vault crashes when over 300,000 content objects are ingested.
When ingesting more than 300,000 titles, the Vault crashes.
Do not ingest more than 300,000 titles.
Server crashed because it could not list the details of an object.
Because a drive was going in and out of repair mode, it caused the evaluators to abort and create multiple copies of some data.
Do not use the serverinfo log commands to dump detailed file map of a GOID.
RTSP server hangs because it has not received a response.
Unable to reproduce.
Restart RTSP server.
TCP sessions have unexpected termination or behavior during failure recovery.
During stream or cache-fill failure recovery, a Streamer tries to start a large number of cache-fill requests in a small window. When using HTTP as the cache protocol, the Streamer only has a fixed set of buffers used to generate packets for HTTP requests to start the recovery. If requests are built too quickly, a buffer can be re-used before the previous packet built in the buffer was sent and can cause packet corruption. This confuses the Caching Node TCP stack, typically because the sequence numbers are out of order and cause an unexpected behavior.
No workaround exists.
When mirroring between two Vaults, there are damaged content objects.
The following conditions could cause this:
–When there are mixed capabilities of two Vaults; that is, a CDE420 with 8 GigE ports, a CDE400 with 6 GigE ports, or a CDE400 with 4 GigE ports. This can cause an overflow of data from the higher capacity Vault to the lower capacity Vault.
–If thin pipe mapping is configured, and a larger pipe is set on the sending Vault than on the receiving Vault, an overflow of the pipe can occur. This typically only happens when a very thin pipe is configured, specifically a pipe that is less than 50 Mbps.
Keep the capability of the Vaults the same and do not configure very thin pipes.
The following caveats have been resolved since Cisco TV CDS Release 2.2.1. Not all resolved issues are mentioned here. The following list highlights associated with customer deployment scenarios.
Service group values greater than 32-bit signed integer (2147483647) are changed to 2147483647 prior to adding the entry to the database.
CDS environments with gigabit Ethernet streaming that have end-users on both IP Subnets and QAMs typically set their CDSM for a cable environment (QAMs), and enter both QAMs and Subnet IPs on the QAM Gateway page in the CDSM GUI. They then convert each subnet IP address to an integer and enter this on the Headend Setup page as a service group. Unfortunately the processing for service groups uses a function that restricts the entry to a 32-bit signed integer and as such, converts any value greater than 2147483647 to 2147483647.
A side effect of this defect is that it can lead to a server crash.
There is a window where if an unnecessary ARP request is made from the Control server during a cost request to determine which server is best able to play the stream, a delayed ARP response could resume the cost request and reference a stream that has been destroyed prior to the response.
A Caching Node prematurely ends a C2 transfer with a zero length HTTP chunk header. A premature termination should not include a zero length chunk header.
This condition is triggered if a Caching Node fails to fill a missing part of a content either from disk or network in the middle of a transfer.
When a Vault is offloaded, the protocol timing log does not specifically state that the server has been offloaded.
The offload functionality on Vaults does not specifically notify the Caching Node that it should be placed offline as it is managed by the backoffice integration application. As a result the informational message is not displayed in the Cserver logs.
When ingesting content with FSI ingest, there were some ingestions that failed.
When ingesting too many pieces of content at the same time and simultaneously capturing recordings, Linux will run out of memory and some of the ingestions will fail.
Database stops after time without user interaction.
Servers are configured in the .arroyorc as active replication hosts that are not reachable which causes a slow memory leak.
The STREAM_TRICK_REPORT.db continues to grow in file size.
Occurred in Release 2.0.0 fc2 on CDSM.
CDSM file system can become full and all logging will stop.
For any customer site running MSA Logging.
Tiling when jumping through an uncached asset. Macroblocking or tiling when transitioning from rewind, fast-forward or pause to 1x play.
VVI environment with Seachange Streamer. Asset must be slightly unusual in that most assets use the default 0xE0 value for the stream ID, and this asset must use something else.
Cache-Fill NICs on Vaults show as malfunctioning adapters in the protocoltiming logfile.
A combination of reduced cache-fill NICs (three or less), high fill-load (in the 1000s), and active local evaluators (local smoothing, defrag).
In specific customer integration testing, a specific backoffice sends a SETUP request for a session. RTSP server is unable to send the SETUP response back to the backoffice.
Specific Customer integration testing. SETUP requests coming on the backoffice port 554.
Rewind trick modes may appear to have regular "jitter" where a frame every so often appears out of place. On some STBs this could manifest as scrambled video frames interleaved with working ones. Other manifestations are possible. The interval should be somewhat predictable. The rate of the "jitter" should be somewhat predictable. In one case with a key change every 8 seconds in the content and a 4X trick file, a frame jitter was seen about every 2 seconds. The jitter occurs during the playback of the trick (for example, while rewinding), not at the start or end of the trick mode itself.
The content must be encrypted with PowerKey. It must be using keys that change on a regular basis.
SNMP Query to a Vault running 2.6.18-53.el5.cdstv.2.1.1.es1.b6 on: cdstvCacheStatsFillRecieveStreamCount - 126.96.36.199.4.1.159188.8.131.52.184.108.40.206 cdstvCacheStatsFillStreamActualBWinKBits - 220.127.116.11.4.1.15918.104.22.168.22.214.171.124 cdstvCacheStatsFillStreamCommittedBWinKBits - "126.96.36.199.4.1.159188.8.131.52.184.108.40.206" returns: SNMPv2-SMI::enterprises.159220.127.116.11.18.104.22.168.1 = Gauge32: 0 SNMPv2-SMI::enterprises.15922.214.171.124.126.96.36.199.1 = Gauge32: 3350 SNMPv2-SMI::enterprises.159188.8.131.52.184.108.40.206.1 = Gauge32: 0 SNMPv2-SMI::enterprises.159220.127.116.11.18.104.22.168.1 = Gauge32: 0 SNMPv2-SMI::enterprises.15922.214.171.124.126.96.36.199.1 = Gauge32: 0
All values should be zero as this is a Vault not a Streamer
This number includes the total data received for any type of packet; for example, mirror traffic, committed rate-fill traffic, monitoring and control traffic, ARP, and so on. Hence, it is normal to have non-zero value on a Vault.
On a Vault, the values represent mirroring and other traffic. On Streamers, this represents streaming traffic.
Upgrading to Release 2.2.1
For new installation, upgrade, and downgrade procedures, see the Cisco TV CDS 2.2 Installation, Upgrade, and Maintenance Guide.
Note Release 2.2 supports upgrades from Release 2.0.x and Release 2.1.x. If your CDS is running an older version, you need to upgrade to Release 2.0.x or 2.1.x, before upgrading to Release 2.2.
Note The following TV CDS software releases can coexist during an upgrade process, which allows for long upgrade windows, if necessary:
•For VVI in an ISA environment with SCS, the Release 2.1.3 software can coexist with the Release 2.2.1 software.
•For VVI in an RTSP environment with HTTP Streamers, the Release 2.1.3 ES3 software can coexist with the Release 2.2.1 software.
•For CDS (non-VVI) in both an ISA and RTSP environment, the Release 2.0.x and 2.1.x software can coexist with the Release 2.2.1 software.
The above TV CDS software releases can only coexist during an upgrade process, and only if the upgrade sequences described in the Cisco TV CDS 2.2 Installation, Upgrade, and Maintenance Guide are followed.
Different TV CDS software releases are not supported in the long term on an ongoing basis.
Updating the Device Drivers for new SSDs
The SSD driver update is for new SSDs and to address an issue with older SSDs. For more information, see the "Important Notes" section.
If a CDE requires an SSD replacement, the device driver must be updated. The device driver must be updated before replacing the SSD. If a new CDE is being added to the CDS, after upgrading the TV CDS software, the device driver must be updated. New SSDs are not recognized with the proper attributes until the device driver is updated.
Note The new driver is 100 percent backward-compatible with older, pre-existing SSD drives. We recommend that a proactive upgrade of the SSD driver is a good best-practice.
To view a list of TV CDS software releases this device driver applies to see the defect, CSCtr29064, in the Bug Tool Kit ((http://tools.cisco.com/Support/BugToolKit/).
Note When using the cdsinstall script to install the software image file, install the driver package after the cdsinstall script is complete.
To install the device driver update package, do the following:
Step 1 Download the cdstv_x.y.z_CSCtr29064.bin driver update package to the /root directory of the CDE. The filename is cdstv_x.y.z_CSCtr29064.bin,where x.y.z denotes the software release.
Note The driver update package includes support for all applicable software releases, so any cdstv_x.y.z_CSCtr29064.bin file installs correctly and can be used to update the drivers for any applicable release.
Following is the md5 checksum for the cdstv_x.y.z_CSCtr29064.bin driver update package:89684e2094d841b236ba1d83e958df9b cdstv_x.y.z_CSCtr29064.bin
The driver update package is a self-extracting, self-installing package.
Step 2 Change the permissions on the CDE. As user root, enter the following command:# chmod 755 /root/cdstv_x.y.z_CSCtr29064.bin
Step 3 Install the device driver update. As user root user enter the following commands:# cd /root# ./cdstv_x.y.z_CSCtr29064.bin
The package installs the device driver.
Step 4 To verify that the package has been installed on the CDE, view the /etc/cisco-version-history file, and verify that the string "cdstv_CSCtr29064" has been added to this version-history file.
Step 5 To verify that the driver has been updated and will be used by the CDS server, enter the following commands:cd /lib/module/`uname -r`/sbin/modinfo -F version csd.ko cdd_sys.ko
The updated driver files report the same version for both driver files in the format of x.y.z.1, where x.y.z is the version of the TV CDS software (for example, 188.8.131.52).
Step 6 Reboot the CDS server.# reboot
Note Rebooting a Vault server does not interrupt stream services, but causes current ingests to fail. If your CDS does not have stream failover, rebooting a Streamer without offloading it interrupts all stream services. If possible, you should perform functions that require a system restart during times when the least number of users are actively connected to your system.
A new SSD drive is a Generation 2 front-mounted SSD. The new SSD model is identified by the title "Intel SSD 320 Series" on the label and has the model number: SSDSA2BW160G3. For more information, see Field Notice 63438 at: http://www.cisco.com/en/US/products/ps7126/prod_field_notices_list.html.
The following command provides information on the external SSDs that are the new drive model:# find /sys/devices -name "model" | xargs grep SSDSA2BW16/sys/devices/pci0000:80/0000:80:05.0/0000:87:00.0/host3/port-3:7/end_device-3:7/target3:0:7/3:0:7:0/model:INTEL SSDSA2BW16/sys/devices/pci0000:80/0000:80:05.0/0000:87:00.0/host3/port-3:6/end_device-3:6/target3:0:6/3:0:6:0/model:INTEL SSDSA2BW16/sys/devices/pci0000:80/0000:80:05.0/0000:87:00.0/host3/port-3:5/end_device-3:5/target3:0:5/3:0:5:0/model:INTEL SSDSA2BW16/sys/devices/pci0000:80/0000:80:05.0/0000:87:00.0/host3/port-3:4/end_device-3:4/target3:0:4/3:0:4:0/model:INTEL SSDSA2BW16/sys/devices/pci0000:80/0000:80:05.0/0000:87:00.0/host3/port-3:3/end_device-3:3/target3:0:3/3:0:3:0/model:INTEL SSDSA2BW16
To view all SSD models currently supported by the Cisco TV CDS software, enter the following command:# find /sys/devices -name "model" | xargs grep SSDSA
The older SSD model is INTEL SSDSA2M160.
Rolling Back the SSD Driver Update
If for any reason you need to revert to the older SSD driver, with the TV CDS software running on the CDS server, do the following:
Step 1 Change to the drivers directory.cd /lib/module/`uname -r`
Step 2 To save the updated driver (optional), enter the following command:cp csd.ko csd.ko.updatecp cdd_sys.ko cdd_sys.ko.update
Step 3 Rename the backed up driver files to the driver filenames. The "previous_version" is the version number of the driver update.cp csd.ko_bkup_<previous_version> csd.kocp cdd_sys.ko_bkup_<previous_version> cdd_sys.ko
Step 4 Verify the driver versions by using the following command:/sbin/modinfo -F version csd.ko cdd_sys.ko
The drivers before the driver update have a version in the format of a.b.c and the two drivers do not necessarily have the same version number.
Step 5 Reboot the CDS server.
Refer to the following documents for additional information about the Cisco TV CDS 2.2:
•Cisco TV CDS 2.2 ISA Software Configuration Guide
•Cisco TV CDS 2.2 RTSP Software Configuration Guide
•Cisco TV CDS 2.1-2.2 API Guide
•Cisco TV CDS 2.2 Installation, Upgrade, and Maintenance Guide
•Cisco Content Delivery System 2.x Documentation Roadmap
•Cisco Content Delivery Engine 205/220/420 Hardware Installation Guide
•Cisco Content Delivery Engine 110 Hardware Installation Guide
•Cisco Content Delivery Engine 100/200/300/400 Hardware Installation Guide
•Regulatory Compliance and Safety Information for Cisco Content Delivery Engines
The entire CDS software documentation suite is available on Cisco.com at:
The entire CDS hardware documentation suite is available on Cisco.com at:
Obtaining Documentation and Submitting a Service Request
For information on obtaining documentation, submitting a service request, and gathering additional information, see the monthly What's New in Cisco Product Documentation, which also lists all new and revised Cisco technical documentation, at:
Subscribe to the What's New in Cisco Product Documentation as a Really Simple Syndication (RSS) feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service and Cisco currently supports RSS version 2.0.
CCDE, CCENT, CCSI, Cisco Eos, Cisco Explorer, Cisco HealthPresence, Cisco IronPort, the Cisco logo, Cisco Nurse Connect, Cisco Pulse, Cisco and the Cisco Logo are trademarks of Cisco Systems, Inc. and/or its affiliates in the U.S. and other countries. A listing of Cisco's trademarks can be found at www.cisco.com/go/trademarks. Third party trademarks mentioned are the property of their respective owners. The use of the word partner does not imply a partnership relationship between Cisco and any other company. (1005R)
Any Internet Protocol (IP) addresses used in this document are not intended to be actual addresses. Any examples, command display output, and figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses in illustrative content is unintentional and coincidental.
© 2011 Cisco Systems, Inc. All rights reserved.