Ubiquitech Ricoh Terminal

Technical Manual

1. Table of Contents
1. Table of Contents

2. Copyright information

3. Configuration of the Terminal

4. Xlet installation on SDK1 devices

10

5. Xlet installation on SDK2, SDK4 and SDK5 devices

10

6.Locking the Ricoh SDK2 MFP

12

7.Locking the Ricoh SDK4 and SDK5 MFP

15

2. Copyright Information
All information contained within this technical manual and accompanying software
programs is copyright of Ubiquitech A/S.
All rights reserved. It is a breach of copyright if this technical manual is copied or
reproduced, in whole or part, using any means whatsoever, without the prior written
approval of Ubiquitech A/S
Ubiquitech A/S gives no condition or warranty, expressed or implied, about the fitness of
this technical manual or accompanying software product. Ubiquitech A/S reserve the right
to make changes to this technical manual or the accompanying software product without
notice to any person or company.
Ubiquitech A/S shall not be liable for any indirect, special, consequential or incidental
damages resulting from the use of this technical manual or the accompanying software
whether caused through Ubiquitech's negligence or otherwise.
Ubiquitech A/S
Naverland 29
2600 Glostrup
Denmark
[email protected]

3. Configuration of the Terminal

The configuration of the Terminal is done in the terminal.properties of client file before
installation.

Connection settings
Define the port which it uses to receive gateway configuration. It is not recommended to change
this. Default UDP port to receive server configuration.
Default: server.port=81

Balance rounding
Round the balance to the specified digits to round the users account balance.
Default: balance.rounding.digits = 2

Power locking
If this option is set to true then the client can prevent the MFP from going into deep power save. This

setting is not recommended to change.

Default: power.lock.enable=false

Windows.colour
The default background colour of the client. Possible values are blue or white
Default: windows.color=blue

Commit.interval
The interval in seconds to perform automatic commit of pending copy/scan transactions. If set to 0
(zero) the autocommit is disabled. Transactions are also recorded upon logging out, logging in and
machine start up.
Default: commit.interval=30 seconds

Pin.enable
Enable ot disable unconditional pin code entry when the card is swiped. If disabled the pin code is
only asked if configured so on the server side.
Default: pin.enable=false

Addressbook.cleanup
Cleanup machines address book upon startup.
Default: addressbook.cleanup=false

Show button
Define which buttons that is shown in the main window, print screen and login screen.
If show.window.select is set to true, then it will display the screen where you can select the copy,
print or scan button.
Default: show.window.select=false
4

3. Configuration of the terminal

This parameter defines how to show the Username field in the login window possible values are
button, label, none.
button shows the push button;
label shows the specified label (see label.username description);
none hides this entry.
Default: show.button.username=button
Defines how to show the Password field in the login window. The values are the same as for the
show.button.username parameter.
Default: show.button.password=button
Show and hide the short ID entry field
Default: show.button.pin=true
Show or hide the Print All button
Default: show.button.printall=true
Show or hide the Scan button.
Default: show.button.scan=true
Show or hide the Print button
Default: show.button.print=true
Show or hide the Copy button
Default: show.button.copy=true

3. Configuration of the terminal

Logo resource
The name of the custom logo file displayed in the upper right corner (without the BMP extension).
The file must be properly specified in the DALP installation script, conform to Ricoh image
requirements (BMP format, 256 colors) and be no wider than 160 pixels.
Default: logo.resource.name=ubi_logo_small

The same rules apply to the secondary logo to be displayed in the upper left corner default is none:
Default: logo.resource2.name=

The label for the Username field:

Default: label.username
The label for the password field:
Default: label.password

4. Configuration of the terminal

Set login/pw/pin buttons
To have a custom login button, you must have the bitmaps in the jar file. That means the
programmers from Ubiquitech have to make a custom xlet for you.

#button.login.res=login_xxx
#button.pass.res=pass_xxx
#button.pin.res=

The default card reader type. This parametre should not be changed
Default: default.cardreader.type

The swipe mode. This parametre should not be changed

Default: default.swipe.mode

Swipe interval
The default interval between card swipes used to detect double-swiping. This parameter is only
used when the card swipe mode is set to 2. This parameter may be changed for slower card
readers.
Default: swipe.interval=2000

ScannerVision settings
Valid only for the Scannervision-integrated version. Enables or disables password authentication for
Scannervision.
Default: scannervision.passpw = false
If enables the Scannervision application will be the main one after logging in.
Default: scannervision.mainscreen = false
If enabled the domain part of the user name will be stripped when performaing Svannervision
authentication
Default: scannervision.truncatepw = false

4. Configuration of the terminal

Logging
Define the level of logging.
You can see the log from the mfp with the rsh command from a Windows PC.
Default: rsh [IP address of the device] mmesg_auto 125

# logging
# valid levels are:
# FATAL = 0;
# ERROR = 1;
# WARN = 2;
# INFO = 3;
# DEBUG = 4;
# ALL = 5;
logger.level=4
logger.file=terminal.log
logToFile = false

If enabled the xlet rsh logging will contain user names, card numbers and short ids
Default: logUserID = false

Administrator account details

These settings are for integration to MFP's address book user name and password.
Default: adminaccount.login = admin
Default: adminaccount.pw =

Short ID login mode

This setting is only used for Cirrato. The setting control how the shourtID login should be used.
normal will compare the typed value in the shortID field with the card number database field. And
if shortforpass is set, then Cirrato will handle the value differently. # valid values are "normal",
"shortforpass"
Default: login.shortid.mode

4. Configuration of the terminal

Extra domain support
The list of maximal 4 domains names. If not empty the appropriate buttons will be displayed on the
login screen propting a user to choose the domain before logging in. The xlet support authentication
for up to four domains separated by comma, if used with the Cirrato print management system. The
username will then be send to the Gateway in the format of [username]@[domain]. The Gateway
will then send the username to Cirrato.
Default: loginDomains = domain1.com,domain2.org,domain3.net,domain4.de

5. Installation VDMS Ricoh Terminal

VDMS Terminal installation on SDK1 devices

Shutdown the printer completely

Take out the sd java card

Unzip the VDMS terminal and copy the file to the SD card)

(...dsdk\dist\320000029\*.* )

Install the card in the printer. Turn it on.

In the display on the printer goto java

log in (password is default 1234)

Install the vdms terminal on SD card, and set the xlet to autostart.

VDMS Ricoh Terminal on SDK2, SDK4 and SDK 5 devices

Note: If you install on a sdk4 or sdk 5 device then you need to lock the MFP before
you install the xlet. Please look at how to lock sdk 4 and sdk 5 devices in section 7
for instructions on how to do that.
The xlet is installed on the MFP from IE browser. Ricoh does not support other
browsers at the moment. The MFP needs to have the Java SDK installed, please
reference to the information provided by the Ricoh sales companies for the right
version of the Java SDK and how to install this.
Login to the MFP's web server by using a IE browser and type IP address or DNS
name and make a login as administrator (admin) to be able to make the installation
of the VDMS client on the Ricoh device.
For further information please make a reference to the official Ricoh documentation
provide by Ricoh sales companies for further information about installation on a
Ricoh device.

5. Installation VDMS Ricoh Terminal

On the Web site for the device, do the following:

Choose configuration and Install

Browse to the xlet you want to install and press Display Extended Feature
List.

Select what you want to install to. We recommend that you don't install on the hard
drive since the hard drive power down, when the MFP go into power save mode.
We normally install on the same SD card as the Java SDK resides on.

Select auto start on or off

Select the application

Press install

Press OK
After the xlet is installed it is necessary to restart the MFP.
After the MFP is restarted you need to send the configuration settings to the MFP
from the Server, so the xlet knows which gateway it should connect with.

6. Locking the Ricoh SDK 2 MFP

The Ricoh MFP can be locked so only users that are Authenticated to VDMS can
use the Copy or Scanning facilities. If you don't want to lock the MFP then you can
skip this chapter. If you do, please read the following:
Using a special version of the Ricoh firmware and the version of the Ubiquitech
xlet, we can lock the MFP. The firmware and xlet are available on request. This
document explains how you use the special firmware and xlet.
Prerequisites:
1. Ricoh MFP model MPC2500, MPC3000, MPC3500, MPC4500, MP5500,
MP6500, MP7500, MP6000, MP7000 and MP8000 are currently supported.
2. Ricoh Java SDK 2.11cs4 (use ONLY java 2.11cs4 for sdk2 devices)
3. VDMS Client version 1.5.4 with accounting (or later).
4. Special firmware from Ricoh with softlock mechanism.
Install the special version of the firmware.
Look in the Ricoh documentation for information about
installing firmware. Follow the normal guidelines.
Got o the service menu to enable the lock.
To go to the service menu you press the yellow button, then 107 and then hold
down the red button until the service menu appears.

Press Copy Sp

6. Locking the Ricoh SDK 2 MFP

Then go to menu 5113 and then 2 and 1.

Then exit the service menu.

Configure the lock settings.

Then go to System Settings in the Administrative interface on the MFP.

Press Enhanced External Change Unit Management

6. Locking the Ricoh SDK 2 MFP

Then select the features that you wish to be locked without authentication.
Make sure that you do not lock the print functions because the server will not be
allowed to print. Also Java should not be locked since that will prevent the users
from unlocking the MFP.

Make sure to make an entry in the MFP's service book about the special firmware.
It must not be upgraded since the standard Ricoh firmware does not support these
features.

7. Locking the Ricoh SDK4 og SDK5

The Ricoh MFP can be locked so only users that are Authenticated to VDMS can
use the Copy or Scanning facilities. This needs to be done on the sdk4 devices
otherwise the xlet will not work. These changes needs to be done before the xlet is
installed.
Update java to the latest.
Take the Java SD card a put in a card reader
Edit the file \sdk\ap\ap.properties
Set the jp.co.ricoh.dsdk.ap.panelservice=1
Save the file and put the java card back in MFP.
Then start the MFP.
Go to the service menu to enable the lock. To go to the service menu you press
the yellow button, then 107 and then hold down the red button until the service
menu appears.

Press Copy Sp

7. Locking the Ricoh SDK4 og SDK5

Then go to menu 5113 and then 2 and 1.

Then exit the service menu.

Configure the lock settings.
Then go to System Settings in the Administrative interface on the MFP.

Press Enhanced External Change Unit Management

7. Locking the Ricoh SDK4 og SDK5

Then select the features that you wish to be locked without authentication. This is
only necessary if you wish that users should authenticate before they can use the
build in functions.
Make sure though that you do not lock the print functions because the server will
not be allowed to print. Also Java should not be locked since that will prevent the
users from unlocking the MFP.