Ubuntu

You are here:

1. Introduction

This document describes the procedure recommended by Admira for the platforming and installation of the Admira Player on Ubuntu distributions.

Specifically, the document focuses on the Ubuntu 18.04 Desktop (LTS) version:
ubuntu-18.04.2-desktop-amd64.iso
http://old-releases.ubuntu.com/releases/18.04.04/ubuntu-18.04.2-desktop-amd64.iso

2. Installing the Ubuntu system

Access the Boot Menu and select Install Ubuntu.

When starting, select the default language English and press the Install Ubuntu button.

Select the following installation features.

  1. Updates and other software
    • What apps would you like to install to start with? Normal installation
    • Other options:
      • Download updates while installing Ubuntu: Enabled
      • Install third-party software for graphics and WIFI hardware and additional media formats: Enabled
  2. Press Continue
  3. On the next screen Installation type, select the option Erase disk and install Ubuntu.
  4. Click on Install Now.
  5. Select the appropriate time zone on the map.
  6. Click on Continue.
  7. Create a user and make sure that the option Log in automatically is selected.
  8. Set the password as appropriate. It is important to keep a record of it in a safe place.
    For example:
    Username:  Admira Password: Admira_2019
  9. Again click on Continue.
  10. Wait a few minutes for the installation to complete.
  11. Finally, after restarting the computer, you will see the Linux desktop. Set it up as follows.

3. Install updates (optional)

Press the Win key and search for Software Updater in the search box.

As of July 2019, the update of the computer introduces a bug in the Autologin. This causes the Autologin to stop working after applying the updates. So, for the moment, skip this step or apply the temporary solution described in this section.

Live session user / admira1234

Fix to avoid Autologin problem

If you choose to update the system with the latest updates, ensure that Autologin works by rebooting several times, as the first reboot after upgrade works.

If your system is affected by the bug, edit the /etc/gdm3/custom.conf file and uncomment the Timed Login lines, as follows:

sudo nano /etc/gdm3/custom.conf
# Enabling timed login
TimedLoginEnable = true
TimedLogin = username
TimedLoginDelay = 10

4. Turn off updates

  1. Press the Windows key and, in the search dialogue, type: Software & Updates.
  2. In the Updates section, set the following parameters:
    • Automatically check for updates: Never
    • Notify me of a new Ubuntu version: Never
  3. Close the window, Close.

This must be done before running the Admira installer, or the installation may fail and the player might not start after reboot.

5. Operating system configuration

After the installation is complete, it is advisable to configure certain aspects of the operating system to ensure stable and uninterrupted playback in any scenario.

  1. Connect to the computer and go to Wired Settings (connectivity via ethernet recommended).
  2. Go to the features by pressing the arrow. 
  3. Now press the Settings icon (a spanner next to a screwdriver). You can also access them via the WIN/CMD key and filter by Settings.

Notifications

  1. In the Notifications section, Settings > Notifications
  2. Configure this tab leaving all notifications turned off.

Desktop background

  1. In the background section, Settings > Background > Colours > Black.
  2. In all cases, choose the black background.

WIFI

  1. In the Wireless section, Settings > WIFI
  2. Connect to the wireless network if it is the only connectivity option. In principle, the Ethernet connection is preferred, and the WIFI is disabled if you have active Ethernet.

Region & Language

  1. In the Wireless section, Settings > Region & Language
  2. Configuration according to customer instructions; default language is English.

Autologin

  1. In the Autologin section, Settings > Details > Users
  2. To begin, first press the Unlock button and enter your administrative password. Once you are ready, turn on the automatic Login Switch.

Date and time

  1. In the Date and Time section, Settings > Details > Date & Time
  2. Configure this tab with the following parameters:
    • Automatic Date & Time: ON
    • Automatic Time Zone: OFF
    • Time Zone, it is important to select the correct one.
    • Time Format: 24-hour

Bluetooth

  1. In the Autologin section, Settings > Bluetooth
  2. Turn off this option.

Privacy

  1. In the Autologin section, Settings > Privacy
  2. Configure this tab with the following parameters:
    • Screen Lock: OFF
    • Location Services: ON
    • Usage & History: OFF. Within this section, specify the following:
      • Recently Used: ON
      • Retain History: Forever
    • Purge Trash & Temporary Files: ON Within this section, specify the following:
      • Automatically Empty Trash: ON
      • Automatically Purge Temporary Files: ON
      • Purge After: 1 day
    • Problem Reporting: Never
    • Connectivity Checking: ON

Share

  1. In the Share section, Settings > Sharing
  2. Configure this tab with the following parameters:
    • Remote login: ON

Power

  1. In the Power section, Settings > Power
  2. Configure this tab with the following parameters:
    • Blank screen: Never
    • WIFI: ON
    • Bluetooth: OFF
    • Automatic suspend: Off
    • When the Power Button is pressed: Power Off

Devices

  1. Under Monitors, Settings > Displays
  2. Configure this tab with the following parameters:
    • Orientation: Landscape or Portrait
    • Resolution
    • Scale: 100%, it is very important that this is set correctly
    • Night Light: OFF

6. Remove the Gnome top bar via Tweaks

When the player does not run in full window, i.e. the player is not set to full screen in the inventory section of the platform. The Gnome top bar is displayed. This causes videowall settings to display the app title “Admira” and the black space of the bar.

To hide this bar, the best option is to use the Gnome Tweaks Auto Hide Top Bar extension (previously installed).

In order for Gnome Tweaks to show the extension, you must log out of the desktop session and re-enter.

After this, run Gnome Tweaks and, in extensions, activate Hide Top Bar.

7. Uninstall Dock

  1. Open terminal (alt+ctrl+T) and launch the following command:
sudo apt-get remove gnome-shell-extension-ubuntu-dock
  1. Install Tweaks and the Hide Top Bar extension.
sudo apt-get install gnome-tweaks
sudo apt-get install gnome-shell-extension-autohidetopbar
  1. Restart your computer. When it restarts, you will see the Tweaks options
sudo shutdown -r now

Remove icons and trash from the desktop.

  1. Press the Windows key and search for the Tweaks app.
  2. In the Desktop section Tweaks > Desktop, set the following parameter:
    • Show Icons: OFF
  3. In the Extensions section Tweaks > Extensions, set the following parameter:
    • Hide top bar, click on the plugin configuration and set the following parameters:
      • Show panel when mouse approaches edge of the screen: ON
      • Key that triggers the bar to be shown: select a key combination that displays the bar. For example: CTRL+Alt+B

8. Teamviewer

  1. Download the app using the following URL
    https://www.teamviewer.com/es/download/linux/
  2. Save the file. You can find the version best suited to the characteristics of your computer by entering the command uname –a. This command will guide you so that you can download the most suitable version.
*Deb x.XX
  1. For installation by interface, right-click above the downloaded directory and install using the package installer.
    Open with Software Installation
  2. Open the programme

Access Teamviewer

  1. Extras > Options > General > Enable the option to: START TEAMVIEWER WITH SYSTEM
  2. Extras > Options > Security > Pass: Admira19
  3. Finally, save the computer ID in the relevant document shared with Admira, next to the computer name:
    For example:
    Test_Ubuntu_18 1122387851/Admira19.

9. Installing the Admira Player

  1. Download the app using the following URL
    http://install.admira.com/linux/list
  2. From this list, select version xXX-h 19.01.01, depending on the characteristics of our computer. To consult the version, use the uname -a command
    which will advise you which version to download.
  3. In this case, the version x64-h 19.01.01 is downloaded. You can locate the download directory by pressing the corresponding button (down arrow) and clicking on the directory image.
  4. Save the file.
  5. After downloading Admira xXX-h 19.01.01, extract the directory from the ZIP file (Right-Click > Extract).
  6. Go to directory xXX -h 19.01.01.
  7. For installation by interface, access the downloaded directory and click on AdmiraMobi.desktop.
  8. You will see a prompt from the Untrusted Application Launcher. Select Trust and Run.
  9. Accept the various warnings that appear.
  10. Admira has been successfully installed.

This installation does not require ANY UPDATES to be sent (16/10/19 QA).

Uninstall Admira

If you want to uninstall Admira, run: 

./opt/ADmiraUninstall

Open with: Run programme

10. Automatic restart and/or shutdown of the computer

For smooth operation of the computer, it is advisable to restart it or shut it down after long periods of operation. Typically, the computer boots from BIOS at a predetermined time and shuts down or restarts once a day. If the computer’s BIOS supports it, it is also recommended to configure the computer to return to the state it was in after a power failure.

There are various options for restarting or shutting down the computer. We will use the crontab for advanced users.  

Crontab

  1. Open the terminal, logging in with root and launching the following command:
sudo su - 
sudo gedit /etc/crontab  
  1. Add this line for daily restart at 23:00.
01 23 * * * * root shutdown -r now
  1. Save the change.
  2. On the terminal, run:
sudo service cron restart

11. Fix remote access via Teamviewer without music thread (optional for music players)

The music players do not have the HDMI cable connected to them. This causes Teamviewer 14 to show a black screen when you connect. Two options have been found to fix this, but the option below gives the best results.

wget -QO - https://bitbucket.org/marcos-martinez/scripts/raw/master/twfix.sh | sudo -E bash

Once the change has been applied and the computer restarted, you will no longer see the image on the HDMI monitor and will only be able to interact with the computer via remote platform access or Teamviewer.

To undo the change, simply delete a file via Teamviewer or SSH. The file to be deleted is:

/usr/share/X11/xorg.conf.d/virtual-monitor.conf

For automatic login to the desktop to work, it is also necessary to remove the dummy driver installed by the script.

sudo apt-get remove --purge xserver-xorg-video-dummy-hwe-18.04

After deleting this file and restarting, you should see the image on the monitor again if you plug it into HDMI.

12. Final checks

  1. Remote access to the computer via TW
  2. Remote access to the computer via platform
  3. Check playback of content
  4. Troubleshooting

Music Players

One of the most common problems is that HDMI is checked in Output, and you do not want to use it. Selecting the sound card will solve this problem. There may be other problems, and it may not be possible to do this using this graphics menu.

  1. Open the terminal and run alsamixer.
  2. After this, the handling of the Alsa controller that emits the sound will appear.
  3. By pressing F6, you can change the default graphics card. This can solve quite a few sound problems although there are some that it will not solve. 
  4. If, after doing all the above, it is still not working, the only option is to restart or reinstall Alsa and PulseAudio. To do this, run the following commands on the terminal:
sudo alsa force-reload
  1. This will restart the service, and Alsa and PulseAudio can be reinstalled by running the following commands:
sudo apt-get remove --purge alsa-base pulseaudio
sudo apt-get install alsa-base pulseaudio

Password recovery

If you have lost your user’s password or been assigned an incorrect password, you can recover it by doing the following:

  1. Switch on the computer, press shift or esc.
  2. Go to the recovery mode console.

Here you can apply the same procedure as above to change the password, but you must first mount the root partition with:

mount -rw -o remove /

Then proceed to change your password:

passwd username

Disable/enable firewall

In the event of firewall issues, you can disable or enable it using the console.

  1. Open the console.
  2. To disable the firewall:
ufw sudo disable
  1. To enable it: 
ufw enable sudo

In both cases, the user password is required.

For any queries or problems, contact Admira Technical Support at soporte@admira.com

Print Friendly, PDF & Email
Previous Debian / Raspberry Pi OS
Table of Contents