Difference between revisions of "Installing the Valt Software"

From IVS Wiki
Jump to: navigation, search
(Obtain an IP Address)
(Configure Storage)
 
(7 intermediate revisions by the same user not shown)
Line 4: Line 4:
 
# Boot the machine from an Ubuntu Server 16.04 installation CD.
 
# Boot the machine from an Ubuntu Server 16.04 installation CD.
 
#: [[File:Install1.png]]
 
#: [[File:Install1.png]]
# When prompted select your language from the menu and press enter.
+
# When prompted select your language from the menu and press Enter.
 
#: [[File:Install2.png]]
 
#: [[File:Install2.png]]
 
# Press '''F4'''.
 
# Press '''F4'''.
Line 85: Line 85:
 
==Download Installation Package==
 
==Download Installation Package==
  
# Connect to the server via SSH or log in to the teminal
+
# Connect to the server via SSH, or log in to the terminal
 
#: ''It is highly recommended that you connect via ssh so you can copy and paste the commands below''
 
#: ''It is highly recommended that you connect via ssh so you can copy and paste the commands below''
# If prompted enter the password for your user account.
+
# If prompted, enter the password for your user account.
# Type '''sudo apt-get install wget -y''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo apt-get install wget -y</pre>
# Type '''wget --content-disposition https://ivs.box.com/shared/static/fuqipanms60q3vd98pcfewuexsbwugnm.gz -O ValtInstall.tar.gz''' and press enter.
+
# Type in the following, and press Enter:<pre>wget --content-disposition https://ivs.box.com/shared/static/fuqipanms60q3vd98pcfewuexsbwugnm.gz -O ValtInstall.tar.gz</pre>
# Type '''tar -xvf ValtInstall.tar.gz''' and press enter.
+
# Type in the following, and press Enter: <pre>tar -xvf ValtInstall.tar.gz</pre>
  
 
==Install Valt==
 
==Install Valt==
  
 
# Connect to the server via SSH or log in to the teminal
 
# Connect to the server via SSH or log in to the teminal
# Type '''cd ValtInstall''' and press enter.
+
# Type in the following, and press Enter: <pre>cd ValtInstall</pre>
# Type '''chmod +x ValtSetup''' and press enter.
+
# Type in the following, and press Enter: <pre>chmod +x ValtSetup</pre>
# Type '''sudo ./ValtSetup''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo ./ValtSetup</pre>
 
# If prompted enter the password for your user account.
 
# If prompted enter the password for your user account.
 
# Enter a password for the MySQL root user.
 
# Enter a password for the MySQL root user.
Line 105: Line 105:
 
#: [[File:2019ValtInstall2revised.png]]
 
#: [[File:2019ValtInstall2revised.png]]
 
# Enter an administrator password for your LDAP directory when prompted.
 
# Enter an administrator password for your LDAP directory when prompted.
#* Although it will not be used an any password can be entered here, the default password for an IVS Valt Install for LDAP is '''admin51'''.
+
#* Although it will not be used, any password can be entered here, the default password for an IVS Valt Install for LDAP is '''admin51'''.
 
#: [[File:2019ValtInstall3.png]]
 
#: [[File:2019ValtInstall3.png]]
 
# Confirm the password.
 
# Confirm the password.
Line 122: Line 122:
 
# Confirm the password when prompted.
 
# Confirm the password when prompted.
 
#: [[File:2019ValtInstall10.png]]
 
#: [[File:2019ValtInstall10.png]]
# When prompted, press enter to select the default for all options.
+
# When prompted, press Enter to select the default for all options.
 
#: [[File:2019ValtInstall11.png]]
 
#: [[File:2019ValtInstall11.png]]
# Press enter to continue.
+
# Press Enter to continue.
 
#: [[File:2019ValtInstall12.png]]
 
#: [[File:2019ValtInstall12.png]]
# When prompted, enter the MySQL root password defined earlier in the install.
+
# When prompted, Enter the MySQL root password defined earlier in the install.
 
#: [[File:2019ValtInstall13.png]]
 
#: [[File:2019ValtInstall13.png]]
# When prompted, enter '''admin''' for the email, followed by '''admin''' for the password.
+
# When prompted, Enter '''admin''' for the email, followed by '''admin''' for the password.
 
#: [[File:2019ValtInstall14.png]]
 
#: [[File:2019ValtInstall14.png]]
# Type '''sudo reboot''' to restart the Server and complete changes.
+
# Type in the following, and press Enter to restart the server and complete changes: <pre>sudo reboot</pre>
 
#: [[File:2019ValtInstall15.png]]
 
#: [[File:2019ValtInstall15.png]]
  
Line 136: Line 136:
 
''If video files will be stored on the same drive as the OS, only the following command needs to be run from the terminal:''
 
''If video files will be stored on the same drive as the OS, only the following command needs to be run from the terminal:''
  
'''sudo ./Storage'''
+
Type in the following, and press Enter: <pre>sudo ./Storage</pre>
  
 
The following steps should be completed only if you have a separate drive (physical or virtual) for storing the video files.  
 
The following steps should be completed only if you have a separate drive (physical or virtual) for storing the video files.  
  
# Type '''sudo lshw -C disk''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo lshw -C disk</pre>
 
# You should now see a list of the available disks on the machine. Locate the disk you want to provision for storage in the list. In this case it is /dev/sdb
 
# You should now see a list of the available disks on the machine. Locate the disk you want to provision for storage in the list. In this case it is /dev/sdb
# Type '''sudo parted ''/dev/sdb''''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo parted /dev/sdb</pre>
 
#* Replace '''''/dev/sdb''''' with the appropriate disk identified in step 2.
 
#* Replace '''''/dev/sdb''''' with the appropriate disk identified in step 2.
 
#: [[File:Install43.png]]
 
#: [[File:Install43.png]]
 
# You will now be taken to a GNU Parted prompt
 
# You will now be taken to a GNU Parted prompt
# Type '''mklabel gpt''' and press enter.
+
# Type in the following, and press Enter: <pre>mklabel gpt</pre>
# Type '''mkpart pri 1 -1''' and press enter.
+
# Type in the following, and press Enter: <pre>mkpart pri 1 -1</pre>
 
# Type '''quit''' and press enter.
 
# Type '''quit''' and press enter.
# Type '''sudo mkfs -t ext4 ''/dev/sdb1''''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo mkfs -t ext4 /dev/sdb1</pre>
 
#* Replace '''''/dev/sdb1''''' with the appropriate disk identified in step 2.
 
#* Replace '''''/dev/sdb1''''' with the appropriate disk identified in step 2.
# Type '''sudo blkid''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo blkid</pre>
 
# This will display the UUIDs for each partition. Note the UUID for the partition you just formatted.
 
# This will display the UUIDs for each partition. Note the UUID for the partition you just formatted.
# Type '''sudo nano /etc/fstab''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo nano /etc/fstab</pre>
 
#: [[File:Install44.png]]
 
#: [[File:Install44.png]]
 
# Add a line for the partition you just created. It should read similar to the following:
 
# Add a line for the partition you just created. It should read similar to the following:
#: UUID=cd07f82a-307c-46e9-8b80-a7859335c3a9 /usr/local/WowzaStreamingEngine/content ext4 defaults 0 2
+
#: <pre>UUID=cd07f82a-307c-46e9-8b80-a7859335c3a9 /usr/local/WowzaStreamingEngine/content ext4 defaults 0 2</pre>
 
#: [[File:Install45.png]]
 
#: [[File:Install45.png]]
# Press '''CTRL-X'''
+
# Press '''CTRL-X'''.
# Enter Y to save.
+
# Enter '''Y''' to save.
# Do not change the file name and press enter
+
# Do not change the file name and press Enter.
# Type '''sudo mount -a''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo mount -a</pre>
# Type '''sudo lsblk''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo lsblk</pre>
 
#: [[File:Install46.png]]
 
#: [[File:Install46.png]]
# The results should be similar to the above picture where sdb1 is mounted under /usr/local/WowzaStreamingEngine-4.0.6/content
+
# The results should be similar to the above picture, where sdb1 is mounted under ''/usr/local/WowzaStreamingEngine-4.0.6/content''
# Type '''sudo ./Storage''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo ./Storage</pre>
# Type '''sudo reboot''' and press enter.
+
# Type in the following, and press Enter: <pre>sudo reboot</pre>
  
 
== 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]]
 
#: [[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 196: Line 196:
 
#: 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 202: Line 202:
 
# 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 215: Line 215:
 
#:* ''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.
  

Latest revision as of 09:41, 23 September 2019

Install Ubuntu 16.0.4 LTS

The Valt software is currently only supported on Ubuntu 16.04 LTS. Internet access is required to complete the installation. After installation is complete, the server can be disconnected from the internet, and run without issue.

  1. Boot the machine from an Ubuntu Server 16.04 installation CD.
    Install1.png
  2. When prompted select your language from the menu and press Enter.
    Install2.png
  3. Press F4.
    Install3.png
    • If you are installing on a virtual machine select Install Minimal Virtual Machine.
    • If you are installing on a physical machine select Install Minimal System.
    Install2.png
  4. Press Enter to begin installing Ubuntu Server.
    Install4.png
  5. When prompted select your language from the menu, and press Enter.
    Install5.png
  6. When prompted select your location from the menu, and press Enter.
    Install6.png
  7. Select No when prompted to detect keyboard layout.
    Install7.png
  8. Select the country of origin for your keyboard from the menu, and press Enter.
    • Most likely English (US)
    Install8.png
  9. Select your keyboard layout from the menu, and press Enter.
    • Most likely English (US)
    Install62.png
  10. Select a primary network interface.
    You will only be prompted if your system has more than one NIC
    Install9.png
  11. Enter a name for the appliance when prompted (This can be changed later).
    Install10.png
  12. Enter a full name for the new user when prompted.
    • The default name for installations of Valt by IVS is IVS Admin.
    Install11.png
  13. Enter a username for the new user when prompted.
    • The default name for installations of Valt by IVS is ivsadmin.
    Install12.png
  14. Enter a password for the new user when prompted.
    Install13.png
  15. Reenter the password for the new user when prompted.
    Install14.png
  16. When prompted to encrypt the home directory, select No.
    Install15.png
  17. Verify the timezone detected is correct, then select Yes.
    Install16.png
  18. When prompted to partition the disks, select Guided – use entire disk.
    Install17.png
  19. Select the proper disk to partition.
    In most cases this will be the smaller of the available disks/array. The larger disks/array should be allocated for video storage and will be configured later.
    Install18.png
  20. Select Yes to write the changes to the disk.
    Install19.png
  21. Wait while the installer completes.
    Install20.png
  22. If you need to enter HTTP Proxy information, enter it now.
    In most cases this will not be required, you can just select Continue.
    Install21.png
  23. Wait while apt is configured.
    Install22.png
  24. Select Install Security Updates Automatically.
    Install23.png
  25. When prompted for software selection, choose OpenSSH server.
  26. Select Continue.
    Install24.png
  27. Select Yes when prompted to install the GRUB boot loader.
    Install25.png
  28. Installation is now complete. Select Continue to reboot the appliance.

Obtain an IP Address

If you specified a static ip address during installation, this section can be skipped. If you opted to use DHCP to configure the network interface, you will need to determine the IP address of the server before proceeding.

To obtain the IP log in to the console and run the following command:

ifconfig

Network configuration will be displayed similar to the below screenshot.

Install26.png

The active network adapter should have an ip address displayed. In this case it is eth0, and the address is 192.168.0.159.

The server should be configured with a static address. If you want to use DHCP, you should set up a DHCP reservation for the server so the IP address does not change.

Download Installation Package

  1. Connect to the server via SSH, or log in to the terminal
    It is highly recommended that you connect via ssh so you can copy and paste the commands below
  2. If prompted, enter the password for your user account.
  3. Type in the following, and press Enter:
    sudo apt-get install wget -y
  4. Type in the following, and press Enter:
    wget --content-disposition https://ivs.box.com/shared/static/fuqipanms60q3vd98pcfewuexsbwugnm.gz -O ValtInstall.tar.gz
  5. Type in the following, and press Enter:
    tar -xvf ValtInstall.tar.gz

Install Valt

  1. Connect to the server via SSH or log in to the teminal
  2. Type in the following, and press Enter:
    cd ValtInstall
  3. Type in the following, and press Enter:
    chmod +x ValtSetup
  4. Type in the following, and press Enter:
    sudo ./ValtSetup
  5. If prompted enter the password for your user account.
  6. Enter a password for the MySQL root user.
    • The default password for an IVS Valt Install for MySQL is admin51.
    2019ValtInstall1.png
  7. Repeat the password when prompted.
    2019ValtInstall2revised.png
  8. Enter an administrator password for your LDAP directory when prompted.
    • Although it will not be used, any password can be entered here, the default password for an IVS Valt Install for LDAP is admin51.
    2019ValtInstall3.png
  9. Confirm the password.
    2019ValtInstall4revised.png
  10. When prompted, select Yes to save the current IPv4 rules.
    2019ValtInstall5.png
  11. When prompted, select Yes to save the current IPv6 rules.
    2019ValtInstall6.png
  12. When prompted to configure phpMyAdmin, select apache2.
    2019ValtInstall7.png
  13. Select Yes when prompted.
    2019ValtInstall8.png
    When prompted, enter a password for phpMyAdmin to communicate with MySQL.
    • The default password for an IVS Valt Install for phpMyAdmin to communicate with MySQL is admin51.
    2019ValtInstall9.png
  14. Confirm the password when prompted.
    2019ValtInstall10.png
  15. When prompted, press Enter to select the default for all options.
    2019ValtInstall11.png
  16. Press Enter to continue.
    2019ValtInstall12.png
  17. When prompted, Enter the MySQL root password defined earlier in the install.
    2019ValtInstall13.png
  18. When prompted, Enter admin for the email, followed by admin for the password.
    2019ValtInstall14.png
  19. Type in the following, and press Enter to restart the server and complete changes:
    sudo reboot
    2019ValtInstall15.png

Configure Storage

If video files will be stored on the same drive as the OS, only the following command needs to be run from the terminal:

Type in the following, and press Enter:
sudo ./Storage

The following steps should be completed only if you have a separate drive (physical or virtual) for storing the video files.

  1. Type in the following, and press Enter:
    sudo lshw -C disk
  2. You should now see a list of the available disks on the machine. Locate the disk you want to provision for storage in the list. In this case it is /dev/sdb
  3. Type in the following, and press Enter:
    sudo parted /dev/sdb
    • Replace /dev/sdb with the appropriate disk identified in step 2.
    Install43.png
  4. You will now be taken to a GNU Parted prompt
  5. Type in the following, and press Enter:
    mklabel gpt
  6. Type in the following, and press Enter:
    mkpart pri 1 -1
  7. Type quit and press enter.
  8. Type in the following, and press Enter:
    sudo mkfs -t ext4 /dev/sdb1
    • Replace /dev/sdb1 with the appropriate disk identified in step 2.
  9. Type in the following, and press Enter:
    sudo blkid
  10. This will display the UUIDs for each partition. Note the UUID for the partition you just formatted.
  11. Type in the following, and press Enter:
    sudo nano /etc/fstab
    Install44.png
  12. Add a line for the partition you just created. It should read similar to the following:
    UUID=cd07f82a-307c-46e9-8b80-a7859335c3a9 /usr/local/WowzaStreamingEngine/content	ext4	defaults	0	2
    Install45.png
  13. Press CTRL-X.
  14. Enter Y to save.
  15. Do not change the file name and press Enter.
  16. Type in the following, and press Enter:
    sudo mount -a
  17. Type in the following, and press Enter:
    sudo lsblk
    Install46.png
  18. The results should be similar to the above picture, where sdb1 is mounted under /usr/local/WowzaStreamingEngine-4.0.6/content
  19. Type in the following, and press Enter:
    sudo ./Storage
  20. Type in the following, and press Enter:
    sudo reboot

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.

Accessing the Valt Server

  1. Open a web browser and navigate to http://IPAddress
    Replace IPAddress with the IP Address of the server.
    Install72.png
  2. Log in using the following credentials:
    Username: admin
    Password: admin