Installing on Linux

[thetechnobear]

Normal Installation

To reduce size we split the application into two parts, the main axoloti application, and a runtime which contains other required files. You must download and install both initially.
(Usually updates will only require the main application to be downloaded and installed.)

1. download both application bundle and axoloti_runtime
   • go to http://github.com/axoloti/axoloti/releases , you will see the 'latest release'
   • download axo_runtime_linux_(version).tgz
   • download axoloti_linux_(version).deb

2. install axoloti runtime

   • unpack axo_runtime.*.tgz into user home directory e.g. cd ~ ; tar zxvf axoloti_runtime.tgz
   • you will now have a folder ~/axoloti_runtime/platform_linux

3. install application

   • install debian package, using dpkg, e.g. sudo dpkg -i axoloti_linux_1.012.deb
   • this will install into /opt
   • Axoloti app will be on your application menu (may be different on different distros)

4. install dependent packages

   • using : sudo apt-get install -y lib32z1 lib32ncurses5 lib32bz2-1.0

5. grant permissions for your user to use the USB device

   • make sure the axoloti board is not connected
   • run ~/axoloti_runtime/platform_linux/add_udev_rules.sh

6. Connect Axoloti Core board

7. Run Axoloti application from your menu

Thats it your done,
Happy patching

important note

It appears the runtime no longer contains valid certificates, so you will need to install the java certificates package and then do the following:
(this will cause an error in axoloti, see other thread below)

• stop axoloti ui
• start terminal, and enter
  • sudo cp /etc/ssl/certs/java/cacerts /opt/Axoloti/runtime/lib/security/cacerts
• start axoloti
• file->preferences -> reset all

---

Recommended Platform

Axoloti runs on many platforms and variations, but we are only able to test on limited number of platforms, if you experience issues we recommend the following, as these are our test platforms.

• Ubuntu Linux 14.04 LTS
• OpenJDK Java 1.7
• gcc-arm-none-eabi (> 4.9-2015q2), this needs 32bit libc

Developer Installation (from source)

If you are a developer and would like to follow the most up to date developments, and perhaps contribute to Axoloti development you can install from the Axoloti github repo

• clone from github
• run build.sh in platform_linux*
• run ./Axoloti.sh

Note: to create the bundles you will need to install the oracle java 8 Jdk

Notes:
* build.sh will install all dependent packages, and assumes these are up to date for your distribution.
If you have issues, please check the versions of the dependencies installed.

[thetechnobear]

note: there is a current issue with 1.0.11, and certificates not being installed by the installer

when running axoloti the first time you will see
Sync (pull) FAILED : factory (1.0.11,anon)
org.eclipse.jgit.api.errors.TransportException: https://github.com/axoloti/axoloti-factory.git: cannot open git-upload-pack

to workaround, you need to enter the following command
sudo cp /etc/ssl/certs/java/cacerts /opt/Axoloti/runtime/lib/security/cacerts

see this post for details

this has been caused by a change in the jdk, I hope to resolve this in a future axoloti release.

[mongrol]

Note that on Ubuntu 16.04 installing the default-java package still does not install the certificates. You must install the ca-certificates-java package then do the cp command above.

[thetechnobear]

I'd like to find a way to package the certs with the javafx install, but not had time as yet. Any help gratefully received

[mongrol]

Should be as simple as specifying the cert package as a dependency in the axo deb.

[thetechnobear]

not as simple as that, because we use javafx, which as well as giving us the application wrapper, gives us the packaging... so I need to see how to integrate that, as I'm not sure it allows package dependancies to be specified.
anyway, I will work it out, just need to find some time.

[mongrol]

Ah yes, I remember having this conversation before.