[[PageOutline]]


= Ubuntu =
Gateworks supports the popular Ubuntu OS on Newport and Ventana products using an Ubuntu built root filesystem with a Gateworks kernel. In some cases you may be able to use an Ubuntu built kernel.

See also:
 * [wiki:newport/ubuntu Newport Ubuntu Page]
 * [wiki:ventana/ubuntu Ventana Ubuntu Page]
 * [wiki:ventana#third_party_linux Ventana third party linux]

[=#packages]
== Ubuntu Packages ==
Ubuntu inherits its package management from Debian Linux using the 'apt' packaging system and 'deb' packages. The list of package feeds is in /etc/apt/sources.list:
{{{
#!bash
# cat rootfs/etc/apt/sources.list
deb http://ports.ubuntu.com/ubuntu-ports vivid main
deb http://ports.ubuntu.com/ubuntu-ports vivid universe
}}}

You can search for Ubuntu packages at https://launchpad.net/ubuntu. The search results will show what Ubuntu versions (by name) the package is available in and clicking on the resulting package will show information as to the package feed its contained in.

The standard Ubuntu package feeds are located at http://ports.ubuntu.com/ubuntu-ports/ and you will find packages in the dist/<ubuntu-version>/<feed> directories. Ubuntu breaks up feeds into the following:
 * Main - Officially supported software.
 * Restricted - Supported software that is not available under a completely free license.
 * Universe - Community maintained software, i.e. not officially supported software.
 * Multiverse - Software that is not free. (meaning licensing)

If you are trying to find out what package an application belongs to you have a few choices:
 1. Use {{{dpkg -S}}} on your Ubuntu development host. For example to find the package that contains ifconfig:
{{{
#!bash
$ dpkg -S $(which ifconfig)
net-tools: /sbin/ifconfig
}}}
  * ifconfig is in /sbin/ifconfig and is part of the net-tools package
  * {{{dpkg -L net-tools}}} will show you everything else contained in that package
 2. Use {{{apt-cache search}}}:
{{{
#!bash
$ apt-cache search ifconfig
iproute2 - networking and traffic control tools
net-tools - The NET-3 networking toolkit
gnome-nettool - network information tool for GNOME
inetutils-tools - base networking utilities (experimental package)
libnet-ifconfig-wrapper-perl - multiplatform Perl wrapper for ifconfig
moreutils - additional Unix utilities
wmifinfo - Dockapp that shows information for all interfaces
}}}
 3. Googling the question 'what package contains <xyz>'

Personal Package Archives (PPAs) are package feeds that are not part of Ubuntu and can be used by people to distribute their own personally built packages. To use a PPA you need to first add it to your repository list and update your package sources.

References:
 * [https://help.ubuntu.com/community/Repositories/Ubuntu Ubuntu Software Repositories]
 * [http://askubuntu.com/questions/4983/what-are-ppas-and-how-do-i-use-them What are PPAs and how do I use them]


[=#modem]
== Modem Support ==
Aleksander Morgado (​https://aleksander.es), a key developer behind the !ModemManager, libqmi, and libmbim projects that provide modem support on Ubuntu provides up-to-date Ubuntu PPA's for 14.04 trusty and 16.04 xenial. Instructions on how to add the PPA feeds and update the packages exist there:
 * [https://launchpad.net/~aleksander-m/+archive/ubuntu/modemmanager-xenial modemmanager/libqmi/libmbim PPA xenial]
 * [https://launchpad.net/~aleksander-m/+archive/ubuntu/modemmanager-trusty modemmanager/libqmi/libmbim PPA trusty]

Xenial:
{{{#!bash
apt-get install software-properties-common # contains add-apt-repository
add-apt-repository ppa:aleksander-m/modemmanager-xenial
apt-get update
apt-get install modemmanager libqmi-utils libmbim-utils
}}}

Trusty:
{{{#!bash
add-apt-repository ppa:aleksander-m/modemmanager-trusty
apt-get update
apt-get install modemmanager libqmi-utils libmbim-utils
}}}

See [wiki:wireless/modem modem] for more info on how to use these packages


[=#ssh]
== SSH Server ==
The {{{openssh-server}}} package provides an ssh daemon suitable for secure shell (ssh) and secure copy (scp):
{{{
#!bash
apt-get install openssh-server
}}}

During development it may be useful to enable root ssh capability, which is disabled by default. To do this  edit /etc/ssh/sshd_config, and:
1. comment out the following line:
{{{
#!bash
PermitRootLogin without-password
}}}
2. Just below it, add the following line:
{{{
#!bash
PermitRootLogin yes
}}}
3. Then reload SSH config:
{{{
#!bash
service ssh reload
}}}



[=#wireless]
== Wireless ==


[=#wireless-client]
=== Client using wpa_supplicant ===
These instructions below are for creating a wireless client that will connect to a nearby access point.

1. Install required packages:
{{{#!bash
apt-get update
apt-get install iw
apt-get install wpasupplicant
apt-get install udhcpc
}}}
1. Edit {{{/etc/network/interfaces}}} and edit/add the following to configure wlan0 on boot wpa_supplicant:
{{{#!bash
auto wlan0
iface wlan0 inet dhcp
        wireless_mode managed
        wireless_essid any
        wpa-driver nl80211
        wpa-conf /etc/wpa_supplicant.conf
}}}
1. Create WPA Supplicant Configuration File at {{{/etc/wpa_supplicant.conf}}}, replacing ssid and psk with correct information
{{{#!bash
network={
        scan_ssid=1
        ssid="testssid"
        proto=WPA
        key_mgmt=WPA-PSK
        psk="testpass"
}
}}}
1. Sync and power cycle the board
{{{#!bash
sync
}}}

Troubleshooting:
 * To scan for available access points in range you can use the iw tool:
{{{#!bash
iw dev wlan0 scan # scan for AP's
}}}
 * To manually connect to wireless if auto connection is not working: While the above will configure wireless Client mode on bootup, if you want to start it manually you can do so by manually starting/re-starting wpa_supplicant (ifup will do this for you on bootup if configured in /etc/network/interfaces):
{{{#!bash
ifconfig wlan0 up
killall wpa_supplicant
wpa_supplicant -i wlan0 -D nl80211 -c /etc/wpa_supplicant.conf -B # manage wireless client
udhcpc -i wlan0 # obtain dhcp lease
}}}