How to identify and correct issues with Unitrends Hyper-V services not starting or preventing adding environments through the UVB Web interface
RabbitMQ credentials are not created or are incorrectly created during installation of Unitrends Hyper-V Services on the Hyper-V host. You may encounter the following symptoms:
- Error starting Unitrends Hyper-V Services
- Cannot add an environment in the UVB web interface
On the Hyper-V host, start a command line editor. The rabbitmqctl.bat file is in the “sbin” folder of the RabbitMQ installation, typically:
C:\Program Files (x86)\RabbitMQ Server\rabbitmq_server-3.1.4\sbin\rabbitmqctl.bat
Enter the following commands:
> rabbitmqctl list_users
The custom user entered in the Installer/Admin Tool should be in this list. A user called ‘phd’ should also be in this list. If either is missing, the configuration did not save correctly.
- If this command returns an error that starts Failed to create cookie file 'u:/.erlang. Check your value for %HOMEDRIVE%. if it is not equal to C: you will need to reinstall with a user who's HOMEDRIVE= C: This is a known Erlang/RabbitMQ issue.
- You may also be able to clear the error by copying the file .erlang.cookie manually from %SystemRoot% to %HOMEDRIVE%%HOMEPATH%.
> rabbitmqctl list_permissions
Both the custom user and the ‘phd’ user should have permissions on vhost “/” (see screen shot below). If either user does not have the appropriate permissions, the configuration did not save correctly.
> rabbitmqctl add_user user user
If missing, add the custom user.
****If the ‘phd’ user is missing, You must use the Windows uninstaller to uninstall the Unitrends Hyper-V Services. Refer to the Installation Guide for more information about the uninstall process. Once completely removed, begin the installation process again exactly as described in the Installation Guide.***
> rabbitmqctl set_permissions .* .* .* (note space between quotes)
Set any permissions that are missing.
Example dialog adding user fred