# Ubuntu installation This guide explains how to install the Ubuntu OS with the AR 51 Mocap Unleashed software pre-installed and configured. --- ## Prerequisites Downloading the Pre-Configured Ubuntu Installation File 1. Access the AR 51 Downloads page: 2. Go to the [AR 51 Downloads page](/download). 3. Locate the Ubuntu Installation File. ![The Ubuntu installation image on the AR 51 download site](./img/installation/ubunut_on_website.png) 4. Click the download link for the installation file and save it to your computer. ## Prepare for Installation ### Create a Bootable USB Drive: Use a software like [Balena-Etcher](https://etcher.balena.io/) to burn the ISO to a USB flash-drive. ### Ensure you have a USB drive or other media Make sure you have a USB drive or another medium available for installing Ubuntu ### Make sure the computer is connected to the internet Ensure the computer is connected to the internet to download updates during the installation process. ## Start the Installation Process ### Step-by-Step Guide: 1. Insert the USB drive or installation media into the computer. 2. Boot your computer from the installation media. 3. Once the system boots from the media, select "Try or Install Ubuntu" ![Ubuntu installation — Install 1 choose try or install](./img/installation/install_1_-_choose_try_or_install.png) 4. When the installation screen appears, select "Install AR 51". ![Ubuntu installation — Install 2 choose install](./img/installation/install_2_-_choose_install.png) ## Configure Installation Options 1. When prompted, select "Install Ubuntu." 2. Choose Your Preferred Language ![Ubuntu installation — Choose lang](./img/installation/choose_lang.png) 3. Connect to the internet when prompted to allow Ubuntu to download updates. 4. In the top-left corner, you should see a network icon. Ensure the computer is connected to the network before proceeding to the next step. ![Ubuntu installation — Install 3 make sure the network is connected](./img/installation/install_3_-_make_sure_the_network_is_connected.png) :::warning If the computer is not connected to the internet, it will be unable to download updates, which may affect system functionality. ::: 5. Check both "Download updates" and "Install third-party software..." to ensure the necessary drivers and codecs are installed. ![Ubuntu installation — Install 4 choose both download and third party graphics](./img/installation/install_4_-_choose_both_download_and_third_party_graphics.png) 6. Choose the appropriate installation type based on your setup: 1. If using a clean disk, select "Erase disk and install Ubuntu." 2. If creating a custom partition, select "Something else" and configure your partitions accordingly. ![install 5 - choose disk install type](./img/installation/install_type.png) 7. Select your location to set the time zone and click "Continue." ![install 6 - choose time zone](./img/installation/time_zone.png) 8. Enter your name, computer name, and create a secure password. Then, click "Continue." ![install 6 - choose time zone](./img/installation/user.png) ## Complete the Installation 1. Follow the on-screen prompts to complete the installation process. ![Ubuntu installation — Install 5 progress bar](./img/installation/install_5_-_progress_bar.png) 2. Once the installation is finished, the system will prompt you to restart. Approve the restart and remove the installation media when prompted. ![Ubuntu installation — Install 7 on first login enter the password](./img/installation/install_7_-_on_first_login_enter_the_password.png) ## First Login 1. After the system boots, enter your username and password to log in. 2. Once logged in, a terminal window should appear. Enter your password when prompted to complete the installation process. 3. When this process is done, you should see a change to the user wallpaper. ## When using Nvidia 50XX Series Graphics card 1. Open the "Additional Drivers" application from the application menu. 2. Select the Nvidia-driver-575-open from the list. ![Ubuntu installation — Nvidia driver 575 open](./img/installation/nvidia_driver_575-open.png) 3. Click "Apply Changes" to install the driver. 4. Restart your computer to apply the changes. 5. After restarting, open a terminal and run `nvidia-smi` to verify the driver installation. ## Configure the Network Interfaces 1. Set the IP address and subnet for **all** network interfaces connected to the cameras. 2. First, open the network interface settings by clicking on the network icon in the top-left corner. ![Ubuntu installation — Install 8 enter network configuration](./img/installation/install_8_-_enter_network_configuration.webp) 3. Edit **all** interfaces that connect to cameras (only once if using a switch). ![Ubuntu installation — Install 9 edit each network interface](./img/installation/install_9_-_edit_each_network_interface.png) 4. For each interface, complete the following steps: 5. Under the **"Identity"** tab, set the **MTU** to **9000**. ![Ubuntu installation — Install 10 set the MTU](./img/installation/install_10_-_set_the_MTU.png) 6. Under the **"IPv4"** tab, configure the IP **Address** and **Netmask**. ![Ubuntu installation — Install 11 set the ip and subnet](./img/installation/install_11_-_set_the_ip_and_subnet.png) 7. Network configuration may vary based on site constraints. We generally recommend the following convention: * The IP address should follow the format **169.254.X.1**, where **X** is a unique interface ID. * The subnet should be **255.255.255.0** . :::warning **Do not** configure a default gateway for these cameras. The cameras should be in a closed-loop/isolated network. ::: In most cases, the interface connected to the internet (external network) should remain unconfigured. :::warning Changing the network interface connected to the internet may disrupt your connection. ::: 8. Once completed, **disable and re-enable** all network interfaces to make the changes take into effect. ![Ubuntu installation — Restart network interface](./img/installation/restart_network_interface.png) ## Set the license key and provide the machine signature 1. Open the **Mocap Unleashed** application using the desktop icon **"Start AR51..."** . ![Ubuntu installation — Install Start AR51](./img/installation/install_-_Start_AR51.png) 2. Navigate to the Settings tab and enter the provided license key. ![Ubuntu installation — Install 12 enter license](./img/installation/install_12_-_enter_license.png) :::warning If you did not receive a license key, contact AR 51 support. ::: 3. The system will display a **"Machine Fingerprint"**. Share this fingerprint with AR 51 support. :::warning Each license is locked to a specific machine. If you reinstall the operating system, the fingerprint may change. ::: If the fingerprint changes, contact AR 51 support to reactivate your machine. ![Ubuntu installation — Install 13 fingerprint warning](./img/installation/install_13_-_fingerprint_warning.png) ## Provide Remote Access for Testing 1. We recommend using **AnyDesk** for remote access. 2. Provide the **AnyDesk access-code** to your support representative. ## Done Your pre-configured AR 51 Ubuntu installation is complete.