ams-install

Installs IMlets on the embedded device.

Usage

ams-install <URL> [auth=<username>:<password>] [hostdownload]

Parameters

This command takes the following parameters:
Parameter 	Description

<URL>
	

Specifies the JAD/JAR location. The URL may contain credentials to access the JAD/JAR server (e.g. http://username:password@host/...).

hostdownload
	

Downloads the JAR file using HTTP and then installs it to device via the tooling channel. Applicable for JAR files only.

auth
	

Specifies the user credentials to access the JAD/JAR server.

Responses

This command may return the following responses:
Response 	Description

<<ams-install,start install, <URL>
	

Information message about the start of the installation process.

<<ams-install, install status: stage <stage> , %percentage%
	

Information message about the installation progress

<<ams-install, OK,install success
	

Information message about the installation completing.

<<ams-install,FAIL,missing parameters. see help.
	

The URL is not specified.

<<ams-install,ERROR,unknown parameter: '<dummy parameter'. see help.
	

An unexpected parameter was found. One or more parameters were found two or more times.

<<ams-install,FAIL,credentials must be specified once: in url or in auth parameter
	

Credential info specified twice: in <URL> and in <auth> parameter.

<<ams-install,FAIL,can't download jar data from <URL>
	

An error occurred while downloading the JAR in hostdownload mode.

<<ams-install,FAIL,errorCode errorcode, errorMessage : message
	

Installation was aborted for some reason, described in error message.

<<ams-install,FAIL, error occurred exception
	

An unexpected error occurred. Note that this response is added for debugging purposes and to avoid confusion.