Installing Cisco ICFP on OpenStack

Workflow for OpenStack Environments

Cisco ICFP should be implemented by all service providers that interface with Cisco Intercloud Fabric for Business 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 following table identifies the high-level tasks involved in installing and configuring Cisco ICFP in an OpenStack environment.

Step

Task

Related Information

1.

Confirm that you have met the installation requirements.

Installation Requirements

2.

Gather the required information.

Information Required for Configuration and Installation

3.

Configure OpenStack for Cisco ICFP and launch a Cisco ICFP instance.

Installing Cisco ICFP on OpenStack

4.

(Optional) Upload a Cisco ICFP license file.

Uploading Cisco ICFP Licenses

5.

Configure Cisco ICFP for use with Cisco Intercloud Fabric.

Configuring Cisco ICFP for Cisco Intercloud Fabric

6.

(Optional) Configure Cisco ICFP virtual appliances for a multiple-node cluster.

Configuring Cisco ICFP for Clusters

7.

Configure Cisco Intercloud Fabric for use with Cisco ICFP.

Cisco Intercloud Fabric Installation Guide

Installing Cisco ICFP on OpenStack

To install Cisco ICFP on OpenStack, you must import an image, create a flavor, and launch an instance. This procedure describes how to complete these tasks.

The amount of time required for this procedure depends on the platform:

  • If the platform does not support QCOW2, the procedure can take up to two hours to complete, depending on the amount of time it takes to upload the image and convert it from QCOW2 format to RAW.

  • If the platform supports QCOW2, no conversion is required, and the procedure takes less time.

Before You Begin

  • Download the Cisco ICFP software package from Cisco.com. For assistance, contact your Cisco representative.

  • Unzip the downloaded file to obtain the QCOW2 file and the README file. For more information, see Cisco ICFP Software.

  • Review the README file for information related to installing and using Cisco ICFP with OpenStack.

  • Confirm that you have met the requirements in System Requirements.

  • Gather the information identified in Information Required for Configuration and Installation.

  • In OpenStack:

    • Confirm that you have admin privileges.

    • Create an OpenSource RC file (name-openrc.sh) in which you define your environmental variables and login credentials.

    • Create a project on which to install Cisco ICFP.

    • Confirm that the Cinder service is up and running.

    • Configure a security group that allows traffic on ports 22, 80, 443, and 3306.

    For more information about performing these operations in OpenStack, see docs.openstack.org.

Procedure
    Step 1   In the shell from which you will enter glance commands, enter the following command: 
    source name-openrc.sh
    Step 2   Copy the Cisco ICFP image to the system running the glance CLI.
    Step 3   Using the glance CLI, upload an image to the OpenStack server by entering the following command: 
    glance image-create --name icfp-n.n.n --disk-format qcow2 --container-format bare --file ./icfp-n.n.n.qcow2

    where icfp-n.n.n is the name of the Cisco ICFP image, such as icfp-3.1.1.

    After the image has been uploaded, it appears in the OpenStack Dashboard Images table at Admin > Images or project > Manage Compute > Images & Snapshots.
    Step 4   In the OpenStack Dashboard, choose Admin > Flavors, and click Create Flavor.
    Step 5   In the Create Flavor dialog box, enter the following information, and click Create Flavor:

    • Name—Enter a flavor name.

    • vCPUs—Enter 4.

    • RAM MB—Enter 8192.

    • Root Disk—Enter the desired disk size in gigabytes.

    • Ephemeral Disk—Enter 0.

    • Swap Disk—Enter 0.

    Step 6   Choose Project > project > Manage Compute > Volumes, and click Create Volume.
    Step 7   In the Create Volume dialog box, add a volume with the size 100 GB, and click Create Volume.
    Step 8   In OpenStack, obtain the following information:

    • Flavor ID

    • Image ID

    • Network ID

    Step 9   At the command line, enter the following command to launch Cisco ICFP: 
    nova boot --image image-id --flavor flavor-id  
--nic net-id=network-id --block-device-mapping vdb=volume-id
icfp-instance-name
    A Cisco ICFP instance is launched.

    Configuring Cisco ICFP for Cisco Intercloud Fabric

    After you have installed Cisco ICFP on an OpenStack server and launched a Cisco ICFP instance, you can configure Cisco ICFP for use with Cisco Intercloud Fabric.

    Before You Begin

    Confirm the following:

    • Cisco ICFP has been installed on an OpenStack server and an instance has been launched.

    • You know the Cisco ICFP public IP address.

    • If Keystone V3 Identity Service is enabled on the cloud instance, the authentication domain.

    • If group-based policies are enabled on the cloud instance, the external segment name and the name of the external group that is used to connect internal groups to the Internet.

    Procedure
      Step 1   In a browser, enter the public IP address assigned to the Cisco ICFP instance and log in to the Cisco ICFP GUI. The default credentials are:

      • Username: admin

      • Password: changeme

      Step 2   In the OpenStack dashboard, choose Project > project > Access & Security, and click the API Access tab.
      Step 3   In the API Endpoints table, locate and note the service endpoint Uniform Resource Identifier (URI) for the Identity service.
      Step 4   In the Cisco ICFP GUI, choose Cloud Instances, and click the Add Cloud Instance icon.
      Step 5   In the New Cloud Instance dialog box, provide the following information, and click Create:

      Field

      Description

      Cloud Instance Name

      Name of the cloud instance.

      Select Cloud

      The cloud instance type: Cisco or Custom.

      Select Module

      For a Cisco cloud instance type, choose the module type. For example, choose OSP for an OpenStack Platform cloud.

      For a custom cloud instance, enter the custom module name.

      Endpoint URI

      The endpoint hostname or IP address of the cloud instance.

      Parameters

      The parameters that are displayed depend on the selected module.

      Image Conversion Support on Cloud

      For OSP modules, indicate whether or not image conversion on the cloud is required.

      First Boot Image Conversion Support

      For OSP modules, indicate whether or not image conversion during VM boot on the cloud is required.

      Enable Group-Based Policy Support

      For OSP modules, indicate whether or not the provider OpenStack cloud uses a group-based policy framework.

      Enable Keystone V3 API Support

      For OSP modules, indicate whether or not OpenStack Keystone V3 Identity Service is used for authentication in the provider OpenStack cloud.

      Enable Boot from Volume Support

      For OSP modules, indicate whether or not the cloud instance is to be booted from a Cinder volume.
      Step 6   In the Cisco ICFP GUI, choose Tenant Accounts, and click the Add Tenant Account icon.
      Step 7   In the New Tenant Account dialog box, provide the following information, and click Create:

      Field

      Description

      Tenant Name

      Enter the tenant name.

      Select Cloud

      Choose the cloud instance.

      You cannot change the cloud instance after adding the tenant.

      Max Servers

      Enter the maximum of servers provisioned for the tenant, including stopped VMs.

      Username

      Enter the tenant account username.

      Email

      Enter the tenant account email address.

      Parameters

      The parameters that are displayed depend on the selected cloud.

      External Segment Name

      For an OpenStack cloud that uses a group-based policy framework, enter the external segment name.

      Domain Name

      For an OpenStack cloud with Keystone V3 Identity Service enabled, enter the domain name.

      External Group Name

      For an OpenStack cloud that uses a group-based policy framework, enter the name of the external group that is used to connect internal groups to the Internet.