From e836ed5ea3e5a5074b9615edf1c90cf652c12f87 Mon Sep 17 00:00:00 2001
From: Russell Bryant <russell@russellbryant.com>
Date: Fri, 9 Mar 2007 23:59:10 +0000
Subject: [PATCH] Merge some updates to the SLA documentation.  I plan to keep
 working on this to explain all of the expected behavior with call handling,
 configuration details for specific phones, and other things.  However, I got
 tired of doing it in plain text, so I switched to using LaTeX.  I have
 included the PDF version. I haven't been able to get a nice looking plain
 text version out of it yet, but I'm not terribly concerned since this is
 supposed to be more of the manual, while the plain text sample configuration
 file is the reference.

git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/1.4@58638 65c4cc65-6c06-0410-ace0-fbb531ad65f3
---
 doc/sla.pdf | Bin 0 -> 66509 bytes
 doc/sla.tex | 339 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 doc/sla.txt | 225 ----------------------------------
 3 files changed, 339 insertions(+), 225 deletions(-)
 create mode 100644 doc/sla.pdf
 create mode 100644 doc/sla.tex
 delete mode 100644 doc/sla.txt

diff --git a/doc/sla.pdf b/doc/sla.pdf
new file mode 100644
index 0000000000000000000000000000000000000000..e61bdeeb229f2de3a55ee94d87c747ac069c77cd
GIT binary patch
literal 66509
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

literal 0
HcmV?d00001

diff --git a/doc/sla.tex b/doc/sla.tex
new file mode 100644
index 0000000000..735285e352
--- /dev/null
+++ b/doc/sla.tex
@@ -0,0 +1,339 @@
+\documentclass[12pt,a4]{article}
+\usepackage{hyperref}
+
+\author{Russell Bryant \\ Software Engineer \\  Digium, Inc.}
+\title{Shared Line Appearances}
+
+\begin{document}
+\maketitle
+
+\tableofcontents
+
+\section{Introduction}
+
+The "SLA" functionality in Asterisk is intended to allow a setup that emulates
+a simple key system.  It uses the various abstraction layers already built into
+Asterisk to emulate key system functionality across various devices, including
+IP channels.
+
+\section{Configuration}
+
+\subsection{Summary}
+
+An SLA system is built up of virtual trunks and stations mapped to real
+Asterisk devices.  The configuration for all of this is done in three
+different files: extensions.conf, sla.conf, and the channel specific
+configuration file such as sip.conf or zapata.conf.
+
+\subsection{Dialplan}
+
+The SLA implementation can automatically generate the dialplan necessary for
+basic operation if the "autocontext" option is set for trunks and stations in
+sla.conf.  However, for reference, here is an automatically generated dialplan
+to help with custom building of the dialplan to include other features, such as
+voicemail (\ref{voicemail}).
+
+However, note that there is a little bit of additional configuration needed if
+the trunk is an IP channel.  This is discussed in the section on trunks (\ref{trunks}).
+
+There are extensions for incoming calls on a specific trunk, which execute the SLATrunk
+application, as well as incoming calls from a station, which execute SLAStation.
+Note that there are multiple extensions for incoming calls from a station.  This is
+because the SLA system has to know whether the phone just went off hook, or if the
+user pressed a specific line button.
+
+Also note that there is a hint for every line on every station.  This lets the SLA
+system control each individual light on every phone to ensure that it shows the
+correct state of the line.  The phones must subscribe to the state of each of their
+line appearances.
+
+\begin{verbatim}
+	
+[line1]
+exten => s,1,SLATrunk(line1)
+
+[line2]
+exten => s,2,SLATrunk(line2)
+
+[sla_stations]
+exten => station1,1,SLAStation(station1)
+exten => station1_line1,hint,SLA:station1_line1
+exten => station1_line1,1,SLAStation(station1_line1)
+exten => station1_line2,hint,SLA:station1_line2
+exten => station1_line2,1,SLAStation(station1_line2)
+
+exten => station2,1,SLAStation(station2)
+exten => station2_line1,hint,SLA:station2_line1
+exten => station2_line1,1,SLAStation(station2_line1)
+exten => station2_line2,hint,SLA:station2_line2
+exten => station2_line2,1,SLAStation(station2_line2)
+
+exten => station3,1,SLAStation(station3)
+exten => station3_line1,hint,SLA:station3_line1
+exten => station3_line1,1,SLAStation(station3_line1)
+exten => station3_line2,hint,SLA:station3_line2
+exten => station3_line2,1,SLAStation(station3_line2)
+
+\end{verbatim}
+
+\subsection{Trunks}
+\label{trunks}
+
+An SLA trunk is a mapping between a virtual trunk and a real Asterisk device.
+This device may be an analog FXO line, or something like a SIP trunk.  A trunk
+must be configured in two places.  First, configure the device itself in the
+channel specific configuration file such as zapata.conf or sip.conf.  Once the
+trunk is configured, then map it to an SLA trunk in sla.conf.  
+
+\begin{verbatim}
+[line1]
+type=trunk
+device=Zap/1
+\end{verbatim}
+
+Be sure to configure the trunk's context to be the same one that is set for the
+"autocontext" option in sla.conf if automatic dialplan configuration is used.
+This would be done in the regular device entry in zapata.conf, sip.conf, etc.
+Note that the automatic dialplan generation creates the SLATrunk() extension
+at extension 's'.  This is perfect for Zap channels that are FXO trunks, for
+example.  However, it may not be good enough for an IP trunk, since the call
+coming in over the trunk may specify an actual number.
+
+If the dialplan is being built manually, ensure that calls coming in on a trunk
+execute the SLATrunk() application with an argument of the trunk name, as shown
+in the dialplan example before.
+
+IP trunks can be used, but they require some additional configuration to work.
+
+For this example, let's say we have a SIP trunk called "mytrunk" that is going
+to be used as line4.  Furthermore, when calls come in on this trunk, they are
+going to say that they are calling the number "12564286000".  Also, let's say
+that the numbers that are valid for calling out this trunk are NANP numbers,
+of the form \_1NXXNXXXXXX.
+
+In sip.conf,  there would be an entry for [mytrunk].  For [mytrunk], 
+set context=line4.
+
+
+\begin{verbatim}
+[line4]
+type=trunk
+device=Local/disa@line4_outbound
+\end{verbatim}
+
+
+\begin{verbatim}
+[line4]
+exten => 12564286000,1,SLATrunk(line4)
+
+[line4_outbound]
+exten => disa,1,Disa(no-password|line4_outbound)
+exten => _1NXXNXXXXXX,1,Dial(SIP/\${EXTEN}@mytrunk)
+\end{verbatim}
+
+
+So, when a station picks up their phone and connects to line 4, they are
+connected to the local dialplan.  The Disa application plays dialtone to the
+phone and collects digits until it matches an extension.  In this case, once
+the phone dials a number like 12565551212, the call will proceed out the
+SIP trunk.
+
+\subsection{Stations}
+
+An SLA station is a mapping between a virtual station and a real Asterisk device.
+Currently, the only channel driver that has all of the features necessary to
+support an SLA environment is chan\_sip.  So, to configure a SIP phone to use
+as a station, you must configure sla.conf and sip.conf.  
+
+\begin{verbatim}
+[station1]
+type=station
+device=SIP/station1
+trunk=line1
+trunk=line2
+\end{verbatim}
+
+Here are some hints on configuring a SIP phone for use with SLA:
+
+\begin{enumerate}
+\item Add the SIP channel as a [station] in sla.conf.
+
+\item Configure the phone in sip.conf.  If automatic dialplan configuration was
+   used by enabling the "autocontext" option in sla.conf, then this entry in
+   sip.conf should have the same context setting.
+
+\item On the phone itself, there are various things that must be configured to
+   make everything work correctly:
+
+   Let's say this phone is called "station1" in sla.conf, and it uses trunks
+   named "line1" and line2".
+   \begin{enumerate}
+  
+   \item Two line buttons must be configured to subscribe to the state of the
+      following extensions:
+        - station1\_line1
+        - station1\_line2
+
+   \item The line appearance buttons should be configured to dial the extensions
+      that they are subscribed to when they are pressed.
+
+   \item If you would like the phone to automatically connect to a trunk when it
+      is taken off hook, then the phone should be automatically configured to
+      dial "station1" when it is taken off hook.
+	
+   \end{enumerate}	
+\end{enumerate}
+
+
+\section{Configuration Examples}
+\subsection{SLA and Voicemail}
+\label{voicemail}
+
+This is an example of how you could set up a single voicemail box for the
+phone system.  The voicemail box number used in this example is 1234, which
+would be configured in voicemail.conf.
+
+For this example, assume that there are 2 trunks and 3 stations.  The trunks
+are Zap/1 and Zap/2.  The stations are SIP/station1, SIP/station2, and
+SIP/station3.
+
+In zapata.conf, channel 1 has context=line1 and channel 2 has context=line2.
+
+In sip.conf, all three stations are configured with context=sla\_stations.
+
+When the stations pick up their phones to dial, they are allowed to dial
+NANP numbers for outbound calls, or 8500 for checking voicemail.
+
+
+sla.conf:
+\begin{verbatim}
+[line1]
+type=trunk
+device=Local/disa@line1_outbound
+
+[line2]
+type=trunk
+device=Local/disa@line2_outbound
+
+[station](!)
+type=station
+trunk=line1
+trunk=line2
+
+[station1](station)
+device=SIP/station1
+
+[station2](station)
+device=SIP/station2
+
+[station3](station)
+device=SIP/station3
+	
+\end{verbatim}
+
+
+extensions.conf:
+\begin{verbatim}
+[macro-slaline]
+exten => s,1,SLATrunk(${ARG1})
+exten => s,n,Goto(s-${SLATRUNK_STATUS}|1)
+exten => s-FAILURE,1,Voicemail(1234|u)
+exten => s-UNANSWERED,1,Voicemail(1234|u)
+
+[line1]
+exten => s,1,Macro(slaline|line1)
+
+[line2]
+exten => s,2,Macro(slaline|line2)
+
+[line1_outbound]
+exten => disa,1,Disa(no-password|line1_outbound)
+exten => _1NXXNXXXXXX,1,Dial(Zap/1/${EXTEN})
+exten => 8500,1,VoicemailMain(1234)
+
+[line2_outbound]
+exten => disa,1,Disa(no-password|line2_outbound)
+exten => _1NXXNXXXXXX,1,Dial(Zap/2/${EXTEN})
+exten => 8500,1,VoicemailMain(1234)
+
+[sla_stations]
+
+exten => station1,1,SLAStation(station1)
+exten => station1_line1,hint,SLA:station1_line1
+exten => station1_line1,1,SLAStation(station1_line1)
+exten => station1_line2,hint,SLA:station1_line2
+exten => station1_line2,1,SLAStation(station1_line2)
+
+exten => station2,1,SLAStation(station2)
+exten => station2_line1,hint,SLA:station2_line1
+exten => station2_line1,1,SLAStation(station2_line1)
+exten => station2_line2,hint,SLA:station2_line2
+exten => station2_line2,1,SLAStation(station2_line2)
+
+exten => station3,1,SLAStation(station3)
+exten => station3_line1,hint,SLA:station3_line1
+exten => station3_line1,1,SLAStation(station3_line1)
+exten => station3_line2,hint,SLA:station3_line2
+exten => station3_line2,1,SLAStation(station3_line2)
+	
+\end{verbatim}
+
+\section{Call Handling}
+\subsection{Summary}
+
+This section is intended to describe how Asterisk handles calls inside of the
+SLA system so that it is clear what behavior is expected.
+
+Note that this section is not yet complete.
+
+\subsection{Station goes off hook (not ringing)}
+
+When a station goes off hook, it should initiate a call to Asterisk with the
+extension that indicates that the phone went off hook without specifying a
+specific line.  In the examples in this document, for the station named
+"station1", this extension is simply named, "station1".
+
+Asterisk will attempt to connect this station to the first available trunk
+that is not in use.  Asterisk will check the trunks in the order that they
+were specified in the station entry in sla.conf.  If all trunks are in use,
+the call will be denied.
+
+If Asterisk is able to acquire an idle trunk for this station, then trunk
+is connected to the station and the station will hear dialtone.  The station
+can then proceed to dial a number to call.  As soon as a trunk is acquired,
+all appearances of this line on stations will show that the line is in use.
+
+\subsection{Station goes off hook (ringing)}
+
+When a station goes off hook while it is ringing, it should simply answer
+the call that had been initiated to it to make it ring.  Once the station
+has answered, Asterisk will figure out which trunk to connect it to.  It
+will connect it to the highest priority trunk that is currently ringing.
+Trunk priority is determined by the order that the trunks are listed in
+the station entry in sla.conf.
+
+\subsection{Line button on a station is pressed}
+
+When a line button is pressed on a station, the station should initiate a
+call to Asterisk with the extension that indicates which line button was
+pressed.  In the examples given in this document, for a station named
+"station1" and a trunk named "line1", the extension would be "station1\_line1".
+
+If the specified trunk is not in use, then the station will be connected to it and
+will hear dialtone.  All appearances of this trunk will then show that it
+is now in use.
+
+If the specified trunk is on hold by this station, then this station will be
+reconnected to the trunk.  The line appearance for this trunk on this station
+will now show in use.  If this was the only station that had the call on hold,
+then all appearances of this trunk will now show that it is in use.  Otherwise,
+all stations that are not currently connected to this trunk will show it
+on hold.
+
+If the specified trunk is on hold by a different station, then this station
+will be connected to the trunk only if the trunk itself and the station(s) that
+have it on hold do not have private hold enabled.  If connected, the appeareance
+of this trunk on this station will then show in use.  All stations that are not
+currently connected to this trunk will show it on hold.
+
+\end{document}
diff --git a/doc/sla.txt b/doc/sla.txt
deleted file mode 100644
index acb9cb07b0..0000000000
--- a/doc/sla.txt
+++ /dev/null
@@ -1,225 +0,0 @@
--------------------------------------------------------------------------------
---- Shared Line Appearances ---------------------------------------------------
--------------------------------------------------------------------------------
-
--------------------------------------------------------------------------------
-INTRODUCTION
-
-The "SLA" functionality in Asterisk is intended to allow a setup that emulates
-a simple key system.  It uses the various abstraction layers already built into
-Asterisk to emulate key system functionality across various devices, including
-IP channels.
--------------------------------------------------------------------------------
-
--------------------------------------------------------------------------------
-DIALPLAN CONFIGURATION
-
-The SLA implementation can automatically generate the dialplan necessary for
-basic operation if the "autocontext" option is set for trunks and stations in
-sla.conf.  However, for reference, here is an automatically generated dialplan
-to help with custom building of the dialplan to include other features, such as
-voicemail.
-
-However, note that there is a little bit of additional configuration needed if
-the trunk is an IP channel.  This is discussed in the TRUNKS section.
-
-[line1]
-exten => s,1,SLATrunk(line1)
-
-[line2]
-exten => s,2,SLATrunk(line2)
-
-[sla_stations]
-exten => station1,1,SLAStation(station1)
-exten => station1_line1,hint,SLA:station1_line1
-exten => station1_line1,1,SLAStation(station1_line1)
-exten => station1_line2,hint,SLA:station1_line2
-exten => station1_line2,1,SLAStation(station1_line2)
-
-exten => station2,1,SLAStation(station2)
-exten => station2_line1,hint,SLA:station2_line1
-exten => station2_line1,1,SLAStation(station2_line1)
-exten => station2_line2,hint,SLA:station2_line2
-exten => station2_line2,1,SLAStation(station2_line2)
-
-exten => station3,1,SLAStation(station3)
-exten => station3_line1,hint,SLA:station3_line1
-exten => station3_line1,1,SLAStation(station3_line1)
-exten => station3_line2,hint,SLA:station3_line2
-exten => station3_line2,1,SLAStation(station3_line2)
--------------------------------------------------------------------------------
-
--------------------------------------------------------------------------------
-TRUNKS
-
-Be sure to configure the trunk's context to be the same one that is set for the
-"autocontext" option in sla.conf if automatic dialplan configuration is used.
-This would be done in the regular device entry in zapata.conf, sip.conf, etc.
-Note that the automatic dialplan generation creates the SLATrunk() extension
-at extension 's'.  This is perfect for Zap channels that are FXO trunks, for
-example.  However, it may not be good enough for an IP trunk, since the call
-coming in over the trunk may specify an actual number.
-
-If the dialplan is being built manually, ensure that calls coming in on a trunk
-execute the SLATrunk() application with an argument of the trunk name, as shown
-in the dialplan example before.
-
-IP trunks can be used, but they require some additional configuration to work.
-
-For this example, let's say we have a SIP trunk called "mytrunk" that is going
-to be used as line4.  Furthermore, when calls come in on this trunk, they are
-going to say that they are calling the number "12564286000".  Also, let's say
-that the numbers that are valid for calling out this trunk are NANP numbers,
-of the form _1NXXNXXXXXX.
-
-In sip.conf,  there would be an entry for [mytrunk].  For [mytrunk], 
-set context=line4.
-
-
-sla.conf:
-
-[line4]
-type=trunk
-device=Local/disa@line4_outbound
-
-
-extensions.conf:
-
-[line4]
-exten => 12564286000,1,SLATrunk(line4)
-
-[line4_outbound]
-exten => disa,1,Disa(no-password|line4_outbound)
-exten => _1NXXNXXXXXX,1,Dial(SIP/${EXTEN}@mytrunk)
-
-
-So, when a station picks up their phone and connects to line 4, they are
-connected to the local dialplan.  The Disa application plays dialtone to the
-phone and collects digits until it matches an extension.  In this case, once
-the phone dials a number like 12565551212, the call will proceed out the
-SIP trunk.
--------------------------------------------------------------------------------
-
-
--------------------------------------------------------------------------------
-STATIONS
-
-Currently, the only channel driver that has all of the features necessary to
-support an SLA environment is chan_sip.  Here are some hints on configuring
-a SIP phone for use with SLA:
-
-1) Add the SIP channel as a [station] in sla.conf.
-
-2) Configure the phone in sip.conf.  If automatic dialplan configuration was
-   used by enabling the "autocontext" option in sla.conf, then this entry in
-   sip.conf should have the same context setting.
-
-3) On the phone itself, there are various things that must be configured to
-   make everything work correctly:
-
-   Let's say this phone is called "station1" in sla.conf, and it uses trunks
-   named "line1" and line2".
-
-   a) Two line buttons must be configured to subscribe to the state of the
-      following extensions:
-        - station1_line1
-        - station1_line2
-
-   b) The line appearance buttons should be configured to dial the extensions
-      that they are subscribed to when they are pressed.
-
-   c) If you would like the phone to automatically connect to a trunk when it
-      is taken off hook, then the phone should be automatically configured to
-      dial "station1" when it is taken off hook.
--------------------------------------------------------------------------------
-
-
--------------------------------------------------------------------------------
-VOICEMAIL
-
-This is an example of how you could set up a single voicemail box for the
-phone system.  The voicemail box number used in this example is 1234, which
-would be configured in voicemail.conf.
-
-For this example, assume that there are 2 trunks and 3 stations.  The trunks
-are Zap/1 and Zap/2.  The stations are SIP/station1, SIP/station2, and
-SIP/station3.
-
-In zapata.conf, channel 1 has context=line1 and channel 2 has context=line2.
-
-In sip.conf, all three stations are configured with context=sla_stations.
-
-When the stations pick up their phones to dial, they are allowed to dial
-NANP numbers for outbound calls, or 8500 for checking voicemail.
-
-
-sla.conf:
-
-[line1]
-type=trunk
-device=Local/disa@line1_outbound
-
-[line2]
-type=trunk
-device=Local/disa@line2_outbound
-
-[station](!)
-type=station
-trunk=line1
-trunk=line2
-
-[station1](station)
-device=SIP/station1
-
-[station2](station)
-device=SIP/station2
-
-[station3](station)
-device=SIP/station3
-
-
-extensions.conf:
-
-[macro-slaline]
-exten => s,1,SLATrunk(${ARG1})
-exten => s,n,Goto(s-${SLATRUNK_STATUS}|1)
-exten => s-FAILURE,1,Voicemail(1234|u)
-exten => s-UNANSWERED,1,Voicemail(1234|u)
-
-[line1]
-exten => s,1,Macro(slaline|line1)
-
-[line2]
-exten => s,2,Macro(slaline|line2)
-
-[line1_outbound]
-exten => disa,1,Disa(no-password|line1_outbound)
-exten => _1NXXNXXXXXX,1,Dial(Zap/1/${EXTEN})
-exten => 8500,1,VoicemailMain(1234)
-
-[line2_outbound]
-exten => disa,1,Disa(no-password|line2_outbound)
-exten => _1NXXNXXXXXX,1,Dial(Zap/2/${EXTEN})
-exten => 8500,1,VoicemailMain(1234)
-
-[sla_stations]
-
-exten => station1,1,SLAStation(station1)
-exten => station1_line1,hint,SLA:station1_line1
-exten => station1_line1,1,SLAStation(station1_line1)
-exten => station1_line2,hint,SLA:station1_line2
-exten => station1_line2,1,SLAStation(station1_line2)
-
-exten => station2,1,SLAStation(station2)
-exten => station2_line1,hint,SLA:station2_line1
-exten => station2_line1,1,SLAStation(station2_line1)
-exten => station2_line2,hint,SLA:station2_line2
-exten => station2_line2,1,SLAStation(station2_line2)
-
-exten => station3,1,SLAStation(station3)
-exten => station3_line1,hint,SLA:station3_line1
-exten => station3_line1,1,SLAStation(station3_line1)
-exten => station3_line2,hint,SLA:station3_line2
-exten => station3_line2,1,SLAStation(station3_line2)
-
--------------------------------------------------------------------------------