Sample configuration for beacons

Requirements and required steps

Required thing types

• amtechM2mBridge
• BLEbeaconsScanner

As a creator define a service with actor(s)

• Define and actor and name it.
• Add to the actor policies to GET (read), POST (create) and/or PUT (edit) entities of the required types. In this case amtechM2mBridge and BLEbeaconsScanner.
• Create an activity and name it.
• Add this actor to the activity.
• Optionally add logic to the activity through new observers/reasoners/etc.
• Publish the activity and in the process, share it with at least one follower tenant by using the property guesttenants. Now the admin of these tenants will have the possibility to subscribe to the generated service and invite new users to its own tenant using the actors defined by the service or a subset of them.

As follower admin

• Subscribe to the service that the creator is offering.
• Figure out the accesses you want to give to the bridge or bridges that will be configured based on this service and design a serie of invited followers (one for each bridge). Invite these new users (bridge users) to the tenant with the actors defined by the creator or a subset of them.

Design the bridges

Still as follower admin (although this can also be done by the creator), start designing the bridge templates:

• Create a new BLEbeaconsScanner instance and configure all its required properties.
• Create an amtechM2mBridge instance.
• Configure required properties and useful properties as:
  • Add the BLEbeaconsScanner instance to the bridge instances
  • Configure bridge error observation config (topic needed).
  • Might be useful to configure the logger level to "debug" instead of the default value "error".
  • Do the observation production configuration part.
  • If configured as creator, share this bridge instance with the follower tenant so that invited users belonging to the least can clone it.
• Validate the bridge (it should validate or otherwise you should have overlooked some of these steps)

As invited user to the follower tenant

• Accept the invitation sent by the follower admin.
• Configure the bridge with the DAP URL and your credentials in bridgeConfig.json
• Set the configured bridge as the template.
• Configure all the other required properties as templateId, bridgeIdPrefix, etc.
• Run the bridge.