> For the complete documentation index, see [llms.txt](https://docs.globalalerting.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.globalalerting.com/devices/gap-guardian-app/gap-guardian-v3-administration-guide.md).

# GAP Guardian v3 Administration Guide

This article explains how to administer GAP Guardian devices via the GAP Portal.

## Configuring Tenant-Level Default Settings

You can set up default settings that apply to new devices on a per-tenant basis via the GAP Portal.

When a new app is activated, the tenant-level default settings will be applied.

{% hint style="warning" icon="triangle-exclamation" %}
Changing these settings does not impact existing apps.
{% endhint %}

To configure tenant-level default app settings:

1. In the GAP Portal, click "Options".
2. Click "Tenants".
3. Click on the name of the tenant whose settings you wish to change.
4. Click "Default App Feature Settings".
5. Click on the device type whose defaults you wish to change (either "GAP Guardian for Android" or "GAP Guardian for iOS").
6. Select which app screens should be available by checking / unchecking options under the "App Features" section.
7. Select which actions should be performed upon app start-up by checking / unchecking options under the "Start-Up Options" section.
8. Set the default setting values for each app feature using the drop-down lists under the "Monitor Me", "Location Service Settings", "Tracking Mode" and "SOS Mode" sections.
9. Click "OK".

{% embed url="<https://vimeo.com/1177540519?fe=ci&fl=sv&share=copy>" %}

### Configure Quick Call <a href="#creatinganewdevice" id="creatinganewdevice"></a>

To configure the app's Quick Call function:

1. In the GAP Portal, click "Options".
2. Click "Tenants".
3. Click on the name of the tenant whose settings you wish to change.
4. Click "App Call Buttons".
5. Enter up to 2 numbers, labels and descriptions into the relevant text boxes.
6. Enter up to 2 numbers, one for SOS calls and one for Monitor Me calls into the "SOS Call Number" and "Monitor Me Call Number" text boxes respectively.
7. Click "OK".

## Creating App Devices <a href="#creatinganewdevice" id="creatinganewdevice"></a>

{% hint style="info" %}
If the [option to automatically create app device records upon login](/administration/access-control/managing-tenants.md#editing-tenants) is not enabled at the tenant-level, device records must be created manually prior to login.
{% endhint %}

1. In the GAP Portal click "Devices"
2. Click "+".
3. Enter a device ID into the "Device Id" text box.  The device ID must be unique (e.g. IMEI or GUID).
4. Select a tenant in which the device will reside from the "Tenant" drop-down list.
5. Enter a device ID in the "Device Id" text box.  This value must be unique (e.g. an IMEI or GUID).
6. Enter a friendly name in the "Friendly Name" field.
7. Select a user to assign the device to via the "Assigned User" drop-down list.  Note the user must in the same tenant as the device.
8. Enter a description into the "Description" text box.
9. Enter the device's phone number into the "Phone Number (MSISDN)" text box.
10. Select a map icon and colour from the pickers.
11. Click the "OK" button.

## Remote Operation & Administration

### Requesting Location <a href="#howtosendalocationrequest" id="howtosendalocationrequest"></a>

To request the current location of the device:

1. In the GAP Portal, click "Devices".
2. Click the name of the device to which you wish to send the command.
3. Under the "Context" section, click "Request Location".

It may take a few minutes for the current location to be returned via a message in the Inbox.

### Requesting Check-In <a href="#howtorequestacheckin" id="howtorequestacheckin"></a>

To request that the user checks in:

1. In the GAP Portal, click "Devices".
2. Click the name of the device to which you wish to send the command.
3. Under the "Check-In Actions" section, click "Request Check-In".
4. Select how long the user should have to check in before they their device enters an overdue state using the "Check-In Period" drop-down list.
5. Click the "Send" button.

### Manually Checking In <a href="#howtoperformamanualcheckin" id="howtoperformamanualcheckin"></a>

You can manually check in a user (for example, if their device is not working) via the "Manual Check-In" button.

See [Monitoring & Check-Ins](/monitoring-and-response/working-with-devices/monitoring-and-check-ins.md#howtoperformamanualcheckin) for more information.

### Declaring an Emergency <a href="#howtodeclareanemergency" id="howtodeclareanemergency"></a>

You can declare an emergency on behalf of the device user. This will send a command to their device to activate SOS mode.

1. In the GAP Portal, click "Devices".
2. Click the name of the device to which you wish to send the command.
3. Under the "Emergency Actions" section, click "Declare Emergency".
4. Click the "Yes, Declare Emergency" button.

### Acknowledging an Emergency <a href="#howtoacknowledgeanemergency" id="howtoacknowledgeanemergency"></a>

When a device is in an emergency state, you can acknowledge an emergency.  This will send a message to the device to that effect.

1. In the GAP Portal, click "Devices".
2. Click the name of the device to which you wish to send the command.
3. Under the "Emergency Actions" section, click "Acknowledge Emergency".
4. Click the "Yes, Acknowledge Emergency" button.

### Cancelling an Emergency <a href="#howtocancelanemergency" id="howtocancelanemergency"></a>

When a device is in an emergency state, you can cancel an emergency from the Portal. This will send a message to the device to deactivate SOS mode.

1. In the GAP Portal, click "Devices".
2. Click the name of the device to which you wish to send the command.
3. Click "Cancel Emergency".
4. Click the "Yes, Cancel Emergency" button.

### Sending Text Messages <a href="#howtosendatextmessage" id="howtosendatextmessage"></a>

To send the device a text message:

1. In the GAP Portal, click "Devices".
2. Click the name of the device to which you wish to send the message.
3. Click "Send Text Message".
4. Enter the message in the text box.
5. Optionally, check the "Force SMS" check box to send the message as an SMS rather than a push notification (note: this will incur a charge and the message will appear in the device's default messaging app, rather than the app's Messages feature).
6. Click the "Send" button.

### Configure App Features <a href="#howtochangeappfeatures" id="howtochangeappfeatures"></a>

To change which app features are enabled for an individual app instance:

1. In the GAP Portal, click "Devices".
2. Click the name of the device whose features you wish to change.
3. Under the "Device Actions" section, click "Configure Device".
4. Click "Feature Settings"
5. Select which app screens should be available by checking / unchecking the options listed
6. Click the "Send" button.

### Configuring App Settings <a href="#howtochangeappsettings" id="howtochangeappsettings"></a>

To change the app's settings:

1. In the GAP Portal, click "Devices".
2. Click the name of the device whose features you wish to change.
3. Under the "Device Actions" section, click "Configure Device".
4. Click "Application Settings"
5. Select which actions should be performed upon app start-up by selecting "Update start-up options" from the "Start-Up Options" drop-down list and then checking / unchecking the options that appear.
6. Set the default setting values for each app feature using the drop-down lists under the "Monitor Me", "Location Service Settings", "Tracking Mode" and "SOS Mode" sections.
7. Click the "Send" button.

### Requesting Logs <a href="#howtodeactivatetheapp" id="howtodeactivatetheapp"></a>

The app's log can assist with troubleshooting app operation.  The user can upload it to the GAP Portal themselves (see [GAP Guardian v3 User Guide](/devices/gap-guardian-app/gap-guardian-v3-user-guide.md#log) for more information), or a GAP Portal operator can request it.  The app log will then appear as a message in the device's inbox.

1. In the GAP Portal, click "Devices".
2. Click the name of the device whose log you want to request.
3. Under the "Device Actions" section, click "Configure Device".
4. Click "Advanced".
5. Click "Request Log".

### Deactivating <a href="#howtodeactivatetheapp" id="howtodeactivatetheapp"></a>

You can deactivate an app so that the user's configuration is deleted from the device and they are returned to the Login screen.

1. In the GAP Portal, click "Devices".
2. Click the name of the device you wish to deactivate.
3. Under the "Device Actions" section, click "Configure Device".
4. Click "Force Log Out".
5. Click the "Yes, Deactivate" button.