Cisco Intersight Mode With UCS X-Series v1 - Instant Demo: Americas Headquarters

Cisco Intersight Mode with UCS X-Series v1 - Instant Demo
First Published: 2021-07-12

Last Modified: 2021-10-05
Americas Headquarters
Cisco Systems, Inc.
170 West Tasman Drive
San Jose, CA 95134-1706
USA
http://www.cisco.com
Tel: 408 526-4000
800 553-NETS (6387)
Fax: 408 527-0883
© 2021 Cisco Systems, Inc. All rights reserved.
CONTENTS
CHAPTER 1 About 1
About This Demonstration 1
Topology 1
About This Solution 2
Getting Started 2
CHAPTER 2 Scenarios 5
Monitor 5
Operate 9
Review Profiles 17
Configure 19
Create and View a UCS Domain Profile 23
Creating a UCS Domain Profile Using the Intersight GUI 24
Creating UCS Domain Profiles Using the Intersight API (Optional) 39
API Prerequisites 39
How to Use the API 43
Review Profiles 47
CHAPTER 3 What's Next 49

iii
Contents

iv
CHAPTER 1
About
• About This Demonstration, on page 1
• Topology, on page 1
• About This Solution, on page 2
• Getting Started, on page 2
About This Demonstration

This demonstration showcases Cisco Intersight Managed Mode (IMM) with UCS X-Series. The demo provides
a high-level view of the product capabilities and advantages of centralized administration of the network
fabric. Users also walk through how to create UCS domain profiles and policies using the Intersight GUI or
by automation using the Intersight API.
Requirements
To successfully run this demonstration, you will need a laptop and internet access.
Limitations
Permissions to the UCS X-Series hardware in this demonstration are read-only, so you cannot modify or
deploy any Intersight configuration (for example UCS domain profiles, policies, pools, and so on) directly
on the hardware.
You can create and configure Intersight objects such as UCS domain profiles, policies, and pools. To keep
the demo environment clean, these objects are deleted 24 hours after creation.
Topology
The following image illustrates the topology used for this demonstration.

1
About
About This Solution
About This Solution

Cisco Intersight Managed Mode (IMM) provides new capabilities that allow you to manage many components
of your compute and network fabric from a central location. Your control of the fabric now extends to servers
and even blade chassis by using profiles and domains.
Improved flexibility viewing the details of the fabric down to specific devices is available and you can filter
the view using attributes or tags that you applied to the devices. IMM allows you to see details of a blade
chassis (with its associated domain), servers, and even the ports within the servers.
You can configure domains, profiles, pools, and policies to apply to the various devices within the fabric to
further simplify the management of your data center.
Getting Started
Before you begin
This procedure assumes that you have already logged into dCloud.
Procedure
Step 1 In the Catalog page, under Content Categories, click the box next to Instant Demo.
Step 2 In the Search Catalog field, enter the name of the demonstration you want to launch and then, below the
entry, click View.

2
About
Getting Started
The demo starts and will provide ways to launch the components that comprise the demo. The demo will
determine when you need to launch those.
Note It may take a few minutes for the demo to start. Be patient.

3
About
Getting Started

4
CHAPTER 2
Scenarios
• Monitor, on page 5
• Operate, on page 9
• Review Profiles, on page 17
• Configure, on page 19
Monitor
In this scenario, you highlight a few of the features available in Cisco Intersight Managed Mode. Some of the
features that are described are read-only in this environment.
Before you begin

After the demo starts, you should see the Intersight display open to the Meet Intersight page as shown in the
following.
If you do not see this page, contact dCloud support.

5
Scenarios
Monitor
Procedure
Step 1 To clear the Meet Intersight display, click Next.

Step 2 Click Select Service > My Dashboards.
Step 3 Across the top of the Monitor page, mention the dashboards that you can define.
The dashboards are collections of widgets that display relevant information about the managed objects by
type. Depending on the session's privileges, dashboards that are known as Presets are available for use and
contain all the widgets that are related to the named subject. Presets such as Fabric Interconnects is an example.
Step 4 Add a new dashboard and widget to contain specific detail about a specific device.
a) At the top of the My Dashboards page, click to create a new dashboard.

b) In the Widget Library panel, click the Presets section, hover on the Servers item and then, click Add.
c) In the upper-right corner of the Widget Library panel, click X.
In the new dashboard, you see several server-related widgets for:
• Server health
• Inventory
• Firmware version
• HCL status
• Server profile summary
• Model summary
• Contract status
d) Click Add Widget.

e) In the Widget Library panel, hover on the Details item and then, click Select.
Example:

6
Scenarios
Monitor
f) In the Details dialog, in the Source drop-down, select Servers then, in the server list, select
RTP-UCS-WS-Pod-01-1-1 and then, click Add Widget.
Example:
Notice that when you select the server, the Title field is filled in automatically. If you choose, you can
change this title before adding the widget.
g) In the upper-right corner of the Widget Library panel, click X.

h) Scroll down the server display to see the widget that you just added.
You now have a new widget that displays the information for the server you just added.

7
Scenarios
Monitor
Step 5 Filter the information displayed.

In this demo, although you specify an attribute to filter the information, the result is the same as the current
display. This is because the servers currently have the same attributes. You cannot change or add any attributes
or tags in this environment.
a) At the top of the screen, click Fabric Interconnects.
b) Click the Filter field then, click Organizations and then, click DCP-X.
Example:

8
Scenarios
Operate
If the environment had different organizations, the result is that you would only see the information that
pertains to the servers that met the specified filter.
Operate
This scenario highlights the visibility to the equipment that makes up your fabric.
Procedure
Step 1 To automatically log into the Intersight dashboard, in the session details page, click the Intersight link.
Step 2 At the top of the screen, in the Select Service drop-down, select Infrastructure Services.
Example:

9
Scenarios
Operate
Step 3 In the menu, under Operate, click Servers.

a) Mention that the top of the display shows information that is related to the servers listed.
b) Click and drag the Name column separator to expand the field so the server names are visible.
These are the same servers as you saw in the Monitor display previously.
c) Briefly describe the Health and Contract Status information and mention that you can rearrange the
columns to fit your needs.
d) Expand the Model column to show that these are X-Series servers in this environment.
e) Expand the UCS Domain column to show that the servers are all part of the same UCS domain.
This provides you the ability to manage the servers using the UCS domain.
f) Expand the Server Profile column to show the various profiles that are assigned to the servers in the UCS
domain.

10
Scenarios
Operate
Step 4 Display the server details.

a) In the Name field of the server list, click RTP-UCS-WS-Pod-01-1-1.
Intersight displays the General details page for the server.
b) Briefly describe the information available on the screen, including the Events panel.
c) Hover over the components in Properties > Front to show the details of server RTP-UCS-WS-Pod-01-1-1,
highlighted in green and displayed in an X-9500 chassis. You can also see other servers, available blade
slots, and the PSUs in the X-9500 chassis.
The Health Overlay controls whether you see visual health indicators that are displayed on the Properties
view.
d) Underneath the server image, click Health Overlay to toggle the health indicator in the display.
e) Above the top-right part of the image, click Top.

11
Scenarios
Operate
The view changes so you can see the CPUs, DIMMs, and other components within the server.
Step 5 Display the server inventory.

a) At the top of the OPERATE display, click Inventory.
b) Expand CPUs, Memory, Network Adapters, and Storage Controllers and describe the features that
are related to the X-Series server.
Step 6 Display the chassis details.
a) In the menu, under Operate, click Chassis.
Example:
There is one X-9500 chassis that is named RTP-UCS-WS-Pod-01-1 which Cisco Intersight manages.

12
Scenarios
Operate
b) In the chassis list, click the chassis name.
In the Details panel, you can see detailed information about the chassis, including the UCS domain to
which the chassis belongs. State, Connection, Power, and Fan details also display. You can see Alarm
and Advisories in the Events panel.
c) Hover over the image of the X-9500 chassis to display information about the servers, PSUs, and available
blade slots in the chassis.
d) Above the image, click Rear.
Here, you can see an image of the rear view of the chassis. As you hover on the components within the
image, you see the IFMs, IFM ports, and fans in the chassis.
Step 7 Display the chassis inventory.

a) At the top of the chassis display, click Inventory.

13
Scenarios
Operate
You see a list of the components that are contained in the chassis. The display initially opens to the
Intelligent Fabric Modules section.
b) In the Intelligent Fabric Modules list, click Intelligent Fabric Module 1.

More details for Intelligent Fabric Module 1 displays.
c) In the Intelligent Fabric Module 1 display, click each tab to show the related information available,
including the Graphic View representation of the Intelligent Fabric module.
d) In the Inventory list, click the other items to show the information available for the X-Fabric Modules,
Thermal, Power, and Servers.
Step 8 Display the Fabric Interconnects details.
a) In the menu, under Operate, click Fabric Interconnects.
b) Briefly describe the information available and point out the UCS domain profile information that is
associated with the FI-6454 fabric interconnects.

14
Scenarios
Operate
The top display shows information for all the fabric interconnects in the list, to provide an at-a-glance
overview of the managed fabric interconnects. The list provides additional information, such as the health
of each fabric interconnect, the contract status, the ports available and consumed, and the firmware installed.
The UCS domain profile allows you to deploy configurations to the fabric interconnects.
c) In the list, click one of the fabric interconnects.
The details of the fabric interconnect displays, including a graphical view of the fabric interconnect.
d) In the Properties > Rear of the fabric interconnect, hover on the ports to see additional information.
The information includes how the port is defined, the status of the port, the current Admin State, and a
link to view more details about the port.
e) Above the fabric interconnect image, click Front.

15
Scenarios
Operate
As you hover over the image, you can see the fan modules and power supply information.
Step 9 Display the Fabric Interconnects inventory.

a) At the top of the display, click Inventory.
The inventory display opens to the Ports & Port Channels section. This display contains the details
about the ports in this fabric interconnect, including a graphic of the fabric interconnect.

16
Scenarios
Review Profiles
b) Click through the tabs above the fabric interconnect image to see the different port and port channels
available. Focus on the Ethernet Port Channels tab to display an active managed port channel and its
details.
c) In the inventory list, click through the other sections and briefly describe the information available.
All these details are available because the fabric interconnects are in Intersight Managed Mode, allowing
Intersight to manage these components.
Review Profiles
Procedure
Step 1 View UCS Domain Profiles.

a) In the menu, under Configure, click Profiles.
The Profiles display shows the various profile types available in Intersight listed as tabs across the top
of the display.
b) At the top of the display, click UCS Domain Profiles.
The existing UCS domain profiles display including any you have created. You can click any UCS domain
profile to see more detailed information.
c) Click the UCS domain profile which you created.
In this example, we review the existing demo profile UCS-WS-Domain-Profile-01, which you
deployed to the X-Series hardware in the demo environment.

17
Scenarios
Review Profiles
You see that the UCS domain profile maps to two fabric interconnects. The Policies display shows both
of the fabric interconnects as you scroll through the display and details about the ports within them.
d) Click the VLAN & VSAN Configuration and UCS Domain Configuration tabs to display the information
there.
e) In each of the tabs in the previous step, click the policies to display the detailed information about the
policies.
Step 2 View the UCS Server Profiles.
a) In the menu, under Configure, click Profiles and then, at the top of the display, click UCS Server Profiles.
In most situations, administrators use this panel to resynch or redeploy UCS server profiles.
You see the UCS Server Profiles that you defined and deployed to the running servers.
b) Review the other columns in the display.

• The Status column shows the current deployment state of the UCS server profiles.
• UCS Server Templates is the template that is used to build out the Profiles and ensure a consistent
configuration.
• The Server column shows which physical server uses the profile.
c) In the Name column, click a UCS Server Profile which has a status of OK.

18
Scenarios
Configure
This demo selected the first UCS server profile.

You see the UCS policies that comprise the UCS server profile. Selecting the tabs along the top of the
Configuration display filters the policies into their specific areas. The groupings are useful for
troubleshooting or examining a specific set of policies.
Configure
This scenario provides a quick overview of what you can configure using Cisco Intersight Managed Mode.
Procedure
Step 1 Display and create pools.

a) In the menu, under Configure, click Pools.
UCS domains and servers that Intersight manages can consume identifier pools that Intersight created.
These Intersight identifiers are similar to UCS identifiers. Pools are consumed by resources through UCS
server profiles.
You see that there are multiple pools Intersight currently manages.

19
Scenarios
Configure
b) In the pools list, click UCS-WS-MAC-Pool-01.

Note If the pool does not display in the inital list, either increase the number of displayed items or
enter the pool name in the filter field.
The display opens to the details for the MAC pool. You see the current configuration of the pool. The
usage information for the pool is available based on user privileges.
c) Return to the Pools display and in the top right, click Create Pool.
Example:

20
Scenarios
Configure
A wizard that walks you through how to create a new pool starts. You begin by selecting which type of
pool to create from the following types.
• IP - IP address
• IQN - iSCSI Qualified Name
• MAC - MAC address
• WWNN - World Wide Node Name
• WWPN - World Wide Port Name
d) Select IP then, click Start.

e) On the General page, enter a name for the IP Pool, such as Test-IP-Pool-1 then click Next.
If the name is already in use, alter the name by changing the appended numbers.
f) In the IPv4 Pool Details page, go to the Configuration section and then, enter the following information
in the indicated fields.
Field Value
Netmask 255.255.255.0
Gateway 192.168.100.1
Primary DNS 192.168.100.5
g) Go to the IP Blocks section and then, enter the following information.
Field Value
From 192.168.100.20
Size 100
h) Click Next.
i) In the IPv6 Pool Details page, toggle Configure IPv6 Pool to Off and then, click Create.
You return to the Pools page where you can see the new IP Pool that you created.
Step 2 In the menu, under Configure, click Templates to display the templates that exist in the environment.
Templates are a way to define up to 100 UCS server profiles with similar characteristics. Templates ease the
work involved in creating and deploying UCS server profiles into your environment. You can clone templates,
further expanding the capability to easily configure servers.
UCS server profiles and templates will be explored in more detail in upcoming dCloud sandbox labs for Cisco
IMM with UCS. In these labs, the UCS hardware has read/write permissions and you can effectively deploy
UCS server profiles to the hardware.

21
Scenarios
Configure
Step 3 Display available policies.

a) In the menu, under Configure, click Policies.
Previously, there were only server policies. Now, there are policies that are also associated with UCS
domains and UCS chassis.
b) Go down the Platform Type column and point out the policies that are consumed by the different platform
types, such as UCS Server, UCS Domain, and UCS Chassis.
This illustrates that when you configure a policy, you can define the policy for use by different platforms.
c) In the upper right of the display, click Create Policy.
A wizard starts that you use to define policies for each platform type. Because it opens to the UCS Server
platform type, you see the policy types that are associated with that platform.

22
Scenarios
Create and View a UCS Domain Profile
d) Click UCS Domain and then, click UCS Chassis to display the policy types available for those platforms.
Notice that some of the policies are available for multiple platforms to use. For example, the IMC Access
and SNMP policies are available for the UCS Chassis and the UCS Server platforms. This makes it possible
to define a policy consumable for multiple platforms.
The UCS Domain platform is new in Intersight, so you look at this closer.
If needed, you can individually create UCS policies that you attach to UCS policies later. In the next section,
you will create UCS domain policies while creating UCS domain profiles.
Create and View a UCS Domain Profile

UCS domain profiles allows you to predefine the configuration for fabric interconnects through associated
UCS domain policies. You can then define and deploy the UCS domain profiles, providing verifiable, scalable,
and repeatable configurations that you can use for consistency in your fabric.
You can define port, VLAN, VSAN, and several other UCS domain policies for use in your fabric.
Note You can use any name you wish when creating policies and domains. This demo guide uses specific
names to provide guidance. If you have received an error message indicating a name you have entered
is already in use, slightly alter the name to proceed.
The fabric interconnects for this demo have already been claimed.
Creating a UCS domain profile consists of:

1. Naming the UCS domain
2. Optionally assigning the UCS domain profile to the fabric interconnect cluster
3. Defining UCS policies for the UCS domain

23
Scenarios
Creating a UCS Domain Profile Using the Intersight GUI
Procedure
Step 1 In the menu, under Configure, click Profiles then, in the Profiles display, click the UCS Domain Profiles
tab and then, click Create UCS Domain Profile.
Example:
Step 2 Name the profile.

a) In the Create UCS Domain page, click Start.
b) In the General page, leave the Organization as is then, in the Name field, enter
Demo-Domain-Profile-01 and then, click Next.
Example:
c) In the UCS Domain Assignment page, click Assign Later and then, click Next.
Example:

24
Scenarios
Step 3 Configure a VLAN policy.

a) In the VLAN & VSAN Configuration page, under Fabric Interconnect A next to VLAN Configuration,
click Select Policy and then, in the Policy pane, click Create New.
Example:
b) In the Create VLAN General page, leave the Organization as is and then, in the Name field, enter
Demo-VLAN-Policy-01 and then, click Next.
Example:

25
Scenarios
c) In the Policy Details page, click Add VLAN then, in the Name / Prefix field enter VLAN then, in the
VLAN IDs field enter 43 and then, under Multicast, click Select Policy.
Example:
d) In the Policy pane, click Create New.

e) In the Create Multicast General page, in the Name field, enter Multicast-Policy-01 and then,
click Next.
Example:
f) In the Create Multicast Policy Details page, click Create.

Example:

26
Scenarios
g) In the Add VLANs page, click Add.

The VLAN policy is created and added to the VLAN policy that you defined.
h) In the Create VLAN Policy Details page, click Create.
The created policy is added to the VLAN Configuration under Fabric Interconnect A.
i) In the VLAN & VSAN Configuration page, under Fabric Interconnect B, next to VLAN Configuration,
click Select Policy and then choose the policy that you created.
This is a basic configuration you use for both fabric interconnects. However, the VSAN configuration is
unique for each fabric interconnect.
Step 4 Configure the VSAN policies.

a) Under Fabric Interconnect A, next to VSAN Configuration, click Select Policy and then, in the Policy
pane, click Create New.
b) In the Create VSAN General page, in the Name field, enter Demo-VSAN-Policy-01-A and then,
click Next.
Example:

27
Scenarios
c) In the Create VSAN Policy Details page, click Add VSAN then, in the Add VSAN dialog, enter the
following information and then, click Add.
• Name - VSAN-100
• VSAN ID - 100
• FCoE VLAN ID - 100
Example:

28
Scenarios
d) In the Create VSAN Policy Details page, click Create.

The VSAN is attached to Fabric Interconnect A.

29
Scenarios
e) Repeat 4.a, on page 27 through 4.d, on page 29 for Fabric Interconnect B using the following information.
• VSAN General Name - Demo-VSAN-Policy-01-B
• Add VSAN Name - VSAN-101
• VSAN ID - 101
• FCoE VLAN ID - 101
f) In the VLAN & VSAN Configuration page, click Next.

Step 5 Configure Ports for Fabric Interconnect A.
a) In the Ports Configuration page, under Fabric Interconnect A, next to Ports Configuration, click
Select Policy.
b) In the Policy pane, click Create New.
c) In the Create Port General page, in the Name field, enter Demo-Port-Policy-01-A and then, click
Next.
Example:
d) In the Unified Port page, under the image, move the slider to define the unified ports and then, click
Next.
For this demo, you configure the first four ports as FC ports. The rest of the ports are Ethernet ports.
Example:

30
Scenarios
e) In the Breakout Options page, click Next.

f) In the Port Roles page, select Port 5 through Port 8 and Port 17 through Port 20 and then click Configure.
Example:
Note You can either select the ports in the image or in the list.

31
Scenarios
You define these ports as server, or downlink, ports.

g) In the Configure page, in the Port Roles drop-down, select Server and then, click Save.
Example:
Step 6 Create uplink ports.

a) In the Port Roles page, click Port Channels and then, click Create Port Channel.
Example:

32
Scenarios
b) In the Create Port Channel page, in the Port Channel ID field, enter a numeric port ID.
Example:
This example uses 123.

33
Scenarios
You can also define Flow Control, Link Aggregation, Ethernet Network Group, and Ethernet Network
Control depending on the port role selected. For the Ethernet Uplink Port Channel role, they are
optional.
c) Scroll to the port list and select Port 49 through Port 52 and then, click Save.
As you did previously, you could select the ports in the image.
Example:
Next, you configure a fiber channel port channel.

d) In the Create Port Channel page, in the Role drop-down, select FC Uplink Port Channel then, in the
Port Channel ID and VSAN ID fields, enter 100 for Fabric Interconnect A and then, select Port 1
through Port 4 then, in the Admin Speed drop-down, select 32 Gbps and then, click Save.
Example:

34
Scenarios
The port channels are defined and the image shows the values that you configured.
e) In the Create Ports > Port Roles page, click Save.

The port configuration displays under Fabric Interconnect A.
Note You may have to click the down arrow next to the fabric interconnect.

35
Scenarios
Step 7 In the Ports Configuration page, under Fabric Interconnect B, repeat Step 5, on page 30 and Step 6, on
page 32 using the following values and then, click Next.
Field Value
Create Port General - Name Demo-Port-Policy-01-B
Create Port Channel - Ethernet Port Channel ID 11
Create Port Channel - FC Uplink VSAN ID 101
Step 8 Configure the UCS Domain Configuration page.

a) In the UCS Domain Configuration page, under Management, next to NTP, click Select Policy.
Example:

36
Scenarios
b) In the Policy pane, select Create New.

c) In the Create NTP General page, in the Name field, enter Demo-NTP-Policy-01 and then, click
Next.
d) In the Create NTP Policy Details page, in the NTP Servers field, enter time.cisco.com then, in
the Timezone drop-down, select America/New_York and then, click Create.
Example:
e) In the UCS Domain Configuration page, under Management, next to Network Connectivity, click
Select Policy.
Note You may need to click the down arrow next to Management.
f) In the Policy pane, select Create New.
g) In the Create Network Connectivity General page, in the Name field, enter Demo-Net-Connect-01
and then, click Next.
h) In the Create Network Connectivity Policy Details page, under Preferred IPv4 DNS Server, enter
173.37.87.157 and then, click Create.
Example:

37
Scenarios
i) In the UCS Domain Configuration page, under Network, next to System QoS, click Select Policy.
Note You may need to click the down arrow next to Network.
j) In the Policy pane, select Create New.
k) In the Create System QoS General page, in the Name field, enter Demo-System-QoS-01 and then,
click Next.
l) In the Create System QoS Policy Details page, Scroll down, if needed, and notice that there is a Fibre
Channel configuration and then, click Create.
Example:
Step 9 In the UCS Domain Configuration page, click Next to display the Summary and review the configuration
by clicking tabs and objects.
a) Make sure to click the Errors / Warnings tab to display any errors in the configuration.
b) When you finish reviewing the configuration, click Close.
This saves the configuration so you can later deploy it where needed.

38
Scenarios
Creating UCS Domain Profiles Using the Intersight API (Optional)
Creating UCS Domain Profiles Using the Intersight API (Optional)

The UCS Domain Deployment Tool for Cisco Intersight automates the comprehensive build and deployment
of UCS Domain Profiles and Policies for Cisco Intersight Managed Mode (IMM).
Features
• Automatically build a UCS Domain Profile with all 15 UCS Domain Policies of your choosing and
configured to your exact specification. Anything that you can do through the Intersight GUI you can do
with the API and more.
• Automatically assign the UCS Domain Profile to a Fabric Interconnect cluster that is registered under
Intersight, using either the Target Name, IP addresses, or serial numbers.
• Automatically deploy the UCS Domain Profile to the assigned Fabric Interconnect cluster.
• Set default Multicast Policies for any configured VLANs.
• Set default Ethernet Network Group, Ethernet Network Control, Flow Control, Link Control, and Link
Aggregation Policies for any configured ports.
• Restore, quickly, UCS Domain Profile and Policy configurations as part of your on-premises Intersight
backup solution.
Automation through the Intersight API is supported with Intersight SaaS, Connected Virtual Appliance, and
Private Virtual Appliance.
API Prerequisites
Procedure
Step 1 Install Python 3.7 or later.

You can download the software from https://www.python.org/downloads/.
Step 2 Install the Cisco Intersight SDK for Python with the following command.
pip install intersight

39
Scenarios
API Prerequisites
You can find more information on the Cisco Intersight SDK for Python at
https://github.com/ciscodevnet/intersight-python.
Step 3 (Optional) If you already have the Cisco Intersight SDK for Python that is installed, you may need to upgrade
it.
a) Upgrade the SDK by using the following command.
pip install intersight --upgrade --user
Step 4 Browse to the Cisco IMM Automation Tools repository at

https://github.com/ugo-emekauwa/cisco-imm-automation-tools.
Step 5 Download the Cisco IMM Automation Tools repository using the link on the main repository web
page.
The downloaded Cisco IMM Automation Tools repository is a zip file.
Step 6 Extract the zip file.
Step 7 Generate a version 3 or version 2 API key from your Intersight user account.
a) In your Intersight user account, in the Services drop-down, select System.
The Settings page displays.
b) In the Settings page, click API Keys and then, in the work pane, click Generate API Key.
Example:

40
Scenarios
API Prerequisites
c) In the Generate API Key dialog, enter a description or name for your API key then, under API Key
Purpose, select API Key for OpenAPI schema version 2 or version 3 and then, click Generate.
Example:

41
Scenarios
API Prerequisites
The system generates a new API key.

d) Copy the API Key ID and download the Secret Key to a secure location.
Example:

42
Scenarios
How to Use the API
How to Use the API
Before you begin

You have performed all the steps in API Prerequisites, on page 39.
Procedure
Step 1 In the extracted Cisco IMM Automation Tools repository, navigate to

\src\deployment_tools\ucs_domain_deployment_tool.
Step 2 Edit ucs_domain_deployment_tool.py to set the key_id variable.
a) Open ucs_domain_deployment_tool.py in IDLE or another text editor.
b) Find the comment # MODULE REQUIREMENT 1 #.
Example:
Under this comment, you see the empty key_id variable.

Example:
c) Between the quotations marks of the key_id variable, enter the ID of the API key.
Example:
key_id =
"5c89885075646127773ec143/5c82fc477577712d3088eb2f/5c8987b17577712d302eaaff"
Step 3 Edit ucs_domain_deployment_tool.py to set the key variable.

43
Scenarios
How to Use the API

Under this comment, you see the empty key variable.
c) Between the quotations marks of the key variable, enter the file path to the Secret.txt file for your
API key.
Example:
key = "C:\\Keys\\Key1\\SecretKey.txt"
Step 4 Edit ucs_domain_deployment_tool.py to set the all the configuration variable values.
Example:

44
Scenarios
How to Use the API
Beneath this comment, you see instructions to edit the configuration variable values to match your
environment. Each variable has a sample value for ease of use. The variable values to edit begin under
the
####### Start Configuration Settings - Provide values for the
variables listed below. #######
comment.
In this demo environment, there are only two variables to update.
c) Go to Section 01 and find # Global Deployment Name Settings.
d) Under # Global Deployment Name Settings, find the deployment_name_prefix variable.
Example:
e) Update this variable with a prefix name for your UCS Domain Deployment to make the created UCS
domain profile and all the associated UCS domain policies easily identifiable in Intersight.
Example:
deployment_name_prefix = â€œDemo-â€
f) Go to Section 02 and find # General Settings.

g) Under # General Settings, find the ucs_domain_profile_organization variable.
Example:

45
Scenarios
How to Use the API
h) Update the variable with the organization for this demo environment.
Example:
ucs_domain_profile_organization = â€œDCP-X-Sandboxâ€
Step 5 Save the ucs_domain_deployment_tool.py file.

Step 6 Run the ucs_domain_deployment_tool.py file.
The UCS Domain Deployment Tool automatically creates a UCS domain profile with all 15 UCS domain
policies. When complete, you can view the newly created UCS domain profile and policies in Intersight.

46
Scenarios
Review Profiles
Review Profiles
Procedure
Step 1 View UCS Domain Profiles.

a) In the menu, under Configure, click Profiles.
The Profiles display shows the various profile types available in Intersight listed as tabs across the top
of the display.
b) At the top of the display, click UCS Domain Profiles.
The existing UCS domain profiles display including any you have created. You can click any UCS domain
profile to see more detailed information.
c) Click the UCS domain profile which you created.
In this example, we review the existing demo profile UCS-WS-Domain-Profile-01, which you
deployed to the X-Series hardware in the demo environment.
You see that the UCS domain profile maps to two fabric interconnects. The Policies display shows both
of the fabric interconnects as you scroll through the display and details about the ports within them.
d) Click the VLAN & VSAN Configuration and UCS Domain Configuration tabs to display the information
there.
e) In each of the tabs in the previous step, click the policies to display the detailed information about the
policies.
Step 2 View the UCS Server Profiles.
a) In the menu, under Configure, click Profiles and then, at the top of the display, click UCS Server Profiles.
In most situations, administrators use this panel to resynch or redeploy UCS server profiles.
You see the UCS Server Profiles that you defined and deployed to the running servers.

47
Scenarios
Review Profiles
b) Review the other columns in the display.

• The Status column shows the current deployment state of the UCS server profiles.
• UCS Server Templates is the template that is used to build out the Profiles and ensure a consistent
configuration.
• The Server column shows which physical server uses the profile.
c) In the Name column, click a UCS Server Profile which has a status of OK.
This demo selected the first UCS server profile.
You see the UCS policies that comprise the UCS server profile. Selecting the tabs along the top of the
Configuration display filters the policies into their specific areas. The groupings are useful for
troubleshooting or examining a specific set of policies.

48
CHAPTER 3
What's Next
Learn more about Cisco Intersight.
• Cisco Intersight Management with X-Series Lab v1
• Cisco Intersight Infrastructure Services
• Cisco Intersight Workload Optimizer
• Cisco Intersight Services

49
What's Next

50

Cisco Intersight Mode With UCS X-Series v1 - Instant Demo: Americas Headquarters

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Cisco Intersight Mode With UCS X-Series v1 - Instant Demo: Americas Headquarters

Uploaded by

Copyright:

Available Formats

Cisco Intersight Mode with UCS X-Series v1 - Instant Demo

First Published: 2021-07-12

CHAPTER 3 What's Next 49