View source for How to install & execute

== Os and core components ==
=== Manual installation of initial components and prerequesites ===
* Installs Ubuntu OS on a Raspberry PI
: <code>https://ubuntu-mate.org/raspberry-pi/</code>
* Boot PI and update packages:
: <code>sudo apt-get update</code>
: <code>sudo apt-get dist-upgrade</code>
* Install java 7 (if LLRPReader is needed)
: <code>sudo add-apt-repository ppa:webupd8team/java</code>
: <code>sudo apt-get update</code>
: <code>sudo apt-get install oracle-java8-installer</code>
* Install nodejs 
: <code>sudo apt-get install nodejs -y</code>
: <code>sudo npm install -g n</code>
: <code>n 7.4.0 </code>
: <code>sudo apt-get remove nodejs -y</code>

* Install other requirement needed for building some libraries:
: <code>apt-get install autoconf libtool</code>
* Installs and configures Bluetooth core libraries (needed by bluetooth related plugins)
: <code>sudo apt-get install bluetooth bluez libbluetooth-dev libudev-dev</code>
* Allow nodejs to read from bluetooth devices (required by bluetooth related plugins):
: <code>sudo setcap cap_net_raw+eip $(eval readlink -f `which node`)</code>
* Allow non-privileged users (belonging to gpio group) to run GPIO commands (required by GPIO plugin):
: <code>git clone git://github.com/quick2wire/quick2wire-gpio-admin.git</code>
: <code>cd quick2wire-gpio-admin</code>
: <code>make</code>
: <code>sudo make install</code>
* Add user that runs the bridge to communicate through serial ports (required by ArduinoSerial plugin):
: <code>adduser <username> dialout</code>
* Install snmp if you are planning to configure a SNMPDevice instance to monitor the Raspberry Pi
    [https://www.digitalocean.com/community/tutorials/how-to-install-and-configure-an-snmp-daemon-and-client-on-ubuntu-14-04 how-to-install-and-configure-an-snmp-daemon-and-client-on-ubuntu-14-04]
    sudo apt-get update
    sudo apt-get install snmp snmp-mibs-downloader
    sudo apt-get update
    sudo apt-get install snmpd
    sudo download-mibs
    ======================================================================
    Edit /etc/snmp.conf
    remove comment from #mibs : to mibs : 
    =======================================================================
    Edit /etc/snmp/snmpd.conf
    1)At ACCESS CONTROL give Full access from the local $
    *remove comment the line rocommunity public  localhost 
    *add the line rwcommunity private
    *comment #rocommunity public  default    -V systemonly
    *comment # rocommunity6 public  default   -V systemonly
        ###############################################################################
        #
        #  ACCESS CONTROL
        #
                                                         #  Full access from the local $
         rocommunity public  localhost
         rwcommunity private
                                                         #  Default access to basic sys$
        # rocommunity public  default    -V systemonly
        #  rocommunity6 is for IPv6
        # rocommunity6 public  default   -V systemonly
    2)At SYSTEM INFORMATION to make write/read sysLocation and sysContact
    *comment line #sysLocation    xxxxxx
    *comment line  #sysContact     xxxxxx
        ###############################################################################
        #
        #  SYSTEM INFORMATION
        #
        #  Note that setting these values here, results in the corresponding MIB object$
        #  See snmpd.conf(5) for more details
        #sysLocation    xxxxxx
        #sysContact     xxxxxx       
    ========================================================================================
    sudo service snmpd restart

=== M2MBridge installation ===

* Use your credentials to identify yourself in the UI at https://platform.amtech.mx
* By using the menu go to <code>Main menu > Sensors > M2MBridge application </code>
* Save <code>M2MBridge.tar.gz</code> to the directory of your choice
* Untar the content:
: <code>tar xzvf M2MBridge.tar.gz</code>
* Delete unneeded plugins from M2MBridge/plugins/xxx (optional)
* Install packages for m2mBridge core and plug-ins (https://docs.npmjs.com/cli/install)
* Install a couple of requirements:
** <code>sudo apt-get install libzmq-dev libavahi-compat-libdnssd-dev</code>
* Execute <code>npm install --save</code> at:
** M2MBridge directory
** Each plugin directory
*: LLRPReader plugin depends on java module and you should use the following options in the the <code>npm install</code> call:
*: <code>GYP_DEFINES="armv7l=0 javalibdir=/usr/lib/jvm/java-7-oracle/jre/lib/arm/server/" CCFLAGS='-march=armv7' CXXFLAGS='-march=armv7' npm install</code>
*If you get this error; var cwd = process.cwd(); Error: No such file or directory #200
: <code>https://github.com/foreverjs/forever/issues/200</code>

=== M2MBridge execution ===
* Customize the bridge configuration [[Edge_Configuration|bridgeConfig,json]], defining the templateId with the bridge instance from DAP to clone [[Cloud Configuration]]
* Set environment variable NOBLE_REPORT_ALL_HCI_EVENTS=1 ([https://github.com/sandeepmistry/noble/blob/master/README.md#reporting-all-hci-events reporting all HCI events])
* Execute M2MBridge.js startup script (located in the M2MBridge directory)
: <code>sudo NOBLE_REPORT_ALL_HCI_EVENTS=1 M2MBridge.js

=== Tools for configuration ===
* If you want to connect a device (like the LLRP Reader) to your PI by sharing you network you may want to run:
: <code>nm-connection-editor</code>
: Find there the connection that represents your ethernet card and configure in IPv4 Settings the method ''Shared to other computers''
* If you want to guess the IP that is assigned through DHCP to a device connected by using the previously mentioned option, you can inspect the syslog with:
: <code>grep DHCPREQUEST /var/log/syslog</code>

== The ansible way ==

This guide assumes you already have ansible installed (detailed instructions in [[Install ansible and requirements|this guide]])

* In the directory of your choice, get a clone of the deployment project:
*: <code>git clone https://github.com/AMTechMX/m2mbridge_deployment.git</code>
* Change directory to m2mbridge_deployment
* Update your inventory by editing <code>static_inventory</code> file. Example:
*: <syntaxhighlight lang="ini">
 [rpis]
 10.0.0.10
 10.0.0.11
 10.0.0.12
</syntaxhighlight>
*: {{Note|You need to configure private/public keys to access this hosts through SSH without password.}}
* Configure common options in rpis/group_vars/all
* Create a file for each host configured in rpi/host_vars whose name matches the IP address. For instance:
*: <syntaxhighlight lang="linuxconfig">
 plugins_enabled: [ SNMPDevice, LLRPReader ]
 bridge_description: Amtech M2M Bridge
 template_id: m2mCreator:m2mBridge
 bridge_id_prefix: tienda1
 location: {"wkt":"POINT(-99.17125583 19.40501031)","sContext":"geo"}
 address_country: usa
 address_city: Las Vegas
 address_road: Las Vegas Boulevard South
 address_number: 3960
</syntaxhighlight>
* cd into rpis directory
* Run ansible playbook:
*: <code>ansible-playbook -i static_inventory main.yml</code>

== Remote debugging ==
*Install VSCode in your machine https://code.visualstudio.com/
*If you need to modify the node code at the Raspberry Pi while debugging setup a share directory using samba
**Install Samba 
**<code> sudo apt-get install samba samba-common-bin -y</code>
**Configure share directory
***http://www.htpcguides.com/create-samba-share-raspberry-pi/
*At M2MBridge directory run 
**<code> node --debug-brk M2MBridge.js</code>
*At your laptop 
**Open shared or local folder from vscode
**Configure launch.json https://code.visualstudio.com/Docs/editor/debugging
*** set "address": "raspberry-pi ip address" and "remoteRoot": "shared-directory name"
<syntaxhighlight lang="jsonld"> 
{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Launch",
            "type": "node",
            "request": "launch",
            "program": "${workspaceRoot}/M2MBridge.js",
            "stopOnEntry": false,
            "args": [],
            "cwd": "${workspaceRoot}",
            "preLaunchTask": null,
            "runtimeExecutable": null,
            "runtimeArgs": [
                "--nolazy"
            ],
            "env": {
                "NODE_ENV": "development"
            },
            "externalConsole": false,
            "sourceMaps": false,
            "outDir": null
        },
        {
            "name": "Attach",
            "type": "node",
            "request": "attach",
            "port": 5858,
            "address": "raspberry-pi ip address",
            "restart": false,
            "sourceMaps": false,
            "outDir": null,
            "localRoot": "${workspaceRoot}",
            "remoteRoot": "shared-directory name"
        }
    ]
}
</syntaxhighlight>