Overview
- Device(s) - Since the Cloud Device Manager is a generic configuration tool for SIP based devices we refer to the devices that we write out configuration files for as Device. This can include SIP Phones, ATAs, Gateways, Door Control Boxes, Overhead Paging or Dect Base Stations.
- Options and Settings - Because Templates are agnostic to manufacture and models of phones not all settings in a template will apply to all manufacture and models of phones.
Logging In
- Open a web browser to https://devices.clearlyip.com
- Login with your Clearly IP Single Sign On (SSO) Username and Password. This is the same username and password used to login to Clearly IP Support Site and different Portals.
- Click on the CDM Tab at the top. If you do not have a CDM tab that means your account is not setup with CDM access. At this time CDM is not sold or offered as a stand alone product and is bundled with the Clearly Cloud offering only.

Location Overview
Locations in CDM are best described as a unique PBX or tenant on a multi tenant PBX. It contains information about the PBX such as the IP Address or Domain Name on how to connect to the PBX for the SIP End Points, What Codecs the Location supports and what its standard feature codes are that may be used in program buttons.
A location gets created and belongs to a Tenant and the users of that Tenant can now manage that Location.
Creating a new Location
- Once Logged into CDM from the Menu bar click on CDM > Locations

- Click on the "Add A New Location" button to add a new Location

- Add Location Step 1 Wizard - Press the next button for step 2
- Tenant Owner - Pick which Tenant this Location belongs to. If you are logged in as a tenant you will not be able to pick a different Tenant. This only pertains to Reseller Level logins.
- Name - Provide a Name for this Location
- Description - Optionally provide a Description for this Location
Extensions are where you define the extensions from your PBX and include the Extension name, username and SIP Password for each extension. Once Extensions are created we can now map Extensions to Specific Templates, Device Models and Locations to build out the configuration file for each Device based on the Devices MAC Address.
Creating new Extensions
- Once Logged into CDM from the Menu bar click on CDM > Extensions

- Click on the Add A New Extension button

- Add Extension Step 1 Basic Wizard - Press the next button for step 2
- Location - Pick which Location this Extension is tied to
- Name - Name of this Extension you are creating
- Number - The Extension Number or on some PBXs known as the SIP User Name
- Secret - The Extension SIP Password or Secret to register as this SIP Extension
- Device Count - How many devices can register to this extension. For example if you set this to 3 than when we setup Device Mapping next CDM will only allow you to map 3 different Device MAC Addresses to this same extension.
- Description - Friendly Description on what this Extension is.
- Add Extension Step 2 Review Wizard - Press Add Extension to complete the process of adding this Extension into CDM

Managing existing Extensions
Mappings are where we pull in all the information of Locations, Templates, Models and Extensions and map them to specific Device MAC Addresses that are used to provide all the configuration details to the Device when it logs in and request the configuration information.
Creating new Mappings
- Once Logged into CDM from the Menu bar click on CDM > Mappings

- Click on the Add A New Mapping button

- Add Mapping Step 1 Template and Model Wizard - Press the next button for step 2
- Location - Pick which Location this Device will be linked to
- Template - What Template are you wanting to use for this Device
- Select a Model - Based on what Template you picked above you will be given a list of all the Models that you have setup under that Template that you can pick from.
- MAC Address - The MAC Address of the device that you are adding.
- Provisoning URL - Allows you to copy the full Provisoning URL that this device will need to be provided on how to get its configuration file. This is a Read only field and provided base on the template you picked above.

- Add Extension Step 1 Mappings Wizard - Press the Add Mapping button to complete the process of adding this device.
- Registration - Generally this would be set to 1 as the main registration on the device but if you were trying to program the same device to 2 different extensions you may pick a different registration for this device.
- Extension - Which Extension we are mapping to this device
- Device - This is a drop down of which Device Count this mapping will use. Earlier when we setup the Extension we defined how many devices are allowed to connect to the same extension and here we are just pick one of the free slots.
- SIP Port - This is the Device local SIP port that you want it to be configured with. Normally this would be left at 5060
- Transport Type - This would be the Transport Type the Device should be setup to communicate with the PBX.
- Media Type - This would be the Media Type the Device should be setup with based on the PBX.
- Remote Phone - If this is checked this will tell the phone to use the"Primary Remote Host" host of the Location versus the default Primary Local Host.
- Add/Remove - This allows you to map an additional Extension to the Device on an additional Registration such as Registration 2. This is only used when you are trying to have a single Device register as different extensions on the same device.

Managing Mappings
- Once Logged into CDM from the Menu bar click on CDM > Mappings

- From here you can see a list of all the Mappings that your login has access to. If you are a reseller you can see all the Mappings that are linked to any Location that belong to Tenants that are under you.

- Click on the Binocular icon.
under the Action column to view and edit the details of the Mapping.
- Click on the Trash Can icon
under the Action column to delete the Mapping
Custom Config is for advanced users. It exposes all the config options for each model of phone that you have setup and lets you change or set any Custom Config setting that the Device supports. This is used mainly to set custom settings for a Device for a setting that is not exposed in the Template of a Device. You will need to understand your Devices configuration structure and options as each manufacture has their own way of handling configuration files and options within those files.
Modifying a Custom Config
- Once Logged into CDM from the Menu bar click on CDM > Custom Config

- From here you can see a list of all the Models that your login has access to. If you are a reseller you can see all the Models that are linked to any Template that belong to Tenants that are under you.

- Click on the Config Icon
under the Action Column for the Model that you would like to modify the Custom Config on.
- From here a text editor will be opened and you can start modifying the configs of anything you need to change.

- Press the Save Custom Config button at the bottom of the page. You will now need to reboot your phones that are mapped to this Model to have them update their config.
