Confirmed users
1,927
edits
| 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 | 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 == | ||