Using the TUI Upgrade Utility to Upgrade the Cisco StadiumVision Software

First Published: March 6, 2013

Revised: January 17, 2014


Note If you are upgrading an existing Cisco StadiumVision Director server from Release 3.0 SP2 to Release 3.1, see the Upgrading a Cisco StadiumVision Director Platform 2 Server from Release 3.0 SP2 to Release 3.1 SP1 and SP2 first.


This module describes how to upgrade an existing server already running Cisco StadiumVision Director, including installation of service packs. This procedure is also referred to generally as an ISO upgrade to refer to both the service pack and upgrade ISO process.

This module includes the following topics:

Best Practices


Caution Do not alter the RAID configuration prior to upgrade.

Before you begin upgrading an existing Cisco StadiumVision Director server, consider the following best practices:

  • Choose an appropriate down time to perform the upgrade on the Cisco StadiumVision Director server when there is adequate time to complete and verify the upgrade before any scheduled events and to allow time to resolve any unexpected issues that might occur.
  • Refer to the Release Notes for Cisco StadiumVision Director Release 3.1 for the latest information about hardware and software requirements, changes, important notes, and caveats for your software release.
  • Pay particular attention to the required hardware and software versions for other devices supporting your Cisco StadiumVision solution and be sure that you upgrade those devices as needed. For example, generally only certain firmware versions are supported for the DMP hardware, or a new firmware version is needed to provide additional functionality supported by the Cisco StadiumVision Director software.
  • Perform a backup and restore of the primary and secondary servers:

Perform a backup of the currently active primary server.

Restore the backup data onto the standby secondary server.


Note The config service must be running on the secondary server to do the restore.


For more information about performing a backup and restore on a Cisco StadiumVision Director Server, see the “Backing Up and Restoring Cisco StadiumVision Director Servers” module of the Cisco StadiumVision Director Server Administration Guide .

  • Promote the secondary server to primary.

For more information about promoting a secondary server to primaryin Release 3.1, see the “Configuring Failover Between Redundant Cisco StadiumVision Director Servers” module of the Cisco StadiumVision Director Server Administration Guide, Release 3.1 .

  • Access the promoted secondary server to perform the upgrade.
  • Verify the boot order in the BIOS (by pressing F2 while booting) prior to upgrading; the virtual DVD should be the primary boot device for the Platform 3 server.
  • Due to the difficulty in recovering from an interrupted installation process if the Linux shell is accidentally closed or the network drops, it is highly recommended that you use a server console connection method that does not pose a risk to the success of upgrade completion if the session breaks during upgrade.

This can be done using a monitor and keyboard that are directly connected to the Cisco StadiumVision Director server to log into the TUI, or through a remote connection with access to the Cisco StadiumVision Director network and using the CIMC interface to log into the TUI.

Prerequisites

Be sure that the following requirements are met before you upgrade your server:

  • Your server is running a minimum of Cisco StadiumVision Director Release 3.1.0-510 or higher.
  • If you are upgrading your server from Release 3.0, you are following the requirements and tasks described in the “Upgrading a Cisco StadiumVision Director Platform 2 Server from Release 3.0 SP2 to Release 3.1 SP1 and SP2” module in this guide.
  • You have the IP address for the Cisco StadiumVision Director server where you want to upload the ISO upgrade image. You will need to use this information as part of the URL to access the ISO upload utility.
  • You have a supported browser version for Cisco StadiumVision Director. For more information about the latest supported browsers, see the Cisco StadiumVision Release Notes for Release 3.1 .
  • You have an installer account on the Cisco StadiumVision Director server.
  • To access the Cisco Integrated Management Controller (CIMC) for the TUI software upgrade, the following requirements are met:

Your computer meets the minimum browser and Flash player requirements for Cisco StadiumVision Director, and also has Java 1.6 or later installed.

You have a laptop connection with access to the Cisco StadiumVision Director server network.

You have the IP address of the CIMC interface on the Cisco StadiumVision Director server.

You have the CIMC interface login credential. The default is admin/password.


Note You also can use a monitor and keyboard that are directly connected to the Cisco StadiumVision Director server to log into the TUI.


Information About Using the TUI Upgrade Utility to Update an Existing Cisco StadiumVision Director Server

The ISO upgrade procedure for Cisco StadiumVision Director includes the following tasks:

1. Downloading an ISO service pack or upgrade file from the software download site on Cisco.com.

2. Uploading the ISO file from your laptop to the Cisco StadiumVision Director server using the upload utility through your browser.

3. Installing the ISO image using the upgrade utility in the Text Utility Interface (TUI).

ISO Upgrade Files

You can store multiple ISO upgrade files on a Cisco StadiumVision Director server. The files will be displayed with a sequence number and the ISO filename in the TUI upgrade utility for you to select which file to install.

Disk Maintenance

There is no automatic aging of ISO upgrade files, but Cisco StadiumVision Director Release 3.1 introduces a utility to delete ISO upgrade files in the TUI.

The Management Dashboard has a gauge for % Disk Utilization, or you can use the TUI to get file system usage.

Upgrade Tasks

To upgrade your Cisco StadiumVision Director server, complete the following tasks:

Downloading ISO Upgrade Files from Cisco.com

Be sure to download the upgrade files to a location, such as a laptop computer, where you can access them for installation onto the Cisco StadiumVision Director server.

To download an ISO upgrade file, complete the following steps:


Step 1 Go to the Cisco StadiumVision Director software download site at:

http://software.cisco.com/download/release.html?mdfid=283489263&flowid=31962&softwareid=283866237&release=3.1.0&relind=AVAILABLE&rellifecycle=&reltype=latest


Note This site page is also available from the Cisco StadiumVision Director product support page by clicking Download Software > Cisco StadiumVision Director.


Step 2 Select the ISO upgrade or service pack file (as available), and optionally the companion MD5 checksum file, and download them.

Table 1 shows the filename conventions used for ISO upgrades.


Note Be sure that you choose the ISO for SV-DIRECTOR and not for SVD-REMOTE. The TUI will verify the filenaming to be sure that the ISO that you are uploading is for SV-DIRECTOR.


 

Table 1 ISO Upgrade Filename Conventions

Hardware Product ID
Filename Convention1

SV-DIRECTOR-K9 or SV-PLATFORM2=

SV-PLATFORM3=

  • SV-DIRECTOR-UPGRADE-3.1.0- nnn .x86_64.iso
  • SV-DIRECTOR-UPGRADE-3.1.0- nnn .x86_64.iso.md5sum

1.nnn” represents the build number of the image in the file.

You can download the files using one of the following methods:

    • Download both files at one time—Select each file and click Add to Cart . Then at the top of the download page, click the “Download Cart (2 items)” link.
    • Download each file independently—Click the Download Now button in the file selection box for each file.

Step 3 (Optional) To verify the integrity of your upgrade file from the download, you can use a command-line or GUI utility on your laptop to calculate the checksum on the .iso file. Open the .md5sum file to compare the value that you calculated with the expected value provided in the .md5sum file.

The values should match. If they do not, retry the download.


 

Uploading an ISO Upgrade File to the Cisco StadiumVision Director Server

After you have downloaded the ISO upgrade file from Cisco.com, you need to upload the file to the Cisco StadiumVision Director server using a URL from a browser to access the ISO uploader utility. Once you have uploaded the software to the server, then you will use the TUI to install the upgrade image.

Prerequisites

Be sure that you know the IP address of the Cisco StadiumVision Director server where you want to upload the file, and you have a supported browser version for Cisco StadiumVision Director.

To upload an ISO upgrade file to the Cisco StadiumVision Director server, complete the following steps:


Step 1 Log into Cisco StadiumVision Director as an administrator.

Step 2 From your browser, go to the following URL, where x.x.x.x is replaced by the IP address of the server where you want to upload the upgrade software (Figure 1):

http://x.x.x.x/cgi-bin/isoupload.cgi
 

Figure 1 ISO Updater Utility

 

Step 3 Click Browse (Figure 1).

Step 4 From the File Upload dialog box, navigate to the location of the ISO upgrade file that you downloaded from Cisco.com. Select the file that you want to upload and click Open .

Step 5 Click the Upload ISO button (Figure 2). The file is sent to the server.


Caution The upload might take several minutes. Do not refresh or reload the ISO Updater page while the upload process is running. Any interruption will corrupt the ISO image being uploaded.

Figure 2 ISO File Selection and Upload

 

When the ISO upload is complete, one of the following occurs:

  • When the image is validated and uploaded successfully, a message is displayed stating that the ISO image has been uploaded.
  • The image upload failed for some reason and you will need to retry the upload again.


 

Logging Into the CIMC Interface

To log into the CIMC interface, complete the following steps:


Step 1 From a laptop connection with access to the Cisco StadiumVision Director server network, open a browser window and type the IP address of the CIMC interface as shown in the following example:

https://ip-address
 

Step 2 If prompted, click OK to open the Java viewer.jnlp as shown in Figure 3:

Figure 3 Opening viewer.jnlp File

 

Step 3 If a security dialog box displays, do the following:

a. (Optional) Select the checkbox to accept all content from Cisco.

b. Click Yes to accept the certificate and continue.

c. Confirm any additional security certificate exceptions.

Step 4 At the CIMC login screen, note the firmware version displayed (Figure 4).


Tip The firmware version is also displayed in the Cisco Integrated Management Controller (CIMC) Information box on the CIMC console after you log in.


Step 5 From the CIMC login screen, type the username and password for the CIMC interface.


Tip The default credential is admin and password. If changed during server setup, use the password that you configured.


Figure 4 CIMC Login Screen

 

Step 6 Click Log In .


 

Verifying the Minimum CIMC Firmware Version for Cisco StadiumVision Director

Before you begin, see the “Cisco StadiumVision Director Server Support” section of the Release Notes for Cisco StadiumVision Director Release 3.1 to find the CIMC/BIOS versions tested for your platform.

To verify the minimum CIMC firmware version for Cisco StadiumVision Director, complete the following steps:


Step 1 Be sure that the CIMC firmware version found on the CIMC login screen or in the CIMC console is at the minimum tested version (or later) for the Cisco StadiumVision Director release.

Figure 5 shows where the firmware version is displayed on the CIMC console for both the BIOS and CIMC firmware.

Figure 5 Firmware Version Verification From the CIMC Console for a Platform 3 Server

 

Step 2 If necessary to upgrade the CIMC/BIOS firmware on the Platform 3 server, refer to the “Updating the BIOS and CIMC Firmware” section of the “ Installing the Server ” module in the Cisco UCS C220 Server Installation and Service Guide .


 

Launching the KVM Console

To launch the KVM console, complete the following steps:


Step 1 From the CIMC console Actions box, click Launch KVM Console .

Figure 6 Launch KVM Console

 


Tip You can also click the keyboard in the icon bar at the top of the console to launch the KVM console.


Step 2 If a security dialog box displays, do the following:

a. (Optional) Select the checkbox to accept all content from Cisco.

b. Click Yes to accept the certificate and continue.

Step 3 At the Cisco Virtual KVM Console confirmation box (Figure 7), do the following:

a. (Optional) Select the checkbox to accept all content from Cisco.

b. Click Run .

Figure 7 Cisco Virtual KVM Console Confirmation

 

c. Confirm any additional security certificate exceptions.

Step 4 The KVM Console window is displayed with a login prompt (Figure 8).

Figure 8 Cisco KVM Virtual Console Login Screen

 


 

Installing the ISO Upgrade Image on the Cisco StadiumVision Director Server

To install the ISO upgrade image on the Cisco StadiumVision Director server, complete the following steps:


Step 1 Do one of the following to run a secure login to the Cisco StadiumVision Director server:

  • Using a directly-connected computer and KVM cable, access the console of the Cisco StadiumVision Director server.

or

  • Log into the CIMC and launch the virtual KVM console.

Step 2 When the login prompt appears, enter the installer userid followed by the installer password at the password prompt.

Step 3 From the Main Menu, do the following:

  • For upgrades from Release 3.0:

From the TUI Main Menu, select the Upgrade StadiumVision Server option (type q and press Enter ) (Figure 9):

Figure 9 TUI Main Menu Option for Server Upgrade—Release 3.0

 

  • For upgrades from Release 3.1:

From the TUI Main Menu, go to the StadiumVision Server Administration menu. Select the Upgrade Server option (type b and press Enter ) (Figure 10):

Figure 10 TUI StadiumVision Server Administration Menu Option for Server Upgrade—Release 3.1

 

Step 4 When the upgrade configuration confirmation prompt appears, type c to continue (Figure 11):

Figure 11 TUI Upgrade Configuration Confirmation

 

Step 5 All of the ISO upgrade files that you have uploaded are displayed with a sequence number and the image name. Type the sequence number that corresponds to the image that you want to install, and press Enter .

Figure 12 shows an example of selection of the first upgrade file for installation.

Figure 12 ISO Upgrade Image File List

 

The upgrade process begins.


Caution Wait until the upgrade process completes. Do not close the terminal while the upgrade is in progress. You will get notification once the installation is complete.

Step 6 When the “Upgrade complete” message appears, press any key. (Figure 13):

Figure 13 End of ISO Upgrade Process

 

Step 7 From the StadiumVision Server Administration menu, select Reboot.

Step 8 ( For systems upgrading from Release 3.0 SP2 only ) Return to the Upgrading a Cisco StadiumVision Director Platform 2 Server from Release 3.0 SP2 to Release 3.1 SP1 and SP2 to continue with the steps required to migrate content to the release 3.1 CMS.


 

Staging the Flash Template

To be sure that any changes that might have been made to the Cisco StadiumVision Director Flash Template (.swf file) are deployed to the DMPs, complete the following steps:


Step 1 Go to the Management Dashboard.

Step 2 From the DMP and TV Controls dashboard drawer, navigate to the following command path:
DMP and TV Controls > DMP Install > Stage Template .

Step 3 Select all of the DMP devices where the command should be applied.

Step 4 Click the play button to run the command on the selected devices.


 

Deploying Global DMP Settings

To apply the global MIB variable settings to all DMPs, complete the following steps:


Step 1 Go to the Management Dashboard.

Step 2 From the DMP and TV Controls dashboard drawer, navigate to the following command path:
DMP and TV Controls > Global > Global DMP Settings .

Step 3 Select all of the DMP devices where the command should be applied.

Step 4 Click the play button to run the command on the selected devices.


 

Verifying the Upgrade

To verify the upgrade, complete the following tasks:

Clearing the Browser Cache

After you perform a Cisco StadiumVision Director software upgrade, you must clear the browser cache to be sure that you are viewing the latest version of Cisco StadiumVision Director.

To clear the browser cache in Mozilla FireFox, complete the following steps:


Step 1 From the menu bar, go to Tools > Clear Recent History .

The Clear Recent History dialog box appears.


Tip You can also press Ctrl + Shift + Delete to open the Clear Recent History dialog box.


Step 2 In the “Time range to clear:” box, select Everything .

Step 3 Open the Details drop-down list and select the Cache checkbox if it does not have a checkmark.

Step 4 Click Clear Now .


 

To clear the browser cache in Microsoft Internet Explorer, complete the following steps:


Step 1 From the menu bar, go to Tools > Delete Browsing History .


Tip You can also press Ctrl + Shift + Delete to open the Delete Browsing History dialog box.


Step 2 Select the Temporary Internet Files checkbox if it does not have a checkmark.

Step 3 Click Delete .


 

Importing the Security Certificate

When you access a Cisco StadiumVision Director server for the first time using Microsoft Internet Explorer or Mozilla Firefox, a security certificate warning will appear. Some Cisco StadiumVision Director functionality requires that the certificate is imported.

Importing the Security Certificate for Microsoft IE

To import the security certificate in Microsoft Internet Explorer, complete the following steps:


Step 1 When you see the warning page with the title “There is a problem with this website's security certificate,” click the “ Continue to this website... ” option.

Step 2 Next to the URL bar on the top of the browser window, click Certificate Error and then click the “ View certificates ” link.

Step 3 In the Certificate dialog box, click Install Certificate... .

Step 4 In the Certificate Import Wizard dialog box, click Next> .

Step 5 In the next step of the wizard, select “Place all certificates in the following store” radio button and then click Browse... .

Step 6 In the Select Certificate Store dialog box, select the “Trusted Root Certification Authorities” store and click Ok .

Step 7 Click Next> in the Certificate Import Wizard dialog.

Step 8 Click Finish .

Step 9 In the Security Warning dialog box, click Yes .

Confirm that a dialog stating “The import was successful.” appears.

Step 10 Close all Microsoft IE windows.

You should now be able to access the Cisco StadiumVision Director server using Microsoft IE without any security certificate warnings.


 

Adding a Security Exception for Mozilla Firefox

To add the security exception for Mozilla Firefox, complete the following steps:


Step 1 When you see the warning page with the title “This Connection is Untrusted,” click the “ I Understand the Risks ” option.

Step 2 Click Add Exception... .

Step 3 In the Add Security Exception dialog box, click Confirm Security Exception .

Step 4 Close all Mozilla Firefox windows.

You should now be able to access the Cisco StadiumVision Director server using Mozilla Firefox without any security certificate warnings.


 

Logging Into Cisco StadiumVision Director

To verify that the upgrade to Cisco StadiumVision Director Release 3.1 was successful, and that Cisco StadiumVision Director is up and operating, complete the following steps:


Step 1 Open a browser window and type the URL for the Cisco StadiumVision Director server, in the following sample format, where x.x.x.x is the IPv4 address of the Cisco StadiumVision Director server:

https://x.x.x.x/StadiumVision/login.jsp
 

or alternatively,

http://x.x.x.x
 

The Cisco StadiumVision Director login screen appears (Figure 14).

Figure 14 Cisco StadiumVision Director Login Screen

 

Step 2 Verify that Version 3.1 is displayed.


Tip If your window is not displaying Version 3.1, be sure that you have cleared the browser cache as describe in the “Clearing the Browser Cache” section.


Step 3 Type your Cisco StadiumVision Director administrator login credentials and click Log In .


Note When you first log into Cisco StadiumVision Director, the default administrator username and password is admin.


The Cisco StadiumVision Director Main Menu screen appears (Figure 15).

Figure 15 Cisco StadiumVision Director Main Menu

 


 

Verifying the Control Panel and Other Menus

To verify the control panel, complete the following steps:


Step 1 From the Cisco StadiumVision Director Main Menu, click Control Panel .

After a few moments of loading resources, the Cisco StadiumVision Control Panel Setup screen will open in a new window.

Step 2 Confirm the version and build number of your Cisco StadiumVision Director software in the lower right corner of the Control Panel window.


Tip If your window is not displaying the appropriate version and build that you loaded, be sure that you have cleared the browser cache as describe in the “Clearing the Browser Cache” section.


Step 3 Verify that you can open the other Cisco StadiumVision Director screens and menus.


 

Verifying that Services are Running

After you upgrade, go to the Management Dashboard to verify that all of the primary Cisco StadiumVision Director services are running.

To verify that services are running, complete the following steps:


Step 1 From the Management Dashboard, expand the Service Alerts pane.

Step 2 Verify that all of the primary services—in particular the Content Management CMS Server—are in “Normal” (green) state without any service alerts.

Figure 16 Verifying Normal Service States

 

Step 3 If the CMS server or another service in the above list is not in Normal state but should be, use the TUI services menu to restart it.


 

Configuring the DMP 4310 Assigned VLAN Property for VLAN Compliance Check

After you upgrade, you need to go to the Management Dashboard and change the Assigned VLAN property under Global DMP Settings for both the 4310 and 4310 v5.x.x settings according to your DMP VLAN configuration.

Configuring this property in the Management Dashboard settings for the DMP 4310s will ensure that the Dashboard value can be checked for compliance with the value being sent by the DMP:

  • If all of your DMPs are located on the same VLAN (recommended)—Type the number of the VLAN and save the configuration.
  • If all of your DMPs are not located on the same VLAN, or you want to bypass any VLAN compliance checking—Type “ $svd_ignore ” and save the configuration.

The value in the Assigned VLAN property in the Management Dashboard settings for the DMP 4310s is checked against what is being sent by the DMP, unless you have configured $svd_ignore.


Caution DMP auto-registration support requires that the VLAN value is correctly set or “$svd_ignore” is used.

Figure 17 shows how to configure the Assigned VLAN property under the 4310 Settings for DMPs that are not located on the same VLAN using the “$svd_ignore” string.


Note You need to set a value for the Assigned VLAN property for both the 4310 Settings and the 4310 v5.2.3 Settings under Global DMP Settings in the Management Dashboard..


To configure the Assigned VLAN Property, complete the following steps:


Step 1 Go to the Management Dashboard, and click SV Director Configuration > System Configuration > Global DMP Settings .

Step 2 Complete both of the following steps, as shown in Figure 17:

a. Click 4310 Settings . Find the Assigned VLAN property. In the box, type either the VLAN number where the DMP resides, or $svd_ignore.

b. Click 4310 v5.x.x Settings . Find the Assigned VLAN property. In the box, type either the VLAN number where the DMP resides, or $svd_ignore

Figure 17 Assigned VLAN Property Configuration for DMPs

 

Step 3 Click the Save icon.


 

Verifying DMPs, Groups, and Zones in the Management Dashboard


Note Before you verify DMP status, be sure that you have set the Assigned VLAN property for your DMP 4310s so that the VLAN compliance check can be performed. For more information, see the “Configuring the DMP 4310 Assigned VLAN Property for VLAN Compliance Check” section.


To check DMPs, groups, and zones after you upgrade your software, complete the following steps:


Step 1 Go to the Management Dashboard and verify that all of your groups, zones and DMPs are present and in the green state.

Step 2 From the DMP and TV Controls dashboard drawer, run a Get Status on all DMPs to update Cisco StadiumVision Director’s record of DMP MAC addresses using the following dashboard command path:
DMP and TV Controls > Monitoring > Get Status .

Step 3 Run an Initial Config using the following dashboard command path:
DMP and TV Controls > DMP Install > Initial Config .

Step 4 Run Get Status to confirm that all DMPs have successfully rebooted and are in good health.


Note This will also update the MAC address for the DMPs.


Step 5 (Optional) Change the DMP State of healthy DMPs to “Production” using the following dashboard command path:
DMP and TV Controls > Auto Registration > Change DMP State .

Step 6 Run Get Status to check the DMP state after the change.

Step 7 Investigate any DMPs that are not in “Normal” state.


 

Verifying the Multicast Configuration

Cisco StadiumVision Director uses both unicast and multicast communications for DMP control-plane operation. The Cisco Connected Stadium design requires that Cisco StadiumVision Director uses the 239.193.0.0 multicast group address range.

The multicast group address for Cisco StadiumVision Director is configured in the “MulticastHostPort” registry.

To verify or configure the multicast addressing for Cisco StadiumVision Director, complete the following steps:


Step 1 From the Management Dashboard, select Tools > Advanced > Registry .

Step 2 Scroll to the “MulticastHostPort” registry key in the Parameters list and confirm the entry for the registry.

Step 3 To change the value, click on the value field and specify a multicast address in the range 239.193.0.0/24.


Note Be sure to use the value that is configured in your Cisco Connected Stadium network and include the :port. The recommended default is :50001.


Step 4 Click Apply .


 

Setting Up the Quest Venue Manager to Send Updates to Cisco StadiumVision Director Server


Note This task is only required if you are using the Quest Point of Sale system.


After you upgrade, you need to set up the Quest Venue Manager to support sending updates to the Cisco StadiumVision server when menu items change.

To set up the Quest Venue Manager to send updates to the Cisco StadiumVision Director server, complete the following steps:


Step 1 Access the Quest server.

Step 2 Go to the C:\Program Files\Quest POS\Quest Venue Manager\Services directory.

Step 3 Start the executable application program named “QuestInterfaceServiceManager” (Figure 18).

Figure 18 QuestInterfaceServiceManager Application

 

Step 4 When the Quest Interface Service Manager application window opens, specify the following options (Figure 19):

a. In the Select a Service box, choose the Quest Menu Web Service Notification .

b. Select the Enabled checkbox so a checkmark appears.

c. In the URL box, enter “ http://svd:8080/StadiumVision/services/TerminalUpdate .”

d. In the Poll Interval box, select 1 minute.

e. Select the Keypad and PLU update checkboxes so a checkmark appears.

f. In the Terminal Type box, select Web Service .

Figure 19 Select a Service to Configure

 

Step 5 Click OK .

Step 6 Restart the windows service to implement the configuration by completing the following steps:

a. From your laptop, click Start > Run. . .

b. When the Run dialog box opens, type “ services.msc ”.

c. Find the Quest Interface Service and restart it (Figure 20).

Figure 20 Restart the Quest Interface Service

 


 

What to Do Next

Use the Appendix A: Post-Upgrade Checklist to be sure that you have completed the required verification steps.