System

System

System

Contents

  1. System
    1. On master tenant
    2. On slave tenant

System



System window administers the core EdgelessPBX MT components such as the file system, system services, server details, licensing, sound files, MOH (Music On Hold) etc.

On master tenant



File System



All EdgelessPBX MT logs, sound recordings, CLI and CLIR files are stored on local file system. Some of these files can grow to a size which will not leave any space left on the system. This section provides management of how and when these files should be rotated or deleted in order to prevent such scenario.

Following files are rotated after selected period of time


  • EdgelessPBX MT logs:

    Time EdgelessPBX MT logs are kept on the filesystem
    '/opt/EdgelessPBX/pw/EdgelessPBX/var/log'

    (ex. Default value '4 weeks')
    (Select box)

  • Asterisk logs:

    Time Asterisk logs are kept on the filesystem
    '/opt/pbxare/pw/var/log/asterisk'

    (ex. Default value '4 weeks')
    (Select box)

Following files are deleted after selected period of time

  • EdgelessPBX MT CLIR files:

    Time EdgelessPBX MT CLIR files are kept on the filesystem
    '/opt/EdgelessPBX/pw/EdgelessPBX/var/clir'

    (ex. Default value '4 weeks')
    (Select box)

  • Asterisk Backup fiels:

    Time Asterisk backup files are kept on the filesystem
    '/opt/pbxare/pw/etc/asterisk/backup'

    (ex. Default value '9 weeks')
    (Select box)

  • Voicemail:
    Time Voicemail files are kept on the filesystem
    '/opt/pbxare/pw/var/spool/asterisk/voicemail/default/$VOICE MAILBOX'

    (ex. Default value '6 weeks')
    (Select box)

  • Recordings:
    Time Recordings are kept on the filesystem
    '/opt/pbxare/pw/var/spool/ast/monitor'

    (ex. Default value 'week')
    (Select box)

Services



This window controls the basic actions (start, stop, restart, reload) of EdgelessPBX MT services


  • System:

    Stop/Start/Restart the system
    (ex. Clicking on the 'Restart' button would reboot the system)
    (Command button)

  • PBX service:

    Stop/Start/Restart/Reload the Asterisk (The core EdgelessPBX MT runs on)
    (ex. Clicking on the 'Restart' button would restart the Asterisk)
    (Command button)

  • EdgelessPBX MT:

    Stop/Start/Restart/Reload the EdgelessPBX MT
    (ex. Clicking on the 'Restart' button would restart the EdgelessPBX MT)
    (Command button)

  • HTTP service:

    Stop/Start/Restart/ web server
    (ex. Clicking on the 'Restart' button would restart the web server. In case you cannot reach the EdgelessPBX MT login screen this is the service you need to start/restart)
    (Command button)

  • Database service:

    Stop/Start/Restart/Reload database service
    (ex. Clicking on the 'Restart' button would restart the database server)
    (Command button)

  • TFTP service:

    Stop/Start/Restart/ the TFTP server
    (ex. TFTP is used for storing and serving the UAD/Phone auto-configuration files)
    (Command button)

  • Jabber server:

    Stop/Start/Restart/Reload the Jabber messaging server
    (ex. Clicking on the 'Restart' button would restart the Jabber server)
    (Command button)

Server Details



This window resets the root EdgelessPBX MT password, timezone, and hostname


  • Root Password:

    EdgelessPBX MT prompts for this password during the system/ssh login and when accessing system services through the interface
    ([a-z][0-9])

  • Confirm Password:

    Re-type the Root Password entered in the above field
    ([a-z][0-9])

  • Time zone:

    Select the appropriate time zone ni which, EdgelessPBX MT is located
    (Select box)

  • Hostname:

    The name given to the machine which will identify the system on the network
    (ex. myhost)
    ([a-z][0-9])

For information on the rest of the fields in the Server detail, check Getting Started->Server Details chapter

Licensing



This window (re)licenses the system. Free and requested licenses are available (both bond to a system MAC address). If you are upgrading your license just paste the license key in 'License Number' field, select the MAC address assigned to a license key and click on the 'Save' button

TIP: System must have access to a fully operational Internet connection in order to license the system.


  • License Type:

    Select a system license type
    (ex. The system comes with two license types. FREE license and 'Requested License')
    (Select box)

  • License Number:

    Provide system license number as received in email.
    (ex. ABCDE123)
    ([a-z][0-9])
    NOTE: This field will not be active if FREE license is requested

  • MAC:

    Select a MAC address to which the license will be applied
    (ex. If your system has multiple MAC addresses, select the one you wish to assign the license to. In case this MAC address changes in the future, you will have to re-license the system)
    (Select options)

Sound Files

This section administers global sound files used by all of the slaves on EdgelessPBX MT, which means that all extensions from all of slave are using these as their general sound files, i.e. 'Please enter the conference PIN number'


  • Sounds:

    Select among available options (gsm, ulaw, alaw, g729, ilbc, sln) to display system sound files of that type
    (ex. Selecting 'gsm' will display all system sounds with the .gsm file type)
    (Select box)

  • Upload:

    Uploads the selected file from the local computer to EdgelessPBX MT
    (ex. Click on the 'Browse' button and select a file from your desktop. Then click this button to upload the selected file to EdgelessPBX MT)
    (Command button)

  • Convert:

    Convert the selected file to the desired codec.
    (ex. Select the box next to a sound file (e.g. arizona). Select a codec from the drop down menu and click on Convert. The sound file will be converted to that codec).
    (Command button)

  • Rename:

    Renames the selected sound file
    (ex. Select the box next to a sound file (e.g. arizona). Change 'arizona' into 'Arizona101' and click this button to rename the selected sound file)
    (Command button)

  • Delete:

    Deletes the selected sound file
    (ex. Select the box next to a sound file (e.g. arizona) and click this button to delete the selected sound file)
    (Command button)

  • Download:

    Downloads the selected sound file to the user's desktop
    (ex. Select the box next to a sound file (e.g. arizona) and click this button to download the selected file to your desktop)
    (Command button)

TIP: EdgelessPBX MT will play only sound file types equal to enabled codecs on dialing extensions.

For example, Extension 1000 has only gsm codec enabled. When the same Extension logs in as a Queue Agent by dialing '*202 + $AGENT_NUMBER', all sounds played by EdgelessPBX MT (asking for password etc.) will be in '.gsm' format.

If multiple codecs are enabled for Extension 1000(ulaw,alaw,gsm), EdgelessPBX MT will play sound files with better sound quality (ulaw/alaw).

Music on Hold



Music on Hold is music or advertisements played to callers while they are waiting for an agent or when put on hold, for example. MOH set on master tenant is played if there is none matched on a slave where MOH is supposed to be played

Content



MOH content window administers EdgelessPBX MT default MOH sound files. They are listed here with the following details

  • Name:

    MOH sound file name
    (ex. Song)
    (Display)

  • Author:

    MOH sound file author
    (ex. Jinkies)
    (Display)

  • Length:

    MOH sound file length in min:sec
    (ex. 3:08)
    (Display)

  • Class:

    MOH class sound file belongs to
    (ex. Default)
    (Display)

  • Status:

    MOH sound file status
    (ex. On/Off)
    (Display)

  • Edit

    Edits the MOH file configuration
    (ex. Click to edit MOH file configuration)
    (Button)

  • Delete

    Deletes a MOH file from the system
    (ex. Click to delete a MOH file from the system)
    (Button)

Search




  • Search:

    Search phrase
    (ex. Provide a search phrase here and hit enter to filter the records)
    ([a-z][0-9])

  • Name:

    Should a search filter be applied to track names
    (ex. Check the box to search track names)
    (Check box)

Add Record




  • Clip name:

    Audio file name
    (ex. Riders on the Storm)
    ([a-z][0-9])

  • Author:

    Author name
    (ex. The Doors)
    ([a-z][0-9])

  • File:

    Displays full path to music file on local computer. Click the 'Browse' button to select a file
    (ex. D:MusicThe DoorsThe Doors - Riders on the Storm.mp3)
    ([a-z][0-9])

  • Length:

    Clip length
    (ex. 4:13)
    ([0-9][:])

  • Class:

    Select the MOH class to which the sound file belongs
    (ex. default)
    (Select box)

  • Status:

    Set the status of uploaded file(active/inactive)
    (ex. On/Off)
    (Option buttons)

Sangoma cards



This part of the interface is used to set various Sangoma cards: PRI, Analog and BRI.

Depending on the cards inserted and the number of ports on them, appropriate row of information will show up in the list of the cards. Also whether a PRI, Analog or BRI card is inserted, they will have different configuration settings.

PRI cards



When a PRI card is inserted (like A101 which has one port) you will get as many "items" in the list as you have ports on that particular card. In this case, A101 has one port hence one item or card in the list. If you insert A102 you will get two items in the list because that card has two ports.

So, you need to configure every port individually, that's why there is a separate Configure button by every port.

When the card is inserted you will see 'Not connected' Status. You need to connect the cable to it and click on Configure button.

  • Media type:

    This is the type of the PRI system that the card is connecting to
    Example:
    • T1 - PRI in US
    • E1 - PRI in EU
    • J1 - PRI in Japan
    (Select box)

  • Coding:

    This is the coding type for this port. This is automatically selected with Media type, so there is no need to change this option.
    (ex. B8ZS)
    (Select box)

  • Framing:

    This is the framing used for this port. This is automatically selected with Media type, so there is no need to change this option.
    (ex. ESF)
    (Select box)

  • Clock:

    Select whether the card will give a clock to devices (Master), or use a clock generated from telco (Normal)
    (ex. Master)
    (Select box)

  • Reference clock:

    This option allows one to use the incoming clock from a different port as a clock source to this port.
    (ex. 2)
    ([0-9])
    NOTE: This option works only if Clock is Master.

  • Hardware DTMF:

    Enable/Disable Hardware DTMF detection
    (ex. Yes, No, N/A)
    (Option buttons)

When you choose which type of connection is used and whether the card will use a clock source from the provider or generating one, click on the Save button. After that click on Apply and then the Restart EdgelessPBX MT button. If the cable is connected and configuration done properly, the system will display 'Connected' by the cards port.

Analog Cards



When you insert an analog Sangoma card, each card has one "item" in the list, regardless of number of ports that it has on it. Under the Port, it will show you how many FXS and/or FXO ports are configured.

  • Codec:

    Codec used for this card
    (ex. MULAW)
    (Select box)

  • FXO Operation mode:

    FXO Operation mode.
    (ex. FCC)
    (Select box)

  • Hardware DTMF:

    Enable/Disable Hardware DTMF detection
    (ex. Yes, No, N/A)
    (Option buttons)

The procedure for configuring FXS/FXO ports is simplest. Click on Configure, Save, Apply and then Restart EdgelessPBX MT.

TIP: If you change the hardware configuration of the card (PCI slot, number of FXS/FXO modules etc.) first reset the settings by clicking on the Reset button in the Configuration window, and then Save.

BRI Cards





Here you can configure Sangoma BRI cards. In this example we used A500 which has 3 physical ports where every port splits into two ISDN ports by a special cable, thus offering 6 ISDN ports which you must configure by clicking on the Configure button.

  • Connection type:

    This should match the settings provided by Telco.
    (ex. point-to-point)
    (Select box)

  • Group:

    Select in which group you want to place the current port. This is useful if you want one trunk to use more than one port so all calls could be spread across several ports. In such a case, put the same number on all ports you want to allocate to the trunk.
    (ex. 2)
    ([0-9])

  • Country:

    Set this to your local country.
    (ex. usa)
    (Select box)

  • Number of incoming digits:

    The minimum number of digits for a called number on an incoming call. Incoming calls with a called number less than this value will be rejected with cause: Invalid number format.
    (ex. 6)
    ([0-9])

  • Dial plan:

    Some switches require the "type of number" network specific facility to be set.
    (ex. international)
    (Select box)

  • Numbering plan:

    Some switches require the "number plan" network specific facility to be set.
    (ex. isdn)
    (Select box)

If the port was connected and properly configured, after clicking on Save and then Apply, restarting EdgelessPBX MT will show Connected by that port.

Information



EdgelessPBX MT continuously monitors system services, load, ZAPTEL modules etc... in order to achieve and maintain high quality operations across the system and network. The result of these monitoring operations are also accessible to an authorized user.

  • Refresh Interval:

    Time interval in seconds at which data is to be refreshed
    (ex. 10 sec)
    (Select box)

  • EdgelessPBX MT Uptime:

    Total time EdgelessPBX MT is available for service
    (ex. 1 hour, 16 minutes, 42 seconds)
    (Display)

  • Last Reload:

    Total time since EdgelessPBX MT was last reloaded
    (ex. 10 minutes, 34 seconds)
    (Display)

  • Load:

    Load shown for past 1, 5 and 15 minutes
    (ex. 0.16)
    (Display)

  • CPU:

    CPU usage by: user, kernel and idle
    (ex. 2.3%)
    (Display)

  • Memory:

    Memory usage by: Used, Cache and Free
    (ex. 299.1M)
    (Display)

  • Swap:

    Swap space usage
    (ex. 5.2M)
    (Display)

  • Processes:

    Processes by Running, Sleeping, Stopped and Zombie
    (ex. 1, 96, 0, 0)
    (Display)

  • rootfs:

    File systems present shows by type, mount, usage and free status
    (ex. 0B, 0B, 3.3G, 1.5G)
    (Display)

  • CPU Info:

    Number of CPU's, Model, Speed and Cache size
    (ex. Core 2 Duo, 1.6Ghz, 2MB)
    (Display)

  • System:

    General system details like Name, Kernel, Architecture and Uptime
    (ex. zenica.domain.com, Linux 2.6.31-27.0.1.EL, i686, 18d 1h 35m)
    (Display)

  • Services:

    Default system services running on the system
    (ex. EdgelessPBX MT, Asterisk, TFTP, Postfix)
    (Display)

  • Modules:

    Currently loaded ZAPTEL modules
    (ex. wsusb)
    (Display)

  • Zaptel:

    A list of all cards detected by the system is displayed here.
    Channel Map displays used slots on TDM card. In this case the first slot is filled with FXO module (displayed in black) while other 'Empty' slots are displayed in gray color.
    (ex. Channel Map: 1: FXO, 2:FXS, 3:Empty, 4:FXO)
    (Display)

TIP: With TDM cards, please make sure your power cable is connected. The message 'PLEASE CHECK TDM POWER CABLE' will be displayed if this happens.

On slave tenant



Sound Files



This section administers sound files used only by the current tenant. This is used to manage only greeting sound files, and overriding of the system's default sound files is not allowed.


  • Sounds:

    Select among available options (gsm, ulaw, alaw, g729, ilbc, sln) to display system sound files of that type
    (ex. Selecting 'gsm' will display all system sounds with the .gsm file type)
    (Select box)

  • Upload:

    Uploads the selected file from a local computer to EdgelessPBX MT
    (ex. Click 'Browse' button and select a file from your desktop. Then click this button to upload selected file to EdgelessPBX MT)
    (Command button)

  • Convert:

    Convert selected file to desired codec.
    (ex. Select a box next to a sound file (e.g. arizona). Select a codec from the drop down menu and click on Convert. The sound file will be converted to that codec).
    (Command button)

  • Rename:

    Renames the selected sound file
    (ex. Select a box next to a sound file (e.g. arizona). Change 'arizona' into 'Arizona101' and click this button to rename the selected sound file)
    (Command button)

  • Delete:

    Deletes the selected sound file
    (ex. Select a box next to a sound file (e.g. arizona) and click this button to delete the selected sound file)
    (Command button)

  • Download:

    Downloads selected sound file to user's desktop
    (ex. Select a box next to a sound file (e.g. arizona) and click this button to download selected file to your desktop)
    (Command button)

TIP: EdgelessPBX MT will play only sound file types equal to enabled codecs on dialing extension.

For example, Extension 1000 has only gsm codec enabled. When same Extension logs in as a Queue Agent by dialing '*202 + $AGENT_NUMBER', all sounds played by EdgelessPBX MT (asking for password etc.) will be in '.gsm' format.

If multiple codecs are enabled for Extension 1000(ulaw,alaw,gsm), EdgelessPBX MT will play the sound files with better sound quality (ulaw/alaw).

Music on Hold



Music on Hold is music or advertisements played to callers while they are waiting for an agent or when put on hold, for example.

Content



MOH content window administers EdgelessPBX MT default MOH sound files. They are listed here with the following details

  • Name:

    MOH sound file name
    (ex. Song)
    (Display)

  • Author:

    MOH sound file author
    (ex. Jinkies)
    (Display)

  • Length:

    MOH sound file length in min:sec
    (ex. 3:08)
    (Display)

  • Class:

    MOH class sound file belongs to
    (ex. Default)
    (Display)

  • Status:

    MOH sound file status
    (ex. On/Off)
    (Display)

  • Edit

    Edits the MOH file configuration
    (ex. Click to edit MOH file configuration)
    (Button)

  • Delete

    Deletes a MOH file from the system
    (ex. Click to delete a MOH file from the system)
    (Button)

Search




  • Search:

    Search phrase
    (ex. Provide a search phrase here and hit enter to filter the records)
    ([a-z][0-9])

  • Name:

    Should the search filter be applied to track names
    (ex. Check the box to search track names)
    (Check box)

Add Recording




  • Clip name:

    Audio file name
    (ex. Riders on the Storm)
    ([a-z][0-9])

  • Author:

    Author name:
    (ex. The Doors)
    ([a-z][0-9])

  • File:

    Displays full path to music file on local computer. Click 'Browse' button to select a file
    (ex. D:MusicThe DoorsThe Doors - Riders on the Storm.mp3)
    ([a-z][0-9])
  • Length:

    Clip length
    (ex. 4:13)
    ([0-9][:])

  • Class:

    Select a MOH class sound file belongs to
    (ex. default)
    (Select box)

  • Status:

    Set the status of uploaded file(active/inactive)
    (ex. On/Off)
    (Option buttons)