System Tools
The System tools tab contains monitoring and trouble shooting tools for the server. You can analyzie the incoming and outgoing data traffic in real time. You can also check the current status and history in the command and SMS queues.
Terminal
Use the Terminal section to analyze traffic on the server. You can follow current traffic in real time and browse through resent traffic history for a user. Select one of the following to find users:
Finding a device
Search device by IMEI, phone number or user
You can search for users based on Username, Email, IMEI and Phone. Enter the text you want to find and press Search to get a list of users matching your search criteria.
Tip: leave the text box empty to return all users.
List unknown connections
Click on Show to show all connections to the server that have not been identified correctly. This is a useful tool for trouble shooting when the username/password or IMEI address for a device has been entered incorrectly in the server.
View connections last X minutes
Enter a number of minutes (X) and Click on Show to show all connections to the server the last X minutes. Do this to only show the most recent connections when you have a large number of users on the server.
List of devices
The list of devices contains the following fields:
Username | This is the username for the user |
The email address | |
IMEI | Device IMEI number. One user can have several devices |
Phone | Device phone number |
Device name | The name of the device |
Type | Device type |
Protocol | The protocol used by the device |
Last position | The last valid position update from the device |
Application(s) | List of applications the device is in |
Terminal | Link to Terminal window for traffic analysis. Click on the link to show the terminal window for this device |
Commands | Link to the Commands queue for the device. Click on the link to bring up this device in Queue viewer |
SMS | Link to the SMS queue for the device. Click on the link to bring up this device in Queue viewer |
Terminal window
The Terminal window shows the latest incoming and outgoing communication for the selected device. You can input custom messages or send commands directly from the terminal window to a device.
To send a custom message to a device just enter the text and select he transport method in the drop down list (direct, http, sms, tcp or udp) and click Send.
To send a command, just select the command from the drop doen list and click Send.
Tip: List the unknown connections and analyze the terminal traffic to find the most common connection errors with wrong username or wrong IMEI number.
Queue Viewer
The Queue Viewer shows the status of ongoing commands and SMS:s as well as the history of completed actions.
Search messages
Enter the following information to find messages in the queues:
- Select the radio button for Commands or SMS
- Enter a time span to narrow down your search (optional)
- Check the Status boxes. If you leave them all un-checked all statuses will be retrieved
- Enter a Device IMEI or username (optional)
List messages
The Commands queue contains the following fields:
Command | The name of the command sent to the device. Click on the command name to show command details |
Current step | The step that the command is on |
Max steps | The total number of steps in the command (for multi step commands this is larger than 1) |
Step description | The status of the current step |
Device | The name of the device |
User | The username the device is connected to |
Status | Status for the command |
Out/In | Command direction, Out for commands sent from the server and In for commands coming to the server |
Client time | Client timestamp for the latest incoming message |
Server time | Server timestamp for the latest message |
Delivered / Last try | Timestamp for when the command was completed, or in case of failure the timestamp for the last try |
Retries | The total number of times the command was sent |
Abort | Press Abort to cancel an ongoing command |
The SMS queue contains the following fields:
Client address | The phone number for the client (user or device) |
Message | The message sent in the SMS |
Device | The name of the device |
User | The username the device is connected to |
Status | Status for the SMS |
Out/In | SMS direction, Out for SMS:s sent from the server and In for SMS:s coming to the server |
Client time | Client timestamp for the latest incoming message |
Server time | Server timestamp for the latest message |
Delivered / Last try | Timestamp for when the SMS was completed, or in case of failure the timestamp for the last try |
Retries | The total number of times the SMS was sent |
Abort | Press Abort to cancel an ongoing SMS |