UM:Mobile Device Monitoring - Revision history

AlexKirhenshtein: Text replacement - "^" to "{{deprecated}}"

2022-09-13T16:13:55Z

Text replacement - "^" to "{{deprecated}}"

← Older revision		Revision as of 16:13, 13 September 2022
Line 1:		Line 1:
	Information moved to documentation:		{{deprecated}}Information moved to documentation:

	https://www.netxms.org/documentation/adminguide/mobile-device-monitoring.html		https://www.netxms.org/documentation/adminguide/mobile-device-monitoring.html

TatjanaDubrovica: Replaced content with "Information moved to documentation: https://www.netxms.org/documentation/adminguide/mobile-device-monitoring.html"

2017-11-24T15:50:36Z

Replaced content with "Information moved to documentation: https://www.netxms.org/documentation/adminguide/mobile-device-monitoring.html"

← Older revision		Revision as of 15:50, 24 November 2017
Line 1:		Line 1:
	~~{{DISPLAYTITLE~~:~~Introduction}}~~		Information moved to documentation:
	~~= About NetXMS Mobile Agent for Android =~~
	~~NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later.<br />~~
	~~Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences sections.<br />~~

	~~= Main window =~~		https://www.netxms.org/documentation/adminguide/mobile-device-monitoring.html
	~~In the figure below you can see how appears the main window.<br />~~

	~~[[File:agent-main-callout.png]]~~

	~~Sections~~:
	~~# Agent status. In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.~~
	~~# Last location section reports info about the last location acquired (date~~/~~time, source provider, geo coordinates and estimated accuracy.~~
	~~# Last connection section reports info about the status of last connection: date~~/~~time and status of connection to the server:port specified in the configuration section~~. ~~In case of errors during connection, here is reported also the error message~~.
	~~# Next connection section reports info about the next scheduled connection.~~
	~~# Device ID section reports the device ID (IMEI in case of devices with phone).~~
	~~# Device Serial section reports the device serial number.~~

	~~== Main menu ==~~
	* ''Reconnect'': select this item to force a reconnection to the server to send new collected data.
	* ''Disconnect & Exit'': select this item to stop the agent and exit from the app.
	* ''Settings'': select this item to configure the agent.

	~~= Settings =~~
	~~This section is used to configure the behaviour of the agent.~~
	~~== Global settings ==~~
	* ''Activate agent'': when set makes the agent operational.
	* ''Autostart on boot'': automatically starts the agent on boot (to be effective, agent must be set to be active).
	* ''Scheduler'': provides the ability to define a “one range” daily on which the agent is operational. Out of the specified range the agent will not collect any new position and will not try to make connections to the server. When set it is possible to specify:
	~~:#''Daily activation on'': start time for daily activation.~~
	~~:#''Daily activation off'': stop time for daily activation.~~

	~~== Connection ==~~
	* Parameters: allows selecting the parameters used to connect to the server:
	~~:# ''Server'': address of the server (IP or name).~~
	~~:# ''Port'': port of the server (default 4747).~~
	~~:# ''User name'': username to connect to the server.~~
	~~:# ''Password'': password to connect to the server.~~
	~~:# ''Encrypt connection'': when selected challenges an encryption strategy with the server (depending on supported~~/~~configured providers).~~
	* ''Frequency'': amount of time, in minutes, that has to elapse between each tentative of connection to the server to send the gathered info.
	* ''Override frequency'': when selected overrides the previous frequency values and forces a new connection to the server (thus resetting the timer) every time a new connection is detected. NB if you are in a situation where connection is not stable it is advised to clear this flag to avoid multiple connections that will drain the battery.

	~~== Locations ==~~
	* ''Force position update'': when cleared instruct the agent to relay on position updates made from other apps in the system (this means that position can be very old if no other apps are trying to get a new fix). When set, instructs the agent to try to gather a new position.
	* ''Frequency (min)'': amount of time, in minutes, that has to elapse before trying to acquire a new position (''Force position update'' set) or before trying to check if someone else updated a position.
	* ''Duration (min)'': maximum amount of time, in minutes, that has to elapse before giving up on acquiring a new position.
	* ''Location strategy'': allows selecting the source provider that has to be used to acquire a new position, allowed providers:
	:# ''Network only'': tries to acquire position from network provider. Network provider is usually fast in acquiring a new position but it is not much accurate, especially using data connection (range from 1Km to 2Km, depending on antennas deployment), the service is not available all around the world. Wi-Fi connection seems to guarantee much higher precision due to a correlation between last known position acquired from GPS.
	:# ''GPS only'': tries to acquire position from GPS provider. GPS provider is usually slow in acquiring a new position, time depends on several factors such as how much time has elapsed since last position, number of satellites in free view (inside buildings can be really had to get a position).
	:# ''Network and GPS'': tries to acquire a position from Network provider or GPS provider, the first one that gives a position is considered ok. There is no special algorithm to evaluate accuracy, the unique criteria is the speed of the fix.

	~~Please note that on 2G networks (GPRS~~/~~EDGE) data connection is not available while you are busy in a conversation, position acquisition will fail. On 3G networks (UMTS~~/~~HSxPA) data connection is available and so the position acquisition. However, if the agent is not able to get a new fix within the time~~-~~frame specified, it will try to gather a position from any available provider that has a valid cached position to provide.~~

	~~== Notifications ==~~
	~~''Toast notification'': when set allows the agent to display “toast” notifications to the user (such as pushing data to the server, inform user about the start of the agent, etc.)~~.

Marco Incalcaterra at 21:14, 15 February 2013

2013-02-15T21:14:25Z

← Older revision		Revision as of 21:14, 15 February 2013
Line 1:		Line 1:
	{{DISPLAYTITLE:Introduction}}		{{DISPLAYTITLE:Introduction}}
	= About NetXMS Mobile Agent for Android =		= About NetXMS Mobile Agent for Android =
	NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later.		NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later.<br />
			Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences sections.<br />

	~~Currently, a very limited set of info~~ can ~~be monitored and reported to a NetXMS server,~~ the ~~next paragraphs briefly describes~~ main ~~screen and preferences sections~~.		= Main window =
			In the figure below you can see how appears the main window.<br />

	[[File:agent-main-callout.png]]		[[File:agent-main-callout.png]]

	~~== Main window ==~~		Sections:
	# Agent status. In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.		# Agent status. In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.
	# Last location section reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.		# Last location section reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.
Line 15:		Line 17:
	# Device Serial section reports the device serial number.		# Device Serial section reports the device serial number.

	=== Main menu ===		== Main menu ==
	* ''Reconnect'': select this item to force a reconnection to the server to send new collected data.		* ''Reconnect'': select this item to force a reconnection to the server to send new collected data.
	* ''Disconnect & Exit'': select this item to stop the agent and exit from the app.		* ''Disconnect & Exit'': select this item to stop the agent and exit from the app.
	* ''Settings'': select this item to configure the agent.		* ''Settings'': select this item to configure the agent.

	== ~~Settings~~ ==		= Settings =
			This section is used to configure the behaviour of the agent.
			== Global settings ==
	* ''Activate agent'': when set makes the agent operational.		* ''Activate agent'': when set makes the agent operational.
	* ''Autostart on boot'': automatically starts the agent on boot (to be effective, agent must be set to be active).		* ''Autostart on boot'': automatically starts the agent on boot (to be effective, agent must be set to be active).
Line 27:		Line 31:
	:#''Daily activation off'': stop time for daily activation.		:#''Daily activation off'': stop time for daily activation.

	=== Connection ===		== Connection ==
	* Parameters: allows selecting the parameters used to connect to the server:		* Parameters: allows selecting the parameters used to connect to the server:
	:# ''Server'': address of the server (IP or name).		:# ''Server'': address of the server (IP or name).
Line 37:		Line 41:
	* ''Override frequency'': when selected overrides the previous frequency values and forces a new connection to the server (thus resetting the timer) every time a new connection is detected. NB if you are in a situation where connection is not stable it is advised to clear this flag to avoid multiple connections that will drain the battery.		* ''Override frequency'': when selected overrides the previous frequency values and forces a new connection to the server (thus resetting the timer) every time a new connection is detected. NB if you are in a situation where connection is not stable it is advised to clear this flag to avoid multiple connections that will drain the battery.

	=== Locations ===		== Locations ==
	* ''Force position update'': when cleared instruct the agent to relay on position updates made from other apps in the system (this means that position can be very old if no other apps are trying to get a new fix). When set, instructs the agent to try to gather a new position.		* ''Force position update'': when cleared instruct the agent to relay on position updates made from other apps in the system (this means that position can be very old if no other apps are trying to get a new fix). When set, instructs the agent to try to gather a new position.
	* ''Frequency (min)'': amount of time, in minutes, that has to elapse before trying to acquire a new position (''Force position update'' set) or before trying to check if someone else updated a position.		* ''Frequency (min)'': amount of time, in minutes, that has to elapse before trying to acquire a new position (''Force position update'' set) or before trying to check if someone else updated a position.
Line 48:		Line 52:
	Please note that on 2G networks (GPRS/EDGE) data connection is not available while you are busy in a conversation, position acquisition will fail. On 3G networks (UMTS/HSxPA) data connection is available and so the position acquisition. However, if the agent is not able to get a new fix within the time-frame specified, it will try to gather a position from any available provider that has a valid cached position to provide.		Please note that on 2G networks (GPRS/EDGE) data connection is not available while you are busy in a conversation, position acquisition will fail. On 3G networks (UMTS/HSxPA) data connection is available and so the position acquisition. However, if the agent is not able to get a new fix within the time-frame specified, it will try to gather a position from any available provider that has a valid cached position to provide.

	=== Notifications ===		== Notifications ==
	''Toast notification'': when set allows the agent to display “toast” notifications to the user (such as pushing data to the server, inform user about the start of the agent, etc.).		''Toast notification'': when set allows the agent to display “toast” notifications to the user (such as pushing data to the server, inform user about the start of the agent, etc.).

Marco Incalcaterra: /* Locations */

2013-02-14T16:50:50Z

Locations

← Older revision		Revision as of 16:50, 14 February 2013
Line 42:		Line 42:
	* ''Duration (min)'': maximum amount of time, in minutes, that has to elapse before giving up on acquiring a new position.		* ''Duration (min)'': maximum amount of time, in minutes, that has to elapse before giving up on acquiring a new position.
	* ''Location strategy'': allows selecting the source provider that has to be used to acquire a new position, allowed providers:		* ''Location strategy'': allows selecting the source provider that has to be used to acquire a new position, allowed providers:
	:# ''Network only'': tries to acquire position from network provider. Network provider is usually fast in acquiring a new position but it is not much accurate, especially using data connection. Wi-Fi connection seems to guarantee higher precision.		:# ''Network only'': tries to acquire position from network provider. Network provider is usually fast in acquiring a new position but it is not much accurate, especially using data connection (range from 1Km to 2Km, depending on antennas deployment), the service is not available all around the world. Wi-Fi connection seems to guarantee much higher precision due to a correlation between last known position acquired from GPS.
	:# ''GPS only'': tries to acquire position from GPS provider. GPS provider is usually slow in acquiring a new position, time depends on several factors such as how much time has elapsed since last position, number of satellites in free view (inside buildings can be really had to get a position).		:# ''GPS only'': tries to acquire position from GPS provider. GPS provider is usually slow in acquiring a new position, time depends on several factors such as how much time has elapsed since last position, number of satellites in free view (inside buildings can be really had to get a position).
	:# ''Network and GPS'': tries to acquire a position from Network provider or GPS provider, the first one that gives a position is considered ok. There is no special algorithm to evaluate accuracy, the unique criteria is the speed of the fix.		:# ''Network and GPS'': tries to acquire a position from Network provider or GPS provider, the first one that gives a position is considered ok. There is no special algorithm to evaluate accuracy, the unique criteria is the speed of the fix.
	If the agent is not able to get a new fix within the time-frame specified, it will try to gather a position from any available provider that has a valid cached position to provide.
			Please note that on 2G networks (GPRS/EDGE) data connection is not available while you are busy in a conversation, position acquisition will fail. On 3G networks (UMTS/HSxPA) data connection is available and so the position acquisition. However, if the agent is not able to get a new fix within the time-frame specified, it will try to gather a position from any available provider that has a valid cached position to provide.

	=== Notifications ===		=== Notifications ===
	''Toast notification'': when set allows the agent to display “toast” notifications to the user (such as pushing data to the server, inform user about the start of the agent, etc.).		''Toast notification'': when set allows the agent to display “toast” notifications to the user (such as pushing data to the server, inform user about the start of the agent, etc.).

Marco Incalcaterra at 18:04, 13 February 2013

2013-02-13T18:04:43Z

← Older revision		Revision as of 18:04, 13 February 2013
Line 4:		Line 4:

	Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences sections.		Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences sections.

			[[File:agent-main-callout.png]]

	== Main window ==		== Main window ==
	* Info about agent status ~~(1)~~. In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.		# Agent status. In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.
	* Last location section ~~(2)~~ reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.		# Last location section reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.
	* Last connection section ~~(3)~~ reports info about the status of last connection: date/time and status of connection to the server:port specified in the configuration section. In case of errors during connection, here is reported also the error message.		# Last connection section reports info about the status of last connection: date/time and status of connection to the server:port specified in the configuration section. In case of errors during connection, here is reported also the error message.
	* Next connection section ~~(4)~~ reports info about the next scheduled connection.		# Next connection section reports info about the next scheduled connection.
	* Device ID section ~~(5)~~ reports the device ID (IMEI in case of devices with phone).		# Device ID section reports the device ID (IMEI in case of devices with phone).
	* Device Serial section ~~(6)~~ reports the device serial number.		# Device Serial section reports the device serial number.

	=== Main menu ===		=== Main menu ===

Marco Incalcaterra at 17:48, 13 February 2013

2013-02-13T17:48:52Z

← Older revision		Revision as of 17:48, 13 February 2013
Line 3:		Line 3:
	NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later.		NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later.

	Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences ~~section~~.		Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences sections.

	=== Main window ===		== Main window ==
	* Info about agent status (~~active or not active~~). In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.		* Info about agent status (1). In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.
	* Last location section reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.		* Last location section (2) reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.
	* Last connection section reports info about the status of last connection: date/time and status of connection to the server:port specified in the configuration section. In case of errors during connection, here is reported also the error message.		* Last connection section (3) reports info about the status of last connection: date/time and status of connection to the server:port specified in the configuration section. In case of errors during connection, here is reported also the error message.
	* Next connection section reports info about the next scheduled connection.		* Next connection section (4) reports info about the next scheduled connection.
	* Device ID section reports the device ID (IMEI in case of devices with phone).		* Device ID section (5) reports the device ID (IMEI in case of devices with phone).
	* Device Serial section reports the device serial number.		* Device Serial section (6) reports the device serial number.

	=== Main menu ===		=== Main menu ===
Line 18:		Line 18:
	* ''Settings'': select this item to configure the agent.		* ''Settings'': select this item to configure the agent.

	=== Settings ===		== Settings ==
	* ''Activate agent'': when set makes the agent operational.		* ''Activate agent'': when set makes the agent operational.
	* ''Autostart on boot'': automatically starts the agent on boot (to be effective, agent must be set to be active).		* ''Autostart on boot'': automatically starts the agent on boot (to be effective, agent must be set to be active).

Marco Incalcaterra: Created page with "{{DISPLAYTITLE:Introduction}} = About NetXMS Mobile Agent for Android = NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later. Currentl..."

2013-02-13T14:40:03Z

Created page with "{{DISPLAYTITLE:Introduction}} = About NetXMS Mobile Agent for Android = NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later. Currentl..."

New page

{{DISPLAYTITLE:Introduction}}
= About NetXMS Mobile Agent for Android =
NetXMS mobile agent is a monitoring agent for Android devices running version 2.2. and later.

Currently, a very limited set of info can be monitored and reported to a NetXMS server, the next paragraphs briefly describes main screen and preferences section.

=== Main window ===
* Info about agent status (active or not active). In case agent is active, reports the basic info about configuration such as scheduler for new location acquisition and connection to server where to update info collected.
* Last location section reports info about the last location acquired (date/time, source provider, geo coordinates and estimated accuracy.
* Last connection section reports info about the status of last connection: date/time and status of connection to the server:port specified in the configuration section. In case of errors during connection, here is reported also the error message.
* Next connection section reports info about the next scheduled connection.
* Device ID section reports the device ID (IMEI in case of devices with phone).
* Device Serial section reports the device serial number.

=== Main menu ===
* ''Reconnect'': select this item to force a reconnection to the server to send new collected data.
* ''Disconnect & Exit'': select this item to stop the agent and exit from the app.
* ''Settings'': select this item to configure the agent.

=== Settings ===
* ''Activate agent'': when set makes the agent operational.
* ''Autostart on boot'': automatically starts the agent on boot (to be effective, agent must be set to be active).
* ''Scheduler'': provides the ability to define a “one range” daily on which the agent is operational. Out of the specified range the agent will not collect any new position and will not try to make connections to the server. When set it is possible to specify:
:#''Daily activation on'': start time for daily activation.
:#''Daily activation off'': stop time for daily activation.

=== Connection ===
* Parameters: allows selecting the parameters used to connect to the server:
:# ''Server'': address of the server (IP or name).
:# ''Port'': port of the server (default 4747).
:# ''User name'': username to connect to the server.
:# ''Password'': password to connect to the server.
:# ''Encrypt connection'': when selected challenges an encryption strategy with the server (depending on supported/configured providers).
* ''Frequency'': amount of time, in minutes, that has to elapse between each tentative of connection to the server to send the gathered info.
* ''Override frequency'': when selected overrides the previous frequency values and forces a new connection to the server (thus resetting the timer) every time a new connection is detected. NB if you are in a situation where connection is not stable it is advised to clear this flag to avoid multiple connections that will drain the battery.

=== Locations ===
* ''Force position update'': when cleared instruct the agent to relay on position updates made from other apps in the system (this means that position can be very old if no other apps are trying to get a new fix). When set, instructs the agent to try to gather a new position.
* ''Frequency (min)'': amount of time, in minutes, that has to elapse before trying to acquire a new position (''Force position update'' set) or before trying to check if someone else updated a position.
* ''Duration (min)'': maximum amount of time, in minutes, that has to elapse before giving up on acquiring a new position.
* ''Location strategy'': allows selecting the source provider that has to be used to acquire a new position, allowed providers:
:# ''Network only'': tries to acquire position from network provider. Network provider is usually fast in acquiring a new position but it is not much accurate, especially using data connection. Wi-Fi connection seems to guarantee higher precision.
:# ''GPS only'': tries to acquire position from GPS provider. GPS provider is usually slow in acquiring a new position, time depends on several factors such as how much time has elapsed since last position, number of satellites in free view (inside buildings can be really had to get a position).
:# ''Network and GPS'': tries to acquire a position from Network provider or GPS provider, the first one that gives a position is considered ok. There is no special algorithm to evaluate accuracy, the unique criteria is the speed of the fix.
If the agent is not able to get a new fix within the time-frame specified, it will try to gather a position from any available provider that has a valid cached position to provide.
=== Notifications ===
''Toast notification'': when set allows the agent to display “toast” notifications to the user (such as pushing data to the server, inform user about the start of the agent, etc.).