mBoosterZip Remote Access Client Supplementary User Guide

 

mBoosterZip Remote Access Client is a command line tool. It is a replacement for the mBoosterZip component of the mBooster J2ME Optimization Suite.

The mBoosterZip User Guide is available at chapter 5 of http://www.innaworks.com/mBooster-2-6-4-Doc.html. This mBoosterZip Remote Access Client Supplementary User Guide specifies the differences between mBoosterZip and mBoosterZip Remote Access Client.

mBoosterZip Remote Access Client Syntax

The syntax is identical to the stand alone mBoosterZip tool, except is run as a java program, and extra properties to control the connection and login to the server are required:

java -jar mBoosterZipRemoteAccessClient.jar [[-<option>[ value]]...] <ZIPoutput> <input...>

File arguments:

<ZIPoutput> The pathname of the generated .JAR/.ZIP file.
<input...> A list of input file names or a single input directory.


Zip options:

-r Recurse into subdirectories. This has no effect if <input...> is not a directory.
-max_chain_length <value> This property defines the scope of the search function in the mBoosterZip compressor while searching for duplicates.
A larger value will generate a higher compression ratio at the cost of a decrease of run-time performance.
Valid values are between 128 and 32768. The default value is 8000. Other recommended values are 2000, 4000, 16000.
Note: A space exists between '-max_chain_length' and <value>
-fixed_block_size Use a preset fixed size for Huffman blocks.


Client control options:

-p <properties file> Specify a properties file containing additional settings, supported properties are here.
-user <username> Specify your username on the server, equivalent to the property REMOTE.USERNAME.
-pass <password> Specify your password on the server, equivalent to the property REMOTE.PASSWORD.
-url <address> Server address, equivalent to the property REMOTE.SERVER.URL.
-D<name=value> Set a property with the given name 'name' to the given value 'value'.
-verbose Enable verbose mode.
-h, -help Prints basic help information.


mBoosterZip Remote Access Client Properties

mBooster Remote Access Client provides this additional set of properties for the specification of remote access related behavior.

REMOTE.SERVER.URL

Function:
Specifies the IP address and the TCP port number of the mBooster Remote Access Server to connect to. The format is the IP address followed by a colon followed by the TCP port number.
Note: This property is compulsory

 

Example:
REMOTE.SERVER.URL=192.168.0.1:1198

Equivalent command-line parameter:
-DREMOTE.SERVER.URL
-url <url>

 

REMOTE.USERNAME

Function:
Specifies the case-sensitive user name to log in as, on the mBooster Remote Access Server.
Note: This property is compulsory

 

Example:
REMOTE.USERNAME=JohnSmith

Equivalent command-line parameter:
-DREMOTE.USERNAME
-user <username>

 

REMOTE.PASSWORD

Function:
Specifies the case-sensitive password for the user account on the mBooster Remote Access Server.
Note: This property is compulsory

 

Example:
REMOTE.PASSWORD=mypassword

Equivalent command-line parameter:
-DREMOTE.PASSWORD
-pass <password>

Running mBoosterZip Remote Access Client

mBoosterZip Remote Access Client is a command line application. mBoosterZip Remote Access Client takes its execution parameters (properties) from three different sources, in the following order of precedence:
1. Command line options other than -D
2. Property override defined through -D command line option on the command line
3. Properties defined in the properties file as specified through -p option on the command line

 

 

 

Example command line

java -jar mBoosterZipRemoteAccessClient.jar -DREMOTE.SERVER.URL=192.168.0.1:1129 
  -DREMOTE.USERNAME=JohnSmith -DREMOTE.PASSWORD=myPassword OutputTarget.zip
  inFile1 inFile2 inFile3 res\inFile4


In this example, mBoosterZip Remote Access Client would attempt to connect to the mBooster Remote Access Server at 192.168.0.1:1129 with the user name JohnSmith and password myPassword. If the username and password are correct on that server, the files inFile1, inFile2, inFile, and inFile4 are uploaded to the server, and the mBoosterZip archive of them is downloaded to OutputTarget.zip.

 

 

java -jar mBoosterZipRemoteAccessClient.jar -p clientprops.properties -r
  OutputTarget.zip zipinputs


In this second example, the client reads properties from the file clientprops.properties, and values for REMOTE.SERVER.URL, REMOTE.USERNAME and REMOTE.PASSWORD must be present in the file. 'zipinputs' is a directory in this case and all files within that directory and its subdirectories are uploaded to the server, and the mBoosterZip archive of them is downloaded to OutputTarget.zip

 

— Previous page – Contents – Next page —