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

From IVS Wiki
Jump to: navigation, search
m (→‎Download the OVF Template)
 
(45 intermediate revisions by the same user not shown)
Line 1: Line 1:
 +
{{Deprecated}}
 
== 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.
−
https://ivs.box.com/shared/static/tf248uzr3qgdg1x4q9crvmgn7952keb1.zip
+
#: <em>link removed</em>
−
# Extract the ValtVMWare.zip
+
# Extract the .zip file
 +
</div>
  
 
== 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]]
+
#: {{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'''.
  
 
== 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]]
+
#: {{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>
−
Click OK once all changes have been made.
+
    <td>16</td>
−
 
+
    <td>32 GB</td>
−
''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.''
+
  </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>
  
−
== Add the USB Key to the VM (Optional) ==
+
Click '''OK''' once all changes have been made.
−
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
+
{{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]].}}
−
#: [[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 ==
−
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.
  
−
# 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]]
+
#: {{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=
 +
 +
# Access the VALT Server Command Line Menu.
 +
# Choose Option 6 to drop to a shell
 +
# Type the following and press enter: <pre>sudo rm /etc/machine-id</pre>
 +
# Type the following and press enter: <pre>sudo systemd-machine-id-setup</pre>
 +
 +
 +
== Set the Timezone ==
 +
{{:Set Timezone}}
  
−
== Install the Wowza Streaming Engine License ==
+
== Accessing VALT from a Web Browser ==
−
# Open a web browser and navigate to '''http://''IPAddress'':8088'''
+
<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>
−
#: Replace '''''IPAddress''''' with the IP Address of the server.
 
−
#: [[File:Install47.png]]
 
−
# 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 ==
+
{{:How to Access VALT}}
−
# 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'''
 
−
#: [[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.
 
  
−
== Accessing the Valt Server ==
+
==Next Steps==
−
# Open a web browser and navigate to '''http://''IPAddress'':8088'''
+
<div class="section">
−
#: Replace '''''IPAddress''''' with the IP Address of the server.
+
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.
−
#: [[File:Install72.png]]
+
</div>
−
# Log in using the following credentials:
 
−
#: Username: '''admin'''
 
−
#: Password: '''admin'''
 

Latest revision as of 14:14, 3 May 2024

⚠DEPRECATED: This page is no longer maintained or updated. It is kept for archival purposes only.

Download the OVF Template

  1. Click on the link below to download the OVF Template for the VALT virtual appliance.
    link removed
  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.

Retrieved from "https://ipivs.info/wiki/index.php?title=Deprecated_Page_-_Installing_a_VMWare_Virtual_Appliance&oldid=12909"