blob: 590bc12985ea87d1716cedab370110ee12ffd71c (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
|
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 https://github.com/PDXostc/rvi_core/releases.
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.
|