Alternative install and troubleshooting instructions for Leaf.

Install Leaf on Ubuntu 14.04

On Ubuntu 14.04, the apt version is too old to support direct .deb install; dpkg install must be used to install Leaf.

First, download leaf_latest.deb and install with dpkg:

$ wget https://downloads.sierrawireless.com/tools/leaf/leaf_latest.deb -O /tmp/leaf_latest.deb
$ sudo dpkg -i /tmp/leaf_latest.deb
$ sudo apt-get install -f

On Ubuntu 14.04 LTS, some library dependencies are not available at the correct version in the system install and will crash leaf. As an alternative, these libraries can be installed through pip:

Update python libraries with pip:

$ sudo apt-get install python3-pip --no-install-recommends
$ pip3 install setuptools --user --upgrade

Install Leaf without apt

To install Leaf without apt, download and extract the latest archive package

$ wget https://downloads.sierrawireless.com/tools/leaf/leaf.tar.gz -O /tmp/leaf.tar.gz
$ mkdir /tmp/leaf-src && cd /tmp/leaf-src && tar xvzf /tmp/leaf.tar.gz

Install the prerequisites:

$ sudo apt-get install python3 python3-requests python3-argcomplete python3-all python3-setuptools

(Note: on Ubuntu 14.04, the python3-argcomplete package doesn't exist. Cf workaround above)

Install:

$ cd /tmp/leaf-src/
$ ./setup.py install --user
$ ./setup.py install_data -d $HOME/.local
$ export PATH=$HOME/.local/bin:$PATH

Update your leaf install:

$ sudo apt update
$ sudo apt install leaf
$ # Or...
$ sudo apt upgrade

Close all your opened terminals and reopen, to get the environment (completion, etc...) correctly configured.

Disable apt installs

If your package install fails during apt verification it is possible to disable the apt verification. You will be responsible for installing all the dependencies yourself.

Set the LEAF_IGNORE_APT variable to disable the apt check for Leaf packages:

$ export LEAF_IGNORE_APT=1                          # Temporary setting for the current terminal
$ # Or...
$ leaf env user --set LEAF_IGNORE_APT=1             # Persistent setting

Reuse Legato Source

If you already have a Legato Clone you are able to use it within your leaf environment:

For example, if you current clone is located in ~/myLegatoClone, and your leaf workspace is in ~/leaf-workspace:

$ ls ~/myLegatoClone -a
.repo
legato
$ cd ~/leaf-workspace
$ ln -s ~/myLegatoClone legato-clone           # Or any other directory name
$ leaf env workspace --set LEGATO_CLONE=$PWD/legato-clone
$ leaf getsrc legato                           # Will reuse your clone instead of creating a new one

Copyright (C) Sierra Wireless Inc.