Snom Service Hub

Content

Page tree

Index:


The File Manager (starting with version 3.6.0) allows SRAPS users to upload and auto-provision files to their desk phones, without having to add additional XML files, just using the SRAPS graphic user interface.


Currently, the following file types are supported:

  • UI Customization: Allows replacing the default Phone User Interface background images and icons with customized ones.
  • Music on Hold: Allows uploading local music on hold file (RAW PCMU 20ms) (from V8.7.3.7)
  • Default Settings: Allows replacing the factory default configuration parameter values with customized values.
  • Custom Minibrowser XML: Allows to add / modify XML pages for the built-in minibrowser
  • Custom XML phone directory: Allows to add / modify the XML pages for the built-in directory
  • License: Allows to upload a license to the phone
  • Replacement Plan: Allows to upload a replacement plan used for XML definitions on function keys
  • Server certificate - base64: Allows to upload a service certificate for client-server authentication
  • Tbook: This can be used to upload a local phonebook on a D-series desk phone
  • TR-069/369 Parameters: Allows to upload a customised parammap file to the phones
  • Default Settings: Allows to provide a set of setting parameters that should be used as factory default values by the phone

These file types are already on the roadmap and will be supported soon:


Use Cases

Files can be used to customize Snom phones. This can be anything from cosmetic personalizations such as Music on Hold or User Interface, to security-related customizations like the staging of the phone with OpenVPN or L2TP configurations.

Unlike referring to a server URL to fetch a file, the file is uploaded and stored on the phone via SRAPS. This lowers network traffic and makes the phone independent from the server hosting the file.


File Upload

A file can either be auto-provisioned to a single phone or - by assigning it to a provisioning profile - to a group of phones, as can be part of the staging process.

In other words, the files can be fetched using the 3 levels of provisioning:

The File Manager section will have all the files centralized stored, and then these files can be dynamically assigned to phones, using the previously mentioned different levels of provisioning.


To upload a file to your SRAPS account (or any customer account, if you are a reseller), go to File Manager, click on Add then select the desired file type: 



Select the file type, and then you can just drag&drop the desired file:

Once you've uploaded a file to SRAPS you will find it listed in the File Manager:

 

Assigning the files to phones

The files were stored in the File Manager section, and now can be freely used within the three levels of provisioning. All webpages (Product Defaults, Provisioning Profiles, Endpoints) will have a new section available to add the files:

E.g. Provisioning Profiles


Clicking in the Files section, then selecting the desired file and clicking on Save, will result in the phone fetching this .wav file, together with the Provisioning Profile that has been assigned to it: 



The procedure to make the file download effective with any of the three levels of provisioning, consists of triggering the settings Synchronization on the phone PUI or with a Reboot, and then, the next time the phone retrieves its configuration from SRAPS, the files will be sent to the phone and stored. 

You will find a new entry in the <uploads> tag of the settings file: 

<uploads>
 <file url=URL type=TYPE />
</uploads>


Removing files from phones

If you want to remove a file from a phone, you will need to:

  1. remove the file from SRAPS or deallocate the file from the phone (or provisioning profile)
  2. factory reset the phone


Further Information


Related articles