View
217
Download
0
Category
Preview:
Citation preview
8/18/2019 Ric Oh Terminal Technical Manual v 2
1/18
Ubiquitech Ricoh Terminal
Technical Manual
8/18/2019 Ric Oh Terminal Technical Manual v 2
2/18
1. Table of Contents 1. Table of Contents 2
2. Copyright information 3
3. Configuration of the Terminal 4
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
8/18/2019 Ric Oh Terminal Technical Manual v 2
3/18
2. Copyright Information
All information contained within this technical manual and accompanying softwareprograms is copyright of Ubiquitech A/S.
All rights reserved. It is a breach of copyright if this technical manual is copied orreproduced, in whole or part, using any means whatsoever, without the prior writtenapproval of Ubiquitech A/S
Ubiquitech A/S gives no condition or warranty, expressed or implied, about the fitness ofthis technical manual or accompanying software product. Ubiquitech A/S reserve the rightto make changes to this technical manual or the accompanying software product withoutnotice to any person or company.
Ubiquitech A/S shall not be liable for any indirect, special, consequential or incidentaldamages resulting from the use of this technical manual or the accompanying softwarewhether caused through Ubiquitech's negligence or otherwise.
Ubiquitech A/S Naverland 29
2600 Glostrup Denmarksupport@ubiquitech.com
3
8/18/2019 Ric Oh Terminal Technical Manual v 2
4/18
3. Configuration of the Terminal
The configuration of the Terminal is done in the terminal.properties of client file beforeinstallation.
Connection settings
Define the port which it uses to receive gateway configuration. It is not recommended to changethis. Default UDP port to receive server configuration.
Default: server.port=81
Balance rounding
Round the balance to the specified digits to round the user’s 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. Thissetting 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 andmachine 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 isonly asked if configured so on the server side.Default: pin.enable=false
Addressbook.cleanup
Cleanup machine’s 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
8/18/2019 Ric Oh Terminal Technical Manual v 2
5/18
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 theshow.button.username parameter.Default: show.button.password=button
Show and hide the short ID entry fieldDefault: 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
8/18/2019 Ric Oh Terminal Technical Manual v 2
6/18
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
8/18/2019 Ric Oh Terminal Technical Manual v 2
7/18
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 theprogrammers 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 onlyused when the card swipe mode is set to 2. This parameter may be changed for slower cardreaders.
Default: swipe.interval=2000
ScannerVision settings
Valid only for the Scannervision-integrated version. Enables or disables password authentication forScannervision.
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
8/18/2019 Ric Oh Terminal Technical Manual v 2
8/18
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. Andif shortforpass” is set, then Cirrato will handle the value differently. # valid values are "normal","shortforpass"
Default: login.shortid.mode
8/18/2019 Ric Oh Terminal Technical Manual v 2
9/18
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 thelogin screen propting a user to choose the domain before logging in. The xlet support authenticationfor up to four domains separated by comma, if used with the Cirrato print management system. Theusername will then be send to the Gateway in the format of [username]@[domain]. The Gatewaywill then send the username to Cirrato.
Default: loginDomains = domain1.com,domain2.org,domain3.net,domain4.de
8/18/2019 Ric Oh Terminal Technical Manual v 2
10/18
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 beforeyou install the xlet. Please look at how to lock sdk 4 and sdk 5 devices in section 7for instructions on how to do that.
The xlet is installed on the MFP from IE browser. Ricoh does not support otherbrowsers at the moment. The MFP needs to have the Java SDK installed, pleasereference to the information provided by the Ricoh sales companies for the rightversion 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 DNSname 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 documentationprovide by Ricoh sales companies for further information about installation on aRicoh device.
8/18/2019 Ric Oh Terminal Technical Manual v 2
11/18
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 FeatureList.
Select what you want to install to. We recommend that you don't install on the harddrive 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 MFPfrom the Server, so the xlet knows which gateway it should connect with.
8/18/2019 Ric Oh Terminal Technical Manual v 2
12/18
6. Locking the Ricoh SDK 2 MFP
The Ricoh MFP can be locked so only users that are Authenticated to VDMS canuse the Copy or Scanning facilities. If you don't want to lock the MFP then you canskip this chapter. If you do, please read the following:
Using a special version of the Ricoh firmware and the version of the Ubiquitechxlet, we can lock the MFP. The firmware and xlet are available on request. Thisdocument 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 holddown the red button until the service menu appears.
Press Copy Sp
8/18/2019 Ric Oh Terminal Technical Manual v 2
13/18
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
8/18/2019 Ric Oh Terminal Technical Manual v 2
14/18
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 beallowed to print. Also Java should not be locked since that will prevent the usersfrom 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 thesefeatures.
8/18/2019 Ric Oh Terminal Technical Manual v 2
15/18
7. Locking the Ricoh SDK4 og SDK5
The Ricoh MFP can be locked so only users that are Authenticated to VDMS canuse the Copy or Scanning facilities. This needs to be done on the sdk4 devicesotherwise the xlet will not work. These changes needs to be done before the xlet isinstalled.
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 pressthe yellow button, then 107 and then hold down the red button until the servicemenu appears.
Press Copy Sp
8/18/2019 Ric Oh Terminal Technical Manual v 2
16/18
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
8/18/2019 Ric Oh Terminal Technical Manual v 2
17/18
7. Locking the Ricoh SDK4 og SDK5
Then select the features that you wish to be locked without authentication. This isonly necessary if you wish that users should authenticate before they can use thebuild in functions.
Make sure though that you do not lock the print functions because the server willnot be allowed to print. Also Java should not be locked since that will prevent theusers from unlocking the MFP.
8/18/2019 Ric Oh Terminal Technical Manual v 2
18/18
Recommended