Create new sections, images, formatting, conf change. (#149)

* Update quick_install.rst

* Create freeswithch_tls.rst

* images add

* image add

* image add

* Update freeswithch_tls.rst

* Update conf.py

* Update conf.py

* Update freeswithch_tls.rst

* Update additional_information.rst

* Rename freeswithch_tls.rst to freeswitch_tls.rst

* Update freeswitch_tls.rst

* Update software_utilities.rst

* images add

* image add

* Create sngrep.rst

* Update sngrep.rst

* Update sngrep.rst

* Update other.rst

* Update software_utilities.rst

* images add

* Update sngrep.rst

* Update sngrep.rst

* image add

* Update sngrep.rst

* Update sngrep.rst

* Update sngrep.rst

* Update sngrep.rst

* Update sngrep.rst

* Update and rename freeswitch_tls.rst to sip_tls.rst

* Update additional_information.rst

* Update sip_tls.rst

* image add

* Update nat.rst

source/additional_information.rst

@@ -14,6 +14,7 @@ Additional Information
   :glob:
 
   additional_information/freeswitch.rst
+  additional_information/sip_tls.rst
   additional_information/testimonials.rst
   additional_information/password_reset.rst
   additional_information/feature_codes.rst

source/additional_information/nat.rst

@@ -22,8 +22,8 @@ Static IP
 ^^^^^^^^^^^^^^^
 FusionPBX is behind NAT and you have a static public IP address and you have phones on the same network and/or outside the network.
 
-* Set external_rtp_ip to autonat:xxx.xxx.xxx.xxx
-* Set external_sip_ip to autonat:xxx.xxx.xxx.xxx
+* Set external_rtp_ip to autonat:xxx.xxx.xxx.xxx (xxx.xxx.xxx.xxx can be used also in some instances)
+* Set external_sip_ip to autonat:xxx.xxx.xxx.xxx (xxx.xxx.xxx.xxx can be used also in some instances)
 * If you don't register a gateway to the carrier you may need to port forward SIP and RTP.
 
 

source/additional_information/sip_tls.rst

@@ -0,0 +1,62 @@
+*****************
+SSL/TLS Setup
+*****************
+
+On a new installation of FusionPBX, TLS for SIP is available to use once you run `letsencrypt.sh <../getting_started/lets_encrypt.html>`_ and make a few setting changes in FusionPBX.
+
+
+Configure TLS
+^^^^^^^^^^^^^^^
+
+Configuration for SIP to use TLS can be achieved with the following steps.
+
+* First open an ssh terminal or console window.
+
+* cd /usr/src/fusionpbx-install.sh/debian/resources/
+
+* Execute `letsencrypt.sh <../getting_started/lets_encrypt.html>`_
+
+* Login to your FusionPBX installation.
+
+* Go to Advanced > Variables.
+
+* Scroll down to **SIP Profile:** Internal (This can be done on any SIP Profile)
+
+.. image:: ../_static/images/fusionpbx_switch_tls.jpg
+        :scale: 85%
+
+
+
+* Set **internal_ssl_enable** value to **true** in lowercase.
+
+* Go to Status > SIP Status.
+
+* Click **FLUSH CACHE** at the top right.
+
+
+.. image:: ../_static/images/fusionpbx_tls_sofia_status2.jpg
+        :scale: 85%
+
+
+* Click **Rescan** on the profile.
+
+
+
+.. image:: ../_static/images/fusionpbx_tls_sofia_status1.jpg
+        :scale: 85%
+
+
+* You should now see at the right under **State** (RUNNING)(0)(TLS)
+
+.. image:: ../_static/images/fusionpbx_tls_sofia_status.jpg
+        :scale: 85%
+
+
+
+
+
+
+
+
+
+

source/additional_information/sngrep.rst

@@ -0,0 +1,165 @@
+Using SNGREP
+^^^^^^^^^^^^^^^^
+
+
+Main Screen
+~~~~~~~~~~~~
+
+
+* **Idx:** Line number column.
+
+* **Method:** Type of SIP message column.
+
+* **SIP From:** SIP message From column.
+
+* **SIP To:** SIP message To column.
+
+* **Msgs:** Numerical amount of messages column.
+
+* **Source:** Source IP and port number column.
+
+* **Destination:** Destination IP and port number column.
+
+* **Call State:** Call identifier column. 
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_main.jpg
+        :scale: 85%
+
+
+
+* **ESC Quit:** escape and quit sngrep.
+
+* **Enter:** Show more information about the highlighted line item.
+
+* **Space:** After pressing the spacebar, the line is selected.  With this you can select multiple lines and can be used with the F2 save option.
+
+* **F1 Help:** Gives a help menu.
+
+* **F2 Save:** Option to save the current capture session dialogs to a .pcap or .txt to a specific path and file name.
+
+* **F3 Search:** Gives the option to search in a more specific and granular way.
+
+* **F4 Extended:** Gives an extended view.
+
+* **F5 Clear:** Clear the screen.
+
+* **F7 Filter:** Like search but with more options to filter the end result.
+
+* **F8 Settings:** Adjust SNGREP settings interface, capture options, call flow options,  and EEP/HEP Homer options.
+
+* **F10:** Adjust what columns are displayed on the open sngrep window.
+
+SPAM
+~~~~~~
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_spam.jpg
+        :scale: 85%
+
+
+* **User-Agent:** Most spam attempts will show an unwanted User-Agent like what is shown in this example.
+
+
+
+
+Registration
+~~~~~~~~~~~~~~
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep1.jpg
+        :scale: 85%
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_register.jpg
+        :scale: 80%
+
+
+Registration Expanded
+~~~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_register_flow.jpg
+        :scale: 85%
+
+
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_register_flow1.jpg
+        :scale: 85%
+
+
+
+
+Call Setup
+~~~~~~~~~~~~
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep1.jpg
+        :scale: 85%
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_call_setup.jpg
+        :scale: 85%
+
+
+**Invite**
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_call_setup1.jpg
+        :scale: 85%
+
+
+**200 OK**
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_call_setup2.jpg
+        :scale: 85%
+
+
+**Call Completed**
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep1.jpg
+        :scale: 85%
+
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_call_setup3.jpg
+        :scale: 85%
+
+
+
+
+F3 Search
+~~~~~~~~~~~
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_f3_search.jpg
+        :scale: 85%
+
+
+F7 Filter
+~~~~~~~~~~~
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_f7_filter.jpg
+        :scale: 85%
+
+
+
+F8 Settings
+~~~~~~~~~~~~~
+
+
+**Interface**
+
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_f8_settings.jpg
+        :scale: 85%
+
+
+**EEP/HEP HOMER**
+
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_f8_settings1.jpg
+        :scale: 85%
+
+
+**Call Flow**
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_f8_settings2.jpg
+        :scale: 85%
+
+
+**Capture**
+
+.. image:: ../_static/images/additional_information/fusionpbx_sngrep_f8_settings3.jpg
+        :scale: 85%
+

source/conf.py

@@ -108,9 +108,9 @@ copyright = u'2008-2018, Mark J Crane'
 # built documents.
 #
 # The short X.Y version.
-version = '4.4.1'
+version = '4.4.2'
 # The full version, including alpha/beta/rc tags.
-release = 'master'
+#release = '2018'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -255,7 +255,7 @@ latex_elements = {
 #  author, documentclass [howto, manual, or own class]).
 latex_documents = [
   ('index', 'FusionPBXDocs.tex', u'FusionPBX Documentation',
-   u'Mark J Crane', 'manual'),
+   u'Mark J Crane & Len Graham', 'manual'),
 ]
 
 # The name of an image file (relative to this directory) to place at the top of
@@ -285,7 +285,7 @@ latex_documents = [
 # (source start file, name, description, authors, manual section).
 man_pages = [
     ('index', 'fusionpbxdocs', u'FusionPBX Documentation',
-     [u'Mark J Crane'], 1)
+     [u'Mark J Crane & Len Graham'], 1)
 ]
 
 # If true, show URL addresses after external links.
@@ -299,7 +299,7 @@ man_pages = [
 #  dir menu entry, description, category)
 texinfo_documents = [
   ('index', 'FusionPBXDocs', u'FusionPBX Documentation',
-   u'Mark J Crane', 'FusionPBXDocs', 'One line description of project.',
+   u'Mark J Crane & Len Graham', 'FusionPBXDocs', 'One line description of project.',
    'Miscellaneous'),
 ]
 

source/getting_started/quick_install.rst

@@ -6,11 +6,11 @@ Quick Install
 
 |
 
-Welcome to the FUSIONPBX installation guide. 
+Welcome to the FusionPBX installation guide. 
 
 |
 
-FUSIONPBX can be several different operating systems. However this install is focused on a **minimal** install of Debian 8 with SSH enabled. This install has been designed to be fast, simple and modular. On many systems it will install in 5 minutes or less. Installation times depend on CPU, RAM and bandwidth. Install Video https://youtu.be/YmIht8hEHYU
+FusionPBX can be several different operating systems. However this install is focused on a **minimal** install of Debian 8 with SSH enabled. This install has been designed to be fast, simple and modular. On many systems it will install in 5 minutes or less. Installation times depend on CPU, RAM and bandwidth. Install Video https://youtu.be/YmIht8hEHYU
 
 |
     

source/getting_started/software_utilities.rst

@@ -27,7 +27,7 @@ Install
 
       you can change the command to suite the proper ethernet device eth0 with what is on your system.  Port 5060 can be changed also if you are using a different port.
 
-`sngrep <https://github.com/irontec/sngrep>`_
+`sngrep <../additional_information/sngrep.html>`_
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Since March 2017 Sngrep is installed on all systems by default.  This is a very useful tool to help troubleshoot all types of sip related issues.
@@ -52,6 +52,12 @@ From your FusionPBX install SSH window or console window
 
  sngrep
 
+
+**sngrep:** https://github.com/irontec/sngrep
+
+
+
+
 Call Quality and Monitoring
 -----------------------------
 

source/other.rst

@@ -41,6 +41,7 @@ Other section is bits of info that needs indexed for the PDF to populate all sec
   applications/provision/phone_screen_capture.rst
   applications/xmpp.rst
   applications_optional/webrtc.rst
+  additional_information/sngrep.rst