Cisco VDS-VR Software 4.1 Configuration Guide

Installation, Upgrade, and Downgrade via YUM

---

You can install VDS-VR Release 4.1.4 software on CDE 465 or CDE 460 hardware via a local or a remote YUM server. When installing via YUM for the first time, you must perform the installation locally. During local YUM installation, YUM RPMs are installed and configuration files and a local repository are created.

Configuring New CDE 465 Systems

Complete the following steps to set up a new CDE 465 with VDS-VR 4.1.4.

Note These instructions apply for new CDE 465 systems obtained from Cisco. Additional steps are needed to install VDS-VR 4.1.4 on CDE 465 systems sourced directly from Supermicro. See the Release Notes for Cisco VDS-VR 4.1.4 for details.

Step 1 Configure /etc/hosts, /etc/sysconfig/network, and /etc/sysconfig/network-scripts/ifcfg-eth0.

Step 2 Execute service network start to start the network device.

Step 3 Was VDS-VR Release 4.1.0 previously installed on the CDE 465?

If not, skip this step and continue with step 4 below.

If so, remove the existing SuperDoctor5 installation as follows:

a. Enter yum groupremove recorder, and when prompted, enter y to confirm.

b. Enter yum clean all.

c. Execute the following commands:

d. Reboot the CDE 465.

e. Log on as root and copy (scp) the new 4.1.4 VDS-TV-PROD.iso image to /root.

f. Execute /vdstvprepinstall /root/VDS-TV-PROD.iso.

g. If prompted, select 5 for RECORDER.

h. Skip step 4 below and resume with step 5.

Step 4 Execute /vdstvprepinstall /VDS-TV-PROD.iso and select 5 for RECORDER.

Step 5 Enter yum groupupdate recorder.

Step 6 Reboot the CDE 465.

Step 7 Execute cdsconfig.

Step 8 Configure the following files manually (the CDSM GUI is not supported).

a. The interface setup file at arroyo/test/recorder/setupfile (IP addresses are examples only):

b. The Recorder setup file at /home/isa/bss/etc/recsvr.conf (IP addresses are examples only):

c. The route table at /arroyo/test/SubnetTable (IP addresses are examples only):

d. The Afterrun file at /arroyo/test/afterrun:

Note ● This example shows only the minimum required content. The file may contain additional lines.

• Be sure that the afterrun file has -x permission.

e. The rc.local file at /etc/rc.d/rc.local (IP addresses are examples only):

Step 9 Reboot the CDE 465.

Step 10 Confirm successful startup by entering the following:

The system response should include two PIDs.

Step 11 Start cserver using one of the following methods.

• If starting cserver for the first time, enter /arroyo/test/run -C, then enter cleardir.
• If cserver was previously started using /arroyo/test/run -C, simply enter arroyo/test/run.

Upgrading the CDE 465 or 460 from VDS-VR 4.1.2 or 4.1.3 to 4.1.4

Step 1 Download the YUM package ISO file (VDS-TV-PROD-4.1.4-b3.iso) and vdstvprepinstall script from the Cisco Software Download website.

Step 2 For the VDS Recorder, on Recorder Manager, offload the VDS Recorder to prevent new recording requests as follows:

a. From the Recorder Manager web GUI, choose ResourceManager > Recorders, and select the Recorder to be upgraded.

b. Choose Recorder CDSRECORDER:XXXX:YYY > Configuration, and change the value of AdminState from InService to OutOfService.

c. Change the value of ArchiveAdminState from InService to OutOfService.

d. Click Commit Changes to make changes take effect.

Step 3 Log into the VDS Recorder via SSH as user root.

Step 4 Is the YUM server used?

• If yes, skip this step and continue with step 5.
• If no, copy the YUM package ISO image file and YUM vdstvprepinstall script to the VDS Recorder.

Step 5 Execute the following commands to kill the /home/stats/monit/monit -d 1 -c /home/stats/monit/monitrc process and prevent applications from being restarted automatically:

Execute the following command to confirm that the monit process is killed.

Step 6 Execute the following commands to stop all applications, avsdb, recsvr, livebackup, and dnsresolver:

Execute the following commands to confirm that all applications, especially avsdb and livebackup, have been stopped.

Step 7 Is the YUM server used?

• If yes, reconfigure baseurl in /etc/yum.repos.d/vdstv.repo to install the 4.1.4-bX build from YUM server as follows:

• If no, execute the following commands to run the vdstvprepinstall script to prepare for YUM installation:

When prompted, choose 5 for 5) RECORDER.

Note When installing YUM for the first time, execute vdstvprepinstall locally on the Recorder. This will install YUM RPMs, create configuration files, and create a local repository.

For subsequent YUM upgrades, you can use the same method, or optionally, use an external YUM server.
To use an external YUM server, configure the server in /etc/yum.repos.d/vdstv.repo as shown in the following example:

baseurl= http://172.22.116.17/rec_4.1.4-bX/

Step 8 Execute the following YUM command to upgrade to Release 4.1.4:

Step 9 Remove all existing tunables in /arroyo/test/afterrun except for the following two lines:.

• avs_indexingmode –c
• echo 10 > /proc/calypso/tunables/recording_nodatatimeout

Note Increasing recording_nodatatimeout from the default value of 5 seconds to 10 seconds could enable the ingest resiliency feature.

Step 10 Check the execution permission of /arroyo/test/afterrun to confirm that it has execution permission.

If afterrun does not have execution permission, add permission.

Step 11 Check the contents of /etc/rc./local and confirm that the following lines are commented out.

• The starting line for statsd:

• The line for the core dump of the recorder service:

Example:

Step 12 Confirm that /home/isa/bss/etc/recsvr.conf includes only the nine configurations listed below.

Note ProtocolVer specifies the R8 version. If this configuration is absent in the recsvr.conf, the application recsvr behaves as R8I02 by default. If present, ProtocolVer=4 designates R8I04, while ProtocolVer=2 designates R8I02 (the default).

Step 13 Reboot the Recorder.

Step 14 After the VDS Recorder boots up, check the status of locate port as follows:

Example: Locate port is not started

Example: Locate port is started successfully

Step 15 On Recorder Manager, bring the VDS Recorder online as follows:

a. From the Recorder Manager web GUI, choose ResourceManager > Recorders, and select the Recorder to be upgraded.

b. Choose Recorder CDSRECORDER:XXXX:YYY > Configuration, and change the value of AdminState from OutOfService to InService.

c. Change the value of ArchiveAdminState from OutOfService to InService.

d. Click Commit Changes to make changes take effect.

Step 16 Check the heartbeat messages in the Event Log of Recorder Manager to confirm that the VDS Recorder is operational, as follows:

Example:

Downgrading the CDE 465 from VDS-VR 4.1.4 to 4.1.2 or 4.1.3

Note VDS-VR 4.1.4 supports installation and upgrade on CDE 465s purchased directly from Supermicro, but it does not support downgrade from Release 4.1.4 to any previous 4.1.x release on these systems. To check if a particular CDE 465 supports downgrade, use this command to obtain its serial number:

# dmidecode -s system-serial-number

If the serial number format begins with CDE465-V01-FTX, the system supports downgrade from Release 4.1.4 to a previous 4.1.x release. Otherwise, it does not support such downgrade.

Step 1 Download the YUM package (for example, VDS-TV-4.1.2-b2.iso or VDS-TV-4.1.3-b2.iso) and the vdstvprepinstall script for Release 4.1.4 from the Cisco Software Download website.

Step 2 On Recorder Manager, offload the VDS Recorder to prevent new recording requests as follows:

a. From the Recorder Manager web GUI, choose ResourceManager > Recorders, and select the Recorder to be upgraded.

b. Choose Recorder CDSRECORDER:XXXX:YYY > Configuration, and change the value of AdminState from InService to OutOfService.

c. Change the value of ArchiveAdminState from InService to OutOfService.

d. Click Commit Changes to make changes take effect.

Step 3 Log in to the VDS Recorder via SSH as user root.

Step 4 Is the YUM server used?

• If yes, skip this step and continue with step 5.
• If no, copy the YUM package ISO image file and YUM vdstvprepinstall script to the VDS Recorder.

Step 5 Execute the following commands to kill the /home/stats/monit/monit -d 1 -c /home/stats/monit/monitrc process and prevent applications from being restarted automatically:

Execute the following commands to confirm that the monit process is killed.

Step 6 Execute the following commands to stop all applications, especially avsdb and livebackup:

Execute the following commands to confirm that all applications, especially avsdb and livebackup, have stopped.

Step 7 Execute the following commands to remove the 4.1.4 YUM packages:

Wait until the Recorder boots up to continue with installation of the new image.

Step 8 Is the YUM server used?

• If yes, reconfigure baseurl in /etc/yum.repos.d/vdstv.repo to install either the 4.1.2-b2 or the 4.1.3-b2 build from the YUM server:

• If no, execute the following commands to run the vdstvprepinstall script to prepare for YUM installation:

When prompted, choose 5 for 5) RECORDER.

Step 9 Execute the following YUM command to downgrade to the chosen release:

Step 10 Reboot the VDS Recorder.

After the VDS server has rebooted, the services avsdb, cserver, monit, recsvr, and dnsresolver should be started automatically as specified in /etc/rc.local.

Step 11 Check the status of locate port as follows:

Example: Locate port is not started

Example: Locate port is started successfully

Step 12 On Recorder Manager, bring the VDS Recorder online as follows:

a. From the Recorder Manager web GUI, choose ResourceManager > Recorders, and select the Recorder to be upgraded.

b. Choose Recorder CDSRECORDER:XXXX:YYY > Configuration, and change the value of AdminState from OutOfService to InService.

c. Change the value of ArchiveAdminState from OutOfService to InService.

d. Click Commit Changes to make changes take effect.

Step 13 To confirm that the VDS Recorder is operational, check the heartbeat messages in the EventLog of Recorder Manager as follows:

Example: