# Installing the VM Essentials manager

## About this task

Deploy the VM Essentials manager virtual appliance in one of your HVM hosts. The VM Essentials virtual appliance is delivered inside an ISO (**HPE\_VM\_Essentials\_SW\_image\_´\*\*\*\*\*.iso**) containing the needed .qcow2 file; you can either upload the qcow2 file to your HVM host or upload the complete iso and mount it. This example will run you through the ISO method.

## Procedure

1. Upload the **HPE\_VM\_Essentials\_SW\_image\_´\*\*\*\*\*.iso** downloaded from [My HPE Software Center](https://myenterpriselicense.hpe.com/cwp-ui/product-details/HPE_VME_EVAL/-/sw360_hpe_internal) using your preferred SCP client.

   NOTE

   There are multiple SCP client options available for Windows client machines.
2. Mount the ISO to a path in your HVM host system:

   ```
   ```
    sudo mount -o loop HPE_VM_Essentials_SW_image_v8.0.12_S5Q83-11039.iso /media
   ```
   ```

   NOTE

   - The indicated filename might be different, this is dictated by your download.
   - The mount point can be any one you choose, /media is used as an example.
3. Enter `sudo hpe-vm` to open the hpe-vm console, and select **<Install VME Manager>**.
4. Fill in the required information.

   ![VM Essentials manager installation-1](https://support.hpe.com/hpesc/public/api/document/sd00007332en_us/GUID-06123BB1-07B2-42F6-B159-50527015E8AE-high.png)
5. When filling the information, consider the following guidelines:

   - Use the IP address that will be configured for the VM Essentials manager
   - For DNS Server, if multiple entries are needed, a comma-delimited list may be added. Bear in mind, the installer does not currently validate for the proper delimiter. This will be fixed in a future release but for now the user must validate the delimiter for themselves.
   - The appliance URL should be resolvable via DNS (including related PTR record) from the hosts to enable communications between them and the VM Essentials manager.
   - The username is the user with admin privilege that will be used to login to the manager’s CLI.
   - For the Image URI, you can select and browse to the qcow2 file in the ISO you mounted previously

     ![VM Essentials manager installation-2](https://support.hpe.com/hpesc/public/api/document/sd00007332en_us/GUID-42C9D685-B588-4D7F-8D59-B0BEB4DCD0AD-high.png)
   - If your VM Essentials manager will use the same network for management access as the host’s management network, select the same vlan tagged network interface you configured for the HVM host.

   NOTE

   Leave the **Use Compute VLAN** box unchecked unless you want your VM Essentials manager to use a different network than the management one.
6. Wait for the installation to finish.

   ![VM Essentials manager installation-3](https://support.hpe.com/hpesc/public/api/document/sd00007332en_us/GUID-1C575100-EF58-412A-8997-C151B4441CB2-high.png)

   NOTE

   At a certain phase in the install process, you’ll see a message in the progress bar modal stating “Starting Morpheus Services…”. At this point, you can direct a web browser to the appliance URL and see if you can access the appliance. If you get a response returned, even if it is just telling you the appliance is still loading, that is a good sign the web server is installed and things are working even if your progress bar seems to get stuck at a high percentage.

   The exact time for this installation to complete is highly dependent on the amount of compute available, the size of the network pipe, and the level of network congestion. It is common for this process to take long enough for the "Morpheus is Loading" graphic to change to a timeout graphic. This is not an indicator that the process has failed. If there are no other failure indicators, allow at least an hour before considering the installation to be irrecoverably stuck (though it would be very rare for the process to take anywhere near that length of time). To view the setup logs, run the `sudo morpheus-ctl tail morpheus-ui` command from the manager VM through SSH.
