Skip to main content
Hitachi Vantara Knowledge

Unified Compute Platform (UCP) Advisor v2.5.0 Release Notes

About this document

This document (RN-92UCP099, April 2018) provides late-breaking information about Unified Compute Platform (UCP) Advisor 2.5.0. It includes information that was not available at the time the technical documentation for this product was published, as well as a list of known problems and solutions.

Intended audience

This document is intended for customers and Hitachi Vantara partners who license and use Unified Compute Platform (UCP) Advisor.

About this release

This release is a major release that adds new features and resolves multiple known problems.

New features and enhancements

·         UCP 4000 Revs Cisco appliance inventory support—Includes support for the UCP 4000 Cisco-based appliance (rev 3) which includes the CB 500 chassis (with HB3/HB4 blade) and inventory.

·         DS220 server support—Includes support for the Hitachi Advanced Server DS220 (with DS120 firmware), a rack mount, network server that delivers a balance of compute and storage capacity.

·         vCSA 6.5u1e support—Supports the latest version of the VMware vCenter Server software (version 6.5u1e).

·         GAD volume inventory support—Provides inventory support for replication pairs (global-active device or GAD). Details are accessed through a new tab added for storage devices, and provides information such as resource group ID, associated host group, storage pool, drive group, and logical unit.

Supported hardware


The UCP Advisor compute hardware and firmware requirements are identified, as follows:























Ethernet Switch

The UCP Advisor Ethernet switch models and firmware requirements are identified, as follows:



Cisco Nexus 93180YC-EX NX-OS version


Cisco Nexus 93180LC-EX NX-OS version


Brocade VDX 6740


Brocade VDX 6940


Ethernet Switch (management)



Cisco Nexus 3048 NX-OS Version

6.0(2)U6(6), 7.0(3)I4(6)

Brocade ICX 7450


Fibre Channel Switch

The UCP Advisor Fibre Channel switch models and firmware requirements
are identified, as follows:



Brocade G620


Brocade 6505


Brocade 6510



The UCP Advisor storage models and microcode requirements are identified, as follows:



VSP G200


VSP G400


VSP G600


VSP G800


VSP G1000


VSP G1500


VSP F400


VSP F600


VSP F800


VSP F1500


1. The listed microcode versions are the minimum versions.

UCP4000 Cisco Rev3 hardware

Compute Chassis


CB500 SVP Firmware


CB500 SVP Equipment Parameter File


CB500 SEL Dictionary File




520H B3


520H B3 firmware file


   Blade firmware version


   BMC version


   EFI version


520H B3 CNA On-board LOM (UCP 4000) (XE104) (4000)

520H B4


520H B4 firmware file


   Blade firmware version


   BMC version


   EFI version


520H B4 CNA On-board LOM (UCP 4000) (XE104) (4000)

Ethernet Switch


Cisco Nexus 9372


Cisco Nexus 9332


Ethernet Switch (management)


Cisco Nexus 3048 NX-OS

6.0(2)U6(6), 7.0(3)I4(6)

Fibre Channel


Brocade 6510


Brocade 6546 (in chassis switch)


Storage (minimum supported version for the storage firmware)


VSP F1500


VSP G1500


VSP G1000


VSP G200


VSP G400


VSP G600


VSP G800


VSP F400


VSP F600


VSP F800


Supported software

The UCP Advisor environment can include the following software programs. Prior to deploying UCP Advisor, verify that the required software is installed and configured.





6.5 U1 (Build 7388607)


6.5 U1e (Build 7515524)

VMware Tools

VMware PowerCLI



vRealize Orchestrator (vRO)


vRealize Log Insight (vRLI)


Hitachi Vantara

Hitachi Vantara


UCP Advisor Controller

UCP Advisor Gateway

Hitachi Automation Director


Hitachi Compute Connector Plugin for vRO

Hitachi Storage Connector Plugin for vRO



Other software




8u161 (64-bit)


2.7.6 (64-bit)





Resolved issues

Defect ID




vSAN: Refresh doesn't work after a host is disconnected.

1. Create a vSAN and check for its fields in the UCP Advisor UI.

2. Disconnect one of the hosts in the vSAN cluster.

3. In the vCenter UI, all disk information goes blank and the status of the host is disconnected.

4. In the UCP Advisor UI, the status remains the same even after multiple refreshes. The disks also continue to appear in the vSAN inventory screen.

Navigate back from vCenter Home > UCP Advisor icon. Select a UCP Appliance and navigate further.


Provisioning datastore to cluster fails.

Create a host group and add WWNs for both hosts in the host group.

1. Go to Storage > DataStore > Provision a DataStore and select both hosts.

2. Create DataStore task failed.

Verify that there is only one host per host group.


UI displays error message "Loading <Resource> failed" for all storage resources.

UI can fail to load storage resources such as logical units or host groups right after performing tasks to create these resources, or after a refresh of the storage system. 

Navigate back from vCenter Home > UCP Advisor icon. Select a UCP Appliance, access the storage resource, and attempt loading the storage resources.


ESXi deployment issue: Datacenter name is missing from the Summary window and deployment is performed to the wrong datacenter with duplicate cluster name.

In the Summary window of vCenter Hosts and Clusters, the datacenter name is not displayed. However, this information is displayed after the deployment is completed. Since the UI does not display the datacenter name, in the case of two clusters with the same name in two datacenters, the host is deployed to a wrong datacenter cluster.

Make sure you don't have two clusters with the same name in different datacenters. If necessary, rename the datacenter.


Error message "Onboarding Storage failed" is displayed due to a missing command device.

Message: "Error occurred while adding storage. Error occurred while connection to storage device 56227. Server internal error: missing configuration info for storage id: 56227" is displayed when adding a storage resource. The command device on the UCP Gateway host is unavailable.

Provision a storage array command device and present it to the UCP Gateway VM host.


Upgrading Brocade G620 and Cisco switches can fail due to SSH host keys.

Upgrading Cisco 3048, 93180YC, 93180LC, and Brocade G620 switches can fail if the SCP server host key changes. This is expected and is a security design.

Not a product issue. Resolution is documented in the "Troubleshooting" section of the Hitachi Unified Compute Platform (UCP) Advisor Administration Guide, and also posted here as an article:


The create command device operation can fail from Toolbox when the proxy settings are enabled.

Not a product issue. Resolution is documented in the Troubleshooting section of the Hitachi Unified Compute Platform (UCP) Advisor Administration Guide, and also posted here as an article:


Edit Zone removes existing WWN member if it is not in any alias.

In the UCP Advisor UI, for creating or editing a zone, it accepts only alias name and not WWN directly.

But in the switch CLI, the user can create a zone with WWN as well.

Consider that the zone has WWN as a member and not the alias. When you select that zone and click Edit Zone, the WWN is not listed in the list of members.

When you make any changes like selecting a new alias name and click Submit, the existing WWN is removed automatically.

Create an alias first, and then create or edit the zone. Do not create a zone with WWN via the switch CLI.


Replace Host: The host is placed in an incorrect data center when two clusters with same name exist in different datacenters.

If two clusters with same name exist in two data centers and Replace Host operation is attempted for a host in one of those clusters, the replacement host is placed in a different cluster.

Make sure that no two clusters have the same name in different data centers. If necessary, rename the data center.


Sync VLAN UI may only show one port for sync but backend syncs both switches

UI will only show 1 of 2 VM NICs for server being synchronized. However, the backend code will synchronize both VM NICs with the switch.

Check vCenter task to confirm both switches are synchronized with VLAN configuration.


If the UCP Appliance instance already exists, you can't create a new UCP Appliance with the same name.

1. Create a single UCP Appliance instance.

2. Stop the UCP Advisor web service.

3. Use the vCenter plugin to delete the UCP Appliance.

4. Start the UCP Advisor web service.

5. Create new UCP Appliance instance with the same name. An error indicating existence of a duplicate UCP Appliance appears.

Use the REST API command to delete the UCP Appliance, and then use the UCP Advisor GUI to create the UCP Appliance instance with the same name.


In Create Zone window, clicking on any unselected alias (not the checkbox) unselects an existing selected alias

1. Click Create Zone and enter the zone name.

2. Click on any new alias in the Alias Name field to select it.

3. Click on a different alias.

The previously selected alias is unselected.

Use the checkbox to select an alias.


Brocade ICX7450 (UCP2000 Management) switch has 28 ports, only 27 ports are displayed in the switch diagram. The missing port is 1/1/22.

Contact Customer Support.


Install script failed to run initialize script when open ssh service failed to start

1. Mount UCP advisor media bundle, and run the install script.

2. The install script fails to start open ssh service and fails to run initialize script.

After VM is rebooted, the UCP appliance cannot be created from the webclient.

Run Initialize script located under UCP advisor controller VM

C:\Program Files\Hitachi\UCP Advisor\Support\InitializeUcpAdvisorRunningEnvironment.bat


Storage array inventory not visible on UCP Advisor Storage tab

Even though a storage array with capacity greater than 2 PB onboards successfully, it does not appear on the UCP Advisor Storage tab.

Upgrade the UCP Advisor software from v02.5.0.556 to v02.5.0.562.

See, Applying hotfix (1444).

Known issues

Defect ID




Two Toolbox items show up in the "Files in use" window during uninstallation.

There is no difference between the two items.
Choose either Toolbox item.


You can onboard host names or IP addresses. However, there is no capability to convert or compare IP addresses to host names with vCenter.

For example, if the host is registered in vCenter using its host name, and the node is on-boarded with its IP address, some features, such as vSAN drives, do not display any information.

Use the IP address.


All tabs under Administration fail to load after the system is left idle.

This issue occurs after adding servers and navigating to the Servers tab, then leaving the UI idle.

Upon returning to the Administration section, all of the tabs such as Configuration, Compute, Storage, Network, Backup, and Log Bundle fail to load and display errors such as, "Loading configuration failed" or  "Loading Compute failed" with no data shown in the windows.

This is a session ID timeout issue. The session timeout occurs after 25 minutes.

Navigate back from vCenter Home > UCP Advisor icon, select an appliance, and access the Administration tab or navigate further.


The confirmation window will not close after the power operation fails, due to the same power state.

This occurs while attempting to perform the same power operation that the server state is already in (for example, power ON while the server is already ON). Even after the operation fails, the confirmation box remains open.

Close the confirmation window by selecting the close button or the X icon on the window.


All device-related operations do not work with host name/FQDN.

Use the host IP address instead.


Unable to download files through the Swagger UI.

Downloaded files appear corrupted when they are downloaded from Swagger UI.

Use an https call in a browser, use postman client, or other methods to download files.

This is a known Swagger issue:


vRO Storage workflows: Storage systems do not appear in the menu for selection.

The added storage is not listed in the HitachiStorageConnector list.

1) Add the storage device using a vRO workflow.

2) Open the workflow Create LU in dynamic Pool and try selecting the added storage in the Hitachi storage array field.

Use the Filter tab to identify and select the storage system, or use the vRO web client.


Swagger UI cannot handle very large files.

The UploadFirmwareBundle REST API call cannot be executed through the Swagger UI because the firmware bundle is large (file size is greater than 3.5 GB).

The Swagger UI returns a no content response, and the operation is not executed.

Use a curl command to execute this API.


Replace host workflow fails to remove host from vCenter if host is part of vDS.

Replace host workflow fails at the very end if host is part of a vDS.

Remove the host from vDS and then try removing it from vCenter.


Set boot option does not change the server BIOS Boot Option #1.

Change the boot option in BIOS.


UI crashes when multiple appliances are created or when multiple sessions are active.

After multiple UCP appliances are created or when multiple users access the same vCenter, the server windows fail to load information or show errors:

1. Individual managed objects fail to load.

2. Incorrect server count is shown: 0 in most places.

3. Permission denied errors are displayed.

Navigate out of UCP Advisor and then navigate back in.


Syslog agent does not forward compute device logs after the Windows service is restarted.

Restart the UCP Advisor Windows service after the Syslog agent Windows service is restarted.


ucp-advisor-sidecar is not restarting after a crash.

1. Find the Process IDs for Local Address containing port 23016.

C:\Windows\system32>netstat -a -n -o | findstr :23016

  TCP              LISTENING       3456

  TCP    [::]:23016             [::]:0                 LISTENING       3456

2. Stop all processes with the following PID:

C:\Windows\system32>TaskKill.exe /F /PID 3456

SUCCESS: The process with PID 3456 has been terminated.

3. Wait for 2 minutes and verify that ucp-advisor-sidecar is RUNNING.


vCenter inventory (Host and Cluster) shows blank in provision datastore, deploy ESXi host, replace ESXi host and vLAN synchronization.

1. Create folder under datacenter and add ESXi to it.

2. Navigate to Provision datastore / Deploy host / VLAN sync / Replace hosts wizard.

UCP Advisor cannot get vCenter inventory when the vCenter datacenter contains a folder.

Manually remove the folder under datacenter from the vCenter inventory.


VLAN name should accept special characters as supported by the switch.

Switches support special characters ~`@#$%^&*()_-+ in a VLAN name. UCP Advisor does not accept these characters while creating a new VLAN.

Avoid using the special characters ~`@#$%^&*()_-+ in a VLAN name.


Update peer switch not able to update/find peer Brocade switch.

Create the same VLAN in all the required peer switches through the switch UI in UCP Advisor.


Editing port from trunk to access or vice versa is not allowed if port count in the VLAN is unchanged.

Remove the VLAN from the PORT and re-add it with the correct setting.


Toolbox - Script failed to create command device if undefined LDEV has virtual LDEV ID.

Remove virtual LDEV ID from undefined LDEV ID manually and create the command device from the Toolbox.

c:\HORCM\etc>raidcom.exe map resource -ldev_id 738 -virtual_ldev_id 738 -I206


Create host group dialog launched from Action manual item does not set the host mode option correctly.

Same issue for Create Storage Pool.

Perform the action from the Host Group or Storage Pool tab.


GetComputeDevice API call requires DeviceIP instead of Device ID. GetComputeChassis API as well.

Use IP address for Device ID.


CB500 blade model shows NA under compute summary

Click on the Refresh icon located under the compute summary screen; once refresh is complete, go to the chassis view and navigate back to compute summary.


Chassis (alias) modified after upgrade to 2.5.0 from 2.0P1.

Onboard server in 2.0 Patch1.

Modify chassis label and then upgrade to 2.5.

In addition to serial number, chassis alias is also modified after the upgrade.

Set the chassis label again.

Applying hotfix (1444)

After onboarding a storage system with capacity greater than 2 PB, the following message may appear after clicking the Storage tab in the UCP Advisor Administration window. The workaround that resolves this issue is to upgrade the UCP Advisor software from v02.5.0.556 to v02.5.0.562.


1)      Download the UCP Advisor Hotfix 1 installation file from the Hitachi Support Connect portal.  A Hitachi login credential is required.

a)       Log on to Support Connect.

b)      Click Product Downloads.

c)       In Find a Download, enter UCP Advisor.

d)      Under Available software, click UCP Advisor.

e)       Download UCP Advisor Hotfix 1.

2)      Start a Remote Desktop session, then log in to the UCP Advisor controller VM as a  local administrator.

3)      Create a temp directory on the C drive named Hotfix. You can delete this directory after the hotfix is installed.

4)      Copy file to the Hotfix temp directory.

5)      Extract the files to the Hotfix temp directory.

6)      Run setup file: UCPAdvisor-Master-setup-

7)      Follow the prompts to install the software.

8)      Select Yes, I want to restart my computer now, then click Finish.

9)      Log in to the UCP Advisor controller VM as a local administrator.

10)   Enter the vCenter plugin IP address and credentials, then click Submit.

11)   Click OK to complete the installation.

12)   Log on to vSphere Web Client, then navigate to Home > Administration > Client Plugins. Verify the Hitachi UCP Advisor for VMware vCenter plugin version is

13)   Navigate to Home > UCP Advisor > <appliance> > Administration. Click the Storage tab.  The onboarded storage array with capacity greater than 2 PB is displayed.


Accessing documentation

This section lists the UCP Advisor user documentation. Product documentation is available on Support Connect: Check this site for the most current documentation, including important updates that may have been made after the release of the product.

Document name

Document number

Hitachi Unified Compute Platform (UCP) Advisor Administration Guide


Hitachi Unified Compute Platform (UCP) Advisor Pre-Installation Requirements and Configuration Guide