Installing Cisco ECDS 2.5.3 S4 on VMWare vSphere ......Installing Cisco ECDS 2.5.3 S4 on VMWare...

Installing Cisco ECDS 2.5.3 S4 on VMWare vSphere Hypervisor (ESXi)

Revised: September 2012

Contents• Overview, page 1

• Guidelines and Limitations, page 1

• Prerequisites, page 2

• Installation and Basic Configuration Workflow, page 2

• Related Documentation, page 27

OverviewCisco MDE10XVB software allows a Cisco ECDS 2.5.3 service engine to run virtually on a VMWare vSphere Hypervisor (ESXi) system. You can manage your virtual service engine from the Cisco Enterprise Content Delivery System Manager (Cisco CDSM) instance that runs on a physical Cisco Media Delivery Engine (Cisco MDE) appliance.

Guidelines and Limitations• The virtual blade operates in service engine (SE) device mode only. You cannot use it as a

content acquirer (CA).

• Do not change any Cisco MDE10XVB parameters unless specifically instructed.

• If you receive a large number of CPU threshold alarms on your ESXi system, reduce the Acq-In bandwidth to 10Mbps. By default, it is 25Mbps.

Americas Headquarters:Cisco Systems, Inc., 170 West Tasman Drive, San Jose, CA 95134-1706 USA

Prerequisites

PrerequisitesBefore you begin, verify the following requirements:

• Host System Hardware, page 2

• Host System Software, page 2

• Host System License, page 2

• Cisco ECDS Software, page 2

Host System HardwareCisco MDE10XVB is supported on a host system that meets or exceeds these basic requirements.

• Min. 4 GB RAM

• Min. 80 GB disk space

• 64-bit processor (x86)

• Virtualization enabled in BIOS

Host System SoftwareYour hypervisor host system must be running:

• VMWare vSphere Hypervisor (ESXi) release 5.0 or 4.1.

• vSphere or vCenter release 5.0 or 4.1.

Host System LicenseYou must have a vSphere or vCenter enterprise software license installed on your hypervisor host system.

Cisco ECDS SoftwareOrder the Cisco ECDS 2.5.3 software CD, part number MDE-10XVB-K9 This software is not available for download from Cisco.com.

Installation and Basic Configuration WorkflowThe workflow to install ECDS 2.5.3 on an ESXi hypervisor host system follows this sequence:

1. Obtain and Install VMWare vSphere Hypervisor (ESXi) 5.0 or 4.1, page 3

2. Configure ESXi, page 3

3. Download, Install, and Run the vSphere Client, page 8

4. Install the ESXi License, page 9

2Installing Cisco ECDS 2.5.3 S4 on VMWare vSphere Hypervisor (ESXi)

Installation and Basic Configuration Workflow

5. Install the Cisco ECDS Image on ESXi, page 10

6. Configure ESXi to Start Automatically, page 12

7. Adjust ECDS Memory Settings per Hypervisor, page 14

8. Allocate Disk Space, page 15

9. Add a Network Interface, page 18

10. Add a Serial Interface, page 21

11. Configure ECDS Software, page 23

12. Enable Apple HTTP Live Streaming, page 26

Obtain and Install VMWare vSphere Hypervisor (ESXi) 5.0 or 4.1

Before You Begin

If you have not done so already, register and log in to a user account with VMWare Incorporated.

Procedure

Step 1 Obtain the ESXi installation utility at http://www.vmware.com/go/get-free-esxi

OR

https://www.vmware.com/tryvmware/p/activate.php?p=free-esxi5&lp=default.

Note ESXi is not a Cisco product. It is a product of VMWare Incorporated, which is solely responsible for ESXi development, maintenance, technical documentation, licensing, and support.

Step 2 Run the ESXi installation utility:

• On a server that meets VMWare compatibility criteria— available at the same URL.

• According to the VMWare installation instructions—available at the same URL.

Configure ESXi

Note • Illustrated values in this SIMPLIFIED procedure are merely examples. Use appropriate values for your network.

• If technical problems prevent you from completing this SIMPLIFIED procedure successfully, please see the authoritative and comprehensive setup documentation on http://www.vmware.com.

Before You Begin

Install ESXi.


http://www.vmware.com/go/get-free-esxi

https://www.vmware.com/tryvmware/p/activate.php?p=free-esxi5&lp=default

http://vmware.com


Procedure

Step 1 Log in to ESXi with the username root.

The first time that you log in, there is no password.

Step 2 Press F2 to load the administrative console.

Step 3 Choose Configure Password, and then press Enter to set a password for root.

Step 4 Choose Configure Management Network > IP Configuration and press Enter.

The IP Configuration dialog box opens. You will set a static IP address.



Step 5 Enter the IP address, subnet mask, and default gateway that your virtual system should use and press Enter.

Because you have set a static IP address (rather than use DHCP), you must now configure all DNS settings manually.

Step 6 Choose Configure Management Network > DNS Configuration and press Enter.

The DNS Configuration dialog box opens.

Step 7 Enter the IP address of your primary DNS server and a hostname that DNS servers should resolve to the IP address from Step 4.

Note Do not use “localhost” as the hostname.

Step 8 (Optional) Enter the IP address of an alternative DNS server.

Step 9 Press Enter.



Step 10 Choose Configure Management Network > Custom DNS Suffixes and press Enter.

The Custom DNS Suffixes dialog box opens.

Step 11 Enter any suffixes that DNS should append automatically to unqualified hostnames and press Enter.

Step 12 Type Y to save your changes to the management network.

Step 13 Choose Test Management Network after ESXi finishes its restart of the management network and press Enter.



The Test Management Network dialog box opens.

Step 14 Press Enter to test the configuration entries that you saved.

Step 15 Choose Troubleshooting Options > Enable ESXi Shell and press Enter.

Step 16 This task is complete; you have configured the hypervisor.



Download, Install, and Run the vSphere Client

Procedure

Step 1 Point your web browser to https://hypervisor_ip_address.

Your browser is directed to a page where you can download the vSphere Client.

Step 2 Click Download vSphere Client.

Step 3 Run the installation. Follow the onscreen instructions.

Step 4 After installation, run the vSphere client.

The vSphere Client login screen appears.

Step 5 Use the IP address / Name field to enter the IP address of the virtual MDE on your ESXi hypervisor.

Step 6 Enter a username in the User name field. If you have not yet configured a username, enter root.



Step 7 Enter your password in the Password field. Or, if you have not yet configured a user name and password, leave this field blank.

The vSphere Client opens.

Install the ESXi License

Procedure

Step 1 In the vSphere Client Inventory screen, click to select the ESXi hypervisor address.

Step 2 Click Configuration.

Step 3 Click Licensed Features in the Software area.

Step 4 Click Edit in the ESX Server License Type area to open the Assign License dialog box.

Step 5 Click Assign a new license key to this host, and then click Enter Key.

Step 6 Enter the license key. Then, click OK to save your work and close the Assign License dialog box.



Install the Cisco ECDS Image on ESXiInstall the virtual machine image from the product installation disc.

Procedure

Step 1 Insert the product disc into your disc drive.

Step 2 In the vSphere Client menu bar, choose File > Deploy OVF Template.

The Deploy OVF Template wizard opens.

Step 3 Click Browse.

Step 4 Navigate to your CD-ROM drive, choose the MDE10XVB.ova file, and then click Next.

The wizard loads its OVF Template Details page.

Step 5 Review the information. Then, click Next.



The wizard loads its Name and Location page.

Step 6 Type a name for your deployed template or accept the default. Then, click Next.

The wizard loads its Disk Format page.

Tip The appearance of this page differs trivially between releases 4.1 and 5.0.



Step 7 Choose Thick provisioned format.

AND

If you use ESXi 5.0 instead of ESXi 4.1, also choose Thick provision lazy zeroed.

Step 8 Click Next.

The wizard loads its Network Mapping page.

Step 9 Click Next.

Step 10 Review the information on the Ready to Complete screen. Then, click Finish.

A progress bar keeps pace with your ECDS deployment, which can take from 10 to 30 minutes to finish. When the deployment is finished, the Deployment Completed Successfully dialog box opens.

Step 11 Click Close to dismiss the dialog box.

Step 12 Click the Inventory icon ( ) to list virtual machines that are deployed to ESXi.

Keep the vSphere client open.

Configure ESXi to Start Automatically

Note VM startup can occur automatically in response to soft reboots of your hypervisor host system. However, this setting does not respond to hard resets of the hypervisor host, such as power cycling.

Procedure





Step 3 Click Virtual Machine Startup/Shutdown in the Software area to open the Virtual Machine Startup and Shutdown dialog box.

Step 4 Check the Allow virtual machines to start and stop automatically with the system check box in the System Settings area.

Step 5 (Optional) Configure settings to delay VM startup, shutdown, or both.

Step 6 Click your new VM in the Manual Startup section of the Startup Order table, and then click Move Up two times.

Your new VM should now be in the Automatic Startup section of the Startup Order table.

Step 7 Click OK to save your work and close the Virtual Machine Startup and Shutdown dialog box.



Adjust ECDS Memory Settings per HypervisorCisco MDE10XVB for ESXi uses 1000 MB of memory in its factory default configuration, but you can configure it to use more.

Note You must reserve at least 1500 MB of physical memory for the hypervisor.

This procedure tells you how to configure Cisco MDE10XVB memory settings.

Before You Begin

• Shut down the guest operating system and make sure that the virtual machine is turned Off.

Procedure

Step 1 In the vSphere Client Inventory screen, click to select the Cisco ECDS virtual machine that you deployed.

Step 2 From the menu, choose Inventory > Virtual Machine > Edit Settings.

The Virtual Machine Properties dialog box appears.

Step 3 On the Hardware tab, click to choose the Memory row.

Memory properties load on the right.

Step 4 Increase the Memory Size as needed. Make sure that MB shows as the unit.

Note You must reserve at least 1500 MB of physical memory for ESXi. Otherwise, performance of your virtual machine might be degraded.

Step 5 Click OK to close the dialog box.

Keep the vSphere client open.



Allocate Disk Space

Before You Begin

• Shut down the guest operating system and make sure that the virtual machine is turned Off.

Procedure

Step 1 Click the virtual machine to select it.

Step 2 Click Edit virtual machine settings on the Getting Started tab.

The Virtual Machine Properties dialog box opens with its Hardware tab already selected.



The hardware list shows four hard disks.

• Hard disk 1 is compact flash. Do not edit it.

• Hard disk 2 is the Linux virtual file system, Sysfs. Do not edit it.

• Hard disk 3 is the ECDS volume for CDNFS objects. Do not edit it.

YOU MUST EDIT HARD DISK 4 NOW.

Caution You can edit the allocated capacity of Hard disk 4 during this initial setup, if needed. However, you cannot change its capacity afterward. Any attempts to do so may cause data loss.

Step 3 Click Hard disk 4 in the list and increase its provisioned size, as needed. Then, click OK.

• The provisioned size cannot exceed 256 GB.

• Make sure to leave at least 10 GB free on the hypervisor partition where your VM is deployed.

Step 4 Click Restart ( ) in the toolbar.

Step 5 Click Console after your virtual machine has restarted.



Step 6 Log in to your virtual service engine as admin.

Step 7 Type the command sh disk details and press Enter.

In the echoed output for this console command, “disk02” corresponds to Hard disk 4. Notice that its 15 GB partition for CDNFS objects differs from the 65 GB allocation that you set in Step 3.

Step 8 You must reformat the disk to reset its partition map.

a. Type the command disk unuse disk02 and press Enter.

b. Type the command disk reformat disk02 and press Enter.

c. Type the command reload and press Enter.

d. Log in again to your virtual service engine as admin.



e. Type the command sh disk details and press Enter.

Now, the echoed output for this console command shows that the changed partition map for “disk02” supports your use of all 65 GB for the storage of CDNFS objects.

Add a Network Interface

Timesaver This procedure is optional.

By default, only a single network interface is created for the virtual machine. This interface is mapped to a NIC on the hypervisor. You can add a second network interface to the virtual machine to support streaming and, optionally, management.

Procedure





Step 3 Click Networking in the Hardware area.

The Configuration tab loads network information about your virtual switch.

Step 4 Click Add Networking to open the Add Network Wizard utility.

Step 5 Click Virtual Machine in the Connection Types area. Then, click Next.

The utility loads its Network Access page.

Click Next.

The utility loads its Connection Settings page.

Step 6 Enter a name for this new connection in the Network Label field. For example “ESXi Interface.”

Step 7 Click Next.

The utility loads a summary of your new VM settings.

Step 8 Click Finish.

The Add Network Wizard utility closes and the Inventory screen appears.


Step 10 From the menu, choose Inventory > Virtual Machine > Edit Settings.

The Virtual Machine Properties dialog box appears.

Step 11 On the Hardware tab, click to choose Network Adapter in the hardware list.



Step 12 Click Add. to open the Add Hardware utility.

Step 13 Click Ethernet Adapter in the device list. Then, click Next.

The utility loads its Network Type page.

Step 14 Choose from the Network Label list the same connection that you named in Step 6. Then, click Next.

The utility loads its Ready to Complete page.

Step 15 Review your settings. Then, click Finish.

The Add Hardware utility closes and the Inventory page appears.



Add a Serial InterfaceOrdinarily, the MDE10XVB boot sequence and most of its diagnostic output are not echoed to any console. Instead, we direct these messages to a serial output — exactly as we do on any physical (non-virtual) SE.

On any of our physical SEs, however, you can attach a serial cable to the serial port and observe its messages easily. You cannot do the same on a virtual platform, even though its host system hardware might have a serial port. Even so, you can add a serial interface to your virtual machine and map this interface to a logical telnet port at the hypervisor IP address. Later, when you attach a telnet terminal client to the virtual serial port, you can observe MDE10XVB output easily.

Before You Begin

• You cannot add a serial interface to your virtual SE until a vSphere Enterprise license is installed on the ESXi hypervisor host system. See the documentation at http://www.vmware.com to understand VMWare licensing.

Procedure


Step 2 Choose Inventory > Virtual Machine > Edit Settings to open the Virtual Machine Properties dialog box.

Step 3 Click Add on the Hardware tab to open the Add Hardware utility.

Step 4 Choose Serial Port from the device list. Then, click Next.

The utility loads its Serial Port Type page.


http://vmware.com


Step 5 Click Connect via Network. Then, click Next.

The utility loads its Network Serial Port Settings page.

Step 6 Click Server in the Network Backing area.

Step 7 Type the hypervisor IP address and a port number of your choosing in the Port URI field. Your entry here must match this format:

telnet://hypervisor_ip_address:port_number

For example:

telnet://10.1.1.5:7001

Tip You can use any unused port number.

Step 8 Click Next.

The utility loads its Ready to Complete page.

Step 9 Review your settings. Then, click Finish to close the Add Hardware wizard utility.




Step 11 If your hypervisor release version is ESXi 5.0, click Security Profile in the Software area.

Step 12 Click Properties in the Firewall area.

The Firewall Properties dialog box opens.

Step 13 Check the VM serial port connected over network check box. Then, click OK.

Configure ECDS SoftwareOnce you configure the basic settings, you can manage the service engine from ECDSM.

This procedure configures two interfaces— one as the primary interface and one as the streaming interface. If you want to use a single interface for both streaming and management, configure only one interface (we recommend using the external interface of ESXi) and set it as both the primary and the secondary interface.

Procedure


Step 2 Click the Console tab for the virtual machine.



The console is blank until you power on the virtual machine.

Step 3 From the menu, choose Inventory > Virtual Machine > Power > Power On.

The login prompt appears after the boot sequence is completed.

Note You will not see the boot sequence until you have configured your system to echo it to the console. See Add a Serial Interface, page 21.

Step 4 Log in with these credentials.

• User Name: admin

• Password: default

The ECDS system prompt appears.



Step 5 Do one of the following to configure your SE.

When you are done configuring the basic settings and the streaming interface, log into your ECDSM and activate the device.

• Will you use the simple setup utility?

When you will use Setup

a. NO-HOSTNAME# setup

b. What is the mode of the device (SE/SR/CDSM): SE

Is this SE going to be managed by a CDSM (Content Delivery System Manager) (y/n) [y]: y

Please choose an interface to configure from the following list:1: GigabitEthernet 1/02: GigabitEthernet 2/0Enter choice: 1

Do you want to enable DHCP on this interface (y/n) [n]: nPlease enter the IP address of this interface: ip_addressPlease enter the netmask of this interface: netmaskPlease enter the default gateway: gateway_ip_addressPlease enter the domain name server IP: dns_ip_addressPlease enter the domain name: domain_amePlease enter the hostname: namePlease enter CDSM (Content Delivery System Manager) IP or Host name: ip_address_or_hostname

Do you want to apply the configurations (y/n) [y] y

This may take a few moments. Please wait...All CLI configurations were applied successfully.Press any key to continue...

• Will you configure settings manually?

When you will use configuration mode

a. Enter configuration mode.

NO-HOSTNAME# configureNO-HOSTNAME(config)#

b. Configure the required settings.

NO-HOSTNAME(config)# hostname hostname

name(config)# ip domain-name domain_namename(config)# interface GigabitEthernet 1/0

name(config-if)# ip address ip_address netmaskname(config-if)# exit

name(config)# primary-interface GigabitEthernet 1/0name(config)# streaming-interface GigabitEthernet 1/0name(config)# ip default-gateway gateway_ip_addressname(config)# ntp server ntp_ip_addressname(config)# cdsm ip ecdsm_ip_address_or_hostnamename(config)# ip name-server dns_ip_addressname(config)# cms enable



Enable Apple HTTP Live StreamingThis optional task enables a service rule to support Apple HTTP Live Streaming, if you use it in your network.

Procedure


Step 2 Click the Console tab for the virtual machine.

The console is blank until you power on the virtual machine.

Step 3 From the menu, choose Inventory > Virtual Machine > Power > Power On.

The login prompt appears after the boot sequence is completed.

Note You will not see the boot sequence until you have configured your system to echo it to the console. See Add a Serial Interface, page 21.

Step 4 Log in with these credentials.

• User Name: admin

• Password: default

The ECDS system prompt appears.


Related Documentation

Step 5 Enter configuration mode.

host# configurehost(config)#

Step 6 Enable the service rule to support Apple HLS.

host(config)# rule enablehost(config)# rule action no-cache pattern-list 20host(config)# rule pattern-list 20 url-regex .m3u8host(config)#

Related DocumentationFor complete document support for the Cisco Media Delivery Engine appliances and the Cisco Enterprise Content Delivery System, see the Documentation for the Enterprise Content Delivery System (ECDS) document roadmap at the following link:

http://www.cisco.com/en/US/docs/video/ecds/documentation.html

Obtaining Documentation and Submitting a Service RequestFor 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:

http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

Subscribe to the What’s New in Cisco Product Documentation as an RSS feed and set content to be delivered directly to your desktop using a reader application. The RSS feeds are a free service. Cisco currently supports RSS Version 2.0.

This document is to be used in conjunction with the documents listed in the “Related Documentation” section.

Cisco and the Cisco logo are trademarks or registered trademarks of Cisco and/or its affiliates in the U.S. and other countries. To view a list of Cisco trademarks, go to this URL: 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. (1110R)

Any Internet Protocol (IP) addresses and phone numbers used in this document are not intended to be actual addresses and phone numbers. Any examples, command display output, network topology diagrams, and other figures included in the document are shown for illustrative purposes only. Any use of actual IP addresses or phone numbers in illustrative content is unintentional and coincidental.

© 2011-2012 Cisco Systems, Inc. All rights reserved.


http://www.cisco.com/en/US/docs/general/whatsnew/whatsnew.html

http://www.cisco.com/go/trademarks

http://www.cisco.com/en/US/docs/video/media_delivery/ecds/documentation.html

http://www.cisco.com/en/US/docs/video/ecds/documentation.html

http://www.cisco.com/en/US/docs/video/media_delivery/documentation.html

Installing Cisco ECDS 2.5.3 S4 on VMWare vSphere ......Installing Cisco ECDS 2.5.3 S4 on VMWare...

Documents

Transcript of Installing Cisco ECDS 2.5.3 S4 on VMWare vSphere ......Installing Cisco ECDS 2.5.3 S4 on VMWare...