Skip to content

Latest commit

 

History

History
156 lines (103 loc) · 6.18 KB

README.md

File metadata and controls

156 lines (103 loc) · 6.18 KB

Liquid Galaxy

Before Installation

Install the lsb-core and lsb packages for Ubuntu 16.04 : $ sudo apt install lsb-core and $ sudo apt install lsb

Update the package database : $ sudo apt update

Upgrade you system using the "-f" parameter .This will attempt to correct a system which has broken dependencies: $ sudo apt upgrade -f .

Installation

The installation script (install.sh) is intended to be used with Ubuntu. It might not work with other distributions.

Tested with:

  • Ubuntu 16.04 LTS
  • Ubuntu 15.10

Distribution installation details:

Machine name: lgX (x = screen number*)
Username: lg

* set them clockwise (i.e. lg4 lg5 lg1 lg2 lg3). lg1 is always the master.

Other details such as the account name or user password are not relevant, write whatever. As a general rule, autologin can be set on the installation, however it is not mandatory since it will be done by the script later.

Installation script

Get and execute installation file on the target machine (from any user folder):

bash <(curl -s https://raw.githubusercontent.com/LiquidGalaxyLAB/liquid-galaxy/master/install.sh)

x64 bits OS might require these additional libraries in order to start Google Earth:

sudo apt-get install -y libfontconfig1:i386 libx11-6:i386​ libxrender1:i386 libxext6:i386 libglu1-mesa:i386 libglib2.0-0:i386 libsm6:i386

Master:

Machine id: the number that identifies your machine (only the number part of the lgX machine name).
Total machines count: the number of machines running your liquid galaxy.
LG frames: how the final setup will look like (use clockwise order).
Unique number (octet): Unique number that identifies your installation (to avoid conflict with other liquid galaxy installations in your network).

Example filled in form (with a 3 machines setup):
Machine id: 1
Total machines count: 3
LG frames: lg3 lg1 lg2
Unique number (octet): 42

During the installation you will be asked for a SSH passphrase and its verification, just press enter twice.

Slaves:

Slaves are asked for additional information, in order to sync with the master.

Do NOT install master before having completed its installation and is up and working! (slaves will connect to master to retrieve configuration files during the installation)

Master IP: master machine IP address: ifconfig eth0 | grep "inet addr" | awk '{print $2}'.
Master local user password: lg user password.

Example filled in form (with a 3 machines setup):
Machine id: 2
Master machine IP: 192.168.1.10
Master local user password: 1234
Total machines count: 3
LG frames: lg3 lg1 lg2
Unique number (octet): 42

Once the slaves installation has completed (including the reboot), you might have to reload master to send them the init signal. lg-relaunch

Other installation details

  • Device GPU drivers might not be enabled by default. Make sure to install your device's latest drivers.
  • If your Liquid Galaxy setup is using the screens in vertical, you will have to rotate them manually (on Ubuntu: Launchpad -> Displays -> Rotation -> Counterclockwise).
  • When booting Ubuntu Installation from your USB, if the USB doesn't appear as a boot option in the list of the BIOS, please make sure your CSM (Compatibility Support Module) allows booting from both Legacy and UEFI systems.
  • When opening Google Earth Pro application, if the screen doesn't properly load, it might be due to the incompatiblity between Google Earth Pro 7.3 and X.Org X server. Install Nvidia driver in order to solve the problem with this command: sudo apt-get install nvidia-384 && shutdown -r now

[Optional] API

API will enable developers to control the Liquid Galaxy over common protocols, such as AJAX or WebSockets.

For example, it makes it easy to send KML files to display on the Google Earth.

Although residing in a different repository, it has been built with this Liquid Galaxy installation in mind, and should not require more than a mere installation command.

See https://github.com/LiquidGalaxyLAB/liquid-galaxy-api#liquid-galaxy-quickstart

[Optional] Full-screen

Liquid Galaxy will by default display Earth's menu bar, which is useful for development but not very good looking for demonstrations.

It is up whether to enable it:

~/tools/earth-fullscreen.sh && sudo reboot

Full screen uses another window manager (Openbox), which does not share Gnome's display settings. If needed, you can rotate your screens by typing the following:

(Openbox tip: use CTRL + ALT + -> to move onto the next Workspace, then right click on desktop -> terminal emulator)

echo 'xrandr -o left;xset s off;xset -dpms;xset s noblank' > ~/.xprofile
xrandr -o left;xset s off;xset -dpms;xset s noblank

You can disable it anytime:

~/tools/revert-earth-fullscreen.sh && sudo reboot

Within this repository

The "gnu_linux" directory contains example configuration files to aid with setup of various software pieces. The philosophy employed was one of letting the underlying distribution simplify the overall setup.

This meant leveraging the default behavior of "Xsession", the "alternatives" system, and various hook or "$product.d" directories.

The "php-interface" directory contains an example collection of code used to provide a touchscreen interface for selecting queries and coordinates to be consumed by Google Earth. Place everything into a WebServer's Docroot.

On the system

NOTE: with SVN, it is up to the client to handle symlinks. If your client doesn't handle symlinks, you might end up with some duplicate files with various names, but things should still work fine.

The following tree represents the suggested directory hierarchy within the "lg" user's home directory:

/home/lg
|-- bin
|-- earth
|   |-- builds
|   |   |-- latest -> ./5.2.X.XXXX-X
|   |   `-- 5.2.X.XXXX-X
|   |-- config
|   |   |-- master
|   |   `-- slave
|   `-- scripts
|-- etc
`-- media
    `-- images
        |-- backgrounds
        `-- google

Using example scripts and tools within this repo, there should also be a "/lg" directory on the system owned by "lg" user.