|
Table Of Contents
Release Notes for Cisco TV CDS 1.5.4.6.1
Upgrade Procedure from Release 1.5.4.4 to Release 1.5.4.6.1
Downloading the Software Upgrade
Loading the ISO Image from a CD-ROM
Obtaining Documentation and Submitting a Service Request
Release Notes for Cisco TV CDS 1.5.4.6.1
Revised: June 3, 2009 OL-19959-01Contents
The following information is in the release notes:
•Upgrade Procedure from Release 1.5.4.4 to Release 1.5.4.6.1
•Obtaining Documentation and Submitting a Service Request
New Features
Release 1.5.4.6.1 of the TV CDS introduces the following new features:
•Application Specific Stream Segregation—Ability to segregate Playlist streaming traffic from Barker streaming traffic by using separate interfaces.
•Application Specific Redundant Streaming—Ability for the applications (Playlist or Barker) to stream from one CDE of a paired-array of two CDEs (current implementation) or from both CDEs.
•Manage Paired Standalone CDEs—Support for paired-array deployments of two CDEs that may not have connectivity between stream/cache interfaces.
•Time of Day Playlist—Easily and quickly select an ingested video asset to create a looped content, with start and end times, in the Playlist.
•Schedule Import/Export—Ability to import a Playout schedule that was created for one CDS to all other CDSs
•Playout Scheduling GUI enhancements:
–Channel Setup (name, IP address, port)
–Playout Schedule workflow
–Auto-complete when searching for content names
•Exportable reports that contain Barker and Playlist activity information.
•Playout Status API—Ability to have a global view of all Playout schedules and Barker streams across all CDSs by using an application program interface (API) for monitoring purposes.
•Manual Ingest—Manual FTP import of content
System Requirements
The Cisco TV CDS Release 1.5.4.6.1 runs on the CDE200 hardware model. See the Cisco Content Delivery Engine CDE100/200/300/400 Hardware Installation Guide for set up and installation procedures.
Open Caveats
This release contains no open caveats.
Resolved Caveats
The following caveats have been resolved since Cisco TV CDS Release 1.5.4.4. Not all the resolved issues are mentioned here. The following list highlights the caveats associated with customer deployment scenarios.
•CSCsq93505
When a timeslot spanning two days in Playout schedule is deleted, the next day's schedule becomes uncommitted.
•CSCsl37838
Symptom:
Maximum trick mode speed is 127.
•CSCsj05445
Symptom:
Stream monitor continues to display Playout streams after Streamer fails.
•CSCsj21083
Symptom:
Disconnecting the cable from the ingest port does not always put ingests into failed state.
•CSCsz17619
Symptom:
A filler content stops after playing once instead of repeating to fill the gap between two playout events. This gives a blank screen, until the next playout event starts.
•CSCsz57148
The Monitor > System Level > Failed Ingest page does not load completely. When a failed ingest item is selected from the drop-down list, and Display is clicked, the page reloads with just the top menu items. The rest of the page is blank.
•CSCsz62532
Streams containing private data on a PID (with type 192) in the PMT have the PMT replaced with one that does not reference the private data PID, which may additionally result in the private data PID not being sent to the STB (because it is stripped by a downstream device like a DCM or QAM).
Upgrade Procedure from Release 1.5.4.4 to Release 1.5.4.6.1
This section contains the following topics:
•Downloading the Software Upgrade
•Loading the ISO Image from a CD-ROM
Introduction
This document explains how to use the upgrade scripts to upgrade Single Streamer-Vault servers (SSVs) from Release 1.5.4.4 to Release 1.5.4.6.1. There are four scripts that you must run to complete the upgrade procedure:
1. preUpgrade
2. upgrade
3. postUpgradeSetup1
4. postUpgradeSetup2
Each script relies on processes that were completed in the previous script, so the scripts must be run in the correct order. If running a script generates error messages, fix as many of the errors as possible before running the next script.
Downloading the Software Upgrade
To download the ISO image software upgrade, do the following:
Step 1 Launch your web browser and enter the following URL:
http://tools.cisco.com/support/downloads/go/Redirect.x?mdfid=268438145
The Log In page is displayed.
Step 2 Log in to Cisco.com using your designated username and password. The Video and Content Delivery page is displayed, listing the available software products.
Step 3 Click Cisco Content Delivery Systems (CDS). The Downloads page is displayed.
Step 4 Click the Cisco Content Delivery Applications folder to expand it, and click the Cisco TV Streamer Application. The page refreshes and the software releases are displayed.
Step 5 Click the software release you want. The page refreshes and the software image files are displayed.
Step 6 Click the link for the software image file you want.
•If this is the first time you have downloaded a file from Cisco.com, the Cisco Systems Inc., Encryption Software Usage Handling and Distribution Policy is displayed.
–Read the policy, fill in the unfilled fields, and click Accept.
•If you previously filled out the Encryption Software Usage and Handling and Distribution form, the form does not display again.
The Download page is displayed with the information about the software image file and a Download link.
Step 7 Click Download. The Cisco End User Software License Agreement is displayed.
Step 8 Read the agreement and click Agree. The File Download dialog box is displayed.
Step 9 Click Save. The Save As dialog box is displayed.
Step 10 Navigate to the location where you want to save the file and click Save. The file downloads.
Copy the ISO image file to a CD-ROM for transporting the file to the SSV servers.
Loading the ISO Image from a CD-ROM
To load the ISO image onto the server, you can either mount the CD-ROM containing the ISO image file or mount the ISO image file directly as a loopback device.
If the CD-ROM is connected, the operating system mounts the CD-ROM as /mnt/cdrom. If the CD-ROM is not automatically mounted, enter the following command:
# mount /dev/cdromIf you are copying the ISO image file directly to the server, you must copy the file to the /root directory. To mount the ISO image file directly as a loopback device, enter the following command:
# mount -o loop /root/ssv_1546.iso /mnt/cdromAfter the image file is mounted by using the CD-ROM or loopback, run the following command to install the upgrade scripts:
# ./install_1544upd_scripts.shThis command copies all the scripts into the /root/upgrade_from_1544 directory.
Running the Upgrade Scripts
To upgrade the SSVs from Release 1.5.4.4 to Release 1.5.4.6.1, do the following for each SSV in the CDS:
Step 1 Log in to the SSV server as root and navigate to the /root/upgrade_from_1544 directory.
Step 2 Run the preUpgrade script.
sh preUpgrade
This script does the following:
•Removes the service start scripts from rc.local file
•Saves the original rc.local as rc.local_original
•Shuts down the database
•Reboots the server
You may see the following output when this script is running:
Removing start script from rc.local...Done.Shutting down the database...Rebooting the server ...Please run the script 'upgrade' when the server comes back up.Broadcast message from root (pts/1) (Fri Jul 11 15:54:52 2008):The system is going down for reboot NOW!Step 3 Run the upgrade script.
sh upgrade
This script does the following:
•Backs up the database and binary files. The files are copied into the /home/backup.1544 directory.
•Mounts the ISO image and installs it.
•Customizes the .arroyorc file.
•Prompts for the IP address of a replication server that you must provide.
You may see the following output when this script is running:
Backing up DB and Binary files...Done.installing iso image...Install SSV System CTRL-C NOW if this is not a SSV Box!Fri Jul 11 16:01:18 PDT 2008Done.Modifying .arroyorc...The follwing will be displayed only if servers already configured in .arroyorcThe replication servers configured are :---------------------------------------ssv 172.22.30.186---------------------------------------Do you want to add Replication Servers ? [Y/N]Please enter the Replication Server IP :fl Enter the replication server IP here
Done.Please make the cabling changes now, if necessary. Then run the script postUpgradeSetup1.Step 4 As it is stated in the last line of the upgrade script, please make any cabling changes necessary.
Step 5 In order to configure the output channels in Release 1.5.4.6.1, you need the IP address and associated ports of each QAM device. Make note of the IP address assigned in the QAM Gateway page, and any associated ports used in sending streams. The Output Channel page allows you to assign an output channel name for each unique QAM IP address and port.
Step 6 Run the postUpgradeSetup1 script.
sh postUpgradeSetup1
This script does the following:
•Changes the access rights of /arroyo/log to 777
•Starts the database
•Checks if the database is started
•Starts the web server
•Runs the runonce script
•Starts statsd
•Prompts for the hostname, IP address, and subnet mask of the server
•Runs the svrinit_15 script
You may see the following output when this script is running:
starting database3244 pts/1 S 0:00 /home/isa/Berkeley/avsdb3246 pts/1 S 0:00 /home/isa/Berkeley/avsdb3247 pts/1 S 0:00 /home/isa/Berkeley/avsdb3248 pts/1 S 0:00 /home/isa/Berkeley/avsdb3249 pts/1 S 0:00 /home/isa/Berkeley/avsdb3250 pts/1 S 0:00 /home/isa/Berkeley/avsdb3251 pts/1 S 0:00 /home/isa/Berkeley/avsdb3252 pts/1 S 0:00 /home/isa/Berkeley/avsdb3253 pts/1 S 0:00 /home/isa/Berkeley/avsdb3254 pts/1 S 0:00 /home/isa/Berkeley/avsdb3261 pts/1 S 0:00 grep avsdb[Fri Jul 11 16:03:53 2008] [alert] httpd: Could not determine the server's fully qualified domain name, using 172.22.99.187 for ServerNameStarting web server.../arroyo/www/bin/apachectl start: httpd startedRunning runonce utility...Initial values inserted successfullydevice is: eth0Please enter the local server host name :rack187 fl Enter the local server host name herePlease enter the local server IP :172.22.99.187 fl Enter the local Server IP herePlease enter the local server Subnet Mask :255.255.254.0 fl Enter the Subnet mask Here172.22.99.187 ASM tables initalized!Please do the initial configurations from the GUI and run postUpgradeSetup2.Step 7 As stated in the last line of the postUpgradeSetup1 script, some of the Release 1.5.4.6.1 features affect network connectivity and require configuration using the CDSM. The new features introduced in Release 1.5.4.6.1 that require configuration are the following:
•Transport Groups
•Interface Setup
•Server Setup
•Route Tables
•Ingest Tuning
•Application Configuration active-active or active-standby mode
For more information about configuring these features, see the Cisco TV CDS Software Configuration Guide that is available through the CDSM under Maintenance > Manual page.
Additionally, the Media Scheduler option must be set to "Off" in the CDSM Setup page by logging in to the CDSM as user arroyo password arr0y021 with the engineering access level.
Step 8 Run the postUpgradeSetup2 script.
sh postUpgradeSetup2
This script does the following:
•Shuts down the database
•Stops statsd
•Upgrades the database
•Changes the access rights of /arroyo/log to 777
You may see the following output when this script is running:
shutting down database....Done.stopping statsd...Done.Upgrading database ...Database is running.DB->Cursor: Successful return: 0send: Transport endpoint is not connectedno reply: Bad file descriptorsend: Transport endpoint is not connectedno reply: Bad file descriptorDone.Scripts executed successfully. Please follow these steps below :1. Copy the data base files to the other server.2. Uncomment the service start commands in /etc/rc.local3. Reboot the servers.Once you have completed running all the scripts, you must do the following steps manually:
Step 1 Copy the database files to the other SSV servers, if required.
a. Log in as isa on the other SSV and delete the database.
cd /arroyo/dbrm -rf DATADIRb. Log in as isa on the SSV that has the upgraded database and run the following command:
cd /arroyo/db scp -pr DATADIR isa@<CDS02>:/arroyo/db/Step 2 Edit the /etc/rc.local file by removing the comment marks from the lines that start the Apache web server and avsdb on boot.
[isa@cdsm isa]# vi /etc/rc.local
#!/bin/sh## This script will be executed *after* all the other init scripts.# You can put your own initialization stuff in here if you don't# want to do the full Sys V style init stuff.export LD_ASSUME_KERNEL=2.4.19touch /var/lock/subsys/local# ISA Kernel Tuneecho 222217728 > /proc/sys/kernel/shmmaxecho 222217728 > /proc/sys/kernel/shmallecho 65535 > /proc/sys/fs/file-max# TCP Kernel Tuneecho 8388608 > /proc/sys/net/core/wmem_maxecho 8388608 > /proc/sys/net/core/rmem_maxecho "4096 65536 4194304" > /proc/sys/net/ipv4/tcp_wmemecho "4096 87380 4194304" > /proc/sys/net/ipv4/tcp_rmemecho 0 > /proc/sys/net/ipv4/tcp_sack/arroyo/test/ssv/run
#The following command will start the database for statsd.su - isa -c "sleep 10"
/home/stats/statsd -f 2 -d eth0
sleep 5
rm -f /arroyo/www/logs/httpd.pid
/arroyo/www/bin/apachectl start
su - isa -c "sleep 10;cd /home/isa/IntegrationTest; ./run_isa >>& /home/isa/IntegrationTest/ns_log&"
sleep 5
Step 3 Reboot the servers.
All servers should be up and running when you complete the procedures outlined in this document.
Documentation Updates
The following documents have been updated for this release:
•Cisco TV CDS Software Configuration Guide
•Cisco TV CDS Playout and Barker Applications Data Input Quick Start Guide
•Cisco Content Delivery Engine 100/200/300/400 Hardware Installation Guide
•Regulatory Compliance and Safety Information for Cisco Content Delivery Engine 100/200/300/400
The following documents have been added for this release:
•Release Notes for Cisco TV CDS 1.5.4.6.1
•Cisco TV CDS C Content Detail Retrieval API
Related Documentation
Refer to the following documents for additional information about the Cisco Internet Streamer CDS 2.0-2.2:
•Cisco Content Delivery Engine 100/200/300/400 Hardware Installation Guide
http://www.cisco.com/en/US/docs/video/cds/cde/installation/guide/CDE_Install_Book.html
•Regulatory Compliance and Safety Information for Cisco Content Delivery Engine 100/200/300/400
http://www.cisco.com/en/US/docs/video/cds/cde/regulatory/compliance/CDE_RCSI.html
•Cisco TV CDS Software Configuration Guide
Available through the CDSM GUI.
•Cisco TV CDS C Content Detail Retrieval API
Available through the CDSM GUI.
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, CCSI, CCENT, Cisco Eos, Cisco HealthPresence, the Cisco logo, Cisco Lumin, Cisco Nexus, Cisco Nurse Connect, Cisco Stackpower, Cisco StadiumVision, Cisco TelePresence, Cisco WebEx, DCE, and Welcome to the Human Network are trademarks; Changing the Way We Work, Live, Play, and Learn and Cisco Store are service marks; and Access Registrar, Aironet, AsyncOS, Bringing the Meeting To You, Catalyst, CCDA, CCDP, CCIE, CCIP, CCNA, CCNP, CCSP, CCVP, Cisco, the Cisco Certified Internetwork Expert logo, Cisco IOS, Cisco Press, Cisco Systems, Cisco Systems Capital, the Cisco Systems logo, Cisco Unity, Collaboration Without Limitation, EtherFast, EtherSwitch, Event Center, Fast Step, Follow Me Browsing, FormShare, GigaDrive, HomeLink, Internet Quotient, IOS, iPhone, iQuick Study, IronPort, the IronPort logo, LightStream, Linksys, MediaTone, MeetingPlace, MeetingPlace Chime Sound, MGX, Networkers, Networking Academy, Network Registrar, PCNow, PIX, PowerPanels, ProConnect, ScriptShare, SenderBase, SMARTnet, Spectrum Expert, StackWise, The Fastest Way to Increase Your Internet Quotient, TransPath, WebEx, and the WebEx logo are registered trademarks of Cisco Systems, Inc. and/or its affiliates in the United States and certain other countries.
All other trademarks mentioned in this document or website 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. (0903R)
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.
© 2009 Cisco Systems, Inc. All rights reserved.