1. Bicom Systems
  2. Solution home
  3. PBXware
  4. HOWTOs

General :: HOWTO Music on Hold (MOH)

Changing Music On Hold on a Tenant Level

  • Log in to the system administration
  • Navigate to 'Home' > 'Tenant' > 'System' > 'Music on Hold'


Music on Hold Class allows users to have a class of files (multiple sound files) that would be played in a specific order.



Adding a new MoH Class

To set up configuration, please navigate to the ‘Classes’ section and proceed with the following:

1. Click the ‘Add MOH Class’ button
2. Populate the following fields:
  • Class Name
Enter a desired Class name
(E.g. Test)
([a-z][0-9])
  • Stream URL
Enter the stream URL to be placed as MoH
([a-z][0-9])
NOTE: This is optional.
  • Status
Set the Status to 'ON'
(Options button)
  • Sort files
Select this field to 'Not set'
(Select box)
NOTE: Users can choose between the following two options:
  • Alphabetically – Files inside the selected MoH Class will be played in the alphabetical order.
  • Randomly - Files inside the selected MoH Class will be played in the random order.,


Adding a New Record


To set up configuration, please navigate to the ‘Content’ section and proceed with the following:

1. Click the ‘Add New Record’ button
2. Populate the following fields:
  • Clip Name
Set 'Clip Name' as desired
(E.g. Test)
([a-z][0-9])
  • File
Upload a file
(Upload box)
NOTE: Please note that the acceptable format for sound files is: 8Khz, Mono, 16-Bit PCM. Users can use any online free converter for this conversion (e.g. https://g711.org/). When uploading file from the GUI, it must be in .wav or .mp3 format.
  • Class
Select the desired class
(E.g. default)
(Select box)
  • Status
Set the Status to 'ON'
(Options button)

When creating a Tenant, every Destination on that Tenant will have the ‘default’ Music on Hold by default. Music on Hold can be changed on a Destination level.

For an Extension, please navigate to:
‘Tenant' > 'Extensions' > 'Advanced options' > under the 'General' section > 'Music on Hold’
From the drop-down menu, select a preferred MoH class.

NOTE: Users can find the same Settings on the Master Tenant level. However, please note that when adding a MoH class to Master Tenant, it will not be added to Slave Tenants.

Changing Default Music on Hold on a System Level

To change Default Music on Hold on a System Level that would be applied to every newly created Tenant, users need to change the Default Music on Hold Class.

To change the Default MoH class:
  • Ssh to the system by entering the following command:
 ssh user-name@IP-ADDRESS-OF-THE-SYSTEM -p2020  
 Password: enter your user password  
 (e.g. ssh root@10.1.1.0 -p2020)  
  • Create a folder named tenant-default and change its ownership:
 mkdir tenant-default
 chown 555:555 tenant-default
  • After creating the folder, users have to upload the sound file they would like to use as their new default MoH when creating a new Tenant.

NOTE: When uploading a sound file from the backend, it needs to in an acceptable format for sound files, such as 8Khz, Mono, 16-Bit PCM. Users can use any online free converter for this conversion (e.g. https://g711.org/). It must be in the .gsm format.

Once the File is converted to .gsm, please upload it to a created tenant-default folder:

/opt/pbxware/pw/var/lib/asterisk/sounds/tenant-default/


After uploading the file to the designated folder, users must also change file ownership and permissions for it.

  • Enter the tenant-default folder:
 cd /opt/pbxware/pw/var/lib/asterisk/sounds/tenant-default/ 

  • Change ownership of the uploaded default.gsm file:
 chown 555:555 default.gsm  
  • Change the mode of the uploaded default.gsm file:
 chmod 644 default.gsm  

Once this is completed, every Tenant that is created afterwards should have a new MoH file used as default MoH.

NOTE: Please note that this action does not affect the existing Tenants. For each existing Tenant, users would need to manually change the default Class for its Destinations.

Adding MoH as a Ringtone

MoH can be set as a ringtone on Extensions, Ring Groups. For a Ring Group, it can be changed under 'Advanced Options'.

In order to set up configuration successfully, please do the following:
1. Navigate to 'Extensions' >
2. Navigate to 'Ring Groups'
3. Click the 'Show Advanced Options'
4. Navigate to the 'Dial Options' field

NOTE: To play music to ring group callers, please set this field to 'm(tenant-number-$CLASS)', where m = MOH class e.g. m(m-150) or if custom class then you need to specify the name m(m-150-customclass), (150-tenant number).

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons

Feedback sent

We appreciate your effort and will try to fix the article