Installing a Hyper-V VALT Virtual Appliance

From IVS Wiki
Jump to: navigation, search

Download the Hyper-V Appliance

  1. Click on the link below to download the Hyper-V virtual appliance:
    Server 2012+: https://files.ipivs.com/VM_Templates/HyperV/5.7/HyperV-Valt-5.7.zip
  2. Extract ValtHyperV.zip.

Load the Template on Hyper-V

  1. Open Hyper-V Manager.
  2. Right click on your Hyper-V Server and select Import Virtual Machine from the menu.
    HyperV1.png
  3. Click Next.
    HyperV2.png
  4. Click Browse.
    HyperV3.png
  5. Browse to the folder where you extracted the zip file, and click on it.
    HyperV4.png
  6. Click Select Folder.
  7. Click Next.
    HyperV5.png
  8. Select the Virtual Machine to import.
    HyperV6.png
  9. Click Next
  10. Select Copy the Virtual Machine.
    HyperV7.png
  11. Click Next.
  12. Review the values for the Virtual Machine Configuration Folder, Checkpoint Store, and Smart Paging Folder.
    1. If changes need to be made, check the box for Store the virtual machine in a different location.
    2. Fill the appropriate values in each of these fields.
    HyperV8.png
  13. Click Next.
  14. Review the values for the location to store the virtual hard disks. If changes need to be made, update the value.
    HyperV9.png
  15. Click Next.
  16. Review the final configuration.
    HyperV10.png
  17. If everything is correct, click Finish.

Configure Virtual Hardware

  1. Right click on the virtual machine in Hyper-V Manager.
  2. Select Settings from the menu.
    HyperV11.png
  3. Adjust the memory and CPU of the appliance to support the number of cameras. The table below contains IVS' recommended specs.
Cameras Cores Memory
5 4 8 GB
15 8 16 GB
25 16 32 GB
50 32 64 GB

Click OK once all changes have been made.

You can also adjust the size of the data drive. The default size is 2 TB. If you adjust the size of the virtual drive, you will also need to adjust the size of the partition.

Configure IP Address

You must complete these steps, even if you have already specified an IP address for the server or want to use DHCP. This will configure the VALT software with the correct IPs.

For more in depth information on network configuration options, see the Command Line Menu Guide.

  1. Access the VALT Server Command Line Menu.
    This menu is presented automatically at the VALT server terminal. It can also be accessed via ssh by running the following command from the prompt:
    sudo /usr/local/valt/bin/Menu
    Install54.png
  2. Enter Option 1 for Network Configuration.
    Install57.png
  3. Enter Option 2 for Set IPs.
    Install58.png
  4. Select your interface from the options listed.
    Install59.png
  5. Select Static or DHCP.
    For this example we will select DHCP
  6. Install60.png
  7. Type Y when to configure this interface for client access.
  8. Install61.png
  9. Enter the IP Address of the interface when prompted.

IP Address changes will not take effect until the server has been rebooted.

Configure a unique machine id

  1. Access the VALT Server Command Line Menu.
  2. Choose Option 6 to drop to a shell
  3. Type the following and press enter:
    sudo rm /etc/machine-id
  4. Type the following and press enter:
    sudo sytemd-machine-id-setup

Install the Wowza Streaming Engine License

  1. Open a web browser and navigate to http://IPAddress:8088
    Replace IPAddress with the IP Address of the server.
    Install47.png
  2. Click Skip Intro.
    Install48.png
  3. Sign in using the username and password defined earlier for Wowza.
    Install49.png
  4. Copy and paste the Wowza License Key into the box provided.
    If you are not prompted for a key:
    1. Click on the Server tab.
    2. Click the Edit button.
    3. Copy and paste the Wowza License Key into the box provided.
    You cannot use a Wowza USB Key with Hyper-V. You must use an non-usb Wowza license.
  5. Click Save.
  6. You will be returned to the sign in page.
    If you are not returned to the sign in page, click Sign Out in the upper right corner of the page.
  7. Sign back in to the Wowza web console.
    If you are returned to the license page, the license was not accepted.
    • Check to make sure the USB key is inserted.
    • Check to make sure there are no typos or leading or trailing spaces.
    • Reboot the server
    Install50.png
  8. Click on Performance Tuning > Java Settings.
    Install51.png
  9. Click Edit.
    Install52.png
  10. Select Production Level.
  11. Click Save.
    Install53.png
  12. You will be prompted to restart, click Restart Now.

Install the VALT Camera License

  1. Access the VALT Server Command Line Menu.
    This menu is presented automatically at the VALT server terminal. It can also be accessed via ssh by running the following command from the prompt:
    sudo /usr/local/valt/bin/Menu
    Install54.png
  2. Enter Option 3 for Valt Configuration.
    Install55.png
  3. Enter Option 1 for Install License.
    Install56.png
  4. Enter your license provided by IVS, and press Enter.
  5. You will be returned to the menu.

Set the Timezone

  1. Connect to the VALT appliance via SSH or from the terminal menu, exit to the shell.
  2. From the command line, type in the following, and press Enter:
    sudo dpkg-reconfigure tzdata
    49.jpg
  3. Select your Country.
    45.jpg
  4. Select your Time Zone.
    46.jpg
  5. From the command line, type in the following, and press Enter:
    sudo service apache2 restart
  6. From the command line, type in the following, and press Enter:
    sudo service WowzaStreamingEngine restart
    48.jpg

Accessing VALT from a Web Broweser

Note that you should use the IP address you used from when you configured the IP address up above

  1. Open a web browser
  2. Type the IP address, or domain name of your VALT server into the URL bar
    • If you do not know your IP address or domain name, ask your local VALT admin.
    Type VALT URL.gif
  3. You should now be at your VALT login screen
    VALT Login Screen.png