diff options
author | Tatiana Jamison <tjamison@jaguarlandrover.com> | 2016-02-23 16:46:58 -0800 |
---|---|---|
committer | Tatiana Jamison <tjamison@jaguarlandrover.com> | 2016-02-23 16:46:58 -0800 |
commit | 1529f48c8c2e4d98a99b2f3a28cbe01f8be9cc43 (patch) | |
tree | 730190b24e033e13fccddf4f7247da2e69c87c0c /INSTALL_debian.md | |
parent | ceef6f073b224caddc5e5492d71f85b7ef0a448a (diff) | |
download | rvi_core-1529f48c8c2e4d98a99b2f3a28cbe01f8be9cc43.tar.gz |
[53177] Update installation docs
Add install instructions for Ubuntu 14.04
Add install instructions for Raspbian
Add install instructions for Debian
Update build, readme files to point to install instructions
Diffstat (limited to 'INSTALL_debian.md')
-rw-r--r-- | INSTALL_debian.md | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/INSTALL_debian.md b/INSTALL_debian.md new file mode 100644 index 0000000..cd8ef9c --- /dev/null +++ b/INSTALL_debian.md @@ -0,0 +1,113 @@ +Copyright (C) 2014-2016, Jaguar Land Rover + +This document is licensed under Creative Commons +Attribution-ShareAlike 4.0 International. + +**Version 0.5.0** + +# INSTALLATION OF RVI (DEBIAN) # + +This document describes the installation process for the RVI project +on a Debian 8 ("jessie") Linux machine. Packages are also available +for [Ubuntu](INSTALL_ubuntu.md) and [Raspbian](INSTALL_raspbian.md). +See ```BUILD.md``` for building from source. + +Please see ```README.md``` for a general description of the project +and its structure. + +Please see ```CONFIGURE.md``` for details on configuring and launching +the system once it has been built. + +The first milestone of the RVI project is the HVAC demo. Please see +```hvac_demo/README.md``` for details on how to setup, launch and +drive the demo. + +# READER ASSUMPTIONS # +In order to build the system, the reader is assumed to be able to: + +1. Have a basic understanding of Linux system operations. +2. Install packages on the system. + +Please note that the configuration process described in +```CONFIGURE.md``` may have additional skill requirements. + +# PREREQUISITES # + +1. The Debian 8 system has the latest updates installed. +2. The user can gain root access to install packages. +3. There is at least 5GB of space availabled for packages and code. + +---- + +# INSTALLATION PROCESS # + +## INSTALL DEPENDENCIES ## + +Install dependent libraries via ```apt-get``` - note you must be root: + + apt-get install python-jsonrpclib + +## INSTALL ESL-ERLANG ## + +Install `esl-erlang` 18.2, or a later version 18 release: + +Tested packages of the latest versions of Erlang can be downloaded from +[packages.erlang-solutions.com](https://www.erlang-solutions.com/resources/download.html) + +Add the following line to your /etc/apt/sources.list + + deb http://packages.erlang-solutions.com/debian jessie contrib + +Update and install `esl-erlang`: + + apt-get update + apt-get install esl-erlang + +**If you receive an authentication error** (such as NO_PUBKEY): note +the hexadecimal value (e.g., 6D975C4791E7EE5E) and request the key: + + apt-key adv --keyserver keyserver.ubuntu.com --recv-keys HEX + +where HEX is the hexadecimal value specified in the error. +Then rerun the ```update``` and ```install``` commands. + +## DOWNLOAD AND INSTALL RVI ## + +Download the RVI package from the remote location: + + wget http://(TODO)/rvi_0.5.0-1_amd64.deb + +Then install RVI via dpkg: + + sudo dpkg -i rvi_0.5.0-1_amd64.deb + +---- + +## TEST THE RVI SYSTEM ## + +To confirm that RVI has started, use `systemctl` as root user: + + systemctl status rvi + +Expected output: + + ● rvi.service - Remote Vehicle Interaction Service + Loaded: loaded (/lib/systemd/system/rvi.service; disabled) + Active: active (running) since Mon 2016-02-22 14:16:27 PST; 15min ago + Process: 1922 ExecStart=/usr/bin/rvi_ctl -c /etc/rvi/rvi.config start (code=exited, status=0/SUCCESS) + Main PID: 1954 (run_erl) + CGroup: /system.slice/rvi.service + ├─1954 run_erl -daemon /tmp/rvi_1922/ /var/log/rvi exec erl -boot /tmp/rvi_1922/rvi/start -sname rvi -config /tmp/rvi_1922/rvi/sys -setcookie rvi_cookie + ├─1955 /usr/lib/erlang/erts-7.2/bin/beam.smp -- -root /usr/lib/erlang -progname erl -- -home /usr/lib/rvi_core -- -boot /tmp/rvi_1922/rvi/start -sname rvi -config /tmp/rvi_1922/rvi/sys -setcookie rvi_cookie + ├─1962 /usr/lib/erlang/erts-7.2/bin/epmd -daemon + ├─1983 /usr/lib/rvi_core/deps/bt/priv/bt + ├─1989 inet_gethost 4 + └─1990 inet_gethost 4 + +## CREATE A RELEASE ## + +The installer configures a release with default (insecure) credentials. + +See ```CONFIGURE.md``` for additional details on configuring and +creating a developer and production release. + |