Installing Cisco UCS Director on Microsoft Hyper-V

Cisco UCS Director for Microsoft Hyper-V

Cisco UCS Director can be deployed in a Hyper-V environment.


Note

  • We recommend to deploy Cisco UCS Director on the Hyper-V managed host, rather than the SCVMM console.

  • The appliance and bootup logs are located in the /var/log/ucsd directory. install.log contains the one time appliance installation logs. bootup.log contains the appliance boot-up sequence information, such as startup messages for the database and infrastructure services.

Prerequisites

Before you install Cisco UCS Director for Microsoft Hyper-V, complete the following steps:

  • Install Microsoft System Center Virtual Machine Manager (SCVMM).

    If you only have a Hyper-V environment, Cisco UCS Director must be deployed on a Hyper-V host.

  • Configure an SCVMM user account with administrator privileges for Cisco UCS Director.

  • Download the Cisco UCS Director software from the Download Software area on Cisco.com.

  • Extract the Cisco UCS Director VHD and db files from the digitally signed zip file to your local disk. See Digitally Signed Images.

Minimum System Requirements for a Single Node Setup on Microsoft Hyper-V

The following tables provide the minimum system requirements and recommended configurations for a single-node setup of Cisco UCS Director. Cisco recommends a single-node setup for installations of up to 5000 VMs.

The minimum system requirements depend on how many VMs you plan to manage. It is recommended to deploy a Cisco UCS Director VM on a local datastore with a minimum of 25 Mbps I/O speed, or on an external datastore with a minimum of 50 Mbps I/O speed.


Note

  • For optimal performance, reserve additional CPU and memory resources. It is recommended to reserve the following resources in addition to the minimum system requirements listed in the tables below:

    • CPU resources of more than or equal to 3000 MHz, and memory reservation of more than or equal to 1 GB.

    • Add more vCPUs if the Cisco UCS Director VM’s CPU usage is consistently high.

The values given in the following tables must be defined in the VMware vCenter. The Cisco UCS Director allows the Shelladmin to define the number of required VMs in the Standalone node. Based on the VM counts specified as an input in the Shelladmin option 35 (Configure Scale Setup), the Cisco UCS Director automatically updates the memory allocation and database configuration values as per the system requirements without manual intervention.

For information about minimum system requirements for a multi-node setup, see Cisco UCS Director Multi-Node Installation and Configuration Guide.

Up to 2000 VMs

Table 1. Minimum System Requirements for up to 2000 VMs
Element Minimum Supported Requirement

vCPU

4

Memory

16 GB

Primary Disk (Hard Disk 1)

100 GB

Secondary Disk (Hard Disk 2)

100 GB

Disk Read I/O Bandwidth

4 MBps

Disk Write I/O Bandwidth

4 MBps

Up to 5000 VMs

Table 2. Minimum System Requirements for up to 5000 VMs
Element Minimum Supported Requirement

vCPU

8

Memory

20 GB

Primary Disk (Hard Disk 1)

100 GB

Secondary Disk (Hard Disk 2)

100 GB

Disk Read I/O Bandwidth

4 MBps

Disk Write I/O Bandwidth

4 MBps
Table 3. Minimum Requirements for Database Configuration
Element Minimum Supported Configuration

thread_cache_size

100

max_connections

1000

innodb_lock_wait_timeout

100

query_cache_size

128 MB

innodb_buffer_pool_size

2 GB

max_connect_errors

10000

connect_timeout

20

innodb_read_io_threads

64

innodb_write_io_threads

64


Important

Upon successful definition of required VMs in the Shelladmin option, the inframgr memory allocation and database configuration values are automatically updated in the /opt/infra/bin/inframgr.env and /etc/my.cnf files respectively. In order for the modifications to take effect, the Shelladmin restarts the database and services through Shelladmin options. For more information, see Cisco UCS Director Shell Guide.

Installing Cisco UCS Director on Microsoft Hyper-V

Before you begin

  • System administrator privileges for Hyper-V are required.

  • Microsoft Windows 2019 with Hyper-V Role or Windows 2022 with Hyper-V Role are required to deploy this release of Cisco UCS DirectorCisco UCS Director.

Procedure

Step 1

Log into the Hyper-V host.

Step 2

Choose Start > Administrative Tools to open Hyper-V Manager.

Step 3

In the Hyper-V Manager dialog box, choose Action > New Virtual Machine.

Step 4

In the Before You Begin pane, click Next.

Step 5

In the Name and Location pane, do the following:

  1. In the Name field, edit the default VM name.

  2. Check the Store the virtual machine in a different location checkbox and specify the alternate location.

  3. Click Next.

Step 6

In the Select Generation pane, choose Generation2.

With Generation2, this virtual machine provides the same virtual hardware to the virtual machine as in previous versions of Hyper-V.

Step 7

In the Assign Memory pane, enter the amount of memory to allocate to this VM (16 GB minimum) and click Next.

Step 8

In the Configure Networking pane, click Next to accept the default option in the Connection field.

The default option is Not Connected.

Step 9

In the Connect Virtual Hard Disk pane, choose Attach a virtual disk later and click Next.

Step 10

In the Completing the New Virtual Machine Wizard pane, verify the settings and click Finish.

Step 11

In the Navigation pane, right-click the new VM and choose Settings.

Step 12

In the Security pane, select the Enable Secure Boot check box and choose the template Microsoft UFFI Certificate Authority.

Step 13

In the Navigation pane, choose SCSI Controller.

Step 14

In the SCSI Controller pane, choose Hard Drive and click Add.

Note

 
You must add two hard drives since we have two VHD files separately for OS and application, and for database.

Step 15

In the Hard Drive pane, choose the downloaded Cisco UCS Director .vhd file and click OK.

Step 16

Inspect the virtual hard drive properties.

Step 17

In the Navigation pane, choose Memory.

Step 18

In the Memory pane, enter the recommended value (minimum 16 GB).

Step 19

In the Navigation pane, choose Processor.

Step 20

In the Processor pane, enter the recommended value (4 vCPU).

Step 21

Remove the network adapter that was created when you created the new VM.

Step 22

In the Navigation pane, choose Add Hardware.

Step 23

In the Add Hardware pane, choose Network Adapter and click OK.

Step 24

In the Navigation pane, choose the network adapter.

Step 25

In the Network Adapter pane, in the Network field, choose your network and click OK.

Step 26

Verify that you have allocated sufficient vCPU and Memory resources. For the minimum resource requirements, see Minimum System Requirements for a Single Node Setup on Microsoft Hyper-V.

Step 27

Power on the VM.

Optionally you can configure network properties from the shelladmin.

By default, this version of Microsoft Hyper-V uses DHCP for address allocation. If you want to use a static IP address instead of DHCP, you can change this configuration through ShellAdmin.

Step 28

After the appliance has booted up, copy and paste the Cisco UCS Director IP address that is displayed into a supported web browser to access the Login page.

Step 29

At the login prompt, enter admin for username and admin for the password to log into Cisco UCS Director.

Note

 
We recommend that you change the default admin password after this initial login.

What to do next

Update your license.