Installing the VALT Software

From IVS Wiki
Jump to: navigation, search

The information on this page is no longer up-to-date.

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