Integration Framework - Smart Package Installer (SPI) 

Definition

Smart Package Installer (SPI) refers to the entry point for SAP mobile component installation using a third party device management system. SPI triggers mobile component installation or uninstallation on the client device after successful deployment. SPI provides several features, which can be implemented by passing various parameter arguments to SPI during startup. The features, argument (parameter) values, and descriptions follow:

Deployment Options

Deployment	Argument	Description
Uninstallation	-U	Specifies that a mobile component needs to be uninstalled.
Installation		Specifies that a mobile component needs to be installed. This is the default value.

Trace Options

Trace	Argument	Description
Trace path	-TP	Provides a way for you to specify a trace file name and location. This feature is useful for identifying the source of a problem while installing or uninstalling an SAP mobile component. If the destination folder of the trace file specified does not exist on the client device, SPI creates it automatically. This parameter is optional.
Trace size	-TS	Specifies the maximum trace file size in bytes. When the maximum trace file size is reached, the existing trace file extension is renamed to .BAK and a new trace file is created. The system maintains only one copy of the .BAK file, therefore only two cycles of tracing are maintained. This parameter is optional. You must provide a valid trace path for this parameter to be passed as an argument. If you do not, the parameter ignored

Communication Options

Communication	Argument	Description
Communications Port	-P	Provides a way for an administrator to change the default communications port used by the mobile client. The communications port notifies the client that a mobile component needs to be installed or uninstalled. This parameter is optional.

If invalid parameters are passed to SPI, SPI creates a default log file in the device’s system directory. The default log file, SPILog.txt, provides a brief description of the error.

SPI[-U] [-TP: “tracefile”] [-TS:SIZE] [-P:PORT]

Example

Installing a MobileComponent

SPI–TP: “c:\\Trace\\trace.log” –TS:5000 –P:45000

Where:

-TP:“c:\\Trace\\trace.log” refers to the trace file to be created

-TS:5000 refers to the maximum size of 5000 bytes for the trace file

-P:45000 refers to port 45000 that communicates with the mobile client

Uninstalling a Mobile Component

SPI–U –TP:“c:\\Trace\\trace.log” –TS:5000 –P:45000

Where:

-TP:“c:\\Trace\\trace.log” refers to the trace file to be created

-TS:5000 refers to the maximum size of 5000 bytes for the trace file

-P:45000 refers to port 45000 that communicates with the mobile client