The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
Cisco ICFPP enables you to perform a number of common administrative tasks via the GUI, such as managing Cisco ICFPP licenses, monitoring tasks, and accessing reports and logs.
You can configure Cisco ICFPP so that it forwards log messages to a server instead of recording them in a local file or displaying them.
Cisco ICFPP enables you to import a Java KeyStore (JKS) file, which is a repository of certification authority (CA) security certificates used in SSL encryption.
Step 1 | In the Cisco ICFPP GUI, choose and click the Certificate Setup tab. |
Step 2 | Click Upload. |
Step 3 | In the Upload Certificate in JKS Format dialog box, in the Keystore File field, browse to and choose the JKS file. |
Step 4 | Click Upload. |
Step 5 | After the file has uploaded, enter the password in the Keystore Password field and click Submit. |
You can use the GUI to install (add) or update an adapter.
Step 1 | Log in to the Cisco ICFPP GUI. | ||||||||||
Step 2 | Choose Install. | ||||||||||
Step 3 | In the Adapters pane, click Install. | ||||||||||
Step 4 | In the
Install
Adapter dialog box, complete the following fields:
| ||||||||||
Step 5 | Click Upload. The file is uploaded to Cisco ICFPP. | ||||||||||
Step 6 | After the upload is complete, click Submit. |
Cisco ICFPP enables you to upgrade standalone appliances and multiple-node clusters for bug fixes and updated adapters. For more information, see the following topics:
Cisco ICFPP provides an upgrade mechanism that allows for Cisco bug fixes and upgrading adapters. Upgrading Cisco ICFPP to a newer version is similar to upgrading a custom adapter.
The procedures for upgrading a standalone node and a multiple-node cluster are different. For information on upgrading a multiple-node cluster, see Upgrading a Multiple-Node Cluster.
Step 1 | In the Cisco ICFPP GUI, choose , and click Install. | ||||||||||
Step 2 | In the
Install
Adapter dialog box, enter the following information:
| ||||||||||
Step 3 | Click Upload. | ||||||||||
Step 4 | After the unload is complete, click Submit. | ||||||||||
Step 5 | Using SSH, log in to the ShellAdmin console for the virtual appliance. | ||||||||||
Step 6 | Choose the Stop Services option. | ||||||||||
Step 7 | Choose the Start Services option. Cisco ICFPP is upgraded to the new version, and updated version information is displayed in the Adapters tab in the GUI. |
This procedure describes how to upgrade a multiple-node cluster for bug fixes and updated adapters. For information on upgrading a standalone (single-node) Cisco ICFPP virtual appliance, see Upgrading a Standalone Node.
The high-level tasks involved in upgrading a cluster are:
Upgrading the HA primary active node.
Stopping the virtual IP services on the upgraded primary active node.
Monitoring status as services fail over to the primary standby node.
Upgrading the HA primary standby node.
Stopping the virtual IP services on the upgraded primary standby node.
Starting the virtual IP services on the primary active node.
Starting the virtual IP services on the primary secondary node.
Upgrading and restarting Infra services for each service node.
The following procedure describes how to perform these tasks.
Step 1 | Using the node management IP address (instead of the virtual IP address for the HA pair), log in to the Cisco ICFPP GUI for the primary active node in the HA pair. | ||
Step 2 | Upgrade the
primary active node as follows:
| ||
Step 3 | Log in to the ShellAdmin console for the primary active node that was upgraded in Step 2. | ||
Step 4 | In the ShellAdmin console for the primary active node, stop the Virtual IP service as follows: | ||
Step 5 | Log in to the ShellAdmin console for the primary standby node for the HA pair. | ||
Step 6 | In the
ShellAdmin console for the primary standby node, choose
Display
Services Status to monitor the following events as they occur:
| ||
Step 7 | Using the node management IP address (instead of the virtual IP address for the HA pair), log in to the Cisco ICFPP GUI for the primary standby node. | ||
Step 8 | Upgrade the
primary standby node by uploading and submitting the upgrade package as
described in Step 2 of this procedure.
| ||
Step 9 | In the ShellAdmin console for the primary standby node that was upgraded in Step 8, stop the Virtual IP service as described in Step 4 of this procedure. | ||
Step 10 | In the ShellAdmin console for the primary active node that was upgraded in Step 2, start the Virtual IP service as follows: | ||
Step 11 | In the ShellAdmin console for the primary standby node that was upgraded in Step 8, start the Virtual IP service as described in Step 10. | ||
Step 12 | For each service node in the cluster: |
Cisco ICFPP is installed with an evaluation license and support for 20 VMs. The topics in this section describe how to view license details and update a license.
Confirm that the license file is accessible from Cisco ICFPP.
After you install Cisco ICFPP, you can view license details at any time to confirm the term of the license, view the number of VMs supported, and obtain the license identifier.
You can use the Cisco ICFPP GUI to monitor the tasks of the tenants.
You can use Cisco ICFPP logs to debug issues, collect system information, and review detailed information related to HA or cluster environments. For more information, see the following topics:
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.
Step 1 | In the Cisco ICFPP GUI, choose . | ||||||||||||
Step 2 | From the
Support
Information drop-down list, choose the required option as described
in the following table:
|
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.
Cisco ICFPP reports are available from the GUI in three formats: Tabular, Historical, or Snapshot. Cisco ICFPP dynamically updates the lists of the reports that are available to you and provides graphic renderings of each type of report. For each context, a different set of reports (each identified by a reportId) is available.
The available reports are:
Tenant report
Cloud instance report
Virtual machine report
Adapters report
Faults report
System tasks report
To generate a report:
Step 1 | In the Cisco ICFPP GUI, navigate to the required object type. For example, to generate a VM report, you would choose , and click the VM tab. |
Step 2 | In the toolbar, click Export Report. |
Step 3 | In the Export Report dialog box, choose the required report format (PDF, CSV, or XLS) and click Generate Report. |
Step 4 | After the report has been generated, click Download. |
A cloud instance has a unique identifier that ties the back-end cloud URI with a southbound adapter that is installed by the service provider. Multiple back-end URIs should have multiple cloud instances. A tenant is part of only one cloud instance. You can manage cloud instances by using the Cisco ICFPP GUI.
You can use the Cisco ICFPP GUI to add (provision) a cloud instance.
Step 1 | In the Cisco ICFPP, choose Cloud Instances. | ||||||||||||||
Step 2 | In the Cloud Instances pane, click Add. | ||||||||||||||
Step 3 | In the Add Cloud
Instance dialog box, provide the following information, and then
click
Add:
|
You can use the Cisco Intercloud Fabric Provider Platform (ICFPP) GUI to view a cloud instance's details.
You can use the Cisco ICFPP GUI to edit (update) a cloud instance.
To edit a cloud instance using the APIs, see Update Cloud Instance.
Step 1 | In the ICFPP GUI, choose Cloud Instances. | ||||||||||||||
Step 2 | In the Cloud Instances pane, choose a cloud instance and click Edit. | ||||||||||||||
Step 3 | In the
Edit
Cloud Instance dialog box, update the information as needed and
click
Save:
|
You can use the Cisco Intercloud Fabric Provider Platform (ICFPP) GUI to delete a cloud instance.
To delete a cloud instance using the APIs, see Delete Cloud Instance.
You can manage tenants by using the Cisco Intercloud Fabric Provider Platform (ICFPP) GUI.
After you create a cloud instance, you can add (provision) a tenant on the cloud.
For a CloudStack cloud instance, you must obtain the API Key and Secret Key for the tenant before adding the tenant. After the tenant is created, Cisco ICFPP generates a Pass Key, which is available in the View Tenant dialog box ( ). This Pass Key is required by Cisco Intercloud Fabric Director when configuring a cloud. For more information, see the Cisco Intercloud Fabric User Guide.
Confirm the following:
A cloud has been created to which the tenant can be assigned.
For a VMware vCloud Director cloud instance, you have the name of the organization for the tenant. For more information, see the VMware vCloud Director documentation.
For a CloudStack cloud instance, you have the API Key and Secret Key for the tenant. For more information, see the Apache Cloudstack documentation.
Step 1 | In the Cisco ICFPP GUI, choose Tenants and click the Accounts tab. | ||||||||||||||||||||||||||||||
Step 2 | Click Add. | ||||||||||||||||||||||||||||||
Step 3 | In the
Add
Tenant dialog box, provide the information as described in the
following table, and then click
Add:
|
You can use the Cisco Intercloud Fabric Provider Platform (ICFPP) GUI to view a tenant's details.
To view a tenant's details using the APIs, see Get Tenant Details.
You can edit existing tenants as needed by using the Cisco ICFPP GUI.
Step 1 | In the Cisco ICFPP GUI, choose Tenants and click the Accounts tab. | ||||||||||||||||||||||||||
Step 2 | In the Accounts pane, choose a tenant and click Edit. | ||||||||||||||||||||||||||
Step 3 | In the
Edit
Tenant dialog box, update the information as needed, and then click
Save:
|
You can use the Cisco ICFPP GUI to delete a tenant.
To delete a tenant using the APIs, see Delete Tenant.
Step 1 | Log in to the Cisco ICFPP GUI. |
Step 2 | Choose Tenants and then click the Accounts tab. |
Step 3 | Choose the tenant that you want to delete, and then click Delete. |
Step 4 | In the
Delete
Tenant dialog box:
|
You can use the Cisco ICFPP GUI to monitor tenants' VMs.