VHD: Installing the Microsoft Hyper-V Image

The first step to installing Turbonomic is to deploy the VM that will host the platform.

For Hyper-V environments, IBM delivers a Hyper-V image for each quarterly release. If you want to run Turbonomic on a Hyper-V VM, you can install the Quarterly Release, and then update to a later point release if necessary.

Note:

For minimum requirements, IBM recommends 128 GB of memory for the VM that hosts Turbonomic. However, if you plan to manage a smaller environment (10,000 VMs or less), you can install on a VM that provides 64 GB of memory. (See Minimum Requirements).

If you plan to install a VM with 64 GB of memory, then you must modify the default for VM memory. (See Deploy the Turbonomic VM).

To install Turbonomic:

  1. Download the Turbonomic installation package.

    The email you received from IBM includes links to the Turbonomic download pages. You can get the installation package from there.

  2. Expand the .zip file and copy the contents, which includes the Virtual Machine image, to your Hyper-V server (either to your cluster shared volume or to a local hard drive).

  3. Use the Import Virtual Machine Wizard in the Hyper-V Manager to import the Virtual Machine into your environment.

  4. Make sure your virtual network adapter is connected to the correct virtual network.

  5. Ensure the Turbonomic instance will have sufficient memory.

    IBM recommends that you use static memory for your Turbonomic instance. However, you can specify static or dynamic memory for the instance. By default, the installation sets static memory to128 GB.

  6. Start the Turbonomic appliance and record its IP address.

  7. Set up the Turbonomic System Administrator account.

    1. Log into the VM's Hyper-V console with the following default credentials:

      • Username: turbo

        Do not use the account name, root.

      • Password: vmturbo

        Then, you will be prompted to enter a new password.

    2. Enter your new password.

      The new password must comply with the strong password policy (a mixture of uppercase and lowercase letters, numbers, and a symbol). Only you will know this new password.

      Note:

      Be sure to save the changes account credentials in a safe place. For security reasons, this is the only account that can access and configure the Turbonomic VM.

    3. Enter your new password again to verify it.

  8. Update the root password.

    The platform uses the root account for certain processes, such as rolling up log messages in /var/log/messages. To ensure the account credentials are current, you must change the password:

    1. Open a SuperUser session.

      • In the remote console, enter su -

      • At the password prompt, enter the default password: vmturbo

    2. Reset a new password.

      After you log in as root with the default password, the system prompts you for a New password. This new password must comply with the strong password policy (a mixture of upper- and lower-case letters, numbers, and a symbol). Only you will know this new password.

    3. Exit the SuperUser session.

      Enter exit.

  9. Set up the static IP address.

    Operation and management of the Turbonomic platform both require a static IP address for the VM. The installed VM includes the ipsetup script to perform this task. To run the script, run the following command:

    sudo /opt/local/bin/ipsetup

    When the script runs, it requests the following inputs. Proxy servers are not supported with the secure client so they cannot be configured.

    Note:

    Provide values for these fields; otherwise, the installation can fail or your VM can be unreachable.

    • Required: Do you want to use DHCP or set a static IP...

      Choose static

    • Required: Please enter the Hostname for this machine

    • Required: Please enter the IP Address for this machine

    • Required: Please enter the network mask for this machine

    • Required: Please enter the Gateway address for this machine

    • Required: Enter DNS Server(s) IP Address for this machine

    • Required: Do you want to configure a proxy server? (y/n)

      Choose n

    Make a note of the IP address that you provide.

  10. Enable the NIC for the installed VM.

    The Turbonomic instance configuration includes one NIC, but it is not enabled or connected to a network. Display the NIC in the Hyper-V Manager and enable it.

  11. Perform other necessary configuration steps, and then install the Turbonomic components.

    To perform the required and important configuration steps for the Turbonomic instance, see General Configuration Tasks.

    To install the Turbonomic components, see Deploying the Turbonomic Components.