Downloads |
 Feedback
|
Table Of Contents
Release Notes for Cisco TV CDS 2.2.1
Dual Conditional Access System Support
Updating the Device Drivers for new SSDs
Rolling Back the SSD Driver Update
Obtaining Documentation and Submitting a Service Request
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-02Contents
The following information is in the release notes:
•
Obtaining Documentation and Submitting a Service Request
New Features
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
Step 2
crontab -e30 05 * * * su - isa -c "cd Asset;./clean_orphaned_contents >& run.log&"Step 3
crontab -l
SNMP Traps
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
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:
•
•
•
•
•
•
•
•
•
Enhancements
Table 1 describes the enhancements to TV CDS 2.2.1.
Supported Environments
Release 2.2.1 of the Cisco TV CDS supports the following environments and associated backoffice integrations:
•
–
–
•
–
–
–
–
–
–
–
System Requirements
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.
Important Notes
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
New 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
For more information, see the "Updating the Device Drivers for new SSDs" section.
Open Caveats
This release contains the following open caveats:
CDSM
•
Symptom:
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.
Conditions:
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.
Workaround:
Make sure DNS search is setup in resolv.conf and resubmit the Reload Service Group command through the CDSM GUI.
Installation
•
Symptom:
Reimaging a server to RHEL5 causes the first sector on the drive to be overwritten.
Conditions:
This issue happens when reinstalling the OS on a Streamer, Vault, or Caching Node.
Workaround:
Remove the front-mounted drives from the server before reimaging.
CServer
•
Symptom:
Vault crashes when over 300,000 content objects are ingested.
Condition:
When ingesting more than 300,000 titles, the Vault crashes.
Workaround:
Do not ingest more than 300,000 titles.
•
Symptom:
Server crashed because it could not list the details of an object.
Condition:
Because a drive was going in and out of repair mode, it caused the evaluators to abort and create multiple copies of some data.
Workaround:
Do not use the serverinfo log commands to dump detailed file map of a GOID.
•
Symptom:
RTSP server hangs because it has not received a response.
Condition:
Unable to reproduce.
Workaround:
Restart RTSP server.
•
Symptom:
TCP sessions have unexpected termination or behavior during failure recovery.
Condition:
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.
Workaround:
No workaround exists.
•
Symptom:
When mirroring between two Vaults, there are damaged content objects.
Condition:
The following conditions could cause this:
–
–
Workaround:
Keep the capability of the Vaults the same and do not configure very thin pipes.
Resolved Caveats
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.
CDSM
•
Symptom:
Service group values greater than 32-bit signed integer (2147483647) are changed to 2147483647 prior to adding the entry to the database.
Condition:
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.
CServer
•
Symptom:
A side effect of this defect is that it can lead to a server crash.
Condition:
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.
•
Symptom:
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.
Condition:
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.
•
Symptom:
When a Vault is offloaded, the protocol timing log does not specifically state that the server has been offloaded.
Conditions:
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.
•
Symptom:
When ingesting content with FSI ingest, there were some ingestions that failed.
Conditions:
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
•
Symptom:
Database stops after time without user interaction.
Condition:
Servers are configured in the .arroyorc as active replication hosts that are not reachable which causes a slow memory leak.
•
Symptom:
The STREAM_TRICK_REPORT.db continues to grow in file size.
Conditions:
Occurred in Release 2.0.0 fc2 on CDSM.
MSA
•
Symptom:
CDSM file system can become full and all logging will stop.
Condition:
For any customer site running MSA Logging.
Video Quality
•
Symptom:
Tiling when jumping through an uncached asset. Macroblocking or tiling when transitioning from rewind, fast-forward or pause to 1x play.
Condition:
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.
Network
•
Symptom:
Cache-Fill NICs on Vaults show as malfunctioning adapters in the protocoltiming logfile.
Conditions:
A combination of reduced cache-fill NICs (three or less), high fill-load (in the 1000s), and active local evaluators (local smoothing, defrag).
RTSP
•
Symptom:
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.
Conditions:
Specific Customer integration testing. SETUP requests coming on the backoffice port 554.
Vaults
•
Symptom:
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.
Conditions:
The content must be encrypted with PowerKey. It must be using keys that change on a regular basis.
SNMP
•
Symptom:
SNMP Query to a Vault running 2.6.18-53.el5.cdstv.2.1.1.es1.b6 on: cdstvCacheStatsFillRecieveStreamCount - 1.3.6.1.4.1.15946.1.2.1.1.1.1.2 cdstvCacheStatsFillStreamActualBWinKBits - 1.3.6.1.4.1.15946.1.2.1.1.1.1.3 cdstvCacheStatsFillStreamCommittedBWinKBits - "1.3.6.1.4.1.15946.1.2.1.1.1.1.4" returns: SNMPv2-SMI::enterprises.15946.1.2.1.1.1.1.2.1 = Gauge32: 0 SNMPv2-SMI::enterprises.15946.1.2.1.1.1.1.3.1 = Gauge32: 3350 SNMPv2-SMI::enterprises.15946.1.2.1.1.1.1.4.1 = Gauge32: 0 SNMPv2-SMI::enterprises.15946.1.2.1.1.1.1.5.1 = Gauge32: 0 SNMPv2-SMI::enterprises.15946.1.2.1.1.1.1.6.1 = Gauge32: 0
All values should be zero as this is a Vault not a Streamer
Condition:
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
Note
•
•
•
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
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
To install the device driver update package, do the following:
Step 1
Note
Following is the md5 checksum for the cdstv_x.y.z_CSCtr29064.bin driver update package:
89684e2094d841b236ba1d83e958df9b cdstv_x.y.z_CSCtr29064.binThe driver update package is a self-extracting, self-installing package.
Step 2
# chmod 755 /root/cdstv_x.y.z_CSCtr29064.binStep 3
# cd /root# ./cdstv_x.y.z_CSCtr29064.binThe package installs the device driver.
Step 4
Step 5
cd /lib/module/`uname -r`/sbin/modinfo -F version csd.ko cdd_sys.koThe 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, 2.3.3.1).
Step 6
# reboot
Note
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 SSDSA2BW16To view all SSD models currently supported by the Cisco TV CDS software, enter the following command:
# find /sys/devices -name "model" | xargs grep SSDSAThe 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
cd /lib/module/`uname -r`Step 2
cp csd.ko csd.ko.updatecp cdd_sys.ko cdd_sys.ko.updateStep 3
cp csd.ko_bkup_<previous_version> csd.kocp cdd_sys.ko_bkup_<previous_version> cdd_sys.koStep 4
/sbin/modinfo -F version csd.ko cdd_sys.koThe 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
Related Documentation
Refer to the following documents for additional information about the Cisco TV CDS 2.2:
•
•
•
http://www.cisco.com/en/US/docs/video/cds/cda/tv/2_2/developer_guide/tv_cds_2_2_apiguide.html
•
•
•
http://www.cisco.com/en/US/docs/video/cds/overview/CDS_Roadmap.html
•
•
http://www.cisco.com/en/US/docs/video/cds/cde/cde110/installation/guide/cde110_install.html
•
http://www.cisco.com/en/US/docs/video/cds/cde/installation/guide/CDE_Install_Book.html
•
http://www.cisco.com/en/US/docs/video/cds/cde/regulatory/compliance/CDE_RCSI.html
The entire CDS software documentation suite is available on Cisco.com at:
http://www.cisco.com/en/US/products/ps7127/tsd_products_support_series_home.html
The entire CDS hardware documentation suite is available on Cisco.com at:
http://www.cisco.com/en/US/products/ps7126/tsd_products_support_series_home.html
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:
http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html
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.
