Installing Cisco ICFPP on VMware

Cisco ICFPP Software

The Cisco ICFPP software is available for download from Cisco.com. For assistance, contact your Cisco representative.

The Cisco ICFPP software package (ICFP-dk9-2.3.1-pkg.zip), contains the following files:

File

Description

icfpp-2.3.1.ova

Cisco ICFPP OVA file.

Use this file to install Cisco ICFPP in VMware environments. See Workflow for VMware Environments.

icfpp-2.3.1.qcow2

Cisco ICFPP QCOW2 file.

Use this file to install Cisco ICFPP in OpenStack environments. See Workflow for OpenStack Environments.

README

README file.

This file contains information about installing and using Cisco ICFPP.

The Cisco ICFPP software includes an evaluation license with support for 20 VMs. To view the license details in the GUI after you install Cisco ICFPP, choose Administration > License, and expand the entry in the License Keys table.

Workflow for VMware Environments

Cisco ICFPP should be implemented by all service providers that interface with Cisco Cisco Intercloud Fabric Director platforms. The only exceptions to this are Amazon EC2 and Windows Azure, which are available to Cisco Intercloud Fabric through their native public cloud APIs.

The high-level tasks involved in deploying Cisco ICFPP in a VMware environment are:

  1. Confirm that you have met the installation requirements—See Installation Requirements.

  2. Gather the required information—See Information Required for Configuration and Installation.

  3. Install Cisco ICFPP—See Installing Cisco ICFPP on VMware.

  4. If needed after the installation, configure the Cisco ICFPP IP address—See Configuring the IP Address for Network Access.

  5. (Optional) Configure Cisco ICFPP virtual appliances for a multiple-node cluster—See Configuring Cisco ICFPP for Clusters.

  6. Configure communications with Cisco Intercloud Fabric Director—See the Cisco Intercloud Fabric Getting Started Guide.

Installing Cisco ICFPP on VMware

This procedure describes how to install Cisco ICFPP in a VMware environment.


Note
We recommend that you configure additional storage for all Cisco ICFPP nodes. If additional storage is not configured, all VM images that are uploaded from Cisco Intercloud Fabric Director are stored on the node's local disk. If the node fails, one or both of the following can occur:

  • Any images stored on the node are no longer available.

  • If the node is part of a cluster, template creation and VM migration fail.

If NFS is not available, you can configure a Cinder volume as described in Configuring a Cinder Volume.

Before You Begin

  • Set your keyboard to United States English.

  • Unzip the Cisco ICFPP software package to obtain the OVA file and the README file.

  • Copy the Cisco ICFPP OVA image to a location that is available from the VMware vSphere Client.

  • Make sure that all requirements are met as specified in System Requirements.

  • Collect the information required for the installation. See Information Required for Configuration and Installation.

  • Review the README file for information related to Cisco ICFPP installation and operation.

Procedure
    Step 1   Using the VMware vSphere Client, log in to the vCenter server.
    Step 2   Choose the host on which to deploy the Cisco ICFPP virtual appliance.
    Step 3   Choose File > Deploy OVF Template.
    Step 4   In the wizard, provide the information as described in the following table:

    Screen

    Action

    Source

    Choose the Cisco ICFPP OVA using one of the following methods:

    • Browse to the location, choose the file, and click Open.

    • Deploy from a URL on your local area network. Replace FQDN with the IP address or the fully qualified domain name, and click Next.

    OVF Template Details

    Verify the details.

    End User License Agreement

    Read the agreement and click Accept.

    Name and Location

    1. Enter a name for the virtual appliance.

    2. Choose the VMware data center or host where Cisco ICFPP will reside.

    Deployment Configuration

    Choose the type of deployment:

    • Standalone—Used for single-node deployments.

    • Primary Node—Used for HA deployment in a multiple-node cluster.

    • Service Node—Used in cluster deployments for handling requests.

    Storage

    Choose the location in which to store the Cisco ICFPP files.

    Disk Format

    Choose the required format for the virtual appliance disks:

    • Thick Provision Lazy Zeroed—Allocates storage immediately in thick format.

    • Thick Provision Eager Zeroed—Allocates storage in thick format. Creating disks might take longer using this option.

    • Thin Provision—Allocates storage on demand as data is written to disk.

    Network Mapping

    Choose the required network.

    Properties

    Address any errors that are indicated in red-colored text below a selection box.

    Node Mode

    Choose the type of deployment for this node: Standalone, Primary Node, or Service Node. The mode you choose should match the deployment type in the Deployment Configuration screen.

    ICFPP Hostname

    Enter the hostname for the Cisco ICFPP node.

    ICFPP Password

    Enter and confirm the password to use for the admin, root, and ShellAdmin account access.

    Static IP Address

    Enter the static IP address to use for the Cisco ICFPP node.

    Static IP Subnet Mask

    Enter the subnet mask to apply to the node IP address.

    IP Gateway

    Enter the gateway IP address.

    Primary Node IP Address for Service Node

    For service nodes only, enter the IP address of the primary node or the virtual IP address (VIP) of the HA pair for database access.

    NFS Server IP Address

    Enter the IP address for an NFS server.

    Note   

    If you do not configure NFS in a multiple-node cluster deployment, template creation and VM migration can fail if a service node fails.

    NFS Server Directory to Mount

    NFS server directory to be mounted.

    Domain Name

    Enter the domain name for the node, such as cisco.com.

    DNS Server IP Address

    Enter the DNS server IP address.

    NTP Server IP (FQDN or IP Address)

    Enter the NTP server IP address or fully qualified domain name.

    Ready to Complete

    Review the deployment settings for accuracy.

    Step 5   Click Finish. A progress indicator displays the task status until Cisco ICFPP is deployed. For additional information, right-click the VM in the VMware vSphere Client and choose Open Console.
    Step 6   After Cisco ICFPP is successfully deployed, power on the virtual appliance.
    What to Do Next

    If needed, configure the Cisco ICFPP IP address for network address. For more information, see Configuring the IP Address for Network Access.

    Configuring the IP Address for Network Access

    After installing Cisco ICFPP in a VMware environment, you might need to configure the Cisco ICFPP IP address for network access.

    The Cisco ICFPP IP address is configured during installation by using Open Virtualization Format (OVF) parameters. However, if the IP address is not configured correctly, you must configure the static IP address by using the ShellAdmin console options as described in this procedure.

    Procedure
      Step 1   Using SSH, connect to the Cisco ICFPP ShellAdmin console by using the following information:

      • Cisco ICFPP IP address

      • Username—shelladmin

      • Password—The password that you set when you installed Cisco ICFPP

      Step 2   At the ShellAdmin prompt, choose the Configure Network Interface option to configure the static IP address.
      Step 3   Enter S to configure a static IP address.
      Step 4   Enter the Ethernet interface that you want to configure, such as eth0 or eth1.
      Step 5   When prompted for the IP version, choose IPv4.
      Step 6   Enter the static IP address, netmask, and gateway IP address.
      Step 7   Enter Y to confirm the information. The Cisco ICFPP virtual appliance reboots and displays a screen with the URL for accessing Cisco ICFPP.
      Step 8   (Optional)To verify that the change has been applied, log in to the ShellAdmin console and choose the Display Network Details option.