Introduction

Cisco UCS Director delivers unified, highly secure management for supported compute, network, storage, and virtualization platforms and for the industry's leading converged infrastructure solutions, which are based on the Cisco UCS and Cisco Nexus platforms.

System Requirements

Information about the system requirements for Cisco UCS Director, Release 5.0 is available in the installation and upgrade guides for the following:

VMware vSphere

Microsoft Hyper-V

Supported Browser Versions

Cisco UCS Director supports the following browsers:

Internet Explorer 8 or higher

Google Chrome 4.1 or higher

Firefox 3.5 or higher

Safari 4.0 or higher (for Apple Mac or Microsoft Windows)

Browsers require the Adobe Flash Player 11 plug-in.

Installation Notes

Cisco UCS Director is a 64-bit appliance that uses a standard virtual machine that is delivered in OVF format for VMware, and in VHD format for Microsoft Hyper-V. It can be hosted on VMware vSphere or vCenter and Microsoft Hyper-V Manager.

Note After you apply the upgrade patch and complete that installation, choose the Start Services option of ShellAdmin to start/restart the Cisco UCS Director services and complete the patch process. The patch process is not complete or successful until the Cisco UCS Director services have started, the Cisco UCS Director appliance GUI is available, the login screen is displayed, and the admin user can log in to Cisco UCS Director.

All Cisco UCS Director services must be stopped before you perform other ShellAdmin procedures, such as apply additional patches, take a database backup, or restore a database from a backup.

New and Changed Features

The following features are available in Cisco UCS Director, Release 5.0:

Installing a set of supported operating system images on baremetal servers or virtual machines

New Features for Cisco UCS Director Self-Service Portal

The Cisco UCS Director Self-Service Portal has been updated with the following features:

Catalog creation

Templates

Configuration management

User-level views

Report generation

Role-Based Access Control Enhancements

Role-based access control for Cisco UCS Director now supports the following:

User roles that determine the read-write permissions to be given to users who are assigned that role.

User access profiles that enable you to assign more than one role to a user and to define the resources that can be viewed by users who are assigned that profile.

Group share policies that give users more control of resources and which resources can be shared with other users. With this policy, users can view resources that are currently assigned only to them, or can view resources that are assigned to all groups that the users are part of.

LDAP Integration Enhancements

LDAP integration with Cisco UCS Director now provides support for the following:

Improved user, group, and access control policy integration

Multiple LDAP servers and accounts

SSL support for LDAP (Microsoft Active Directory and OpenLDAP)

OpenLDAP directory support

New Compute Features

Cisco UCS Director now supports the following:

Cisco UCS Manager, Release 2.2(2c)

Cisco UCS Manager, Release 2.2 (1d)

HP C7000 with Onboard Administrator (HP OA) version 3.60

New Networking Features

Networking support now includes the following:

Cisco Nexus 9396

Cisco Nexus 9508

Cisco Nexus 7700

Cisco Adaptive Security Virtual Appliance (ASAv), Release 9.3.1

F5 Load Balancer Big-IP2200 version 11.5.1 (physical device only)

New Storage Features

Storage support now includes the following:

EMC VPLEX version 5.2

EMC Isilon version 7.1.0.0

EMC RecoverPoint version 4.0.2

New Virtualization Features

VMware vSphere—Support is available for VMware vSphere 5.5 and the following features and enhancements:

VMware vMotion

Site Recovery Manager

Linked clone

Storage vMotion

VM-FEX Adapter

Host profile

VM Provisioning using an ISO Image

Template management

Data store cluster support

VMRC Console support

DRS VM affinity rules

VM annotation

RedHat Enterprise Virtualization Manager—Support is available for the RedHat Enterprise Virtualization Manager (RHEV-M 3.2 and RHEV-M 3.3) connector for the standard Red Hat Enterprise Linux 6 kernel with the following features:

Management of the Red Hat Enterprise Virtual Machine Manager through the REST API

Basic inventory

VM/Host level monitoring

VM basic power actions and snapshot actions.

Provisioning services as follows:

– Compute Policy—Memory and CPU resize options

– Storage Policy—Local, NFS, and ISCSI storage types

– Network Policy—Multiple NICs

New Converged Infrastructure Features

FlexPod—Support has been added for the following:

Cisco Nexus 9396

Cisco Nexus 9508

Cisco Nexus 7700

Cisco Secure Enclave Architecture

EMC VPLEX—Support has been added for VPLEX clusters.

Orchestration and Workflow Enhancements

Orchestration in Cisco UCS Director now provides support for the following in orchestration workflows and tasks:

Versioning

Run Book creation

Conditional statements

Looping

Multi user approval - AND condition

– User Approval Task

– Custom Approval Task

– VDC Approval Task

Cloupia Script® Interpreter—The Cloupia Script interpreter is a JavaScript interpreter populated with built-in libraries and APIs. You can use the Cloupia Script Interpreter to execution functions, define variables, and functions.

New Application Container Features

Application containers in Cisco UCS Director now provide support for the following:

Virtual extensible local area network (VXLAN)

F5 load balancing

New PowerShell API Support

Cisco UCS Director now supports the Microsoft PowerShell API, including the following:

PowerShell cmdlet wrappers to Cisco UCS Director REST APIs

PowerShell cmdlet wrappers for the Legacy JSON–based APIs that aid in workflow management

Report Enhancements

Cisco UCS Director now provides users with the ability to create and generate customized reports.

Metering and Chargeback Enhancements

Cisco UCS Director now presents the cost computation at the beginning of metering and chargeback, rather than the end.

New and Changed Documentation

In addition to these Release Notes, the following Cisco UCS Director documentation was created for Release 5.0.

Caveats

Tip Release note information is sometimes updated after these Release Notes are published. Use the Cisco Bug Search Tool to see the most up-to-date release note information for any caveat listed here.

Open Caveats in Release 5.0

Table 2 lists the open issues that may impact your testing of the features and enhancements in Cisco UCS Director, Release 5.0.

Table 2 Open Caveats in Release 5.0

Defect ID

Symptom

Workaround

CSCup86035

A vDC is configured with a first and a second approver. When a VM is provisioned with the vDC, only the first approver appears in the Service Request status.

There is no known workaround for this issue.

CSCup00032

Comma separated values are not accepted as Admin input for multi-user approval functions in a User Approval task.

Use Task input or execution input for multi-user approval functions.

CSCuq10986

If the name of a workflow in Cisco UCS Director 4.1.x includes the special characters \ (backslash) or ' (single quote), the workflow will not be upgraded to Cisco UCS Director 5.0 due to the special character limitations.

Clone the workflow and then rename the cloned workflow without any special characters.

To retain the workflow after you upgrade, you must clone the workflow in Release 4.1.x prior to upgrading to Release 5.0.

CSCup69655

When you edit LDAP users from the Login User tab, the incorrect group is displayed. Instead of the group to which the user belongs, a random group is displayed in the drop-down.

There is no known workaround for this issue.

CSCup48576

Korean—Unable to submit the Configure Lease Time action in Korean.

There is no known workaround for this issue.

CSCup44036

REST API—When creating a datastore with netapp vsc, the following issues occur:

When executed, this returns an error of "field cluster aggregate is empty". When a 7mode account is selected, this field should not be checked since cluster aggregate is applicable only for a Cmode device. When any junk value is given for the cluster aggregate ID by editing the xml and then executed, this error does not occur.

When executed, this returns an error of "field aggregate is empty". When a Cmode account is selected, this field should not be checked since aggregate field is applicable only for a 7mode device. When any junk value is given for aggregate ID by editing the xml and then executed, this error does not occur.

When executed, this returns an error of "field cluster volume is empty". When a 7mode account is selected, this field should not be checked since the cluster volume is applicable only for a Cmode device. When any junk value is given for the cluster volume ID by editing the xml and then executed, this error does not occur.

When executed, this returns an error of"field volume is empty". When a Cmode account is selected, this field should not be checked since the volume is applicable only for 7mode device. When any junk value is given for the volume ID by editing the xml and then executed, this error does not occur.

Edit the sample xml manually by giving any value for aggregate, cluster aggregate, volume, cluster volume when the field is required and then execute the task.

CSCup98885

The Assign VLAN to Group task does not display the vDC field after a Nexus 7000 device is selected.

The vDC can be given as input by admin input.

CSCum87361

When you execute Configure Trunk Rollback, the port retains the trunk native VLAN, but the port mode is changed to Access.

For Configure Private VLAN Port, after you configure a port and then do a rollback, the port remains in Private VLAN mode.

Change the native VLAN and the private VLAN port type by passing the respective commands using the Execute CLI Commands task.

CSCup66383

The Create ASA Context Action Flow does not list port channels. It lists only L2 interfaces.

Use the Create ASA Context workflow task.

CSCuo21996

Cisco UCS Director displays invalid strings when a workflow that includes custom tasks from an earlier release is imported.

Import the custom workflow task first using the.wfdx file. Then import the workflows using the.wfd file.

CSCup04550

The Execute PowerShell Command workflow task does not display the correct value for Maximum Wait Time after upgrading to Release 5.0.

Do not use a workflow from an earlier release. Create a new workflow for the Execute Powershell command and execute that workflow.

CSCuo74647

Workflow completion e-mail is sent before virtual machine is ready for use when customization is required and the virtual machine is customized from the workflow.

Create a post provisioning workflow to send a second e-mail. In this workflow, insert a WAIT_TASK with the time necessary for sysprep to finish.

CSCup61134

The user input in the Migrate VM task has changed from Host Name to Hostnode Identity.

For workflows from an earlier release, delete the existing Host Name user input, add the Hostnode Identity, and map it.

CSCup85949

Datastore mount and VM creation happens successfully on PowerPath hosts but Stack view information will not be shown.

There is no known workaround for this issue.

CSCup09631

Due to VM provisioning consolidation limitations, the provision later options, Dynamic Datastore and NIC Selection (end-user options) do not work through orchestration.

Set these options in the Service Request.

CSCup92660

The Modify VM Network task is failing when VMWare Inventory task is running in parallel.

Increase the time stamp for VMWare inventory for the VMWare Inventory task.

CSCuq09385

Cannot submit the consistency group task. An error message indicating an invalid work flow exception is displayed.

While creating consistency groups with the detach rule as "no automatic winner”, if a workflow is submitted and executed, it will through invalid work flow exception. If the workflow is re-opened, then it expects the delay input as well.

While creating the consistency groups with the detach rule as "no automatic winner", reopen the task and provide the delay input and execute the workflow.

CSCup60429

NetApp OnCommand shows the inventory for only NetApp 7mode filers and not cluster mode in Cisco UCS Director.

There is no known workaround for this issue.

CSCuq04489

VM Clone with VSC task is failing for ONTAP Cluster Mode when the Storage Efficiency option is enabled.

This task works only in the ONTAP 7mode but fails for the Cluster Mode.

There is no known workaround for this issue.

CSCuq15568

The Mount ISO Image as CD ROM task is available as an option in the VM Action list.

This option is available as an action button for a VM. After executing this task, it does not return a value. While running this task, an exception “Error in operation” is recorded in the log.

There is no known workaround for this issue.

CSCup37013

Without running the inventory, ISO information is not displayed.

You must run the manual inventory at the cloud level to get the ISO details from the data store.

CSCuq11892

The ApplyHostProfiletask will not work until host profile inputs are configured.

Before applying the Host Profile, provide additional inputs after attaching the host to the host profile which can be done as follows:

A) Attach host to a host profile.

Go to Virtual-> Compute-> Host Profile tab. Navigate to the specific host profile, The Attached Hosts table will appear. Navigate to the specific attached host. The User Inputs table will be shown. Provide a value for each input using the Edit User Input button.

If these values are not provided, the Apply Host Profile will fail for that host.

If the User Input table is not populated, then use the 'Collect Host Profile Inventory' which is available at per cloud level and as a workflow task. This task will collect host profile related inventory for selected accounts.

CSCuq15405

The Cloud Sense action button is shown under Virtual > Compute > Select SCVMM cloud > Cluster. After navigating to this point, select any cluster. That action button is not applicable to it.

There is no known workaround for this issue.

CSCuq03179

LUN creation happens on the selected Raid Group or Storage Pool but in the Service Request log it shows a default input value for the unselected one.

Ignore the unselected input value.

CSCuo71969

Associate virtual volume as shared DS- Datastore mounts on selected multiple hosts but the task fails with the following error message for one of the hosts:

Host initiators are not in selected Storage view.

Ignore the error message.

CSCup73898

Control not coming back to the UI if an action takes more than 2 minutes.

For such actions, use the workflow task as it will wait for the task to complete. If action is used, reload the page after the UI times out.

CSCuq11753

After upgrade, unable to login to the openLDAP user (Account will be in the report after upgrade) in a multinode setup.

Create a new open Ldap account, then synchronize the users and try to login the open ldap users.

Delete the existing openLDAP account and create a new openLDAP account. Then synchronize the users and try to login with a newly synchronized user.

CSCuq07118

In a Multinode setup, PowerShell Agent is unreachable after upgrading Cisco UCS Director to version 5.0.

In Cisco UCS Director, delete the PSA and add it again.

CSCup80224

In a multinode setup, when a KVM VM is provisioned, the SR-Request shows the VM as not discovered.

As a result the VM does not belong to the group in which it is provisioned. It belongs to a default group.

After upgrading, the Baremetal Agent account name, user name, password fields display as empty and the connectivity status is shown as Failed. Editing the Baremetal Agent account to provide these parameters does not return the status to Active.

Delete the existing Baremetal Agent account and create a new Baremetal Agent account.

CSCuq12334

Adding an OpenLDAP account with the wrong domain name does not generate an error message. Cisco UCS Director creates an OpenLDAP account with the wrong domain name.

Delete the inaccurate account and create an OpenLDAP account with the correct domain name.

CSCup66379

For VM provisioning with a static IP address, Cisco UCS Director does not wait until the customization is completed. Cisco UCS Director needs to wait for the default time (10 minutes) or wait until the static IP address is assigned to the VM.

Wait 10 to 15 minutes and then check to see if the static IP address has been properly assigned to the VM.

CSCuq32448

Invicta (Whiptail) connection error in Cisco UCS Director Release 5.0

When the "test connection" action is performed on an Invicta (Whiptail) account after you have changed the credentials, Cisco UCS Director shows “connection failed” but the status of the account is green until after you perform an inventory.

To see the failed connection status, you must perform an inventory on the Invicta (Whiptail) account. The connection status for the account will then display as red.

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: www.cisco.com/go/trademarks. 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)

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.