= SAMBRO Guide = [[TOC]] [http://eden.sahanafoundation.org/wiki/Deployments/SAMBRO 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. [[br]] === 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''': 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO#SubscribersAlertRecipients How to receive alerts?] Steps for first registering in SAMBRO as a Subscriber (Closed User Group; e.g. first-responder) to receive location, event type, and warning priority specific messages as well as public alerts 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO#PublishersAlertIssuers How to create, authorize, and disseminate alerts?] Instructions for Alerting Authorities for managing the process of issuing alerts to Closed User Groups (CUGs) and the Public 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO#ImplementersSuperUsers How to implement SAMBRO for your alerting needs?] For Super Users to define the user roles/responsibilities, message qualifiers, message templates, first-responder groups, and standard operating procedures. 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO#SystemAdministrators How to install and operationalize SAMBRO software?] Guides a Systems Administrator through installation and customization process to get SAMBRO up and running. == Role Specific Topics == ==== Subscribers (Alert Recipients) ==== WARNING! SAMBRO has the option of [# subscribing to new feeds] that can be rendered in the News Feeds column in the home page. That administrative process should not be mistaken with the subscription work flows discussed in this section, which is specific to subscribing to SAMBRO feeds[[br]][[br]] There are two types of alert recipients: Public and CUGs. Public can subscribe to RRS/Atom and Social Media feeds. CUGs have all the previledges the pubic has plus other options to receive email and SMS alerts filtered by location, event type, and warning priority. 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Subscribe#RSSAtomFeeds RSS/Atom Feeds] for your alert hub or RSS/Atom Reader for all alerts 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Subscribe#SubscribeViaEmailSMSandFTP Email, SMS, FTP] subscription to receive event and area specific alerts 1. '''UNAVAILABLE''' [# Social Media] - link to Twitter, FaceBook news feeds applying the instructions given by the Administrator 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Subscribe#Viewpublishedalerts 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. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Publish#CreateaCAPMessage Create] a message for the first time and as a message originator 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Publish#UpdateCancelorClearaCAPMessage Update] a message using an existing message 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Publish#UpdateCancelorClearaCAPMessage Cancel] a message that has been wrongly issued or provided wrong information 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Publish#UpdateCancelorClearaCAPMessage Clear] a message when the event has subsided to inform the subscribers with an 'All Clear' message 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Publish#AuthorizeaCAPMessage Authorize] a message before issuing, posting or dissemination 1. [# Testing the publishing of alerts] ==== Implementers (Super Users) ==== Section is for CAP Implementers for orienting the CAP Broker in the country or implementation specific context. 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/Admin/UserManagement Manage Users] by associating them with the relevant [http://eden.sahanafoundation.org/wiki/BluePrint/CAPBroker#Use-Cases roles] and alerting authority 1. [# Edit First-Responder compulsory messaging lists] to force messages (i.e. Admin/Implementer defined subscriber lists) 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Implement#CreateMessageTemplate Create Message Templates] for categories of events and user groups 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Implement#CreatingPredefinedAlertArea Predefined Alert Area] polygon and area description developments 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Implement#ManagingtheRegisterofAlertingAuthoritiesandOIDs Update Register of Alerting Authorities]; i.e. setup your organizational structure and alerting jurisdictions 1. [wiki:UserGuidelines/SAMBRO/Profile Define CAP implementation specific information] such as Waring priorities, Event types, Incident tables, ... 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/SAMBRO/Implement#Configure Configure Broker] with identifier, warning priorities, and other relevant implementation or country context information 1. [# Subscribe to external feeds] to render other CAP, RSS/Atom, Social Media (Twitter, Facebook ...), or News Bulletines 1. [# Testing the implementation] after setup, configuration, and adding users ==== System Administrators ==== Steps for '''INSTALLING''' your SAMBRO instance 1. ''[OPTIONAL]'' [http://eden.sahanafoundation.org/wiki/ConfigurationGuidelines#SwitchtoanalternateGitHubrepo 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. 1. Activate the [# script to automatically pull the latest version] of the code from your github repository. 1. [http://eden.sahanafoundation.org/wiki/InstallationGuidelines Install] the Sahana Eden software with web2py framework and other dependencies. a. Recommend that you [http://eden.sahanafoundation.org/wiki/InstallationGuidelines/Linux/Server install on a Linux server] a. [# Setup the server with a Public IP] to be visible over the Internet a. [# Configure the installation] to send receive SMS, Email. a. [http://eden.sahanafoundation.org/wiki/ConfigurationGuidelines#ChangingtheTemplate Activate the SAMBRO template] by changing the default template. Follow the code snippet below.{{{ ADD ACTUAL CODE SNIPPET TO CHANGE TEMPLATE SPECIFIC TO SAMBRO }}} [[br]] Steps for CUSTOMIZING your SAMBRO instance 1. [http://eden.sahanafoundation.org/wiki/ConfigurationGuidelines Customize] the CAP Broker for the implementation context (e.g Admin contact details, banner or logo changes 1. [http://eden.sahanafoundation.org/wiki/UserGuidelines/Admin Basic Administration] tasks for activating an instance for the users 1. [# 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[[br]] [wiki:BluePrint/CAPBroker CAP Broker BluePrint]