Chapter 1. Overview

Cisco Intercloud Fabric Provider Platform

Overview of the Troubleshooting Process

Overview of Best Practices

Contacting Cisco

Chapter 2. Troubleshooting Cisco ICFPP

Problems with Connectivity

Cisco ICFPP Error Codes and Faults

Chapter 3. Troubleshooting Adapters

Working with Dimension Data Adapters

Chapter 4. Obtaining Help from Cisco

Contacting Cisco Customer Support

Obtaining Logs for Cisco Customer Support

Obtaining System Information

Downloading Logs for HA and Cluster Environments

Chapter 5. Additional Information

Related Documentation for Cisco Intercloud Fabric Provider Platform

Obtaining Documentation and Submitting a Service Request

Documentation Feedback

Copyright Page

Chapter 1. Overview

- Cisco Intercloud Fabric Provider Platform

- Overview of the Troubleshooting Process

- Overview of Best Practices

- Contacting Cisco

Cisco Intercloud Fabric Provider Platform

Cisco Intercloud Fabric Provider Platform (ICFPP) simplifies and abstracts the complexity involved in working with a variety of public cloud APIs, and enables cloud API support for service providers who currently do not have API support. Cisco ICFPP provides an extensible adapter framework that allows integration with a variety of provider cloud infrastructure management platforms, such as OpenStack, CloudStack, VMware vCloud Director, and any other API that can be integrated through an software development kit (SDK) provided by Cisco.

Currently, service providers have their own proprietary cloud APIs—such as Amazon EC2 and Windows Azure—that give customers limited choices and provide no easy method for moving from one provider to another. Cisco ICFPP abstracts this complexity and translates Cisco Intercloud Fabric cloud API calls to cloud platform APIs of different provider infrastructure platforms, giving customers the option of moving their workloads regardless of the cloud API exposed by the service provider.

Many service providers do not provide cloud APIs that Cisco Intercloud Fabric can use to deploy customers' workloads. One option for these providers is to provide direct access to their virtual machine manager's SDK or API, such as vCenter or System Center, which exposes the provider environment and is not a preferred option for service providers due to security concerns. Cisco ICFPP, as the first point of authentication for the customer cloud so that it can consume provider cloud resources, enforces highly secure access to the provider environment. In addition, it provides the cloud APIs that are required for service providers to be part of the provider ecosystem for Cisco Intercloud Fabric.

As the interface between the Cisco Intercloud Fabric from customer cloud environments and provider clouds (public and virtual private clouds), Cisco ICFPP provides the following benefits:

- Standardizes and brings uniformity to cloud APIs, making it easier for Cisco Intercloud Fabric to consume cloud services from service providers that are part of the Cisco Intercloud Fabric ecosystem.

- Helps secure access to a service provider's underlying cloud platform.

- Limits the utilization rate per customer or tenant environment.

- Provides northbound APIs for service providers for integration with existing management platforms.

- Supports multitenancy.

- Monitors resource usage per tenant.

- Meters resource usage per tenant.

Overview of the Troubleshooting Process

Follow the steps below to troubleshoot your network:

1. Gather information that defines the specific symptoms.

2. Identify all potential causes for the symptoms.

3. Systematically eliminate each potential cause (from most likely to least likely) until the symptoms disappear.

Overview of Best Practices

Best practices are the recommended steps you should take to ensure the proper operation of your appliance. We recommend the following best practices for most networks:

- Maintain a consistent Cisco Intercloud Fabric Provider Platform release across all network devices.

- Refer to the release notes for your Cisco Intercloud Fabric Provider Platform release for the latest features, limitations, and caveats.

- Document private data center details, including the vNIC configuration used by virtual machines (VMs) and the corresponding vSwitch configuration to ensure that they are consistent with each other.

- Verify and troubleshoot any new configuration changes after implementing a change.

Contacting Cisco

If you cannot resolve a problem by using the information in this guide, contact Cisco Customer Support for help. For more information, see Contacting Cisco Customer Support.

Chapter 2. Troubleshooting Cisco ICFPP

- Problems with Connectivity

- Cisco ICFPP Error Codes and Faults

Problems with Connectivity

The following figure shows how the Cisco ICFPP components are connected:

Deployment Topology

If you experience issues with network connectivity, check network access by using the traceroute and ping commands. You can use the ShellAdmin console to ping a remote host by hostname or IP address.

Cisco ICFPP Error Codes and Faults

Cisco ICFPP has two classes of error codes:

- Client error codes—In most cases the errors are attributed to the request that the client made, such as a bad resource or method call, or permission issues. These errors are accompanied by a 400-series HTTP response code.

- Server error codes—Usually these errors are caused by a Cisco ICFPP or adapter-side issue. These errors are accompanied by a either a 400-series or 500-series HTTP response code.

The service provider administrator can also monitor faults see on the Cisco ICFPP system or error messages from the adapters in the GUI. The GUI shows the error code and the error message as seen by the adapter.

Error Codes for Transactions with the Service Provider REST APIs

The following table lists error codes for transactions with the service provider REST APIs.

Error Code

Description

AccountLoginFailed

Logging in with the account that is specified in the request has failed.

AccountUnauthorized

The user is not authorized to be on this system.

CloudInstanceAlreadyExists

The specified cloud instance already exists.

CloudInstanceDeleteError

Cisco ICFPP could not delete the cloud Instance. One or more tenants are associated with the cloud instance.

CloudInstanceDoesNotExist

The requested cloud instance does not exist.

CloudInstanceProvisionError

You have not provisioned the cloud with the correct parameters. Revisit the request and retry.

CloudInstanceUpdateError

Updating the cloud Instance did not have the required parameters or was passed in error.

CloudInstanceValidationError

The specified module is not supported.

NoLicenseAvailable

A valid license has not been installed.

ServerDoesNotExist

The specified server does not exist.

TenantAlreadyExists

The specified tenant already exists.

TenantDeleteError

Either the tenant is in the process of being deleted or the tenant has been deleted.

TenantDoesNotExist

The tenant does not exist in Cisco ICFPP.

TenantProvisionError

You have not provisioned the tenant with the correct parameters. Revisit the request and retry.

TenantUpdatingError

Cisco ICFPP cannot update tenant credentials due to an error in input parameters

TenantValidationError

The tenant could not be validated due to one or more of the following items:

- @ is not allowed in the tenant name.

- The cloud instance does not exist.

- The org name is missing from the request.

- The API key or secret key is missing from the request.

Error Codes for Transactions with the Cisco Intercloud Fabric Director

The following table lists error codes for transactions with the Cisco Intercloud Fabric Director.

Error Code

Description

ConnectionNotAvailable

Connection is not available with the cloud adapter.

DatabaseError

A database error occurred.

ImageDoesNotExist

The image is not present on Cisco ICFPP.

InvalidInput

Invalid input provided in the request.

ProviderVpcDoesNotExist

The VPC query failed because the VPC does not exist.

SessionError

TemplateError

There was a template error while doing a template operation.

VpcError

There was a VPC error while creating a VPC.

Chapter 3. Troubleshooting Adapters

- Working with Dimension Data Adapters

Working with Dimension Data Adapters

The following information applies to Dimension Data adapter errors:

- In logging files, all exception strings that are associated with Dimension Data adapters are prefixed with "DiDataApiException:" as shown in the following example:

DiDataApiException: 60d47a8d-a7a1-303a-540a-7bec1db0caed....
Ovftool import output for 02e20ca7-2afd-43a9-a57e-43575a3ffbc7 shows non-progress
output.

- Error reasons are also available in logs, as shown in the following example:

modify server Error - REASON_320 , Supplied memory value:(536870912 bytes)
is invalid. The value must be positive and divisible as a whole gigabyte.

Chapter 4. Obtaining Help from Cisco

- Contacting Cisco Customer Support

- Obtaining Logs for Cisco Customer Support

Contacting Cisco Customer Support

If you cannot solve a problem after using the troubleshooting suggestions in this guide, contact a customer service representative for assistance and further instructions. Before contacting Cisco, collect the following information so that Cisco Customer Support can assist you as quickly as possible:

- Version of Cisco Intercloud Fabric Provider Platform software that you are running

- Contact phone number

- Brief description of the problem

- Brief explanation of the steps you have already taken to isolate and resolve the problem

After collecting this information, see Obtaining Documentation and Submitting a Service Request for information on how to submit a service request.

Obtaining Logs for Cisco Customer Support

If you contact Cisco Customer Support, you might need to provide logs for them to assist in determining the cause of the problem. In addition to system details, logs contain error codes generated by Cisco ICFPP.

The following procedures describe how to obtain logs for Cisco ICFPP:

- Obtaining System Information

- Downloading Logs for HA and Cluster Environments

- Obtaining System Information

- Downloading Logs for HA and Cluster Environments

Obtaining System Information

Cisco ICFPP can provide general or detailed system information, and can assist in troubleshooting issues. This information can also be helpful if you need to contact Cisco for technical support.

Procedure

Step 1

In the Cisco ICFPP GUI, choose Administration > Support Information.

Step 2

From the Support Information drop-down list, choose the required option as described in the following table:

Option

Description

System Information (Basic)

Displays status for system services, the Cisco ICFPP license, and accounts and resource usage.

System Information (Advanced)

Displays detailed system information including system configuration, running processes, memory usage, processor details, and task status.

Show Log

Displays the log that you select:

- Infra Manager

- Web Context Cloud Manager

- Tomcat Log

- Authenticator Log

- Mail Delivery Log

- Patch Log

Download All Logs

Downloads a zipped file of all logs.

Debug Logging

Enables debug logging and records up to 30 minutes of activity.

Downloading Logs for HA and Cluster Environments

Cisco ICFPP enables you to download the following logs associated with HA and cluster environments:

- Infra Manager log

- MySQL log

- Apache Catalina log

- OpenAPI log

- Scalability log

- HA log

- Install log

- System messages log

If you select a log that is not applicable to your environment (for example, if you choose the HA log but HA is not configured in your environment), Cisco ICFPP will generate and download all logs except the one that does not apply.

Procedure

Step 1

In the Cisco ICFPP GUI, choose Administration > System, and click the Logs tab.

Step 2

Check the check box for each log that you want to download, and click Download. A zipped file containing all requested logs is downloaded to your system.

Chapter 5. Additional Information

- Related Documentation for Cisco Intercloud Fabric Provider Platform

- Obtaining Documentation and Submitting a Service Request

- Documentation Feedback

Related Documentation for Cisco Intercloud Fabric Provider Platform

The documentation listed below is available for Cisco Intercloud Fabric Provider Platform at the following URL:

Click Here

General Information

Cisco Intercloud Fabric Provider Platform Release Notes

Install and Upgrade

Cisco Intercloud Fabric Provider Platform Installation Guide

Administration

Cisco Intercloud Fabric Provider Platform Administrator Guide

Troubleshooting and Alerts

Cisco Intercloud Fabric Provider Platform Troubleshooting Guide

Cisco Intercloud Fabric Documentation

The documentation listed below is available for Cisco Intercloud Fabric at the following URL:

Click Here

Cisco Intercloud Fabric Release Notes

Cisco Intercloud Fabric Getting Started Guide

Cisco Intercloud Fabric Director REST API Guide

Cisco Intercloud Fabric Configuration Guide

Cisco Intercloud Fabric Firewall Configuration Guide

Cisco vPath and vServices Reference Guide for Intercloud Fabric

Cisco Intercloud Fabric User Guide

Cisco Intercloud Fabric Troubleshooting Guide

Cisco Nexus 1000V Documentation

Cisco Nexus 1000V for VMware vSphere

Cisco Nexus 1000V for KVM

Cisco Nexus 1000V for Microsoft Hyper-V

Cisco Virtual Security Gateway Documentation

Cisco Virtual Security Gateway

Cisco Cloud Services Router Documentation

Cisco Cloud Services Router 1000V

Obtaining Documentation and Submitting a Service Request

For information on obtaining documentation, using the Cisco Bug Search Tool (BST), submitting a service request, and gathering additional information, see What's New in Cisco Product Documentation, at: Click Here .

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

Documentation Feedback

To provide technical feedback on this document, or to report an error or omission, please send your comments to: ciscodfa-docfeedback@cisco.com.

We appreciate your feedback.

THE SPECIFICATIONS AND INFORMATION REGARDING THE PRODUCTS IN THIS MANUAL ARE SUBJECT TO CHANGE WITHOUT NOTICE. ALL STATEMENTS, INFORMATION, AND RECOMMENDATIONS IN THIS MANUAL ARE BELIEVED TO BE ACCURATE BUT ARE PRESENTED WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. USERS MUST TAKE FULL RESPONSIBILITY FOR THEIR APPLICATION OF ANY PRODUCTS.

THE SOFTWARE LICENSE AND LIMITED WARRANTY FOR THE ACCOMPANYING PRODUCT ARE SET FORTH IN THE INFORMATION PACKET THAT SHIPPED WITH THE PRODUCT AND ARE INCORPORATED HEREIN BY THIS REFERENCE. IF YOU ARE UNABLE TO LOCATE THE SOFTWARE LICENSE OR LIMITED WARRANTY, CONTACT YOUR CISCO REPRESENTATIVE FOR A COPY.

The Cisco implementation of TCP header compression is an adaptation of a program developed by the University of California, Berkeley (UCB) as part of UCB's public domain version of the UNIX operating system. All rights reserved. Copyright © 1981, Regents of the University of California.

NOTWITHSTANDING ANY OTHER WARRANTY HEREIN, ALL DOCUMENT FILES AND SOFTWARE OF THESE SUPPLIERS ARE PROVIDED “AS IS" WITH ALL FAULTS. CISCO AND THE ABOVE-NAMED SUPPLIERS DISCLAIM ALL WARRANTIES, EXPRESSED OR IMPLIED, INCLUDING, WITHOUT LIMITATION, THOSE OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OR ARISING FROM A COURSE OF DEALING, USAGE, OR TRADE PRACTICE.

IN NO EVENT SHALL CISCO OR ITS SUPPLIERS BE LIABLE FOR ANY INDIRECT, SPECIAL, CONSEQUENTIAL, OR INCIDENTAL DAMAGES, INCLUDING, WITHOUT LIMITATION, LOST PROFITS OR LOSS OR DAMAGE TO DATA ARISING OUT OF THE USE OR INABILITY TO USE THIS MANUAL, EVEN IF CISCO OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.

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.

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: Click Here . 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)