Installation: Debian-Based Linux
This guide shows you how to install ARDI on Debian-based variants of Linux, including our preferred variants, Ubuntu 16.04 LTS (for virtual machines and desktops) and Raspbian for Raspberry PI.
Scripted Install
Optrix offers a Debian Install Script designed to install ARDI on some of the most popular debian-based systems, such as Ubuntu and Raspbian.
The installer should run on any relatively modern version (it must support PHP 5.6 or higher), but it has been specifically tested on…
| Tested Platforms |
|---|
| Ubuntu 16.04 LTS |
| Raspbian Jessie |
| Debian Jessie |
| No Longer Available For |
|---|
| Ubunto 14 Or Below |
Known Incompatibilities
| Not Working On |
|---|
| Ubuntu 18.04 LTS |
Currently, ARDI has an issue running with PHP 7.1 or higher, while the 18.04 version of Ubuntu defaults to using 7.2. We will be offering an update shortly.
Size
A full installation of ARDI (including all of its libraries and associated services) should consume approx. 550MB on your device.
Note that this is the initial install size only - as you add assets, your ARDI database and cache will continue to grow beyond that initial amount. Addons - particular the ARDI-VE addon - can add considerably to that amount.
Install It
Follow the steps below in a terminal window ( or via SSH )…
- Download the script
wget http://repo.optrix.com.au/installers/debian
- Mark the script as 'executable'
chmod a+x debian
- Execute the script
sudo debian
or
sudo debian beta
Note that if you would like to install the unstable (pre-release) version of ARDI, you can add the word 'beta' to the end of the command - for example, sudo . debian beta will launch the installation of ARDI Unstable.
In the above example, sudo was used to run the installation with elevated priviliges. Some platforms such as Debian Jessie don't include sudo by default. In this case, login as root and skip the 'sudo' part of the command.
This will perform a full unattended installation - it will update all of the packages on the system, download and install both ARDI and all of its pre-requisites. It will also include some common additional content, such as drivers and popular addons.
As part of the installation, it will set up your first ARDI database.
Note that this script is intended for a brand new, clean system. It may overwrite or alter settings if your system offers other services.
Add Additional Drivers/Addons
This installs a basic ARDI system, but it does not include any addons and only includes the most basic drivers.
Now is a good time to install any additional software and consider installing addons.
Addons are installed using the Debian package manager. For example, to install the addon to integrate with the SeedDMS document management system, you'd type…
sudo apt-get install ardi-seeddms
Or to install the ARDI MySQL driver to access databases for live or historical information, you'd use…
sudo apt-get install ardi-mysql
See the list of ARDI addons and the list of ARDI drivers for more information on what additional components are available and what their packages are called.
Once downloaded, you'll need to install your license file. If you have issues, check our ARDI Installation Troubleshooting Guide.