Auto-tools/Projects/SUTAgent: Difference between revisions

Line 21: Line 21:
== Configuration ==
== Configuration ==


The SUTAgent can be configured by providing it with a file called SUTAgent.ini. This optional file can be used to configure the network connection and the registration server (see below). The sutini app from mozdevice can be used to update this file on a remote device.
The SUTAgent can be configured by providing it with a file called SUTAgent.ini. This optional file can be used to configure the network connection and the registration server.
 
For the original Java Android agent, SUTAgent.ini should be put into the "files" directory of the package installation path, typically /data/data/com.mozilla.SUTAgentAndroid/files/SUTAgent.ini. For the C++ agent, Negatus, it should be /data/local/SUTAgent.ini.
 
The sutini app from mozdevice can be used to update this file on a remote device for the Java agent (Negatus is not yet supported by sutini).
 
There are two supported sections in SUTAgent.ini.
 
=== [Registration Server] ===
 
A [Registration Server] section can be included in SUTAgent.ini to cause the agent to register itself upon start-up. The section should contain the following variables:
 
* IPAddr: Address of the registration server.
* PORT: Port of the registration server (normally 28001).
* HARDWARE: Short description of the device.
* POOL: Free-form string that can be used for categorizing the device or other administration tasks.
 
See the Registration Server section below for more details.
 
=== [Network Settings] ===
 
The [Network Settings] section provides a ''limited'' ability to configure the device's wireless network settings via the Java agent. Some options are read by the agent but not actually used; these are indicated below. Note that Negatus does not yet support this section at all.
 
* SSID: Name (SSID) of the wireless network to which the device should connect.
* AUTH: Authentication protocol. Currently only "wpa2" is supported.
* ENCR: Encryption algorithm. Currently only "aes" is supported.
* KEY: ''Ignored''. Probably intended to store the network password, e.g. WPA key.
* EAP: Authentication protocol. Currently only "peap" is supported.
* ADHOC: ''Ignored''.
 
It seems that, if authentication is enabled, the username is always "bmoss@mozilla.com" and the password is "password", though I haven't verified that.


== Start up ==
== Start up ==
Confirmed users
1,927

edits