SAMBRO Guide

An Introduction to SAMBRO (Sahana Alerting and Messaging Broker)

Purpose

The user guide provides a set of step=by=step instructions from installing, customizing, and operationaizing SAMBRO software to issue and manage alerts. It is intended for all user levels: novices to experts. The guide is structured to take you through an actual implementation with real world examples and data.

How to use the Guide

The user guide is designed to quickly access relevant information for performing a user's role specific task. The topics are ordered such as that tthe most frequently used activities are listed first, like subscribing to alerts, and the seldom used, one time Admin type activities, are listed at the bottom. We have segmented the role specific work flow topics. If you are a particular user searching for a topic, first navigate to the type of user you are and then select the work flow activity.

Role Specific Topics

Subscribers (Alert Recipients)

1. RSS/Atom Feeds for your alert hub or RSS/Atom Reader for all alerts
2. Email, SMS, FTP subscription to receive event and area specific alerts
3. UNAVAILABLE Social Media - link to Twitter, FaceBook news feeds applying the instructions given by the Administrator
4. View Alerts and interpret them on a map and complete

Publishers (Alert Issuers)

The section discusses ways and means for creating a CAP message, having it authorized, and then issuing (or disseminating) to the subscribers

1. Create a message for the first time and as a message originator
2. Update a message using an existing message
3. Cancel a message that has been wrongly issued or provided wrong information
4. Clear a message when the event has subsided to inform the subscribers with an 'All Clear' message
5. Authorize a message before issuing, posting or dissemination

Implementers (Super Users)

Section is for CAP Implementers for orienting the CAP Broker in the country or implementation specific context.

1. Manage Users by associating them with the relevant roles and alerting authority
2. Create Message Templates for categories of events and user groups
3. Predefined Alert Area polygon and area description developments
4. Update Register of Alerting Authorities; i.e. setup your organizational structure and alerting jurisdictions
5. Define CAP Profile specific information (waring priorities, event types, incident tables)
6. Configure Broker with identifier, warning priorities, and other relevant implementation or country context information
7. Testing the implementation after setup, configuration, and adding users

System Administrators

Steps for INSTALLING your SAMBRO instance

1. [OPTIONAL] Branch an instance of the Sahana Eden code to a new github repository of your own. This would allow you to manage your own customized implementation such as with changing the theme. Ohterwise, ignore this step and pull the code from the main github repository; explained in the subsequent step.
2. Activate the script to automatically pull the latest version of the code from your github repository.
3. Install the Sahana Eden software with web2py framework and other dependencies.
   1. Recommend that you install on a Linux server
   2. Setup the server with a Public IP to be visible over the Internet
   3. Configure the installation to send receive SMS, Email.
   4. Activate the SAMBRO template by changing the default template. Follow the code snippet below.{{{

ADD ACTUAL CODE SNIPPET TO CHANGE TEMPLATE SPECIFIC TO SAMBRO }}}
Steps for CUSTOMIZING your SAMBRO instance

1. Customize the CAP Broker for the implementation context (e.g Admin contact details, banner or logo changes
2. Basic Administration tasks for activating an instance for the users
3. Testing the installation to ensure all SAMBRO specific features are functional

Design and Specifications

For advance users or developers interested in the SAMBRO software design requirements and specifications are discussed in the
CAP Broker BluePrint