deploy: 4b29d8b

onrelay · Jul 1, 2024 · 71cae34 · 71cae34
commit 71cae34
Show file tree

Hide file tree

Showing 259 changed files with 32,270 additions and 0 deletions.
diff --git a/.buildinfo b/.buildinfo
@@ -0,0 +1,4 @@
+# Sphinx build info version 1
+# This file hashes the configuration used when building these files. When it is not found, a full rebuild will be done.
+config: 93180aa5b9a9cc262d2605403dc4a2c4
+tags: 645f666f9bcd5a90fca523b33c5a78b7
diff --git a/.doctrees/apiref.doctree b/.doctrees/apiref.doctree
diff --git a/.doctrees/building.doctree b/.doctrees/building.doctree
diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle
diff --git a/.doctrees/faq.doctree b/.doctrees/faq.doctree
diff --git a/.doctrees/features.doctree b/.doctrees/features.doctree
diff --git a/.doctrees/history.doctree b/.doctrees/history.doctree
diff --git a/.doctrees/howto.doctree b/.doctrees/howto.doctree
diff --git a/.doctrees/index.doctree b/.doctrees/index.doctree
diff --git a/.doctrees/installing.doctree b/.doctrees/installing.doctree
diff --git a/.doctrees/maintenance.doctree b/.doctrees/maintenance.doctree
diff --git a/.doctrees/monitoring.doctree b/.doctrees/monitoring.doctree
diff --git a/.doctrees/planning.doctree b/.doctrees/planning.doctree
diff --git a/.doctrees/restapi.doctree b/.doctrees/restapi.doctree
diff --git a/.doctrees/setupscript.doctree b/.doctrees/setupscript.doctree
diff --git a/.doctrees/soapapi.doctree b/.doctrees/soapapi.doctree
diff --git a/.doctrees/troubleshooting.doctree b/.doctrees/troubleshooting.doctree
diff --git a/.doctrees/upgrading.doctree b/.doctrees/upgrading.doctree
diff --git a/.doctrees/webui.doctree b/.doctrees/webui.doctree
diff --git a/.nojekyll b/.nojekyll
diff --git a/_downloads/ca0c143bed6e39623be3a2bd971bda8a/100reldisable.cfg b/_downloads/ca0c143bed6e39623be3a2bd971bda8a/100reldisable.cfg
@@ -0,0 +1,4 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd">
+<voIpProt.SIP voIpProt.SIP.supportFor100rel="0" />
+</polycomConfig>
diff --git a/_downloads/d14dc2602f7048ba91f73a663d2ced88/blindxferdefault.cfg b/_downloads/d14dc2602f7048ba91f73a663d2ced88/blindxferdefault.cfg
@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<polycomConfig xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="polycomConfig.xsd">
+<call call.DefaultTransferType="Blind">
+</call>
+</polycomConfig>
diff --git a/_images/auto_refresh.png b/_images/auto_refresh.png
diff --git a/_images/bridge_transport.png b/_images/bridge_transport.png
diff --git a/_images/devicefiles_unmanagedtftp.png b/_images/devicefiles_unmanagedtftp.png
diff --git a/_images/devices_gw_addnew.png b/_images/devices_gw_addnew.png
diff --git a/_images/devices_phone_addnew.png b/_images/devices_phone_addnew.png
diff --git a/_images/devices_phonegrp_addnew.png b/_images/devices_phonegrp_addnew.png
diff --git a/_images/devices_tab.png b/_images/devices_tab.png
diff --git a/_images/diagnostics_about.png b/_images/diagnostics_about.png
diff --git a/_images/diagnostics_alarms_config.png b/_images/diagnostics_alarms_config.png
diff --git a/_images/diagnostics_alarms_groups.png b/_images/diagnostics_alarms_groups.png
diff --git a/_images/diagnostics_alarms_history.png b/_images/diagnostics_alarms_history.png
diff --git a/_images/diagnostics_alarms_traps.png b/_images/diagnostics_alarms_traps.png
diff --git a/_images/diagnostics_audit_history.png b/_images/diagnostics_audit_history.png
diff --git a/_images/diagnostics_audit_settings.png b/_images/diagnostics_audit_settings.png
diff --git a/_images/diagnostics_banned.png b/_images/diagnostics_banned.png
diff --git a/_images/diagnostics_cdr_active.png b/_images/diagnostics_cdr_active.png
diff --git a/_images/diagnostics_cdr_historic.png b/_images/diagnostics_cdr_historic.png
diff --git a/_images/diagnostics_cdr_reports.png b/_images/diagnostics_cdr_reports.png
diff --git a/_images/diagnostics_jobs_failed.png b/_images/diagnostics_jobs_failed.png
diff --git a/_images/diagnostics_jobs_success.png b/_images/diagnostics_jobs_success.png
diff --git a/_images/diagnostics_pcap_configure.png b/_images/diagnostics_pcap_configure.png
diff --git a/_images/diagnostics_pcap_logfiles.png b/_images/diagnostics_pcap_logfiles.png
diff --git a/_images/diagnostics_regs.png b/_images/diagnostics_regs.png
diff --git a/_images/diagnostics_snapshot.png b/_images/diagnostics_snapshot.png
diff --git a/_images/diagnostics_tab.png b/_images/diagnostics_tab.png
diff --git a/_images/diagnostics_trunkstat.png b/_images/diagnostics_trunkstat.png
diff --git a/_images/enum_domain.png b/_images/enum_domain.png
diff --git a/_images/ezuce_enum.png b/_images/ezuce_enum.png
diff --git a/_images/features_authcode.png b/_images/features_authcode.png
diff --git a/_images/features_authcode_authcode.png b/_images/features_authcode_authcode.png
diff --git a/_images/features_autoatt.png b/_images/features_autoatt.png
diff --git a/_images/features_autoatt_att.png b/_images/features_autoatt_att.png
diff --git a/_images/features_callback.png b/_images/features_callback.png
diff --git a/_images/features_callpark.png b/_images/features_callpark.png
diff --git a/_images/features_callqueue.png b/_images/features_callqueue.png
diff --git a/_images/features_conf1.png b/_images/features_conf1.png
diff --git a/_images/features_conf2.png b/_images/features_conf2.png
diff --git a/_images/features_huntgroup.png b/_images/features_huntgroup.png
diff --git a/_images/features_intercom.png b/_images/features_intercom.png
diff --git a/_images/features_moh.png b/_images/features_moh.png
diff --git a/_images/features_paging1.png b/_images/features_paging1.png
diff --git a/_images/features_paging2.png b/_images/features_paging2.png
diff --git a/_images/features_paging3.png b/_images/features_paging3.png
diff --git a/_images/features_phonebook1.png b/_images/features_phonebook1.png
diff --git a/_images/features_phonebook2.png b/_images/features_phonebook2.png
diff --git a/_images/features_tab.png b/_images/features_tab.png
diff --git a/_images/firmware_release_notes.png b/_images/firmware_release_notes.png
diff --git a/_images/firmware_release_notes_vvx.png b/_images/firmware_release_notes_vvx.png
diff --git a/_images/group_versiondropdown.png b/_images/group_versiondropdown.png
diff --git a/_images/interconnect_trunk1.png b/_images/interconnect_trunk1.png
diff --git a/_images/interconnect_trunk2.png b/_images/interconnect_trunk2.png
diff --git a/_images/interconnect_trunk3.png b/_images/interconnect_trunk3.png
diff --git a/_images/interconnect_trunk4.png b/_images/interconnect_trunk4.png
diff --git a/_images/interconnect_trunk5.png b/_images/interconnect_trunk5.png
diff --git a/_images/interconnect_trunk6.png b/_images/interconnect_trunk6.png
diff --git a/_images/interconnect_trunk7.png b/_images/interconnect_trunk7.png
diff --git a/_images/interconnect_trunk8.png b/_images/interconnect_trunk8.png
diff --git a/_images/moh_user.png b/_images/moh_user.png
diff --git a/_images/mwi_subscription.png b/_images/mwi_subscription.png
diff --git a/_images/nagios_nrpe.png b/_images/nagios_nrpe.png
diff --git a/_images/phone_versiondropdown.png b/_images/phone_versiondropdown.png
diff --git a/_images/phoneprofile_customconfigs.png b/_images/phoneprofile_customconfigs.png
diff --git a/_images/proxy_loglevelinfo.png b/_images/proxy_loglevelinfo.png
diff --git a/_images/setup_script_dns.png b/_images/setup_script_dns.png
diff --git a/_images/showadvanced.png b/_images/showadvanced.png
diff --git a/_images/speeddial_presence.png b/_images/speeddial_presence.png
diff --git a/_images/superadmin_pwd.png b/_images/superadmin_pwd.png
diff --git a/_images/system_db_dbs.png b/_images/system_db_dbs.png
diff --git a/_images/system_db_settings.png b/_images/system_db_settings.png
diff --git a/_images/system_dialing.png b/_images/system_dialing.png
diff --git a/_images/system_maintenance_backup_ftp.png b/_images/system_maintenance_backup_ftp.png
diff --git a/_images/system_maintenance_backup_local.png b/_images/system_maintenance_backup_local.png
diff --git a/_images/system_maintenance_export.png b/_images/system_maintenance_export.png
diff --git a/_images/system_maintenance_import.png b/_images/system_maintenance_import.png
diff --git a/_images/system_maintenance_restore_ftp.png b/_images/system_maintenance_restore_ftp.png
diff --git a/_images/system_maintenance_restore_restore.png b/_images/system_maintenance_restore_restore.png
diff --git a/_images/system_maintenance_restore_upload.png b/_images/system_maintenance_restore_upload.png
diff --git a/_images/system_maintenance_restore_upload1.png b/_images/system_maintenance_restore_upload1.png
diff --git a/_images/system_security_certificate_webcsr.png b/_images/system_security_certificate_webcsr.png
diff --git a/_images/system_security_firewall_groups.png b/_images/system_security_firewall_groups.png
diff --git a/_images/system_security_firewall_ratelimit.png b/_images/system_security_firewall_ratelimit.png
diff --git a/_images/system_security_firewall_rules.png b/_images/system_security_firewall_rules.png
diff --git a/_images/system_security_firewall_settings.png b/_images/system_security_firewall_settings.png
diff --git a/_images/system_security_sipsecurity_settings.png b/_images/system_security_sipsecurity_settings.png
diff --git a/_images/system_security_sipsecurity_sipsecurity.png b/_images/system_security_sipsecurity_sipsecurity.png
diff --git a/_images/system_servers_addserver.png b/_images/system_servers_addserver.png
diff --git a/_images/system_servers_addserver1.png b/_images/system_servers_addserver1.png
diff --git a/_images/system_servers_addserver4.png b/_images/system_servers_addserver4.png
diff --git a/_images/system_servers_addserver5.png b/_images/system_servers_addserver5.png
diff --git a/_images/system_servers_addserver6.png b/_images/system_servers_addserver6.png
diff --git a/_images/system_servers_coreservices.png b/_images/system_servers_coreservices.png
diff --git a/_images/system_servers_deviceprovisioning.png b/_images/system_servers_deviceprovisioning.png
diff --git a/_images/system_servers_instantmessaging.png b/_images/system_servers_instantmessaging.png
diff --git a/_images/system_servers_server_services.png b/_images/system_servers_server_services.png
diff --git a/_images/system_servers_servers.png b/_images/system_servers_servers.png
diff --git a/_images/system_servers_telephonyservices.png b/_images/system_servers_telephonyservices.png
diff --git a/_images/system_servers_utilityservices.png b/_images/system_servers_utilityservices.png
diff --git a/_images/system_services_cdr.png b/_images/system_services_cdr.png
diff --git a/_images/system_services_conferenceevent.png b/_images/system_services_conferenceevent.png
diff --git a/_images/system_services_dns_advisor.png b/_images/system_services_dns_advisor.png
diff --git a/_images/system_services_dns_customrecord1.png b/_images/system_services_dns_customrecord1.png
diff --git a/_images/system_services_dns_customrecord2.png b/_images/system_services_dns_customrecord2.png
diff --git a/_images/system_services_dns_failover.png b/_images/system_services_dns_failover.png
diff --git a/_images/system_services_dns_recordview1.png b/_images/system_services_dns_recordview1.png
diff --git a/_images/system_services_dns_recordview2.png b/_images/system_services_dns_recordview2.png
diff --git a/_images/system_services_dns_recordview3.png b/_images/system_services_dns_recordview3.png
diff --git a/_images/system_services_dns_settings.png b/_images/system_services_dns_settings.png
diff --git a/_images/system_services_ftp.png b/_images/system_services_ftp.png
diff --git a/_images/system_services_im.png b/_images/system_services_im.png
diff --git a/_images/system_services_lw.png b/_images/system_services_lw.png
diff --git a/_images/system_services_ms1.png b/_images/system_services_ms1.png
diff --git a/_images/system_services_ms2.png b/_images/system_services_ms2.png
diff --git a/_images/system_services_ms3.png b/_images/system_services_ms3.png
diff --git a/_images/system_services_mwi.png b/_images/system_services_mwi.png
diff --git a/_images/system_services_mybuddy.png b/_images/system_services_mybuddy.png
diff --git a/_images/system_services_pp1.png b/_images/system_services_pp1.png
diff --git a/_images/system_services_pp2.png b/_images/system_services_pp2.png
diff --git a/_images/system_services_pp3.png b/_images/system_services_pp3.png
diff --git a/_images/system_services_proxy.png b/_images/system_services_proxy.png
diff --git a/_images/system_services_proxy_stats.png b/_images/system_services_proxy_stats.png
diff --git a/_images/system_services_redis.png b/_images/system_services_redis.png
diff --git a/_images/system_services_reg.png b/_images/system_services_reg.png
diff --git a/_images/system_services_rest.png b/_images/system_services_rest.png
diff --git a/_images/system_services_rls.png b/_images/system_services_rls.png
diff --git a/_images/system_services_saa.png b/_images/system_services_saa.png
diff --git a/_images/system_services_snmp.png b/_images/system_services_snmp.png
diff --git a/_images/system_services_trunk1.png b/_images/system_services_trunk1.png
diff --git a/_images/system_services_trunk2.png b/_images/system_services_trunk2.png
diff --git a/_images/system_services_voicemail.png b/_images/system_services_voicemail.png
diff --git a/_images/system_settings_admin.png b/_images/system_settings_admin.png
diff --git a/_images/system_settings_auth1.png b/_images/system_settings_auth1.png
diff --git a/_images/system_settings_auth2.png b/_images/system_settings_auth2.png
diff --git a/_images/system_settings_devicezone.png b/_images/system_settings_devicezone.png
diff --git a/_images/system_settings_didpool.png b/_images/system_settings_didpool.png
diff --git a/_images/system_settings_domain.png b/_images/system_settings_domain.png
diff --git a/_images/system_settings_extpool.png b/_images/system_settings_extpool.png
diff --git a/_images/system_settings_inetcalling.png b/_images/system_settings_inetcalling.png
diff --git a/_images/system_settings_localization.png b/_images/system_settings_localization.png
diff --git a/_images/system_settings_location.png b/_images/system_settings_location.png
diff --git a/_images/system_settings_nat1.png b/_images/system_settings_nat1.png
diff --git a/_images/system_settings_nat2.png b/_images/system_settings_nat2.png
diff --git a/_images/system_settings_nat3.png b/_images/system_settings_nat3.png
diff --git a/_images/system_settings_ntpsettings.png b/_images/system_settings_ntpsettings.png
diff --git a/_images/system_settings_ntpunmanaged.png b/_images/system_settings_ntpunmanaged.png
diff --git a/_images/system_settings_ntpzone.png b/_images/system_settings_ntpzone.png
diff --git a/_images/system_settings_perms.png b/_images/system_settings_perms.png
diff --git a/_images/system_settings_region.png b/_images/system_settings_region.png
diff --git a/_images/system_tab.png b/_images/system_tab.png
diff --git a/_images/user_sharedlines.png b/_images/user_sharedlines.png
diff --git a/_images/user_usergroup.png b/_images/user_usergroup.png
diff --git a/_images/user_usergroup_settings.png b/_images/user_usergroup_settings.png
diff --git a/_images/users_phantom.png b/_images/users_phantom.png
diff --git a/_images/users_tab.png b/_images/users_tab.png
diff --git a/_images/wireshark1.png b/_images/wireshark1.png
diff --git a/_images/wireshark2.png b/_images/wireshark2.png
diff --git a/_images/wireshark3.png b/_images/wireshark3.png
diff --git a/_images/wireshark4-ladder.png b/_images/wireshark4-ladder.png
diff --git a/_images/wireshark5-playstreams.png b/_images/wireshark5-playstreams.png
diff --git a/_images/wireshark6-prepfilter.png b/_images/wireshark6-prepfilter.png
diff --git a/_images/wireshark7-export1.png b/_images/wireshark7-export1.png
diff --git a/_images/wireshark8-export2.png b/_images/wireshark8-export2.png
diff --git a/_sources/apiref.rst.txt b/_sources/apiref.rst.txt
@@ -0,0 +1,17 @@
+.. index:: API Reference
+
+=============
+API Reference
+=============
+
+At the heart of the platform are an extensive collection of REST and SOAP web service APIs that enable developers to customize the user experience, or build new applications and integrations.
+
+REST API Refrence
+-----------------
+
+  :ref:`rest-api-reference`
+
+SOAP API Reference
+------------------
+
+  :ref:`soap-api-reference`
diff --git a/_sources/building.rst.txt b/_sources/building.rst.txt
@@ -0,0 +1,243 @@
+.. index:: building
+
+============
+Building
+============
+
+Use Build Server
+-----------------
+
+To build the sipXcom source for execution or RPM generation on a physical server or cloud image, follow the instructions from installing_ to setup and configure a server.
+
+Use Docker Container
+-----------------
+
+To build sipXcom RPMs in a desktop or server Docker image, instantiate a container with the following command:
+
+    .. code-block:: bash
+        
+        docker run -it --hostname=sipxecs --name=sipxecs-centos7 --privileged \
+        --env=PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin \
+        --label='org.label-schema.build-date=20201113' --label='org.label-schema.license=GPLv2' \
+        --label='org.label-schema.name=CentOS Base Image' --label='org.label-schema.schema-version=1.0' \
+        --label='org.label-schema.vendor=CentOS' --label='org.opencontainers.image.created=2020-11-13 00:00:00+00:00' \
+        --label='org.opencontainers.image.licenses=GPL-2.0-only' --label='org.opencontainers.image.title=CentOS Base Image' \
+        --label='org.opencontainers.image.vendor=CentOS' --runtime=runc -d centos:centos7
+
+Setup System
+-----------------
+
+- Log on as root via ssh
+
+  .. code-block:: bash
+    
+    yum update -y
+
+    yum install -y sudo git wget
+
+- If you are NOT using a Google Cloud image, you must add and install their artifact registry plugin:
+
+  .. code-block:: bash
+
+    wget -O /etc/yum.repos.d/artifact-registry-plugin.repo \
+        https://storage.googleapis.com/sipxecs/artifact-registry/artifact-registry-plugin.repo
+    
+    yum install -y yum-plugin-artifact-registry
+
+
+Add sipx User
+-----------------
+
+sipXcom must be built by a user called *sipx* with sudo privileges. 
+
+- Add the *sipx* user:
+
+    .. code-block:: bash
+
+        useradd -m sipx
+  
+- If not on desktop docker, protect the sipx user with a password:
+
+    .. code-block:: bash
+
+        passwd sipx
+  
+- Assign sipx user sudo privileges:
+
+    .. code-block:: bash
+
+        visudo 
+        
+        ->
+
+        # add sipx as sudo user
+        sipx    ALL=(ALL)       NOPASSWD:ALL
+
+Checkout sipXcom
+-----------------
+
+Execute the following commands to checkout the sipXcom repository:
+
+  .. code-block:: bash
+
+    mkdir /src
+
+    cd /src
+
+    git clone https://github.com/onrelay/sipxecs.git
+
+    chown -R sipx.sipx sipxecs
+
+Build sipXcom
+-----------------------
+
+To build sipXcom from source, execute the master build script from the root scr folder as the sipx user with sudo privileges:
+
+  .. code-block:: bash
+
+    su sipx
+
+    cd /src/sipxecs
+
+The `sipxecs-build` script will create /src/sipxecs/build and /usr/local/sipx directories where all build results are saved.
+
+
+Build RPMs
+~~~~~~~~~~~~~~~~~~
+
+To build all the sipX* RPMs from source, just add the --rpm option to the sipxecs-build script as follows:
+
+  .. code-block:: bash
+
+    sudo ./sipxecs-build --rpm
+
+The resulting RPMs are e.g. found in the build/repo/CentOS_7/x86_64 folder for CentOS 7.
+
+To also install the RPMs locally, add the '--install' option:
+
+  .. code-block:: bash
+
+    sudo ./sipxecs-build --rpm --install
+
+Build Executables
+~~~~~~~~~~~~~~~~~~
+
+To just build the sipX* executables from source, simply run:
+
+  .. code-block:: bash
+
+    sudo ./sipxecs-build
+
+Additional Build Options
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The sipxecs-build script has the following additional options:
+
+  .. code-block:: bash
+
+    sudo ./sipxecs-build [options]
+
+        **-p | --platform**: OS platform of sipxcom RPM to build, e.g. centos-7 (default), rocky-9
+
+        **-a | --architecture**: Hardware architecture of sipxcom RPM to build, e.g. x86_64 (default)
+
+        **-s | --subproject**: subproject to build or sipx for building all RPMs, e.g. sipx (default), sipXconfig, sipXproxy
+
+        **-v | --version**: sipXcom cersion to build, e.g 24.01 (default), 24.07
+
+        **-r | --rpm**: Include this option if building rpms
+
+
+Advanced Builds
+~~~~~~~~~~~~~~~
+
+For more advanced builds, sipXcom relies on GNU autoconf and make to build its source. To use these mechanisms directly, you may use the following steps:
+
+- Prepare build folders:  
+
+  .. code-block:: bash
+
+    mkdir -p /src/sipxecs/build
+
+    cd /src/sipxecs/build
+
+    sudo mkdir -p /usr/local/sipx
+
+    sudo chown sipx.sipx /usr/local/sipx
+
+- To exclude *oss_core* module from build:
+
+  .. code-block:: bash
+
+    sudo echo oss_core >> .modules-exclude
+
+    sudo yum install -y oss_core oss_core-devel oss_core-debuginfo
+
+    sudo mkdir -p /usr/local/sipx/lib
+
+    sudo ln -s /usr/lib64/liboss_core.la /usr/local/sipx/lib/liboss_core.la
+
+    sudo ln -s /usr/lib64/liboss_carp.la /usr/local/sipx/lib/liboss_carp.la
+
+    sudo mkdir -p /usr/local/sipx/opt
+
+    sudo ln -s /usr/opt/ossapp /usr/local/sipx/opt/ossapp
+
+- Configure:
+
+  .. code-block:: bash
+
+    cd /src/sipxecs
+
+    sudo autoreconf -ivf
+
+    sudo chown -R sipx.sipx build
+
+
+- To build for running sipXcom locally:
+
+  .. code-block:: bash
+
+    cd build
+
+    sudo ../configure
+
+    sudo make sipx
+ 
+- Create a repo to build RPMs with mock:
+
+  .. code-block:: bash
+
+    sudo yum install -y createrepo rpm-build mock
+
+    sudo wget http://li.nux.ro/download/nux/misc/el7/x86_64/thttpd-2.25b-33.el7.nux.x86_64.rpm
+
+    sudo rpm -ivh thttpd-2.25b-33.el7.nux.x86_64.rpm
+
+    rm -f thttpd-2.25b-33.el7.nux.x86_64.rpm
+
+    sudo usermod -a -G mock sipx`
+
+- To create sipXcom RPMs:
+
+  .. code-block:: bash
+
+    sudo ../configure --enable-rpm DISTRO="centos-7-x86_64"
+
+    sudo make sipx.rpm
+    
+- Run `sudo chown -R sipx.sipx repo` if it gives a permission error on first try
+
+- If compilation stops for a subproject, it is possible to list all its dependencies:
+
+  .. code-block:: bash
+
+    cd /src/sipxecs/sipXproxy
+
+    grep -R '^BuildRequires'  | awk '{print $2}'
+
+
+
+
+
+
diff --git a/_sources/faq.rst.txt b/_sources/faq.rst.txt
@@ -0,0 +1,14 @@
+***
+FAQ
+***
+
+Why sipxcom over asterisk, freepbx, etc?
+----------------------------------------
+
+The biggest difference is sipxcom proxy is a `stateless proxy <https://tools.ietf.org/html/rfc3261#page-116>`_, where other proxies such as Asterisk are `B2BUAs <https://tools.ietf.org/html/rfc7092>`_.
+
+This means sipxcom is only involved in the call setup. It is never involved in relaying audio or video (RTP) media unless you're using a b2bua function, like :ref:`conferencing` , :ref:`voicemail`, :ref:`auto-attendants`, or :ref:`call-queue`.
+Once there is a 200 OK with SDP to a INVITE, and ACK to the 200 OK with SDP, the media (RTP) is direct between phone to phone.
+
+Because of this sipxcom (on sufficient hardware) can handle 10s of thousands of SIP transactions per second, per proxy instance. Some services such as proxy and registrar can run on multiple servers, increasing capability and reliability.
+