SAIL Community Supported PBX

I've been playing around with a 64bit arm .img install for RaspberryPi.   You've always been able to install sark on the 64 bit Pi 4 but, to make it easier, we've put up a ready-to-run image here:-

http://www.sailpbx.com/sail/raspi-arm-64-img/

Download it and burn it onto a microSD card with the RaspberryPi imager and it should just run on any Pi 4. 
N.B.  The image inflates to about 7.6Gb so you'll need a micro SDcard of at least 8Gb.

SSH login creds are

UID sark
PWD sarkadmin

The front-end browser is just the same as always.

UID admin
PWD sarkadmin

In version 6 systems you may encounter the above message when adding a new extension.   The cause is a URL change in the location of the wireshark public mainufacturers' database.   We are working up a fix in source but it will take a few days.  In the meantime here is a module fix you can apply directly to your system.

The module which fetches the manufacturers database is

/opt/sark/scripts/getmaclist.sh

Replace the module with this one

#!/bin/sh
# get a list of macs amd manufacturers
#

[ ! -e /opt/sark/www/sark-common/manuf.txt ]  && touch /opt/sark/www/sark-common/manuf.txt
chown www-data:www-data /opt/sark/www/sark-common/manuf.txt
curl -L -s "https://gitlab.com/wireshark/wireshark/-/raw/master/manuf" > /tmp/manuf.txt
if [ -s /tmp/manuf.txt ]; then
        diff /opt/sark/www/sark-common/manuf.txt /tmp/manuf.txt
        if [  "$?" -ne "0" ] ; then
                mv /tmp/manuf.txt /opt/sark/www/sark-common/manuf.txt
                logger SARKgetmaclist - updated manufacturer MAC DB
        else
                logger SARKgetmaclist - manufacturer MAC DB up to date
        fi
else
        logger SARKgetmaclist - **** Could not fetch new manufacturer MAC DB ****
fi

This module gets run every Sunday at 00:00 hours so it will self heal if you leave it to its own devices.  However, you can prime it by simply running the module.

sudo sh /opt/sark/scripts/getmaclist.sh
     

SARK 6.2 beta is up in the repos so you can install it if you wish.   There are quite a few new features and I'll cover some of them below.

Support for ARM 64 bit
There is an image available for the HPE on arm64.  This allows 6.2 to run with the new AWS EC2 Graviton enterprise ARM instances (and any other arm64 cpu running in native 64 bit mode). 

Support for Ubuntu netplan
As you probably know, Ubuntu went a bit off piste with their networking and introduced Netplan (I think in 16.04). To be fair, it made their lives a lot easier when dealing with cloud deployments but it caused us all a bit of a problem when defining networks.  Anyhow, 6.2 runs natively with Netplan.  Furthermore, 6.2 will always run with two IP addresses on the prime NIC, one dynamic and one static.   It will always grab a DHCP address if one is available and, in addition,  it will use a second user-defined static IP address.   The static address is specified in the networks section and it is used for SIP operations.  The benefit of this dual strategy is that you can more easily move the PBX between networks without tears.  Whatever network it finds itself in, it will always attempt to grab a DHCP address so you won't be locked out if you forgot to change the static IP.

The only exception to this is if the instance is running under AWS, in which case it will simply use the given address it gets from AWS.   In this case, you won't be given the option of adding another address.

HTTPS Certificates
You can load and install your web certificates through the browser app

HTTPS provisioning with certificate checking
You can load your phone manufacturers' certificates and have the provisioning engine validate provisioning requests against them.   

Non standard SIP ports for extensions
You can provision a non standard (non 5060) SIP port for your phones.

Provisioning support for Fanvil phones
Still a bit of a work in progress but it will get a basic config Fanvil up and running

Upgraded wallboard
Re-written with more detailed information on live call flows

   

We're in the process of putting out a series of short videos on V6.   They are listed below and we'll add to the list as we produce more.

SV6 first login - https://youtu.be/SlQMS6zr8Nc
SV6 Provisioning - https://youtu.be/i7gMyaUhaYw
SV6 Responsive Design principles - https://youtu.be/-PreASmdej4
SV6 Interactive Browser Console - https://youtu.be/oxH0OBrnWVU

We're in the process of putting out a series of short videos on V6.   They are listed below and we'll add to the list as we produce more.

SV6 first login - https://youtu.be/SlQMS6zr8Nc
SV6 Provisioning - https://youtu.be/i7gMyaUhaYw
SV6 Responsive Design principles - https://youtu.be/-PreASmdej4

SARK V6 alpha is ready for testing.   You can find instructions on how to install it on the main wiki.   Installation is much the same as for earlier releases.  For now, we would advise only installing on a virgin Debian 8.  We are still testing 5->6 upgrades.   

V6 is a complete rewrite of the SARK front-end using HTML5, CSS3 and W3CSS.   What's the big deal?  Well, mainly in its mobile-first design which means it has both adaptive and responsive design elements.  The bottom line is that it can run well on pretty much any device you have to hand, including your phone or tablet.   Would you use it exclusively from those devices?  Probably not but the point is you can.  You can perform admin on a remote box from your car or the train, or increasingly, the plane  without struggling to setup a laptop or notebook.  We think it's pretty cool!   

There's also a ton of other changes and improvements and some things have gone.  Most notably, the old Areski CDR stats pack is no longer included in the system.   This is because we now run with PHP7 and it won't support the old stats MySQL calls.  We do have a replacement in the pipeline and that should be appearing in a near release. We've also included call recording retrieval/playback into the main line as well as adding click-to-call capabilities for end users and a very cool new cellphone integration feature.

SARK V6 also has support for IPV6, both for itself (there's a new IPV6 firewall) and for IPV6 capable phones.   It can also handle IPV6 provisioning for IPV6 capable phones.   Up to press this has mostly been tested with snom phones but we've also successfully run tests with Yealink and a few others. 

Lastly, we've moved away from model numbering phones.  SARK figures out the phone type automatically during provisioning so all you need provide is a MAC address.  This should help a lot in dealing with the Yealink predilection for new model number releases.     

We will shortly put together a few vids of V6 to show you around some of the new features.
             

Sail is now packaged for Debian 9.  This is still a beta release but it is available to install now from the repository.   Stretch is quite a bit different from its predecessor Jessie.  Among other things it uses Systemd, PHP7 and Asterisk 13.  Stretch has also dropped MySQL in favour of MariaDB but it's a straight "drop-in" replace so there's not much of a learning curve if you know MySQL.   Install instructions for SAIL on stretch are pretty much the same as previous Debian versions.  Here they are in a nutshell.  This assumes you have a vanilla stretch install with only ssh.


wget  http://sailpbx.com/sail/sail-5.0/debs/sail.gpg.key
apt-key add sail.gpg.key
echo deb http://sailpbx.com/sail/sail-5.0/debs/repo/ stretch main >> /etc/apt/sources.list
apt-get update
apt-get install ssmtp
apt-get install sail
reboot
mysql -u root < /opt/sark/stat/asterisk-stat-v2/cdr-mysql-setup.sql
apt-get install ast-en-gb-gpl-gsm-sounds


That's it.  Functionally, the only difference is that the Areski "stats" package is no longer supported in stretch. This is because PHP7 is PDO only so the stats package would require quite a bit of work to bring forward.  This is a temporary situation and we are actively working on a replacement for it.  Meanwhile, the stats code is still in the release if anyone wants to have a go at modifying it.

We are just about to start moving sailpbx.com to a new home in the cloud.  With luck, you won't see any change or disruption but we can't guarantee it so please accept our apologies if there are periods where you can't get access.

We've just completed the certification process for two new phone model ranges.     The new KX-HDV range from Panasonic and the new VSP range from Vtech.  Both ranges can do PnP, zero touch provisioning (ZTP) with SARK and the HDV Panasonics can do on-the-fly function key setting and provisioning.  We've added them to the provisioning section here

http://www.sailpbx.com/mediawiki/index.php/SARK_V4.0.1_Provisioning

There is also a new Discovery and Adoption feature in V5 which is also briefly covered in the wiki. 

Sail 5 is in late alpha and should make it into beta in about three weeks at which point you will be able to download and install it to test yourself.  Lots of new features and a new UI which has direct and stepwise navigation for larger users; new features for single-tenant users.   Here's a brief list of what made it into the first out of 5.0

Asterisk 11 or higher
HTTPS only
Frameless design and output buffering make rendering faster, particularly for large tables
some HTML5 usage; older browsers may not run these features
tested with IE/Chrome/Firefox/Safari/Opera
No longer requires DAHDI unless your are running TDM cards
Jquery and Datatables at latest levels
New session management - Login/Logout/Timeout/Nag
New menus and icon set
Navigation re-written, new controls
New searchkey and "steplinks"
Step/Searchkey navigation means you don't need to visit the tables so often on big systems
Sticky tabs, scroll and search
Adaptive tables fit to Window Height (more rows in view)
Proxy now uses dynamic on-the-fly iFrames
New "fast add? tab
ConfBridge replaces MeetMe
Active Xrefs
LDAP Directory can upload Vcard files on-the-fly; export from contacts, import to LDAP.
Ajax cells now single click (ready for touch)
New info boxes in Trunk/Exten edit
extension SIP password default length now 12 characters
Visible counts on the big tables
Adopt feature in Discover panel
Queue Preannounce
Persistent agents
Holiday planner (xmas, Easter, Eid, bank holidays etc.)
Highlight active timers agents conferences and holidays
Highlight down trunks and phones
Take phones on and offline (active/inactive)
Timer state shown in globals
Jquery makes IVR faster/easier
Backup/Restore enhanced with selective restore
Greetings upload/download (mp3 or wav)
Factory Reset with selective parameters
Easy TLS/SRTP with full provisioning support for Snom/Yealink
Easy cellphone twinning to an extension
Voicemail view/playback/delete for non-admin users
Visible logs
Simplified Firewall front-end
IP Blacklist feature

sail-4.1 is up onto the server.   It has a lot of new features so I thought I'd list them all and say a word or two about a few.   There may be bugs in some of the new features so I would encourage you to install and test the release on a tame server before you upgrade any customers.  4.1 is available for Debian Wheezy.

Here is the changelog since the last 4.0.1 release (17)

sail (4.1.0-7) UNRELEASED; urgency=low
  * tagged as 4.1.0-7
  - fix to setip for dnsmasq option66
  - fix to discover to handle some phone types which return names

-- CoCoSoft <admin@aelintra.com>  Wed, 15 Jul 2015 18:00:00 +0000

sail (4.1.0-6) UNRELEASED; urgency=low
  * tagged as 4.1.0-6
  - added missing dependency for php5-ldap

-- CoCoSoft <admin@aelintra.com>  Wed, 24 Jun 2015 18:00:00 +0000

sail (4.1.0-5) UNRELEASED; urgency=low
  * tagged as 4.1.0-5
  - fix permissions on http sark_meetme display
  - fix validation on firewall descriptions

-- CoCoSoft <admin@aelintra.com>  Wed, 24 Jun 2015 18:00:00 +0000

sail (4.1.0-4) UNRELEASED; urgency=low
  * tagged as 4.1.0-4
  - fix permissions on sark_meetme and rssh port file

-- CoCoSoft <admin@aelintra.com>  Sat, 20 Jun 2015 18:00:00 +0000

sail (4.1.0-3) UNRELEASED; urgency=low
  * tagged as 4.1.0-3
  - added templates for Yealink T21D

-- CoCoSoft <admin@aelintra.com>  Fri, 19 Jun 2015 18:00:00 +0000

sail (4.1.0-2) UNRELEASED; urgency=low
  * tagged as 4.1.0-2
  - Bumped to 4.1

-- CoCoSoft <admin@aelintra.com>  Tue, 9 Jun 2015 18:00:00 +0000
sail (4.1.0-1) UNRELEASED; urgency=low
  * tagged as 4.1.0-1
  - Bumped to 4.1

-- CoCoSoft <admin@aelintra.com>  Tue, 19 May 2015 18:00:00 +0000

sail (4.0.1-20)
  * tagged as 4.0.1-20
  - added dialout rssh for supported customers
  - added icmp response support
  - added firewall descriptions

sail (4.0.1-19)
  * tagged as 4.0.1-19
  - fix to database structure
  - fix to extension status

sail (4.0.1-18)
  * tagged as 4.0.1-18
  - add sarkdiscover
  - add sarkconference
  - add timers for tenants
  - message change on sarknet reboot
  - sarkpci bugfix to tabs
  - sarktrunk fix to handle unmonitored trunks
  - srkhelper enhance for meetme table
  - srkPageclass bug fix
  - diskabs bugfix for potential loop
  - setip now allows multiple local networks
  - sarkhelper now permanently logs
  - USB automount with autodump of IP
  - require ipcalc in dependencies

The things that require further explanation are as follows

Reverse ssh tunnelling for supported customers

SARK 4.1 can set up an on-demand reverse SSH session from the customer site.   This allows support teams to login to a remote SARK, under customer control, with no prior firewall or NAT setup as long as the SARK box has line-of-sight to the internet.

Ping (ICMP) support

You can turn it on and off in the network panel

Firewall rule descriptions

What it says.   You can make little notes about who's where.

SIP discovery

A new panel in the end-points group.  It will do a sniff of the local network (only an 8 bit search - /24) and tell you what it can see.

Conference panel

Add/delete conference rooms and PINs.

Trunks and Extensions

An unmonitored trunk will now show up as UM instead of X so you can see that they may be up but we don't know because we aren't looking.
Down trunks/extensions  will have the status code if you hover the mouse over the X.

Tenant open/closed master switch

Each Tenant now has it's own open/close throws.   You can set them from the panel or you can set/unset them via BLF Fkey.   Simply set a BLF key to the tenant name and it will act as a visual open/close throw.

Multiple local networks

Set it in sark_sip_local_network.conf.  Handy for VPN's and so forth.

USB automount (SARK200 only).

Label a USB stick as SARKUTILS and shove it in the S200.   It will write a file to the stick with the network information on it (IP address and so forth).   You can also use the stick to reset the S200 to DHCP and change the root password back to default.

We'll update the wiki pages with the new features shortly

INSTALLATION

There is a 4.1.0 repo on the servers so installation is pretty simple.   You can just do

echo deb http://sailpbx.com/sail/sail-4.1/debs/repo/ wheezy main >> /etc/apt/sources.list
apt-get update
apt-get install sail

This will install 4.1 and the necessary dependencies.   Make sure you take a copy of the sail database (/opt/sark/db/sark.db) before you start,  if you think you may later want to regress to 4.0.

When you install 4.1; if you have or have had a browser window open to 4.0 on the same sail machine then you MUST clear the browser cache.  If you don't, the Javascript will get all confused and the screen will look very odd when you browse to your new 4.1

Change log is as follows


sail (4.0.1-18)
  * tagged as 4.0.1-18
  - add sarkdiscover
  - add sarkconference
  - add timers for tenants
  - message change on sarknet reboot
  - sarkpci bugfix to tabs
  - sarktrunk fix to handle unmonitored trunks
  - srkhelper enhance for meetme table
  - srkPageclass bug fix
  - diskabs bugfix for potential loop
  - setip now allows multiple local networks
  - sarkhelper now permanently logs
  - USB automount with autodump of IP
  - require ipcalc in dependencies

-- CoCoSoft <admin@aelintra.com>  Sun, 12 Apr 2015 18:00:00 +0000

There is a new pre-req for "ipcalc" so you should install this before running dpkg to install the release.

The main new features are sarkdiscover, an automatic SIP discovery panel and sarkconference a panel for conference bridge maintenance.  Tenants now have there own open/close master switches with BLF support.

Source code is already on GiTHub and a deb will go up shortly onto the sail libs.

This is a community supported site hosted by the SARK development team.   

Feel free to post any questions or comments you may have and do please help others if you know the answer to their questions.

Please be polite and courteous in your dealings on the site.   We will tolerate most things but rude or insulting behaviour is frowned upon and posts which exhibit these behaviours will be deleted without notice.

sarkdevs
 

Hello

Welcome to the Forum for SAIL PBX discussion.  Feel free to post any questions you have to the community and we'll do our best to answer them for you.

Kind Regards

Sarkdevs