There are three sample applications. A running instance of Motr such as singlenode Motr is a prerequisite for compiling, building and running these applications.

1. c0cp
2. c0cat
3. c0rm

Build dependencies using following command

$ ./scripts/install-build-deps

Compile, build and run applications

$ make
$ make test

Generate rc files on VM

$ make vmrcf

make clean

The clean install motr script stops currently running m0singlenode, uninstall motr and motr-devel packages, removes all configuration and storage disks. It then installs the new version pointed by directory path, configures it as a m0singlenode and starts services.

$ ./scripts/clean_install_motr <rpms directory path>
$ # (example) ./scripts/clean_install_motr ./rpms/jenkins-OSAINT_motr-1400-29-g7a51cbd/

Each application requires a resource file residing in the same directory where the application is residing. This resource file contains all Motr-client related resource parameters for running the application on a particular client node where the application is executed. This file can be generated using the cappsrcgen utility for dev VMs. The name of the file should be .[application name]rc. Replace the application name with your application's basename. A c0cp example is shown below:

$ ./scripts/c0appzrcgen > .c0cprc  # Generates configuration

Containts of .c0cprc is as follows

#local address
10.0.2.15@tcp:12345:44:101

#ha address
10.0.2.15@tcp:12345:45:1

#profile id
<0x7000000000000001:0>

#process id
<0x7200000000000000:0>

#tmp
/tmp/

Pre-registration with Sage userID and application names is required. Once registered the sage-user-application-assignment script can be used on the CMU node to generate this information. This script takes Username, app name and the client IP as input and outputs the required resource information. See example below:

[sage0004@sage-cmu]$ sage-user-application-assignment ganesan c0del 172.18.1.21

#
# USER: ganesan
# Application: c0rm
#

#local address
172.18.1.21@tcp:12345:41:304

#ha address
172.18.1.21@tcp:12345:34:101

#profile id
<0x7000000000000001:0x1>

#process id
<0x7200000000000001:0x3b>

#tmp
/tmp/

>> make clean
>> git pull
>> make 
>> make sagercf
>> make test