Tutorials

Step 1. Upgrade your OS. ARTIK modules come pre-loaded with a specific Linux operating system (OS), depending on module type:

• Ubuntu only (ARTIK 530s and 710s modules)
• Fedora upgradable to Ubuntu (ARTIK 530 and 710 standard modules)
• Fedora 24 only (ARTIK 520)
• Fedora 22 only (ARTIK 1020).

Fedora is more compact than Ubuntu, but its support lifetime is limited compared to Ubuntu (5 yrs). Move to Ubuntu now to avoid reloading all your software and tools later. Click to install the latest ARTIK image and choose the newest image for your module.

Step 2. Connect to a Network. To load software, you'll need to either connect an Ethernet cable or set up your Wi-Fi^® network and password.

Try out "on-boarding." If you like, jump ahead to the Connect to the World article to set your network connection using a simple smart phone app.

Step 3. Upgrade installed packages. Start by reading a primer on package management systems. Now you're ready for the latest software updates.

In the version of Ubuntu we use, apt-get and apt are nearly interchangeable. We use apt but you can feel free to use either.

Ubuntu

apt update

apt upgrade

apt install build-essential

Fedora

Verify your repository first as noted below, then type
dnf upgrade

Note: A patch is available in the repositories for the KRACK vulnerability of wpa_supplicant. Simply run the normal update/upgrade process to implement the fix. You can also patch just the affected package as follows.

Ubuntu

apt update

apt install --only-upgrade wpasupplicant

Fedora

dnf upgrade wpa_supplicant

Step 4. Install a development environment on your PC. If you loaded the ARTIK IDE earlier, you're nearly done – go to the Update SDK article to check for updates. If not, go to Software Tools to get an overview of what's available.

Step 5. Update SDK. ARTIK API support is included automatically when you install the ARTIK IDE. For the latest Ubuntu images (os_18.05.00 or newer), just update the SDK version on the board.

apt install libartik-sdk

For Fedora or older Ubuntu images, you need to enable repository access on your ARTIK board first and then install the SDK as directed in that article.

Step 6. Add additional packages. You'll eventually want to add other software, typically using a package installer. We've included instructions throughout the articles about what packages you'd need for a specific feature (like adding Node-RED as we describe in the Tutorials).

Verifying Fedora repository

At the conclusion of active development for a given Fedora release, Fedora repositories may be phased out and moved to a permanent archive. If you are having any problems with dnf update or package downloads, make sure the repository URLs point to the right locations.

You'll find the information in /etc/yum.repos.d/ in various files. You can either change them manually or use a command like the one below to make the substitution.

sed -i 's|archive\.fedoraproject\.org\/pub|archives\.fedoraproject\.org\/pub\/archive|g' /etc/yum.repos.d/*