Hyper-V Agent Onboarding
Hyper-V Agent Onboarding overview
Requirements
- Must have access to Cloud.Red platform and permissions to download the needed VM template
- Must be able to upload the VM template to Hyper-V environment
- Must be able to create a virtual machine in the Hyper-V environment
- Must be able to access the created virtual machineâs console in the Hyper-V environment
- Must have the needed firewall rules deployed allowing access to the internet, access to your managed devices, etcâŚ
- Must have the agent names provided to you by your project manager
Cloud.Red Agent Deployment
- Download the OVA file via the agents tab in cloud.red
- Select downloads in the upper-right hand corner and be sure to select the OVA file
Deploy the VM template to your Hyper-V environment
- The VM template needs to be uploaded to the Hyper-V server, unzipped, and used to create the virtual machine
- When importing, it is suggested that you select the âcreate a new unique IDâ option in the wizard.
Power on the virtual appliance
- The virtual machine is now ready to be powered on.
Menu Shell
- Access the VMware console for the virtual machine
- Provide the credentials listed below
User: netadmin
Default Password: Will be provided by WTIT
Note: We strongly advise updating the default password for the ânetadminâ user to enhance security.
Once logged in, the GUI menu will be displayed.
The GUI menu provides a way for users to:
- Configure NTP: The Network Time Protocol (NTP) is a standard protocol used to synchronize computer clock times in a network. The âConfigure NTPâ option in the GUI menu allows users to set up or modify the NTP servers that the device will use to sync its internal clock.
- Configure Network: This option provides users the ability to set or modify network parameters like IP addresses, subnet masks, gateways, and hostname.
Disclaimer: If you are operating within AWS, Azure, or GCP environments, do NOT configure network settings!!! Any changes could lead to connectivity or functionality issues.
- Cloud-Init Network Toggle: The âToggle Cloud-Init Network settingsâ option allows users to enable or disable the Cloud-Initâs network configuration settings.
Disclaimer: If you are operating within AWS, Azure, or GCP environments, do NOT modify this cloud-init setting!!! Any changes could lead to connectivity or functionality issues.
- Reboot: This option allows users to safely restart the device.
- Change Password: This option allows users to modify the password for the ânetadminâ user profile.
- Quit: This option allows users to exit the menu, and log out of the ânetadminâ user.
Select the expands below for more information on each action.
Before Continuing validate the following is complete:
- The virtual applianceâs static IP address is correct.
- Cloud-Init is disabled.
- All Network Configurations are correct.
- NTP has been configured correctly.
- The password for Netadmin user has been updated.
If issues with onboarding the agent occur, take the following steps:
- Confirm that all Connectivity Requirements are met.
- Restart Cr Agent Service.
- Reboot the VM.
- If issues persist contact WorldTech IT.
Registering the Cloud.Red Agent
To register the device, all previous instructions must be complete and a user must be able to reach the agentâs private IP, over HTTPS on port 443, to register the Cloud.Red Agent.
Connect to the Agentâs HTTPS Console
In your web browser, visit the IP address of your VM.
Accept the potential security risk and continue (this will look different in different browsers)
Continue Registration
Follow one of the following methods:
Please contact WorldTech IT to complete the installation.