Linux Installation

System Requirements

Before you begin the installation process, please refer to the Release Notes to ensure compatibility with third party software and hardware. 

Open

NOTE: Contact our Sales department in order to download the software (sales@sangoma.com)

Installing The Software

NetBorder Call Analyzer is distributed on supported Linux distributions using the rpm format. Superuser (root) privileges are required to install.

Shell command syntax:

   rpm -i netborder-call-analyzer-2.<version>.<arch>.rpm

The NetBorder Call Analyzer software will be installed under the following directory:

• /opt/Sangoma_NetBorderCallAnalyzer

This directory will be referred to as [NETBORDER_INSTALLDIR] throughout this document when the OS in used is Linux. 

Directories and files installed by software

There are a list of the directories, subdirectories and files copied to the system during the installation process.  Click below for details:

-> List of directories, subdirectories and files

-> CPA-stats.csv file

The License File

The NetBorder Call Analyzer default license provides customers with the ability to perform one analysis at a time. Attempts to place simultaneous calls will be rejected with a 603 Decline SIP response

• A Call Analyzer port uses a license while active analysis is performed, i.e. from the reception of the incoming call request from the dialer to the moment the analysis result is provided to the dialer. The segment of the call where the customer is interacting with an agent or an IVR is not licensed.

•  

Look for 603 Decline (Licensing capacity has been reached) in file: [NETBORDER_INSTALLDIR]/ logs/call-analyzer-service.out if you get 603 Decline responses to confirm it is a license capacity issue.

To obtain a full license (host-locked) , obtain the MAC (Media Access Control) address of the system and use the Installation ID that came with the software to generate a license file. Please follow this URL:

http://www.sangoma.com/support/register_netborder_software.html

To obtain the physical address of the Ethernet adapter (on Linux distributions): 

1. Executethefollowingcommandinashell:

   ● ifconfig

2. Look for the Hwaddr field value for a network adapter that is permanent on your server, usually eth0.

3. The Hwaddr value is shown using the XX:XX:XX:XX:XX:XX notation.  Upon registration of the software, the license provided will show the physical address (MAC address) using the Windows notation (XX-XX-XX-XX-XX-XX): this is expected. 

Installing The License

1. Upon filling the online form, you will be able to download your new license files in a .zip file:

   ● call-analyzer-license.txt

   ● call-analyzer-license.txt.sig

2. Onceyouhavereceivedthelicensefiles,copythefiles(ineffect, you will

   be replacing the temporary license) to the following folder:

        ● [ NETBORDER_INSTALLDIR ]\config

        where [NETBORDER_INSTALLDIR] is the root folder of the installation (for example, C:\Program Files\Sangoma NetBorder Platform 2.0\config).

1. Start the Sangoma NetBorder Call Analyzer service 

Uninstalling The Software

1. Make sure you backed up any file that you manually edited under [NETBORDER_INSTALLDIR]/config

1. Execute the following command in a shell (superuser,i.e. root,privileges are required):

      ● rpm -e netborder-call-analyzer 

Validating The Installation

Once you have installed the NetBorder Call Analyzer software, you should validate the successful installation by starting the application.  Note that two services/processes makes up NetBorder Call Analyzer:

• Sangoma NetBorder Call Analyzer: Provides Call Progress Analysis Services to the NetBorder framework. It is the entry point where SIP INVITE requests must be sent (default is UDP port 5062)

• Process name: netborder-call-analyzer-service

• Sangoma NetBorder Engine For Call Analyzer: Internal service that hosts the Engine performing the analysis on the media stream.

Process name: netborder-call-analyzer-engine 

Starting The Service

The package name for NetBorder Call Analyzer on Linux is:

● netborder-call-analyzer

The installer also creates a service of the same name, so the commands to control the service are:

● service netborder-call-analyzer {start|stop|status}

Superuser (root) privileges are required to start and stop the service.

The “start” command will launch all necessary processes for the service, “stop” will terminate them and “status” will tell if the service is started or not.

Automatic service startup on Linux

The netborder-call-analyzer service is setup to start up automatically on server boot-up: To change that behaviour, execute the following command in the shell:

● chkconfig netborder-call-analyzer off To restore automatic startup, use:

● chkconfig netborder-call-analyzer on 

You are now ready to place a call through your IP network.  Please Proceed to Getting Started