MMS App

The MMS OCE app provides for converting an USDS formatted message to an MMS and sending it. This is a grey area application in place to bridge gaps until Fautore is more widely used. In the strict senses, sending an MMS message is turning the POD protected data over to a third party, a definite violation of the OSA principles. Use of this app should be constrained to simple "Hey you got a message" notifications that do not actually contain message data. Visibility enforcement is in progress to ensure OSA principles are not violated in the use of this app.

MMS App

Registration

The fauMMSSMS app is registered to the OCE via command line.

{OCE home}/apps/fauMMSSMS/fauMMSSMS.pl -r <membername> <password>

where

{OCE home}
the location to which the OCE is installed

<membername>
the login name of a POD member authorized to register applications

<password>
the current tribe password for the registering member. The password is exposed when entered as a parameter on the command line

Note:

You may receive a series of errors citing :

DBD::SQLite::db prepare failed: no such table:

the first time fauMMSSMS is run. This is normal and a self correcting error.

Management

The fauMMSSMS app is managed via command line.

{OCE home}/apps/fauSMTP/fauSMTP.pl [opts] <action>

Action Commands

stop	Stop the server
start	Start the server
restart	Stop server (if it was running) and then start it

Options

Option	Param	Example	Description
-r	username	-r Harold MyVisiblePassword	Register this application with Fautore OSA/OCE
-usdsport	integer	-usdsport 24240	Set a new port number to listen for for USDS messages (default is 20010)
-jsonport	integer	-jsonport 5981	Set a new port number to send OCE communications (default is 1895)
-usefromsmtp	0 or 1	-usefromsmtp 1	Switch outgoing SMTP mail to use the from address SMTP server (its realm) rather than using that of the to address. Value may be any of 0 1 on off
-dedicatedsmtp	string	-dedicatedsmtp myhost.com,26,mruser,somepass	Switch outgoing SMTP mail to use a dedicated SMTP server as defined within the values. The values are a comma delimited string of hostname,port,username,password.
-settings	N/A	-settings	Display control/configuration settings
-pullinfo	N/A	-pullinfo	Retrieve and Display OSA data synchronisation status.
-pullcfg	N/A	-pullcfg	Retrieve and Display OSA member settings data synchronisation status.
-clearqueue	N/A	-clearqueue	Clear the outgoing unsent mail queue (all mail will be lost)
-test	membername	-test bigfoot	Send a test message to the specified tribe member name

Operational Overview

The fauMMSSMS application is an entirely reactionary tool that cannot initiate an inbound message to the OCE. For this reason the only way to use this application is in response to some other action within the OCE. The general concept is that some event within the OCE, such as receiving an expected message would trigger the sending of an MMS message to an intended recipient.

Use of the fauMMSSMS application is set up via Fautore Instructions. An example workflow would be that of setting up an instruction trigger so that if a (USDS) message comes in from a specific tribe member that the message itself is passed to a specified application and a text stating "The message you've been waiting for has arrived" is additionally sent to the recipient.

Member Configuration

Once installed this application is available to all members. It cannot however be used until the member wishing to make use of the application is set up. The fauMMSSMS application sends the MMS message by parsing the inbound USDS message from the OCE into an email format and sending it to the receiving member's telephone MMS or SMS service. The sending members "text by email" service must be configured in Fautore in order for the converted OSA/USDS message to be sent.

1.1.1. Accessing Application Configuration

All applications are configured from the "External Applications" button in the main button bar.
From here all application available to the currently logged in tribe member will be listed.

App & Member Selection

The External Applications screen will list all applications available to the logged in member.
Two screen objects will appear for applications that have member specific configuration options available to it. These screen object will not be available for application that cannot be configured to specific tribe member needs.

Member Name: The "Member Name field is a drop down that will list all members for which the currently logged in member has privileges to changes application values. The tribe "Chieftain" can change anyone's values, a "Chief" can change anyone but the "Chieftain" related values. All others can change only their own values.
Note
The "Default" dropdown selection is supposed to set the Fautore defaults for the application. This has not yet been proven to work. Please delete this note if you have proven it to work.

App Specs: The "App Specs" button will bring forward the screen specific to the external application for entering member specific configuration values. The values entered to this screen will be applied only to the member selected in the "Member Name" dropdown.

Application Configuration Values

The "Application Configuration Values" screen is different for every application that accepts member specific configuration items. The below listed screen is specific to the fauMMSSMS application.

Field	Example	Description
10 Digit Phone Number	5557462281	The ten digit number for the phone that will receive the text message when sent. Use digits only and no other characters like dots, dashes or parens.
Domain Name of Service	mms.att.net	In technical circles this is called the Fully Qualified Domain Name of the server to receive the text for processing. For simplicity sake you can think of this as being very much like the URL one often types into the address bar of their browser.
Service Type	MMS	Dropdown field with option to select either MMS for "MultiMedia Service" or "SMS" for "Simple Messaging Service." The entry to the "Domain Name Service" field will often provided clues as to the correct value to select. If the entered domain contains "mms" them MMS is the correct selection here. If the entered domain contains "sms" or "text," then chances are SMS is the correct selection. Most smart phones will use a MMS service and flip type phones will use a SMS type service.
From Email Address	MyEmail@TekAdv.com	The recipient of the text cannot reply directly back to the OCE (Fautore). The email address provided here will receive any replies.
Dedicated Outgoing SMTP Server:Port	mail.tekadv.com:26	This is the email server Fautore should use to send the text message. Text message are sent to phone service providers as email. the provider then converts it to a text and send it to the phone at the number above. What is being listed here is the email server to use sending the email containing the text. The port value is "25" as the common standard. Some Internet Service Providers block port 25 from going out and in these cases value "26" is a good substitute. Trial and error often gets it pretty quickly, or you can consult the documentation for your mail service provider.
Dedicated Outgoing User Name	BigFoot@tekadv.com	This value is for the mail service account name expected by the "Dedicated Outgoing SMTP Server" to be identified as a valid user of that server.
Dedicated Outgoing Password	NotHiddenHere	This value is for the password for the account listed as the mail service account name expected by the "Dedicated Outgoing SMTP Server" to be identified as a valid user of that server.

Click "Submit" and the values will be recorded and you will be returned to the External Applications screen.