Ricoh 2051 - Aficio B/W Laser, Technesis Quick Start Manual
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
&
Technesis Quick Start Guide
Ricoh Embedded Software Architecture
Last Updated: November 2009
Technesis®, Inc. Page 1 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Table of Contents
Introduction....................................................................................................................3
Purpose of this Document...................................................................................................... 3
Warnings .................................................................................................................................. 3
Copyright Protection...............................................................................................................3
Trademarks .............................................................................................................................. 3
Technesis Solution Overview....................................................................................... 4
Technesis Ricoh ESA Applications....................................................................................... 4
Integration Overview ............................................................................................................... 4
Before you Begin.....................................................................................................................5
Installation of Technesis Java Applications ............................................................... 6
Java 1.x Devices......................................................................................................................6
Java 2.x, 4.x & 5.x Devices ...................................................................................................16
Technesis iBridge Installation & Configuration........................................................ 39
Install Technesis iBridge ......................................................................................................39
Configure Technesis iBridge ............................................................................................... 39
Scheduling ............................................................................................................................. 42
Using the Technesis ESA Application....................................................................... 44
Virtual Keyboard.................................................................................................................... 44
User Login Options ............................................................................................................... 44
Billing Options ....................................................................................................................... 44
Device Enabled ...................................................................................................................... 45
Transaction Creation ............................................................................................................45
Appendix....................................................................................................................... 46
Appendix A – Technesis & Ricoh Timeouts ....................................................................... 46
Appendix B – Ricoh Service Mode ......................................................................................46
Appendix C – SP 5162 (App. Switch Method) ..................................................................... 46
Appendix D – Ricoh Models Reference............................................................................... 47
Appendix E – Fiery controller configuration ...................................................................... 48
Appendix F – Technesis, Inc. Software License Agreement............................................. 49
Technesis®, Inc. Page 2 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Introduction
Purpose of this Document
This document describes the installation and setup of Technesis’ application integration on Ricoh
Embedded Software Architecture capable devices.
Warnings
1. The contents of this document may be changed without notice in the future.
2. We will not be held responsible for any of our customer’s losses, disadvantages, or demands
from a third party on using this document.
Copyright Protection
Copyright protection claimed includes all forms and matters of copyrightable material and information now
allowed by statutory or judicial law or hereinafter granted including without limitation, material generated
from the software programs which are displayed on the screen, such as icons, screen displays, looks, etc.
Use of all or a part of this document is prohibited without prior permission from Technesis, Inc.
Copyright © 2007 Technesis Corporation. All Rights Reserved.
Trademarks
o Microsoft® and Windows® are registered trademarks of Microsoft Corporation in the United
States and other countries.
o Java, JVM (CVM) and CDC are trademarks or registered trademarks of Sun Microsystems, Inc. in
the United States and other countries.
o PostScript® and Acrobat® are trademarks or registered trademarks of Adobe Systems
Incorporated in the United States and/or other countries.
o Other product names used herein are for identification purposes only and might be trademarks of
their respective companies. We disclaim any and all rights in those marks.
Technesis®, Inc. Page 3 of 50 Technesis Ricoh Java Application
Technesis
Integration Guide
®
Ricoh ESA
Technesis Solution Overview
This section describes the basic overview of all the software components required for Technesis’
integration with the Ricoh Embedded Software Architecture (ESA) or Java Platform.
Technesis Ricoh ESA Applications
Technesis provides (2) applications that are installed within the Ricoh ESA infrastructure.
Technesis Servlet – Programmatic interface into the ESA platform that enables Technesis to
retrieve information from the device.
Technesis Xlet – Graphical user interface that displays on the Ricoh device panels for users to
enter user and/or billing information.
Integration Overview
The following diagram illustrates the basic communication between the Technesis Print Control System
and the Technesis ESA applications running on the Ricoh Controller.
, Inc.
Server Running Technesis Console
The Technesis Console is the base system to the entire print management and cost recovery
system. This must be installed and configured before beginning. Please consult the
Technesis NetDeploy Quick Start guide for details.
The Technesis database stores all activity and configuration information. This database can
be based on Jet or SQL Sever.
Server Running Technesis iBridge
Technesis iBridge is the component that links the main Technesis Print Control System and
the Technesis applications running within the Ricoh ESA platform.
The Technesis Ricoh ESA Vendor must be installed within the Technesis iBridge
infrastructure.
Ricoh Controller
The Ricoh Java Platform (ESA) must be installed and running on the Ricoh Controller.
The Technesis Servlet provides a programmatic interface into the ESA platform that enables
Technesis to retrieve information from the device.
Technesis®, Inc. Page 4 of 50 Technesis Ricoh Java Application
Technesis
Integration Guide
The Technesis Xlet provides the User Interface for users to enter user and/or billing
information.
Before you Begin
• These installation instructions assume that the Ricoh Java SD™ card has already been installed
by an authorized Ricoh service technician.
• These installation instructions also assume that you have already installed the Technesis
Network Deployment version 5.5 or higher on a centralized workstation or server.
• SNMP with TCP/IP protocol must be enabled for the Technesis application to obtain meter reads
for copy and fax functions. Please verify these settings with your authorized Ricoh service
technician. These settings can be found with the Configuration – Network settings of the device.
• GLOBALSCAN NOTE: There have been reported problems with installation of the Technesis
Java application when GlobalScan has already been installed. Technesis recommends
uninstalling the GlobalScan application and reinstalling GlobalScan after the Technesis
application is installed on the device.
®
, Inc.
Ricoh ESA
Technesis®, Inc. Page 5 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Installation of Technesis Java Applications
This section describes the installation and removal procedures for the Technesis java based applications.
Technesis strongly recommends installing the Technesis application with an authorized Ricoh service
technician. The installation and removal process is different for Java 1.x and Java 2.x based Ricoh
devices.
Java 1.x Devices
o Overview of the Java 1.x installation process.
o General expectations when installing Java.
o Manual installation via a SD Card.
Preparation of Java 1.x Devices
Supported Java 1.x Devices
Please refer to Appendix D – Ricoh Models Reference for a complete list of the Java 1.x Ricoh family
devices that Technesis supports. These devices will require the Java VM Card Type B provided by Ricoh.
Verify Ricoh Java 1.x Platform
The Technesis installation instructions require that the Ricoh Java SD™ card has already been installed
by an authorized Ricoh service technician. Java 1.x requires that the Java runtime engines be installed
manually via Extended Feature Settings. The Java 1.x implementation has a platform to run Xlets and
also a platform to run Servlets. Both Java platforms must be verified that they are installed and running.
Also verify the Ricoh Java Platform is version 1.4 or higher.
At this time, there is not a way to check for the Java 1.x Platform remotely and must be checked on the
device panel.
***NOTE*** Technesis only support Java Platform version 1.4 or higher.
Please contact your Ricoh service representative to upgrade your
existing Ricoh VM Card Type B.
Launch User
Tools / Counter
o Select [User
Tools/Counte
r] hard key on
the device.
o Select
[Extended
Features
Settings].
Technesis®, Inc. Page 6 of 50 Technesis Ricoh Java Application
* Reference
red arrows
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Extended
Feature Settings
o Select
[Extended
Features].
Extended
Feature Details
o Under
Extended
Feature
Name, you
should both
JavaTM
Platform and
JavaTM SVR
Platform as
loaded
features.
o The Status
for both
should be
displaying
Starting Up
o The Version
must be 1.4
or higher for
both.
If the Java platforms are not detected as an installed Extended Feature, the device is NOT
ready to install the Technesis Java Application. Please contact your Ricoh sales or service
technician.
Set Java 1.x Platform as Default Function Priority
The default function priority on the Ricoh device must be set to the Java Platform. This will ensure at
system startup the Technesis Java application launches at system startup and locks out the panel.
The following instructions can be followed to set Java as the default function priority. At this time, there is
not a way to enable this via Web Image Monitor and must be set manually at the device panel.
Technesis®, Inc. Page 7 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Launch User Tools / Counter
o Select [User Tools/Counter]
hard key on the device.
o Select [System Settings].
* Reference red arrows
Change Function Priority
o From the General Features
tab, select [Function
Priority].
Select Function Priority
o Select and highlight
[JavaTM/X] as the default
Function Priority.
o Select [OK] to accept
changes.
Exit System Settings
o Select [Exit] to exit System
Settings.
Technesis®, Inc. Page 8 of 50 Technesis Ricoh Java Application
Technesis Servlet Installation Guide on Java 1.x Devices
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Technesis Servlet Installation on Java 1.x Devices
Launch Ricoh DSDK Installation Server
o Launch Ricoh ESA Installation Server from a
workstation.
o Enter the following URL:
http://<IP_Address>:8080/
Where <IP_Address> is the IP address of
your Ricoh MFP.
o Enter the appropriate credentials.
Note: The default credentials for the ESA
installer is the following:
Username: admin
Password: ricoh
Navigate to Install
o At the ESA Installer home
page, select the [Install]
tab.
* Reference red arrows
Technesis®, Inc. Page 9 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Install Technesis Servlet
o First, select [Browse…]
button and browse to the
Technesis Servlet zip file
[34079490.zip].
1
2
o Second, select [Install]
button.
Confirm Installation
o Select [OK] button to
confirm the installation of
the Technesis Servlet.
Technesis®, Inc. Page 10 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Installation Complete
The ESA installer will prompt an
Installation Complete screen.
Technesis recommends one
more step to confirm the
Technesis Servlet is installed
and running.
o Select [Application List] tab.
Verify Technesis Servlet
o Verify that [Technesis
Servlet] is listed in the
Application List.
Technesis®, Inc. Page 11 of 50 Technesis Ricoh Java Application
Technesis Servlet Removal on Java 1.x Devices
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Launch ESA Installer
o Launch Ricoh ESA
Installation Server from a
workstation. Please
reference previous section
on URL and credentials.
o Select [Details] button.
* Reference red arrows
Uninstall Technesis Servlet
o Select [Uninstall] button.
o When prompted with the
following dialog, select
[OK].
Technesis®, Inc. Page 12 of 50 Technesis Ricoh Java Application
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Verify Successful Uninstall
o Verify the Technesis
Servlet is not displayed in
the [Application List].
Technesis Servlet Update on Java 1.x Devices
1. Following the instructions above to first remove the Technesis Servlet application and reset the
device.
2. Following the instructions above to install the Technesis Servlet application.
Technesis Xlet Installation Guide on Java 1.x Devices
Technesis Xlet Installation on Java 1.x Devices
Application Manager Login
o Navigate to the Java
Application Manager.
o Select [Login] to log in as
the administrator.
* Reference red arrows
Install Technesis Xlet
o Select the [Install] tab.
Technesis®, Inc. Page 13 of 50 Technesis Ricoh Java Application
o Page down and select the
Technesis Tracking
application.
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Specify Destination
o Select [Hard Disk] for the
installation destination.
o Select [OK] to accept
changes.
Auto-Start Option
o Select [Yes] for the Auto-
Start option.
o Select [OK] to accept
changes.
Note: This option will ensure
the Technesis application starts
upon boot up of the device.
Server Configuration
When the application is first
launched, you are prompted
with a message Controller
Server not configured.
• Select [Administration] to
configure the controlling
server.
Note: The default Technesis
administrative password is
8675309.
Administration Settings
• Controlling Server – Enter
the IP address or name of
the machine running the
Technesis ESA Server
application.
• Allow user during down
time? – Determines if
functions can be used
when the Technesis ESA
Server application is
unavailable.
Technesis®, Inc. Page 14 of 50 Technesis Ricoh Java Application
• Select # button to accept
changes.
®
Technesis
Integration Guide
, Inc.
Ricoh ESA
Technesis Xlet Removal on Java 1.x Devices
Technesis recommends removing the Technesis ESA Application with assistance of an authorized Ricoh
service technician.
Application Manager Login
• Select [Menu] to access the main Application Manager screen.
• Select [Login] to log in as the administrator.
Stop Technesis Application
• Navigate to the [Start/Stop] tab.
• Select the [Technesis Tracking] application within the list.
• Select [Execute] to stop the application.
Uninstall Technesis Tracking
• Navigate to the [Uninstall] tab.
• Select the [Technesis Tracking] application from the list.
• Select [OK] to uninstall the application.
Note: Power down is required to fully uninstall the application.
Technesis Xlet Update on Java 1.x Devices
3. Following the instructions above to first remove the Technesis application and reset the device.
4. Following the instructions above to install the Technesis application.
Technesis®, Inc. Page 15 of 50 Technesis Ricoh Java Application
Loading...