Uplift rapidjson version to follow upstream
[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:
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
10
11     Build release binaries:
12       $ scons WITH_RA=1 WITH_RA_IBB=1
13 (Note: C sdk requires tiny-cbor. Please follow the instruction in the build
14 message to install tiny-cbor)
15
16     Build debug binaries:
17       $ scons WITH_RA=1 WITH_RA_IBB=1 RELEASE=false
18
19     Help:
20       $ scons -h
21
22     Clear:
23       $ scons -c
24
25 2. Run the remote access testing
26     remote access samples in <iotivity>/out/linux/x86_64/release/resource/csdk/stack/samples/linux/SimpleClientServer
27
28     before testing,
29       setup a XMPP server and create an account in XMPP server
30       ex: account: user1@localhost / password: 1234
31
32     oic server:
33       $ ocserver -o 1 -u user1 -d localhost -w 1234 -s localhost
34
35     oic client:
36       $ ocremoteaccessclient -t 1 -u user1 -d localhost -w 1234 -s localhost
37
38     test steps:
39       1. run ocserver, and copy the bound jid
40       2. run ocremoteaccessclient on the another term, and paste the bound jid of ocserver and press 'Enter'
41         use '-t' to change testcase.
42