Locations

Owned by Chris Clark
Last updated: Nov 07, 2017 by Ken Lasko (Unlicensed)
4 min read


Locations allow for logical grouping of Device Profiles, Software, and Speed Dials to a specific physical location, and a network location. The physical location is defined by Address, City, State, Post Code, Country, Timezone. Additionally, a Contact Name, contact Number, and Contact Email for the location can be configured.
Logical location is defined by the network Subnets. You define the Subnets associated with the physical location by defining the TCP/IP network using classless inter-domain routing (CIDR) notation.
At a minimum, for each location, you should define all fields in the Location section and define at least one network. You add device profiles, software and speed dial entries to apply these elements to devices in the location and subnet.

Add Locations

To add a new location, do the following.

  1. Click Locations on the sidebar. On the Locations dialog, click Add.
  2. On the Location – Add New dialog in the Location section
  3. Click the field for Location Name and type a name for this new location
  4. Click the field for Address and fill in the address of the physical location
  5. Click the field City and type the city for this physical location
  6. Click the State field and type the state for this physical location
  7. Click the Postcode field and type the postal code or ZIP code for this physical location
  8. Click the Country field and type the country for this physical location
  9. Click the Timezone field and start typing the time zone this physical location. For example, for US Central, you can type 'cen' and select US/Central or '6' and select 'CST6CDT'
  10. Click the Contact Name field and type the person's name who is the point of contact for this physical location
  11. Click the Contact Number field and type the phone number of SIP URI for the person named in Contact Name for this physical location
  12. Click the Contact Email field and type the email address for the person named in Contact Name for this physical location
  13. To add subnets to this location, Click Add in the Subnets section
  14. Click the field for CIDR and type the network portion of the TCP/IP address. For example, if a network is defined by a netmask of 255.255.255.0, the CIDR definition you would type is 192.168.10.0/24
  15. Click Create to add the subnet to the location or Cancel to discard your changes
  16. To add device profiles to this location, click Add in the Device Profiles section
  17. In the Add Device Profiles dialog, select one or more device profiles by checking the check box associated with the profiles you want to add to the location.
  18. Use the Filter to find a device profile or reduce the number of device profiles and locate the profiles you need
  19. Click Apply to add the selected profiles to the location or Cancel to discard your changes
  20. To add software to this location, click Add in the Software section
  21. In the Apply Software dialog, select one or more software packages by checking the check box associated with the software package(s) you want to add to the location.
  22. Use the Filter to find a software package or reduce the number of software packages and locate the software package(s) you need
  23. Click Apply to add the selected software package(s) to the location or Cancel to discard your changes
  24. To add speed dial sets to this location, click Add in the Speed Dials section
  25. In the Add Speed Dials dialog, select one or more speed dial sets by checking the check box associated with the speed dial set(s) you want to add to the location.
  26. Use the Filter to find a speed dial set or reduce the number of speed dial sets and locate the speed dial set (s) you need
  27. Click Apply to add the selected speed dial set(s) to the location or Cancel to discard your changes
  28. To save the Location configuration, click Save to commit the Location settings, or Cancel to discard the changes
  29. In order to apply your changes to the devices in the newly created Location, you can reboot all devicesThis needs clarification. How can you reboot devices in a location that isn't defined?

Edit Locations

You can edit an existing Location to add or remove items from the existing configuration. You can change the Location name, physical address and point of contact information, Add, edit or remove subnets, add or remove device profiles, add or remove software, or add or remove speed dials.
To edit an existing Location, click Locations in the sidebar. Do the following.
Note! You can save after every change, or you can save when you are done with the entire Location edit.

  1. From the Locations dialog, locate the location that you want to edit. Click on the name of the Location
  2. If you need to change any item in the Location section, click in the text field of the item, edit the item to what you need it to be
  3. If you need to Add subnets, click Add in subnets and type the TCP/IP CIDR network address. Conversely, to delete a subnet from Subnets, click the trash can icon (delete.)
  4. If you need to Add a Device Profile, click Add and then select the device profile from the pick list. Conversely, to delete a device profile from the device set, click the trash can icon (delete.)
  5. If you need to add Software, click Add and then select the software from the pick list. Conversely, to delete a software from the device set, click the trash can icon (delete.)
  6. If you need to add Speed Dials, click Add and then select the Speed Dial set from the pick list. Conversely, to delete a speed dial set from the device set, click the trash can icon (delete.)
  7. When you are done with editing the Location, click Save. If you want to discard your changes, click Cancel, and confirm that you understand your changes will be discarded by clicking Procced.

Deleting Locations

A function of good management is to delete items that you no longer need.
To delete a Location, do the following:

  1. Scroll to locate or use Filter to find the location to delete
  2. Click the Delete icon (trash can icon) on the right of the location
  3. A Confirmation dialog is displayed. Click Cancel if you do not want to delete the location, or click Delete to remove the selected location

Importing Locations

A list of locations can be imported via CSV file.  The only field required to be populated is the name field. The CSV file needs to have the following column headers:

  • name
  • note
  • address
  • city
  • state
  • postcode
  • country
  • timeZone *
  • contactName
  • contactNumber
  • contactEmail

*  timeZone should use the standard TZ naming format as described in this Wikipedia article