Difference between revisions of "Deprecated Page - Installing a VMWare Virtual Appliance"

From IVS Wiki
Jump to: navigation, search
(Download the OVF Template)
Line 7: Line 7:
 
== Load the Template on vSphere ==
 
== Load the Template on vSphere ==
  
# Open vSphere Client
+
# Open vSphere Client.
# Click on File
+
# Click on '''File'''.
 
#: [[File:VMWare1.png]]
 
#: [[File:VMWare1.png]]
# Select Deploy OVF Template from the menu.
+
# Select '''Deploy OVF Template''' from the menu.
 
#: [[File:VMWare2.png]]
 
#: [[File:VMWare2.png]]
# Click on Browse
+
# Click on '''Browse'''.
 
#: [[File:VMWare3.png]]
 
#: [[File:VMWare3.png]]
 
# Browse to where you extracted the zip file.
 
# Browse to where you extracted the zip file.
# Select the Valt.ovf file.
+
# Select the '''Valt.ovf''' file.
# Click Open
+
# Click '''Open'''.
 
#: [[File:VMWare4.png]]
 
#: [[File:VMWare4.png]]
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare5.png]]
 
#: [[File:VMWare5.png]]
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare6.png]]
 
#: [[File:VMWare6.png]]
# Enter a name for your Valt appliance
+
# Enter a name for your Valt appliance.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare7.png]]
 
#: [[File:VMWare7.png]]
 
# Select your disk provisioning
 
# Select your disk provisioning
 
#: ''Thin Provisioning Recommended''
 
#: ''Thin Provisioning Recommended''
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare8.png]]
 
#: [[File:VMWare8.png]]
 
# Select the network the appliance should be connected to.
 
# Select the network the appliance should be connected to.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare9.png]]
 
#: [[File:VMWare9.png]]
# Click Finish
+
# Click '''Finish'''.
  
 
== Configure Virtual Hardware ==
 
== Configure Virtual Hardware ==
  
# Right click on the virtual machine in vSphere Client
+
# Right click on the Virtual Machine in vSphere Client.
# Select Edit Settings from the menu
+
# Select '''Edit Settings''' from the menu.
 
#: [[File:VMWare11.png]]
 
#: [[File:VMWare11.png]]
 
# Adjust the memory and CPU of the appliance to support the number of cameras. The table below contains IVS' recommended specs.
 
# Adjust the memory and CPU of the appliance to support the number of cameras. The table below contains IVS' recommended specs.
Line 64: Line 64:
 
|}
 
|}
  
Click OK once all changes have been made.
+
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 [[Resize Partition|adjust the size of the partition]].''
 
''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 [[Resize Partition|adjust the size of the partition]].''
  
 
== Add the USB Key to the VM (Optional) ==
 
== Add the USB Key to the VM (Optional) ==
There are two types of Wowza licenses. By default IVS will provide a Wowza license key and a USB key. The steps below are to add the USB key to the VM. If you want to use the VM in a highly available environment, IVS can provide a license only key that does not require a USB key. Please make sure to request this at the time of order.
+
There are two types of Wowza licenses. By default, IVS will provide a Wowza license key and a USB key. The steps below are to add the USB key to the VM. If you want to use the VM in a highly available environment, IVS can provide a license-only key that does not require a USB key. Please make sure to request this at the time of order.
  
# Right click on the virtual machine in vSphere Client
+
# Right click on the Virtual Machine in vSphere Client.
 
#: [[File:VMWare10.png]]
 
#: [[File:VMWare10.png]]
# Select Edit Settings from the menu
+
# Select '''Edit Settings''' from the menu.
 
#: [[File:VMWare11.png]]
 
#: [[File:VMWare11.png]]
# Click Add
+
# Click '''Add'''.
 
#: [[File:VMWare12.png]]
 
#: [[File:VMWare12.png]]
# Select USB Controller
+
# Select '''USB Controller'''.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare13.png]]
 
#: [[File:VMWare13.png]]
# Select EHCI+UHCI
+
# Select '''EHCI+UHCI'''.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare15.png]]
 
#: [[File:VMWare15.png]]
# Click Finish
+
# Click '''Finish'''.
# Click Add
+
# Click '''Add'''.
 
#: [[File:VMWare12.png]]
 
#: [[File:VMWare12.png]]
# Select USB Controller
+
# Select '''USB Controller'''.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare14.png]]
 
#: [[File:VMWare14.png]]
# Select xHCI
+
# Select '''xHCI'''.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare15.png]]
 
#: [[File:VMWare15.png]]
# Click Finish
+
# Click '''Finish'''.
# Click Add
+
# Click '''Add'''.
 
#: [[File:VMWare16.png]]
 
#: [[File:VMWare16.png]]
# Select USB Device
+
# Select '''USB Device'''.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare17.png]]
 
#: [[File:VMWare17.png]]
# Select Future Devices HID UNIKEY
+
# Select '''Future Devices HID UNIKEY'''.
# Click Next
+
# Click '''Next'''.
 
#: [[File:VMWare18.png]]
 
#: [[File:VMWare18.png]]
# Click Finish
+
# Click '''Finish'''.
# Click OK
+
# Click ''''OK'''.
  
 
== Configure IP Address ==
 
== 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
+
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 Valt Command Line Menu page.
 
For more in depth information on network configuration options, see the Valt Command Line Menu page.
Line 111: Line 111:
 
# Access the Valt Server Command Line Menu.
 
# 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:''
 
#: ''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'''
+
<pre>sudo /usr/local/valt/bin/Menu</pre>
 
#: [[File:Install54.png]]
 
#: [[File:Install54.png]]
# Enter Option 1 for '''Network Configuration'''
+
# Enter Option 1 for '''Network Configuration'''.
 
#: [[File:Install57.png]]
 
#: [[File:Install57.png]]
# Enter Option 2 for '''Set IPs'''
+
# Enter Option 2 for '''Set IPs'''.
 
#: [[File:Install58.png]]
 
#: [[File:Install58.png]]
 
# Select your interface from the options listed.
 
# Select your interface from the options listed.
 
#: [[File:Install59.png]]
 
#: [[File:Install59.png]]
# Select Static or DHCP.
+
# Select '''Static''' or '''DHCP'''.
 
#: ''For this example we will select DHCP''
 
#: ''For this example we will select DHCP''
 
# [[File:Install60.png]]
 
# [[File:Install60.png]]
Line 132: Line 132:
 
#: Replace '''''IPAddress''''' with the IP Address of the server.
 
#: Replace '''''IPAddress''''' with the IP Address of the server.
 
#: [[File:Install47.png]]
 
#: [[File:Install47.png]]
# Click Skip Intro.
+
# Click '''Skip Intro'''.
 
#: [[File:Install48.png]]
 
#: [[File:Install48.png]]
 
# Sign in using the username and password defined earlier for Wowza.
 
# Sign in using the username and password defined earlier for Wowza.
Line 138: Line 138:
 
# Copy and paste the Wowza License Key into the box provided.  
 
# Copy and paste the Wowza License Key into the box provided.  
 
#: If you are not prompted for a key:
 
#: If you are not prompted for a key:
#:# Click on the '''Server''' tab
+
#:# Click on the '''Server''' tab.
 
#:# Click the '''Edit''' button.
 
#:# Click the '''Edit''' button.
 
#:# Copy and paste the Wowza License Key into the box provided.  
 
#:# Copy and paste the Wowza License Key into the box provided.  
 
#: ''If you were provided with a USB key by IVS, the USB key must already be inserted into the appliance.''
 
#: ''If you were provided with a USB key by IVS, the USB key must already be inserted into the appliance.''
# Click Save
+
# Click '''Save'''.
 
# You will be returned to the sign in page.
 
# 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.''
 
#: ''If you are not returned to the sign in page, click '''Sign Out''' in the upper right corner of the page.''
Line 151: Line 151:
 
#:* ''Reboot the server''
 
#:* ''Reboot the server''
 
#: [[File:Install50.png]]
 
#: [[File:Install50.png]]
# Click on Performance Tuning > Java Settings
+
# Click on '''Performance Tuning''' > '''Java Settings'''.
 
#: [[File:Install51.png]]
 
#: [[File:Install51.png]]
# Click Edit
+
# Click '''Edit'''.
 
#: [[File:Install52.png]]
 
#: [[File:Install52.png]]
# Select Production Level
+
# Select '''Production Level'''.
# Click Save
+
# Click '''Save'''.
 
#: [[File:Install53.png]]
 
#: [[File:Install53.png]]
# You will be prompted to restart, click Restart Now
+
# You will be prompted to restart, click '''Restart Now'''.
  
 
== Install the Valt Camera License ==
 
== Install the Valt Camera License ==
 
# Access the Valt Server Command Line Menu.
 
# 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:''
 
#: ''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'''
+
<pre>sudo /usr/local/valt/bin/Menu</pre>
 
#: [[File:Install54.png]]
 
#: [[File:Install54.png]]
# Enter Option 3 for '''Valt Configuration'''
+
# Enter Option 3 for '''Valt Configuration'''.
 
#: [[File:Install55.png]]
 
#: [[File:Install55.png]]
# Enter Option 1 for '''Install License'''
+
# Enter Option 1 for '''Install License'''.
 
#: [[File:Install56.png]]
 
#: [[File:Install56.png]]
# Enter your license provided by IVS and press enter.
+
# Enter your license provided by IVS and press Enter.
 
# You will be returned to the menu.
 
# You will be returned to the menu.
  
 
== Set the Timezone ==
 
== Set the Timezone ==
 
# Connect to the Valt appliance via SSH or from the terminal menu, exit to the shell.
 
# Connect to the Valt appliance via SSH or from the terminal menu, exit to the shell.
# From command line type '''sudo dpkg-reconfigure tzdata'''
+
# From command line type in the following, and press Enter: <pre>sudo dpkg-reconfigure tzdata</pre>
 
#:[[File:49.jpg]]
 
#:[[File:49.jpg]]
# Select your country
+
# Select your Country.
 
#:[[File:45.jpg]]
 
#:[[File:45.jpg]]
# Select your Time Zone
+
# Select your Time Zone.
 
#:[[File:46.jpg]]
 
#:[[File:46.jpg]]
# From command line type '''sudo service apache2 restart'''
+
# From command line type in the following, and press Enter: <pre>sudo service apache2 restart</pre>
# From command line type '''sudo service WowzaStreamingEngine restart'''
+
# From command line type in the following, and press Enter: <pre>sudo service WowzaStreamingEngine restart</pre>
 
#:[[File:48.jpg]]
 
#:[[File:48.jpg]]
  
 
== Accessing the Valt Server ==
 
== Accessing the Valt Server ==
To access the system open up a web browser (Chrome, Firefox, Internet Explorer, Safari) and point it to the DNS name (example: http://video.myschool.edu) or IP address (example: http://192.168.0.99) of the Valt server. Note the default IP address the servers ship with is 192.168.0.99.
+
To access the system open up a web browser (Chrome, Firefox, Internet Explorer, Safari), and point it to the DNS name (example: http://video.myschool.edu) or IP address (example: http://192.168.0.99) of the Valt server. Note that the default IP address the servers ship with is 192.168.0.99.
For all non-chrome browsers if adobe flash player is not already installed it will need to be.  (http://get.adobe.com/flashplayer/)  
+
For all Non-Chrome browsers, if Adobe Flash Player is not already installed, it will need to be.  (http://get.adobe.com/flashplayer/)  
  
 
[[File:Admin-1.jpg]]
 
[[File:Admin-1.jpg]]
Line 194: Line 194:
 
[[File:Admin-2.jpg]]
 
[[File:Admin-2.jpg]]
  
Based on your login information you may have access to any of the following sections: Observe, Record, Schedule, Upload and Admin as shown below.
+
Based on your login information, you may have access to any of the following sections: Observe, Record, Schedule, Upload and Admin as shown below.
  
 
[[File:Admin-3.jpg]]
 
[[File:Admin-3.jpg]]

Revision as of 16:17, 30 April 2019

Download the OVF Template

  1. Click on the link below to download the OVF Template for the Valt virtual appliance.
    VMWare 5.0 and above: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
  2. Extract the ValtVMWare.zip

Load the Template on vSphere

  1. Open vSphere Client.
  2. Click on File.
    VMWare1.png
  3. Select Deploy OVF Template from the menu.
    VMWare2.png
  4. Click on Browse.
    VMWare3.png
  5. Browse to where you extracted the zip file.
  6. Select the Valt.ovf file.
  7. Click Open.
    VMWare4.png
  8. Click Next.
    VMWare5.png
  9. Click Next.
    VMWare6.png
  10. Enter a name for your Valt appliance.
  11. Click Next.
    VMWare7.png
  12. Select your disk provisioning
    Thin Provisioning Recommended
  13. Click Next.
    VMWare8.png
  14. Select the network the appliance should be connected to.
  15. Click Next.
    VMWare9.png
  16. Click Finish.

Configure Virtual Hardware

  1. Right click on the Virtual Machine in vSphere Client.
  2. Select Edit Settings from the menu.
    VMWare11.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.

Add the USB Key to the VM (Optional)

There are two types of Wowza licenses. By default, IVS will provide a Wowza license key and a USB key. The steps below are to add the USB key to the VM. If you want to use the VM in a highly available environment, IVS can provide a license-only key that does not require a USB key. Please make sure to request this at the time of order.

  1. Right click on the Virtual Machine in vSphere Client.
    VMWare10.png
  2. Select Edit Settings from the menu.
    VMWare11.png
  3. Click Add.
    VMWare12.png
  4. Select USB Controller.
  5. Click Next.
    VMWare13.png
  6. Select EHCI+UHCI.
  7. Click Next.
    VMWare15.png
  8. Click Finish.
  9. Click Add.
    VMWare12.png
  10. Select USB Controller.
  11. Click Next.
    VMWare14.png
  12. Select xHCI.
  13. Click Next.
    VMWare15.png
  14. Click Finish.
  15. Click Add.
    VMWare16.png
  16. Select USB Device.
  17. Click Next.
    VMWare17.png
  18. Select Future Devices HID UNIKEY.
  19. Click Next.
    VMWare18.png
  20. Click Finish.
  21. Click 'OK.

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 Valt Command Line Menu page.

  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
  1. 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.

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.
    If you were provided with a USB key by IVS, the USB key must already be inserted into the appliance.
  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
  1. 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 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 command line type in the following, and press Enter:
    sudo service apache2 restart
  6. From command line type in the following, and press Enter:
    sudo service WowzaStreamingEngine restart
    48.jpg

Accessing the Valt Server

To access the system open up a web browser (Chrome, Firefox, Internet Explorer, Safari), and point it to the DNS name (example: http://video.myschool.edu) or IP address (example: http://192.168.0.99) of the Valt server. Note that the default IP address the servers ship with is 192.168.0.99. For all Non-Chrome browsers, if Adobe Flash Player is not already installed, it will need to be. (http://get.adobe.com/flashplayer/)

Admin-1.jpg

Log into the system with the proper username and password. (default: “admin” “admin”)

Admin-2.jpg

Based on your login information, you may have access to any of the following sections: Observe, Record, Schedule, Upload and Admin as shown below.

Admin-3.jpg