Guest

Enterprise Medianet

Cisco Media Services Interface Installation Guide

  • Viewing Options

  • PDF (1.1 MB)
  • Feedback


Contents

Obtaining Documentation and Submitting a Service Request....................................................................................... 3

Introduction.................................................................................................................................................................................. 3

Supported Platforms................................................................................................................................................................. 3

Deploying Cisco MSI on Microsoft Windows....................................................................................................................... 3

Manual Installation................................................................................................................................................................. 4

Silent Installation.................................................................................................................................................................... 7

Firewall Configuration........................................................................................................................................................... 7

Uninstalling Cisco MSI.......................................................................................................................................................... 7

Cisco MSI Certificate Deployment with Microsoft Active Directory.............................................................................. 7

Deploying Cisco MSI on Mac OS X......................................................................................................................................... 7

Manual Installation................................................................................................................................................................. 8

Silent Installation.................................................................................................................................................................. 12

Uninstalling Cisco MSI........................................................................................................................................................ 12

Appendix A: Silent Installation on Microsoft Windows................................................................................................... 13

Appendix B: Troubleshooting............................................................................................................................................... 14

Troubleshooting on Microsoft Windows.......................................................................................................................... 14

Troubleshooting on Mac OS X.......................................................................................................................................... 14


Obtaining Documentation and Submitting a Service Request

For information about obtaining documentation, submitting a service request, and gathering additional information, see What’s New in Cisco® Product Documentation at http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html.

Subscribe to What’s New in Cisco Product Documentation, which lists all new and revised Cisco technical documentation, as an RSS feed and deliver content directly to your desktop using a reader application. The RSSfeeds are a free service.

Introduction

The Cisco Media Services Interface (MSI) provides a comprehensive, consistent, and easy-to-use interface that enables applications on multimedia endpoints to use Cisco Medianet network services (to learn more, see www.cisco.com/go/medianet). The endpoints can use Cisco MSI to send valuable information about the media flows to the network, making the network media aware and armed with important information that can be used to make intelligent decisions. The endpoints also become network aware and can request intelligent network services: for example, for troubleshooting.

This guide is for customers who are installing Cisco MSI on a Microsoft Windows or an Apple Mac OS X system.

Supported Platforms

Cisco MSI is supported on both 32- and 64-bit versions of the following operating systems:

Microsoft Windows 7

Microsoft Windows 8

Apple OS X 10.7 (Lion)

Apple OS X 10.8 (Mountain Lion)

Deploying Cisco MSI on Microsoft Windows

The Cisco MSI runtime package must be predeployed on a Microsoft Windows user machine for compatible applications to use Cisco MSI services. It is distributed as a Microsoft Windows installer package (.msi) or a self-contained runtime executable (.exe) and can be installed, if needed, without any user interaction (see Silent Installation later in this section).

There is only one version of this runtime package, which is valid for both 32-bit and 64-bit x64 architectures. The files are installed in the following locations:

/Program Files/Cisco Systems/Media Services Interface (32-bit platforms)

/Program Files (x86)/Cisco Systems/Media Services Interface (64-bit platforms)

Note: That you must have administrative privileges to run the installer.


The following components are installed:

Cisco MSI Protocol Driver, a device driver that is signed with a VeriSign certificate and a Microsoft and VeriSign cross-signing certificate

Cisco MSI service, a Microsoft Windows service automatically started at boot time that runs under the Local System account; it is configured to log onto the Microsoft Windows event log (see Appendix B: Troubleshooting for more information about logging)

Manual Installation

To install Cisco MSI on your Microsoft Windows machine, complete the following steps:

1. Run the Installer as an administrator.

2. Read and accept the Cisco MSI license agreement. Click Install to proceed.


3. Wait until the installation is completed.

4. If the following Microsoft Windows Security pop-up window appears, click Install to proceed with theinstallation.

This pop-up window asks you to confirm that you agree to install the Cisco MSI Protocol Driver. Note that this confirmation is required by Microsoft Windows even though the device driver is signed with valid certificates (see Appendix A: Silent Installation on Microsoft Windows for details and silent-installation instructions).


5. If the following dialog box appears, you have successfully installed Cisco MSI. Click Finish to complete theinstallation.

6. If the installation fails, the following dialog box appears. See Appendix B: Troubleshooting for instructions on how to troubleshoot your problem.


Silent Installation

You can install Cisco MSI with no user interface and no user interaction. To launch a silent installation, run the Microsoft Windows Installer program msiexec from the command line (requires administrative privileges). Run the following msiexec command:

msiexec /quiet /i msi_setup_$version.msi

Note that, on Microsoft Windows 7 and 8, a Microsoft Windows Security pop-up window requires manual confirmation and therefore blocks the silent installation. For the solution to this problem, see Appendix A: Silent Installation on Microsoft Windows.

Firewall Configuration

Medianet features such as Flow Metadata and Mediatrace use the Resource Reservation Protocol (RSVP). By default, the Microsoft Windows Firewall blocks all incoming traffic for protocols other than TCP and User Data Protocol (UDP). Therefore, for Cisco MSI to run properly, you must add a firewall rule to allow incoming RSVP traffic. The Cisco MSI service automatically adds an allow RSVP firewall rule at startup and removes it at shutdown.

If a third-party firewall is running on the device, you must manually configure a firewall rule to enable RSVP incoming traffic.

Uninstalling Cisco MSI

You can uninstall the Cisco MSI service and protocol driver from the Add/Remove Programs section of the Control Panel. Alternatively, run the following msiexec command:

msiexec /x msi_setup_$version.msi

If the Cisco MSI service is running, it will be stopped, and all the client applications that are using Cisco MSI will no longer have access to its features.

Cisco MSI Certificate Deployment with Microsoft Active Directory

The Cisco MSI software uses X.509 certificates over Transport Layer Security (TLS) to provide authentication, authorization, and confidentiality services for the Cisco MSI Representational State Transfer (MSIREST) and MSI-to-MSI (MSI2MSI) protocols. Cisco MSI can adapt to any certificate enrollment and provisioning technique used by the platform integrator or system administrator.

Deploying Cisco MSI on Mac OS X

The Cisco MSI runtime package must be predeployed on a Mac OS X user machine for compatible applications to use Cisco MSI services. It is distributed as a Mac OS X installer package (.pkg) and can be installed, if needed, without any user interaction (see Silent Installation later in this section).

The identifier for the package is com.cisco.pkg.CiscoMediaServicesInterface, and the files are installed at /Library/Cisco Systems/Media Services Interface.

Note: That you must have administrative privileges to run the installer.

The component that is installed is the Cisco MSI daemon, a launch daemon on Mac OS X started at boot time that runs under the user _ciscomsi account. It is configured to log onto syslog (see Appendix B: Troubleshooting for more information about logging).

Manual Installation

To install Cisco MSI on your machine, complete the following steps:

1. Run the MSI installer package (.pkg) and follow the installation wizard.


2. Read and accept the Cisco MSI license agreement.

3. Choose Continue (recommended) or customize your installation.

Note: That Cisco Medianet features such as Flow Metadata or Mediatrace use RSVP. For Cisco MSI to provide such features, you must add the RSVP firewall rule to allow incoming RSVP traffic. This rule is disabled by default by the Mac OS X firewall. Uninstalling Cisco MSI automatically removes this rule.

4. Continue to follow the wizard until the installation is completed.


5. If the following dialog box appears, you have successfully installed Cisco MSI. Click Close to complete theinstallation.

6. If the installation fails, the following dialog box appears. See Appendix B: Troubleshooting for instructions on how to troubleshoot your problem.

Silent Installation

You can install Cisco MSI silently on Mac OS X, with no user interface and no user interaction. To launch a silent installation, use the Apple installer command-line utility. Run the following command:

sudo installer -pkg "Cisco Medianet Services Interface.pkg" -target /

Run the man installer command for information about how to use the installer from the command line.

Uninstalling Cisco MSI

To uninstall Cisco MSI, as an administrator run the following script from the command line:

sudo /Library/Cisco\ Systems/Media\ Services\ Interface/uninstaller.py

If the Cisco MSI daemon is running, it will be stopped, and all the client applications that are using Cisco MSI will no longer have access to its features.


Appendix A: Silent Installation on Microsoft Windows

When you launch the Cisco MSI installer for the first time on a Microsoft Windows 7 or 8 machine, a pop-up confirmation request from Microsoft Windows Security blocks the silent installation. This pop-up request concerns the Cisco MSI Protocol Driver that is about to be installed, and it occurs even though the device driver is signed with valid certificates. The solution to this problem requires proper certificate deployment, and this appendix describes the overall approach.

During manual installation, when the Microsoft Windows Security pop-up window appears and you select the Always Trust check box, a Cisco certificate is added in the Microsoft Windows Certificates store (under Trusted Publishers). Then any additional installation on the same machine will look for the Cisco certificate, and if it does not find it, a pop-up window will appear. However, if you then copy this certificate and add it in the store of any other Microsoft Windows 7 or 8 machines prior to installing Cisco MSI, the installation will run silently on these devices, without asking for permission.

The following steps demonstrate how to make sure that you add the right certificate:

1. Install Cisco MSI manually on a machine and select the Always Trust check box when asked forpermission.

2. Obtain the certificate as follows:

a. Run certmgr.msc at the command prompt.

b. In the certmgr window, choose Trusted Publishers > Certificates.

c. Right-click the Cisco Systems, Inc. certificate and choose All Tasks > Export.

d. Follow the Export Wizard, keeping the default settings and selecting a directory in which to save the certificate.

3. Copy this certificate to any machine on which you want to run a silent installation and run, as an administrator, certutil -addstore "TrustedPublisher" cisco.cer at the command prompt (where cisco.cer is the name of the exported certificate).

4. You can now perform a silent installation of Cisco MSI on any machine on which you copied the certificate.

Note: That Microsoft Windows provides many ways to deploy certificates on several Microsoft Windows machines at the same time, especially by using group policies (see the online Microsoft Windows documentation).

Appendix B: Troubleshooting

Troubleshooting on Microsoft Windows

Installer Logging

If problems occur during the installation process, you can enable detailed logging by installing the logging package using the following command:

msiexec /lv <logfile> /i msi_setup_$version.msi

Event Viewer

If you have problems when using Cisco MSI, a detailed log is available in Microsoft Windows Event Viewer. To access those logs and troubleshoot your problem, follow these steps.

For Microsoft Windows 7:

7. Open Event Viewer by clicking Start. In the Search field, enter Event Viewer, and from the list of results, select Event Viewer.

8. In the left menu, double-click Applications and Services and select Cisco MSI to view the Cisco MSI servicelogs.

9. In the left menu, double-click Windows Logs and select System to view the Cisco MSI Protocol Driver logs (only the logs that have Msidriver as the source).

For Microsoft Windows XP:

1. Open Event Viewer by choosing Start > Run. In the Open field, enter eventvwr.msc, and then click OK.

2. In the left menu, choose Cisco MSI to view the Cisco MSI service logs.

3. Select System to view the Cisco MSI Protocol Driver logs (only the logs that have Msidriver as the source).

You can find more information about how to use the Microsoft Windows Event Viewer on the online MicrosoftWindows Support page.

Troubleshooting on Mac OS X

Cisco MSI Daemon Logs

Cisco MSI daemon logs are sent to syslog and can be displayed in the Apple Console.app application, located at /Applications/Utilities/. The Console application allows you to view the logs that are stored on your Mac.

Installer Logging

The detailed logging information for the installation procedure is located in the syslog. However, you can redirect these logs to the standard error (stderr) file if you launch the installation using the Apple installer command-line utility:

sudo installer -dumplog -pkg "Cisco Medianet Services Interface.pkg" -target /