doc: Install chrpath
[iotivity.git] / README-building-and-running-remote-access-sample.txt
1 == Quick guide: build and run IoTivity(remote access) projects on Ubuntu ==
2
3 1. Build
4         Go to the top directory of 'iotivity' project
5     (Note: should always run 'scons' command in this directory)
6
7     Install external libraries (on Debian based OS):
8       $ sudo apt-get install libboost-dev libboost-program-options-dev libboost-thread-dev uuid-dev libssl-dev
9       $ sudo apt-get install libglib2.0-dev autoconf libtool chrpath
10
11     Or check this page for more updated info:
12     https://wiki.iotivity.org/os
13
14     Build release binaries:
15       $ scons WITH_RA=1 WITH_RA_IBB=1
16 (Note: C sdk requires tiny-cbor. Please follow the instruction in the build
17 message to install tiny-cbor)
18
19     Build debug binaries:
20       $ scons WITH_RA=1 WITH_RA_IBB=1 RELEASE=false
21
22     Help:
23       $ scons -h
24
25     Clear:
26       $ scons -c
27
28 2. Run the remote access testing
29     remote access samples in <iotivity>/out/linux/x86_64/release/resource/csdk/stack/samples/linux/SimpleClientServer
30
31     before testing,
32       setup a XMPP server and create an account in XMPP server
33       ex: account: user1@localhost / password: 1234
34
35     oic server:
36       $ ocserver -o 1 -u user1 -d localhost -w 1234 -s localhost
37
38     oic client:
39       $ ocremoteaccessclient -t 1 -u user1 -d localhost -w 1234 -s localhost
40
41     test steps:
42       1. run ocserver, and copy the bound jid
43       2. run ocremoteaccessclient on the another term, and paste the bound jid of ocserver and press 'Enter'
44         use '-t' to change testcase.
45