Location

The Location view presents the scaffolds associated with configuring the location services layer of your network.

Location Services

An entry in the Location Services scaffold defines a Location server with which the rXg will use to determine the location of a wireless client.

The name field is an arbitrary string descriptor used only for administrative identification. Choose a name that reflects the purpose of the record. This field has no bearing on the configuration or settings determined by this scaffold.

The note field is a place for the administrator to enter a comment. This field is purely informational and has no bearing on the configuration settings.

The Type field specifies the type of equipment being configured. Choose the appropriate option from the supported device types drop-down menu.

The Host field is the IP address or domain name of the Location device.

The Subnet mask field is used to enter the subnet mask of the network the location device is on.

The Gateway IP field is used to enter the gateway IP address of the location device.

The API port field is used to set the API port, leave blank for device default.

The Username field sets the device admin username.

The Password field sets the device password, note password will remains the same if left blank.

The API key field sets the device API key.

The Timeout field sets the connection timeout in seconds.

The Areas field sets the location areas managed by this service.

The Location events checkbox will create device location events for notifications recieved from the server if checked.

Location Areas

An entry in the Location Areas scaffold allows the Operator of the rXg to define areas that can then be tied to Location Categories.

The Type field is used to determine if the area is a floor or site.

The Category field if set specifies the category applied to events in this area, unless overridden by a more specific category.

The Parent field sets the parent are which contains this area. Example, a site may be a parent to floor.

The Conference AP's field allows the Operator to add any AP's that should be used for Conferences, this used in conjunction with the conference tool makes it easy to broadcast Conference SSIDs to only the areas where the conference is taking place.

The Conference Ports field allows the Operator to add switch ports that should be used for Conferences.

When configured the Admin Roles field sets the admin roles that will be able to request pending admin transactions from APs in this Location Area.

Location Categories

The Areas field allows the Operator of the rXg to assign categories to specific Location Areas , which includes any APs selected when creating the category.

The Access Points field allows the Operator to select specific APs that will be tied to this Location Category.

The Infrastructure Devices field allows the Operator to assign Infrastructure Devices to the Location Category.

Device Locations

The Device Locations scaffold lists the reported location of devices on the network. The Time entry shows the time the record was created. The MAC entry lists the MAC address of the connected device. The Session entry shows the login session for the device. The Account entry lists the account the device is a member of. The Event field shows the event type for record. The Area field shows the Location Area the record belongs to and the Category field shows the Location Category the record is associated with. The Dwell entry displays the amount of time the device has been in a given area. The Last Area and Last Category entries display the previous are and category the device was associated with. The Access Point entry lists the IP and MAC address the device was connected to at the time the entry was created. The SSID field displays the SSID the client device was connected to. The WLAN entry shows the WLAN on the rXg the client device was associated with. The RADIUS Realm entry shows the radius realm the device authenticated against. The Location Device lists the Infdev device providing the location information.

Example Setup

In this example shows the process of setting up location in a MDU.

1. Add floorplan to location area.
2. Create regions for AP placement.
3. Place AP's into regions.

4. Create Location Categories and add AP's.

5. Add floorplan to location area.

Navigate to Network::Location and create a new Location Area. The Name field is arbitrary, enter a name. Change the Type field to Floor. Note: by selecting floor it allows the operator to upload a floor plan and this will become the partent for any regions that are created, if Site is selected this will be the parent of the floors. Leave Category on -select- as there are none to select at this time. For the Floorplan field click the Choose File button and select the floorplan image to be used. Set the Floor number field to set the floor number. Leave the Parent field on -select- and hit the Create button.

1. Create regions for AP placement.
   

To create regions click on the Floorplan in the Location Area scaffold, this will open up the map allowing the placement of AP's and Regions.

In the Add a Region section enter a name for the region, pick a color for the region and then click Add Region. This create a region that can be placed on the floorplan. The region can be resized by dragging the bottom right corner.

Drag the region to the desired area on the floor plan, adjust size and click save.

Repeat for each area that needs a region.

1. Place AP's into regions.
   

Select an AP from the Place an Access Point / Senso: dropdown. Click the Drag me button.

This will generate an AP that can be placed on the floor plan, the first AP will go in Unit1.

Drag AP to its placement on the map and click Save.

Repeat this step for each AP that is present on the floorplan.

1. Create Location Categories and add AP's.
   

Create a new Location Category.

The Name field is arbitrary, in this case there will be a Location Category created for each unit, the name will reflect the unit. Select the unit for in the Areas field. Select the AP or APs from the Access Points field. Click Create.

Repeat for each Unit.

The rXg is now configured to start keeping track of Device Locations. In order for this to work at a minimum, radius account packets must be received. The below image shows the WLAN settings for the SSID setup for this example. Note: In this example we have control of the wireless infrastructure creating the WLAN pushed all needed settings, without control the WLAN would need to be configured manually on the wireless infrastructure.

The below image shows the information received in the Device Location scaffold.