Please note
It is possible to extract the "InstallerForDevelpmentG2.zip" [sic] from the RICOH_Uroboros.jarfile the using any zip utility and installing that to G2 devices directly without using the self-installation method described here. This will install v3.1 of the Installer For Development suitable for G2 devices only.
Usage
In order to use this tool you have to run it from the command line. Since this tool is a Java jar file, use the Java command to run this tool.
The following shows how to use this tool:
Install - Install the application installer for development to the device that is indicated by the IP address.
>> install targetIPAddress [--password password]
Uninstall - Uninstall the application installer for development from the device that is indicated by the IP address.
>> uninstall targetIPAddress [--password password]
Version – Display Ricoh Uroboros version number
>> version
Attribute definitions:
targetIPAddress - Specify the IP address of the target machine.
password - Specify the password for remote installation of the target machine. Password is not required if the machine's password for remote installation has not been changed.
Example Usage and Results
The following is an example of running this tool.
The first line of each section is the command, and the second and the following lines indicate the result.
1. Install
>> java -jar Ricoh_UroborosG2.jar install 192.168.1.100
Processing finished.
Result=true,ErrorCode=0,message=
Specify the IP address of the target machine and run the install command.
Line 2 "Processing finished." indicates the end of the process.
Line 3 shows the result of installation. "Result=true" indicates successful installation.
2. Uninstall
>> java -jar Ricoh_UroborosG2.jar uninstall 192.168.1.100
Processing finished.
Result=true,ErrorCode=0,message=
Specify the IP address of the target machine and run the uninstall command.
Line 2 "Processing finished." indicates the end of the process.
Line 3 shows the result of uninstallation process. "Result=true" indicates successful uninstallation process.
3. Install/Uninstall error
>> java -jar Ricoh_UroborosG2.jar install 192.168.1.100
Processing finished.
Result=false,ErrorCode=5102,message=Operation busy.
If install/uninstall process fails after running the command,
"Result" in line 3 becomes "false".
Also, "ErrorCode" in line 3 indicates the cause of the error.
Error codes are explained in the section [Reference].
In this example, the command has failed because the machine is in use.
4. Communication error
>> java -jar Ricoh_UroborosG2.jar install 192.168.1.100
Processing error occurred.
Please check a target machine network settings.(IP address, Network port, RemoteInstall password and more.)
If process fails by a communication error after running the command, this error appears.
If this message appears,
check network settings of the target machine (e.g. IP address, network port setting).
5. Install by specifying the password for remote installation
>> java -jar Ricoh_UroborosG2.jar install 192.168.1.100 --password password
Processing finished.
Result=true,ErrorCode=0,message=
Specify the option "--password <password for remote installation>" after the IP address in the command.
If the machine's password for remote installation has been changed, specify the password with this option.
The result is the same as the previous example.
6. Display Tool Version
>> java -jar RICOH_UroborosG2.jar version
version 2.01
Run the version command to check the tool version.
[Reference]
* Error codes for install/uninstall
Error code - Description
0 Successfully completed
1000 Invalid parameter
2000 Memory related error
3000 Input/Output error
4000 Network related error
4001 Failed to access SasManagerService
5000 Application install error or Application uninstall error
5100 SmartOperation Panel application install/uninstall internal error
5101 Failed to install SmartOperation Panel application because the machine does not permit upgrading
5102 Failed to obtain SmartOperation Panel application install/uninstall offline
5103 Failure caused by reconnect between controller and SmartOperation Panel
5104 Failure caused by insufficient memory on SmartOperation Panel
5105 Installation failed by invalid SmartOperation Panel application file
5106 Cannot find the SmartOperation Panel application to be uninstalled
5107 Failed to stop SmartOperation Panel application when uninstalling the application
5108 Failed to uninstall SmartOperation Panel application (Important application which is not allowed to be uninstalled)
5110 Failed because SmartOperation Panel does not support remote installation
7000 File uploading error
7001 Zip file error
7002 Failed to unzip the Zip file
8000 Password mismatch
8001 Password registration failure
9000 Other exception
* Installable files
Conditions for Usage
The Installer for Development identifies the installable files with the following conditions:
- ZIP compressed file which contains both apk file and valid dalp file
Files that don't meet the above conditions are not supported and not listed in the installable application list.
Examples:
- apk file by itself
- zip file without a dalp file
- zip file with an invalid dalp file
Important Notes
The following describes important notes on using the command line tool.
• While operating this tool, do not run any other processes. System Settings screen must be closed.
• While operating this tool, do not shut the machine power down or reset the operation panel.
• While operating this tool, do not press the Energy Saver button or make the machine switch to Energy Saver mode.
• Note that during the operation, a machine is disabled to switch to Energy Saver mode by timer or by key operations.
• The target machine is set to enable firmware updates. Login to the machine as a Machine Administrator and check the following setting:
[System Settings] - [Administrator Tools] -[Extended Security] - [Update Firmware] is set to [Do not Prohibit].
• If Java(TM) Platform startup setting is being disabled, enable the setting by the following procedure:
[Configuration] - [Extended Feature Settings] - [Administrator Tools] - [JavaTMPlatform Setting]
• The version of SDK/J platform of the target machine is v11.19.03 or v12.03.01 or higher.
• The version of SmartOperation Panel G2 firmware of the target machine is v1.02 or higher.
• Do not run more than one instance of this tool at the same time.