Skip to main content
Outside service Partner
Hitachi Vantara Knowledge

Upgrading UCP Advisor

This procedure is for upgrading the UCP Advisor management node instance from version 2.5. or 2.5 Hotfix 1 to version 2.7.0. Upgrading from versions 1.2 and earlier is not supported.

Preparing for the upgrade

Preparing for the upgrade will help ensure that the upgrade process goes smoothly and efficiently.

Before you go to the customer site:

  • Prepare a list of credentials for the system components you are upgrading.
  • Download the upgrade installation media and related documentation in case you do not have web access at the customer site.

At the customer site:

  • Ensure that the system you are upgrading is up and running with no active alerts, alarms, or unresolved issues.
  • Back up the UCP Advisor software configuration data.
  • Take snapshots of all of the management VMs for recovery.

Preparing a credentials list

Prepare a list of user credentials for each system component.

Work with the customer to provide a list of user credentials, either beforehand or available when you arrive on site. This list should include all user names and passwords for the current system components listed below, and will help save time when at the customer site.

  • vSphere (both vCenter root and vCenter SSO)
  • vCenter management port (root password for https://<vsphereIP>:5480)
  • Management hosts (root password for ESXi hosts hosting management VM URL https://<ManagementHostIP>/ui)
  • UCP Advisor controller VM
  • UCP Advisor Gateway VM
  • Hitachi Automation Director (if installed)
  • vRealize Orchestrator (if installed)
  • vRealize Log Insight (if installed)
  • Hi-Track Monitor
  • BMC IP and credential for compute servers

Proxy server information

Ask the customer if their network is open, or if it requires a proxy for connecting to the Internet (HTTP and HTTPS) and downloading.

If a proxy is required, then gather the following information:

  • HTTP and HTTPS proxy server IP addresses
  • Port information for the HTTP and HTTPS server

This information will be used in a later procedure when configuring the upgraded UCP Advisor Gateway VM.

Verifying the UCP Advisor system

Prior to upgrading, verify that the UCP Advisor system is up and running with no active alerts or alarms, including its network and switches. All issues must be resolved before starting the upgrade. If you find any issues, discuss with the customer about how to resolve them before continuing with the upgrade.

  1. Verify compliance of the vCenter host profile. For details, see the VMware document, Checking compliance of a host profile.

  2. Verify that there are no active alarms in the vSphere Web Client. For details, see the VMware document, View and Edit Alarms.

  3. Create a list of all devices (network, Fibre Channel, compute, and storage) that are onboarded, online, and visible in UCP Advisor. Verify that there are no issues with any of the devices.

  4. Make sure the firmware versions of each device (switches, compute servers, storage) match the firmware version given in the release notes for that version.

  5. Fix any issues prior to the upgrade.

Downloading the UCP Advisor installation media ISO package

Download the media installation ISO package before going to the customer site because you might not have web access at the site where the upgrade is to be performed.

Procedure

  1. Log on to the Support portal at: https://support.hitachivantara.com.

  2. Click Product Downloads.

  3. In Find a Download, enter UCP Advisor.

  4. Under Available Software, click UCP Advisor.

  5. Download the 2.7.0 version of the UCP Advisor installation media.

  6. Verify that the media downloaded properly.

Backing up the UCP Advisor software configuration data

Back up the XML files used to configure the UCP Advisor software so that you can use them to restore the pre-upgrade configuration, if necessary. Verify with the customer if the XML files were modified from the standard installation version. If they were, you can use these backup files to reconfigure the software after the upgrade.

Procedure

  1. Log on to the UCP Advisor controller VM.

  2. Open an administrator CMD window.

  3. Run the following commands:

    md c:\temp\AdvisorConfigBackupFor2_7
    cd "C:\Program Files\Hitachi\UCP Advisor"
    xcopy /fcedy *.config c:\temp\AdvisorConfigBackupFor2_7
    For reference, the XML files for UCP Advisor 2.0 and 2.0 Patch 1 are shown below.

Taking VM snapshots

Take snapshots of all management node VMs to enable recovery if needed.

  1. Log on to all management hosts, as the VMs may be spread across multiple management hosts.

  2. Shut down each VM in the following sequence. Allow each VM to shut down completely before shutting down the next one.

    1. UCP Advisor controller VM

    2. UCP Advisor Gateway VM

    3. Hitachi Automation Director, if present

    4. vRealize Orchestrator, if present

    5. vRealize Log Insight, if present

    6. vSphere VM

  3. In the Navigator pane, select Virtual Machines.

  4. Right-click the UCP Advisor controller VM, then select Snapshot > Manage Snapshots.

  5. Enter a name for the snapshot; for example, BeforeAdvisorUpgrade2_7.

  6. Click Take Snapshot.

  7. Repeat steps 4 through 6 to take a snapshot of each VM.

Upgrading UCP Advisor system components

Upgrade the software and VM components in the UCP Advisor system:

  • VMware vSphere
  • Hitachi Automation Director, if present
  • vRealize Orchestrator, if present
  • vRealize Log Insight, if present
  • UCP Advisor Gateway VM
  • UCP Advisor controller VM
  • Third-party software
  • UCP Advisor software

Upgrading vSphere

Use the vCenter Server Appliance to upgrade the vSphere components to the level supported by the UCP Advisor upgrade version, as specified in the Release Notes.

Before you begin

Access the Release Notes for the upgrade version: https://knowledge.hds.com/Documents/Converged/UCP_Advisor.

For details on using this appliance, see Patching the vCenter Server Appliance and Platform Services Controller Appliance, available from VMware Docs at https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.upgrade.doc/GUID-043EF6BD-78F7-412F-837F-CBDF844F850C.html.

Procedure

  1. Log on to the vCenter Server Appliance using the management URL. This step assumes that the upgrade ISO image is attached to the vCenter VM as CD/DVD.

  2. In the Navigator pane, click Update.

  3. In the Available Updates area, click Install Updates.

  4. When the installation is done, click OK.

  5. Restart the vSphere VM.

Next steps

Verify that vSphere updated correctly.

  1. Log on to the vSphere Web Client: https://<vSphereVM_IP>/vsphere-client/?csp.
  2. Verify that the Hitachi UCP Advisor for VMware vCenter plug-in is present on the home page. Note that other appliances are not displayed because all of the other VMs were shut down in a previous step.
  3. In the Navigator pane, click Administration > Client Plugins, and verify that the old version is installed. For current versions, see the Release Notes.

    NoteUpgrading to VMware 6.5U2 will prevent the plugin from being displayed in the Client Plugins list.

Upgrading optional software components

The following optional software component does not require upgrading for the current release of the UCP Advisor software:

  • vRealize Orchestrator, if present

The following optional software components require upgrading for the current release of the UCP Advisor software:

  • Hitachi Automation Director, if present
  • vRealize Log Insight, if present

Hitachi Automation Director

When upgrading the Hitachi Automation Director software, the installer backs up any existing customer data and custom configuration files before it installs the new version, and then it restores them after the installation is completed. See the Release Notes for the supported version of the Automation Director software, and then follow the installation procedure described in the Automation Director documentation at https://knowledge.hitachivantara.com/Documents/Management_Software/Automation_Director.

Upgrading the vRealize Log Insight plugin

If the vRealize Orchestrator plugin VM it is currently part of your system, bring it online, then upgrade it as described in the following document: https://docs.vmware.com/en/vRealize-Log-Insight/4.6/com.vmware.log-insight.administration.doc/GUID-3F7BCA8B-DDD8-4CAD-B924-59D2DA14F613.html.

Upgrading the UCP Advisor Gateway VM

Upgrade the software on the UCP Advisor Gateway VM, and then configure it.

Before you begin

Procedure

  1. Bring the UCP Advisor Gateway VM online.

  2. From a vCenter host, log on to the UCP Advisor Gateway VM console.

  3. Verify the currently installed version of the REST server:

    1. On the command line, enter puma_adm -pc to display the configuration information.

    2. Verify that the REST Server version is 6.0.0.3115.

  4. Bring the UCP Advisor controller VM on-line.

  5. Start a Remote Desktop session, then log on to the UCP Advisor controller VM.

  6. Copy the UCP Advisor installation media ISO package you previously downloaded to C:\temp. If this directory does not exist, create it.

  7. Mount the ISO package listed above as F: drive.

  8. From an administrator command window, use the PSCP tool to copy the RPM file to the UCP Advisor Gateway VM. If you are prompted for an RSA key, enter y.

    "c:\Program Files\Hitachi\UCP Advisor\HivSphereConverged\InstallerUtil\putty\PSCP.EXE" -pw <UCP Advisor Gateway VM Password> F:\Software\AdvisorGatewayOVA\puma-6.1.2-1.el7.x86_64.rpm root@<UCP Advisor Gateway VM IP>:/root/

    In some cases, you may be prompted for the RSA keys.

    The server's host key is not cached in the registry. You have no guarantee that the server is the computer you think it is. The server's rsa2 key fingerprint is: ssh-rsa 2048 34:58:4b:9b:7c:cf:88:27:ae:52:93:1d:3a:03:fc:83 If you trust this host, enter "y" to add the key to PuTTY's cache and carry on connecting. If you want to carry on connecting just once, without adding the key to the cache, enter "n". If you do not trust this host, press Return to abandon the connection. Store key in cache? (y/n) y

    When copying is completed, the following line is displayed:

    puma-6.1.1-1-el7.x86_64.rpm | 405638 kB | 27042.6 kB/s | ETA: 00:00:00 | 100%
  9. From the UCP Advisor Gateway VM console, run the following command to update the software:

    puma_adm -r <rpm_file>
  10. At the Upgrade all [BFNS] prompt, press Enter.

Next steps

Verify that the UCP Advisor Gateway VM upgraded correctly.

  1. Enter puma_adm -ck | more, then verify that the command device is attached. If any of the services are listed as FAIL, restart the VM, then repeat this step.
  2. Enter puma_adm -pc to display the configuration information, then verify that the REST Server version matches the upgrade version as listed in the Release Notes.

Configuring the UCP Advisor Gateway VM

Configure the UCP Advisor Gateway VM to use HTTP and HTTPS proxies, if required by the customer's network, and then configure if for provisioning.

Before you begin

  • Determine if the customer's network requires proxies for connecting to the Internet (HTTP and HTTPS) and downloading.
  • If proxies are required, use the proxy information gathered when preparing for this upgrade. See Proxy server information.

Procedure

  1. If the customer's network requires proxies, run the following commands. If proxies are not required, go to step 2.

  2. Run the following command to configure the UCP Advisor Gateway VM for provisioning:

    puma_adm -pi
  3. If proxies were required in step 1, run the following commands. Otherwise, skip to step 4.

    • unset http_proxy
    • unset https_proxy
  4. Run the following command, and then verify that additional services are running

    puma_adm -ck | more.

Upgrading the UCP Advisor controller VM

Upgrade the UCP Advisor controller VM in multiple steps: verify that the UCP Advisor services are running; upgrade the third-party software; then upgrade the UCP Advisor; and then upgrade the UCP Advisor software.

Verifying UCP Advisor services

Verify that the UCP Advisor services are running on the UCP Advisor controller VM before upgrading the software.

Before you begin

Verify that the UCP Advisor controller VM is online.

Procedure

  1. Start a Remote Desktop session, and then log on to the UCP Advisor controller VM.

  2. Open the Services panel, and then verify that the following services are running:

    • Hitachi Syslog Agent for vRLI
    • Hitachi UCP Advisor Ghost
    • Hitachi UCP Advisor Hi-Track Web Service
    • Hitachi UCP Advisor Service Registry
    • Hitachi UCP Advisor Services
    • Hitachi UCP Advisor Sidecar
    • Hitachi UCP VI Service
    • Hitachi vRO Converge Web Service
    • Hitachi Watchdog Service

Uninstalling the UCP Advisor software

Uninstall the UCP Advisor software.

  1. Start a Remote Desktop session, and then log on to the UCP Advisor controller VM.

  2. Unregister the UCP Advisor plugin from vCenter using the following command:

    "C:\Program Files\Hitachi\UCP Advisor\Support\UnregisterUCPAdvisorvCenterPlugin.exe"
    <VCENTER_SERVER_IP> <VCENTER_ROOT_PASSWORD> < VCENTER_SSO_USER> < VCENTER_SSO_PASSWORD>
    NoteAlert the customer that running this command will cause the vSphere client to restart.
  3. Open the following Managed Object Browser (MOB) URL, and then verify that the UCP Advisor extension com.hitachi.ucp.advisor is removed.

    https://<vSphereIP>/mob/?moid=ExtensionManager
  4. From Control Panel > Programs and Features, uninstall the 2.5.0.x version of Hitachi Compute AdvisorAPI.

  5. Manually restart the UCP Advisor controller VM, and then log on again.

  6. From Control Panel > Programs and Features, uninstall the 2.5.0.x version of Hitachi UCP Advisor.

    1. At the following prompt, click Yes:

      Do you want to completely remove the selected application and all of its features?
    2. At the following prompt, click Skip:

      Upgrade vCenter Plugin.
    3. Select Automatically close and attempt to Restart applications, and then click OK.

    4. Click Finish.

  7. Open an administrator command prompt, and then delete the following UCP Advisor services.

    sc delete HiUcpServices
    sc delete HivROConvergeWebServiceHost
    If deletion of the specified services fails, then they are not installed.
  8. Delete the previous UCP Advisor installation folder. The default path is: C:\Program Files\Hitachi.

  9. Manually restart the UCP Advisor controller VM.

Upgrading third-party software

Upgrade third-party software before upgrading the UCP Advisor software.

Locate the UCP Advisor installation media ISO package in C:\temp, and then mount it as drive F.

Upgrading Java

Upgrade the Java 8 software to Update 172.

Procedure

  1. On the UCP Advisor controller VM, browse to the following directory:

    F:\Software\Java8
  2. Double-click jre-8u172-windows-x64.exe.

  3. Click Install to set up Java with the default settings.

  4. Select the out-of-date versions of the Java 8 update, and then click Uninstall.

    The Java Setup - Complete window opens. The uninstall process might take 10 to 15 minutes to complete.
  5. Click Next, and then follow the remaining prompts to complete the upgrade installation.

Next steps

Verify that the Java software has been upgraded.

  1. Navigate to Control Panel > Programs and Features.
  2. Verify that the Java 8 Update 172 (64-bit) has been installed.

Upgrading OpenSSH

Upgrade the OpenSSH software from version 7.5p1-1 to 7.7p1-1.

Procedure

  1. Log on to the UCP Advisor controller VM.

  2. In an administrator command window, run:

    F:\Software\OpenSSH77\ setupssh-7.7p1-1.exe /password=<UCP_Advisor_Controller_VM_Password> /S

Next steps

Verify that the OpenSSH software has been upgraded.

  1. Navigate to Control Panel > Programs and Features.
  2. Verify that the OpenSSH version 7.7p1-1 is installed. For additional information, including troubleshooting, see https://www.mls-software.com/opensshd-silent.html.

Installing Elasticsearch

Create a new JAVA HOME environment variable to the latest Java JRE folder, and then install and configure the Elasticsearch-5.5.0 software.

Procedure

  1. Create a new environment variable.

    1. In the Control Panel, navigate to System and Security > System.

    2. Click Advanced system settings > Advanced > Environment Variables.

    3. In the System variables pane, click New.

    4. For Variable name, enter: JAVA_HOME.

    5. For Variable value, enter the path to the latest Java Runtime Environment folder. For example, C:\Program Files\Java\jre1.8.0_172.

    6. Click OK until all of the windows are closed.

  2. Open a new administrator command window, and then copy the Elasticsearch software to c:\Program Files\ElasticSearch-5.5.0 folder.

    md "c:\Program Files\ElasticSearch-5.5.0"
    cd "c:\Program Files\ElasticSearch-5.5.0"
    xcopy /cedy F:\Software\elasticsearch-5.5.0
    
  3. Verify that the JAVA_HOME environment variable is set.

    C:\Users\Administrator>set JAVA_HOME=C:\Program Files\Java\jre1.8.0_172
  4. Run the following command to install the Elasticsearch service.

    C:\Users\Administrator>"c:\Program Files\ElasticSearch-5.5.0\bin\elasticsearch-service.bat" install
    Installing service	:"elasticsearch-service-x64"
    Using JAVA_HOME (64-bit): "C:\Program Files\Java\jre1.8.0_172"
    The service 'elasticsearch-service-x64' has been installed.
  5. Open Administrative Tools > Services, and then double-click the Elasticsearch service to open its properties panel.

  6. On the General tab, change the startup type to Automatic, and then click Start to start the service.

Next steps

Verify that the service is started, and then close the Properties panel and Services window.

Upgrading the UCP Advisor software

Upgrading to UCP Advisor version 2.7.0 requires upgrading the following two components:
  • UCP Advisor
  • UCP Advisor API
NoteThe UCPAdvisorOnBoardSheet.csv onboarding template from prior versions cannot be used in this upgraded version. A new template file is available in the same location (C:\Program Files\Hitachi\UCP Advisor\Documentation).

Upgrading the UCP Advisor

Perform the following procedures to upgrade the UCP Advisor.

Procedure

  1. Browse to the location of the UCP Advisor installation media:

    F:\Software\UCPAdvisor27
  2. Double-click the UCPAdvisor-Master-setup-02.7.0-(x64).exe file.

  3. Click Install.UCP advisor sw install wizard

  4. Click Next.UCP advisor install wizard next

  5. Accept the terms of the license, and then click Next.

  6. Click Install, and then wait for the installation to complete.

Upgrading the UCP Advisor REST API

Upgrade the UCP Advisor REST API.

  1. Browse to C:\Program Files\Hitachi\UCP Advisor\RestAPI.

  2. Double-click setup.exe to launch the install wizard.

  3. Click Next.UCP Advisor sw install wizard next

  4. Accept the terms of the license, and then click Next.

  5. Enter the customer information, and then click Next. UCP advisor sw rest API install wizard customer info

  6. Set the destination folder for the installation. Click Next to accept the default folder, or click Change to specify a different folder.UCP Advisor rest API install wizard dest info

  7. Click Install to begin the installation.UPS Advisor rest api install ready

  8. Click Finish.

  9. Reboot the VM.

Registering the UCP Advisor plugin

Register the UCP Advisor plugin using UCP Advisor Toolbox.

Before you begin

  • Upgrade the UCP Advisor.
  • Upgrade the UCP Advisor REST API.
  • Gather the vCenter plugin credentials.

Procedure

  1. From the UCP Advisor controller VM desktop, launch the UCP Advisor Toolbox.

  2. In the vCenter plugin pane, enter the following information:

    • VSCA Address: The vCenter Server Appliance management IP address.
    • Root Password: The password for the root user.
    • SSO Username: The vCenter SSO user name.
    • SSO Password: The vCenter SSO user password.
  3. Click Submit.

Updating UCP Advisor configuration files

If the customer modified the UCP Advisor XML configuration files after installing the previous version of the UCP Advisor software, you need to update the upgraded XML configuration files using the XML files you backed up when preparing for this upgrade. Skip this procedure if the customer did not modify the configuration files.

Before you begin

Locate the XML configuration files you backed up when preparing for this upgrade. They should be located in C:\temp\AdvisorConfigBackupFor2_7.

Procedure

  1. In an administrator command window, compare each of the old and new XML configuration files for differences between them.

  2. Manually update the new files with the values found in the old files. The new files are located in C:\Program Files\Hitachi\UCP Advisor\.

    For example, a comparison of the old and new versions of the App.config file shows a difference in the values for the CommunicationType key. The old value is HTTPS but the new value is HTTP. You would update this key in the new App.config file with the value from the old App.config file.

    fc "C:\Program Files\Hitachi\UCP Advisor\HiLogInsightConverged\SyslogAgent\App.config"
    C:\temp\AdvisorConfigBackupFor2_7\HiLogInsightConverged\SyslogAgent\App.config
    ***** C:\PROGRAM FILES\HITACHI\UCP ADVISOR\HILOGINSIGHTCONVERGED\SYSLOGAGENT\App.config
    <!-- CommunicationType possible value: HTTP or HTTPS -->
    <add key="CommunicationType" value="HTTP"/>
    <add key="httpsPort" value="2054"/>
    ***** C:\TEMP\ADVISORCONFIGBACKUPFOR2_7\HILOGINSIGHTCONVERGED\SYSLOGAGENT\APP.CONFIG
    <!-- CommunicationType possible value: HTTP or HTTPS -->
    <add key="CommunicationType" value="HTTPS"/>
    <add key="httpsPort" value="2054"/>
    *****
    

Verifying UCP Advisor plugin status

Verify the status of the UCP Advisor plugin upgrade and all onboarded devices. Verify that the version numbers match those listed in the Release Notes.

Before you begin

Access the Release Notes for the upgrade version: https://knowledge.hds.com/Documents/Converged/UCP_Advisor.

Procedure

  1. From the UCP Advisor controller VM, open Control Panel > Programs and Features.

  2. In the Version column, verify that the version of the UCP Advisor plugin matches the version listed in the Release Notes.Verify that the version of the UCP_ADVISOR plugin matches the version listed in the Release

  3. Open Administrative Tools Services, and then verify that the Hitachi services are running. If a Hitachi service is not running, start it.

  4. Log on to the vSphere Web Client.

  5. In the Navigator pane, click Administration > Client Plug-Ins.

  6. In the Version column, verify that the version of the UCP Advisor plugin matches the version listed in the Release Notes.

    Verify the status of the UCP Advisor plugin verify that the version matches the version listed in the Release Notes
  7. Navigate to the UCP Advisor plugin. If the plugin is not visible, go to step 8, and then return to this step.

    The UCP Advisor Dashboard shows all onboarded devices. The status for all onboarded devices may appear as Unreachable. Wait for the database to refresh, possibly for 30 to 45 minutes. The status will refresh to Normal, indicating that the software upgrade is complete.

Upgrading the firmware of onboarded devices

Upgrade the firmware for each onboarded device. For a list of devices that support firmware upgrades, see the Release Notes.

Before you begin

Access the Release Notes for the upgrade version: https://knowledge.hds.com/Documents/Converged/UCP_Advisor.

Procedure

  1. Upgrade the DS120 and DS220 blade firmware according to the procedure described in: Upgrading the DS120 or DS220 firmware.

  2. From the previously downloaded UCP Advisor Media ISO package, extract the firmware ZIP file from F:\FirmwareBundle. This file is for the UCP CI and UCP HC appliances.

  3. Upload the firmware ZIP file to Appliance > Administration in the UCP Advisor plugin, and then update the firmware.

  4. Make sure that the firmware on all devices matches the firmware version described in the Release Notes.

Upgrading ESXi hosts

Make sure that the ESXi hosts are updated to the latest version.

Procedure

  1. Verify that the management hosts are clustered, so they can failover the management VM for the dedicated management host.

  2. Verify that the compute host in the cluster has sufficient spare capacity to handle at least one node being down. If not, verify that the customer can accept the workload.

  3. Follow the VMware standard practice to upgrade the host. For supported versions, see the UCP Advisor 2.7 Release Notes here: https://knowledge.hds.com/Documents/Converged/UCP_Advisor.

    Recommended patch: https://kb.vmware.com/s/article/2151102.

    For details on using the update manager for patch updates, see: https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.update_manager.doc/GUID-F7191592-048B-40C7-A610-CFEE6A790AB0.html.

Performing a final validation and cleanup

Verify that each device on the list you created when preparing for the upgrade is up and running.

Repeat the visual validation of vSphere for compliance and other issues to ensure consistency of the UCP Advisor system before and after the upgrade. Remove the VM snapshots taken before starting the upgrade.

Troubleshooting

Tips are provided for troubleshooting the upgrade process.

Using a snapshot to recover a previous VM version

You can restore a previous VM version from the snapshot taken during the upgrade process.

NoteRestoring snapshots can cause the host to go out of synchronization.

Procedure

  1. Power off all of the VMs according to the order specified in Taking VM snapshots.

  2. Restore all of the VMs based on the snapshot procedure described in Taking VM snapshots.

  3. Power the VMs back on in the following order:

    1. vSphere VM (wait approximately 15 minutes after powering on for all services to start up)

    2. vRealize Log Insight (VRLI , if installed)

    3. vRealize Orchestrator (VRO, if installed)

    4. Hitachi Automation Director (HAD, if installed)

    5. UCP Advisor Gateway VM

    6. UCP Advisor controller VM (wait 5 minutes)

    7. Wait 1-2 minutes before starting the next VM.

Fixing host synchronization errors

When reverting to a VM snapshot, vCenter can generate an error indicating that the host cannot be synchronized. You can fix these synchronization errors using the following procedure.

  1. From the vSphere Web Client, right-click the host, then click Connection > Disconnect.

  2. Follow the prompts, and then wait for the current task to complete.

  3. Click Connection > Connect.

  4. Provide the appropriate credentials to reconnect.

    The synchronization error message should be resolved.

Upgrading firmware

This appendix describes how to manually upgrade the DS120 and DS220 firmware.

Upgrading the DS120 or DS220 firmware

UCP Advisor 2.7 is currently only certified to run version 4.23.06, follow these steps to upgrade to 4.23.06 from 3.16.06 or 3.75.06 using Toolkit.

NoteThe Toolkit detects all server nodes via IPv6 link local addresses and flashes the BIOS/BMC/CPLD/HBA/NIC. It also backs up the BIOS and BMC settings and reapplies it to the server nodes after flashing to preserve settings.

Procedure

  1. Start a Remote Desktop session, then log on to the UCP Advisor controller VM.AppendixA_RemoteDesktopConnection

  2. If not already mounted, mount the UCP MediaBundle ISO as F.

  3. Open a new administrator command window, and then copy the UCPToolKit software to a temp directory.

    md "c:\Temp\UCPToolKit"
    cd "c:\Temp\UCPToolKit"
    xcopy /cedy F:\Tool\UCPToolKit
    
  4. Navigate to the C:\Temp\UCPToolKit\Requirements folder.Navigate to UCPToolKit requirements folder.

  5. Install vcredist_x86.AppendixA Install vcredist x86

  6. Navigate to C:\Temp\UCPToolKit\WinPython-64bit-3.6.3.0Zero.

  7. Right-click on WinPython Command Prompt and select Run as administrator.AppendixA_Right-click on WinPython Command Prompt and select Run as administrator

  8. On the command line, enter python firmware.py.

  9. Enter the number of nodes in the rack.

  10. Enter y for flashing existing nodes in a system.

  11. Enter the username of the BMC.

  12. Enter the password of the BMC.AppendixA Enter the password of the BMCs

  13. Verify you have entered the correct credentials and enter y.

  14. When asked which appliance to install, type 2.0.

  15. NoteOnly use this option; this upgrade supports no other option.
    AppendixA_When asked which appliance to install type 2.0
  16. Press Enter to continue.

  17. After the detection of nodes is complete, press Enter to continue. Only the powered off nodes will be updated.AppendixA_Once detection is completed, hit enter to continue

  18. Verify the BIOS, BMC, CPLD, HBA, or NIC firmwares are updated on the servers.AppendixA This will update the BIOS BMC CPLD HBA NIC firmware’s on the servers.

  19. Log on to UCP Advisor and refresh all servers to make sure the firmware version is 4.23.06.AppendixA_Now login to UCP Advisor and refresh all servers to make sure the firmware version is shown 4.23.06

  20. Delete the UCPToolKit folder under c:\Temp after all the blades are successfully upgraded.