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

From IVS Wiki
Jump to: navigation, search
(Configure Virtual Hardware)
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
== Download the OVF Template ==
 
== Download the OVF Template ==
 
+
<div class="section">
 
# Click on the link below to download the OVF Template for the VALT virtual appliance.
 
# Click on the link below to download the OVF Template for the VALT virtual appliance.
#: VMWare 5.0: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
+
#: [https://files.ipivs.com/VM_Templates/VMWare/5.7/VMware7.0.zip VMWare 7.0]
#: VMWare 5.1: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
 
#: VMWare 5.5: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
 
#: VMWare 6.0: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
 
#: VMWare 6.5: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
 
#: VMWare 6.7: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
 
#: VMWare 6.7 U2: https://ivs.box.com/shared/static/6ob2q3b4ajjwoguibxicne65wxmyx2f9.zip
 
 
# Extract the .zip file
 
# Extract the .zip file
 +
</div>
  
 
== Load the Template on vSphere ==
 
== Load the Template on vSphere ==
Line 15: Line 10:
 
# Open vSphere Client.
 
# Open vSphere Client.
 
# Click on '''File'''.
 
# Click on '''File'''.
#: [[File:VMWare1.png]]
+
#: {{img | file = VMWare1.png}}
 
# Select '''Deploy OVF Template''' from the menu.
 
# Select '''Deploy OVF Template''' from the menu.
#: [[File:VMWare2.png]]
+
#: {{img | file = VMWare2.png}}
 
# Click on '''Browse'''.
 
# Click on '''Browse'''.
#: [[File:VMWare3.png]]
+
#: {{img | 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]]
+
#: {{img | file = VMWare4.png}}
 
# Click '''Next'''.
 
# Click '''Next'''.
#: [[File:VMWare5.png]]
+
#: {{img | file = VMWare5.png}}
 
# Click '''Next'''.
 
# Click '''Next'''.
#: [[File:VMWare6.png]]
+
#: {{img | file = VMWare6.png}}
 
# Enter a name for your VALT appliance.
 
# Enter a name for your VALT appliance.
 
# Click '''Next'''.
 
# Click '''Next'''.
#: [[File:VMWare7.png]]
+
#: {{img | file = VMWare7.png}}
 
# Select your disk provisioning
 
# Select your disk provisioning
 
#: ''Thin Provisioning Recommended''
 
#: ''Thin Provisioning Recommended''
 
# Click '''Next'''.
 
# Click '''Next'''.
#: [[File:VMWare8.png]]
+
#: {{img | 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]]
+
#: {{img | file = VMWare9.png}}
 
# Click '''Finish'''.
 
# Click '''Finish'''.
  
Line 44: Line 39:
 
# 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]]
+
#: {{img | 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.
  
:::{|class="wikitable"
+
:::<table class="simple_table">
!style="width:100px;" | Cameras
+
  <tr>
!style="width:100px;" | Cores
+
    <th style="width:100px>Cameras</th>
!style="width:100px;" | Memory
+
    <th style="width:100px>Cores</th>
|-
+
    <th style="width:100px>Memory</th>
|5
+
  </tr>
|4
+
  <tr>
|8 GB
+
    <td>2</td>
|-
+
    <td>2</td>
|15
+
    <td>4 GB</td>
|8
+
  </tr>
|16 GB
+
  <tr>
|-
+
    <td>5</td>
|25
+
    <td>4</td>
|16
+
    <td>8 GB</td>
|32 GB
+
  </tr>
|-
+
  <tr>
|50
+
    <td>15</td>
|32
+
    <td>8</td>
|64 GB
+
    <td>16 GB</td>
|-
+
  </tr>
|}
+
  <tr>
 +
    <td>25</td>
 +
    <td>16</td>
 +
    <td>32 GB</td>
 +
  </tr>
 +
  <tr>
 +
    <td>30</td>
 +
    <td>20</td>
 +
    <td>40 GB</td>
 +
  </tr>
 +
  <tr>
 +
    <td>40</td>
 +
    <td>24</td>
 +
    <td>48 GB</td>
 +
  </tr>
 +
  <tr>
 +
    <td>50</td>
 +
    <td>32</td>
 +
    <td>64 GB</td>
 +
  </tr>
 +
</table>
  
 
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]].''
+
{{Aside | content = 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) ==
 
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.
 
#: [[File:VMWare10.png]]
 
# Select '''Edit Settings''' from the menu.
 
#: [[File:VMWare11.png]]
 
# Click '''Add'''.
 
#: [[File:VMWare12.png]]
 
# Select '''USB Controller'''.
 
# Click '''Next'''.
 
#: [[File:VMWare13.png]]
 
# Select '''EHCI+UHCI'''.
 
# Click '''Next'''.
 
#: [[File:VMWare15.png]]
 
# Click '''Finish'''.
 
# Click '''Add'''.
 
#: [[File:VMWare12.png]]
 
# Select '''USB Controller'''.
 
# Click '''Next'''.
 
#: [[File:VMWare14.png]]
 
# Select '''xHCI'''.
 
# Click '''Next'''.
 
#: [[File:VMWare15.png]]
 
# Click '''Finish'''.
 
# Click '''Add'''.
 
#: [[File:VMWare16.png]]
 
# Select '''USB Device'''.
 
# Click '''Next'''.
 
#: [[File:VMWare17.png]]
 
# Select '''Future Devices HID UNIKEY'''.
 
# Click '''Next'''.
 
#: [[File:VMWare18.png]]
 
# Click '''Finish'''.
 
# Click '''OK'''.
 
  
 
== Configure IP Address ==
 
== Configure IP Address ==
Line 118: Line 97:
 
#: ''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:''
 
<pre>sudo /usr/local/valt/bin/Menu</pre>
 
<pre>sudo /usr/local/valt/bin/Menu</pre>
#: [[File:Install54.png]]
+
#: {{img | file = Install54.png}}
 
# Enter Option 1 for '''Network Configuration'''.
 
# Enter Option 1 for '''Network Configuration'''.
#: [[File:Install57.png]]
+
#: {{img | file = Install57.png}}
 
# Enter Option 2 for '''Set IPs'''.
 
# Enter Option 2 for '''Set IPs'''.
#: [[File:Install58.png]]
+
#: {{img | file = Install58.png}}
 
# Select your interface from the options listed.
 
# Select your interface from the options listed.
#: [[File:Install59.png]]
+
#: {{img | 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]]
+
# {{img | file = Install60.png}}
 
# Type '''Y''' when to configure this interface for client access.
 
# Type '''Y''' when to configure this interface for client access.
# [[File:Install61.png]]
+
# {{img | file = Install61.png}}
 
# Enter the IP Address of the interface when prompted.
 
# Enter the IP Address of the interface when prompted.
  
 
''IP Address changes will not take effect until the server has been rebooted.''
 
''IP Address changes will not take effect until the server has been rebooted.''
 +
=Configure a unique machine id=
  
== Install the Wowza Streaming Engine License ==
+
# Access the VALT Server Command Line Menu.
# Open a web browser and navigate to '''http://''IPAddress'':8088'''
+
# Choose Option 6 to drop to a shell
#: Replace '''''IPAddress''''' with the IP Address of the server.
+
# Type the following and press enter: <pre>sudo rm /etc/machine-id</pre>
#: [[File:Install47.png]]
+
# Type the following and press enter: <pre>sudo systemd-machine-id-setup</pre>
# Click '''Skip Intro'''.
 
#: [[File:Install48.png]]
 
# Sign in using the username and password defined earlier for Wowza.
 
#: [[File:Install49.png]]
 
# Copy and paste the Wowza License Key into the box provided.
 
#: If you are not prompted for a key:
 
#:# Click on the '''Server''' tab.
 
#:# Click the '''Edit''' button.
 
#:# 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.''
 
# Click '''Save'''.
 
# 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.''
 
# 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''
 
#: [[File:Install50.png]]
 
# Click on '''Performance Tuning''' > '''Java Settings'''.
 
#: [[File:Install51.png]]
 
# Click '''Edit'''.
 
#: [[File:Install52.png]]
 
# Select '''Production Level'''.
 
# Click '''Save'''.
 
#: [[File:Install53.png]]
 
# You will be prompted to restart, click '''Restart Now'''.
 
  
== Install the VALT Camera License ==
 
# 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:''
 
<pre>sudo /usr/local/valt/bin/Menu</pre>
 
#: [[File:Install54.png]]
 
# Enter Option 3 for '''VALT Configuration'''.
 
#: [[File:Install55.png]]
 
# Enter Option 1 for '''Install License'''.
 
#: [[File:Install56.png]]
 
# Enter your license provided by IVS and press Enter.
 
# 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.
+
{{:Set Timezone}}
# From command line type in the following, and press Enter: <pre>sudo dpkg-reconfigure tzdata</pre>
 
#:[[File:49.jpg]]
 
# Select your Country.
 
#:[[File:45.jpg]]
 
# Select your Time Zone.
 
#:[[File:46.jpg]]
 
# From command line type in the following, and press Enter: <pre>sudo service apache2 restart</pre>
 
# From command line type in the following, and press Enter: <pre>sudo service WowzaStreamingEngine restart</pre>
 
#:[[File: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/)
 
 
 
[[File:Admin-1.jpg]]
 
 
 
Log into the system with the proper username and password. (default: “admin” “admin”)
 
  
[[File:Admin-2.jpg]]
+
== Accessing VALT from a Web Browser ==
 +
<div class="floating_card">''Note that you should use the IP address you used from when you configured the IP address [[#Configure_IP_Address | up above]]''</div>
  
Based on your login information, you may have access to any of the following sections: Observe, Record, Schedule, Upload and Admin as shown below.
+
{{:How to Access VALT}}
  
[[File:Admin-3.jpg]]
+
==Next Steps==
 +
<div class="section">
 +
Once you can reach the VALT interface in your web browser, your VALT Virtual Appliance has been successfully deployed! You can reach out to your Project Manager to schedule a VM Validation. At that time, one of our Support Engineers will validate the deployment and assist with licensing and mass storage configuration.
 +
</div>

Revision as of 09:18, 22 February 2024

Download the OVF Template

  1. Click on the link below to download the OVF Template for the VALT virtual appliance.
    VMWare 7.0
  2. Extract the .zip file

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
2 2 4 GB
5 4 8 GB
15 8 16 GB
25 16 32 GB
30 20 40 GB
40 24 48 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 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.

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 systemd-machine-id-setup


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 VALT from a Web Browser

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

Next Steps

Once you can reach the VALT interface in your web browser, your VALT Virtual Appliance has been successfully deployed! You can reach out to your Project Manager to schedule a VM Validation. At that time, one of our Support Engineers will validate the deployment and assist with licensing and mass storage configuration.