Get documents about "SmartSource Developer Tips and Performance Guidelines
Document Sample
Version Date Changes Author 1.105 6/18/2009
Internal release. Included Developers TIPS
0.001 10/26/2008 and Performance Guidelines only ISVLAB
Internal release. Added Throughput by
0.002 12/15/2008 function ISVLAB
0.003 1/15/2009 Internal release. Added Common Issues ISVLAB
Initial Release.
Includes Change Control, Overview, Common Should you have ques
Isues, Developers TIPS, Thruput by function comments about this work
1.000 2/10/2009 and Performance Guidelines. ISVLAB send an email to "ISVLAB@
Added link to FAQ 10031672 - USB
1.001 2/12/2009 connection and MS KB 817900 ISVLAB
1.002 2/26/2009 Added "Slow Boot" to symptoms ISVLAB
Added "HTTP SSL Service" to Common
1.003 3/2/2009 Issues ISVLAB
Added Network tools and Port assignments
and conflicts to Developer TIPS sheet
1.100 4/30/2009 ISVLAB
Added link to WDS Pre-Install Diagnotic Tool
1.101 5/5/2009 (requires password from ISVLAB) ISVLAB
1.102 5/13/2009 Added WireShark to list of Network tools ISVLAB
1.103 5/13/2009 Added links to Network tool sites ISVLAB
Added "granting non-administrator access"
1.104 6/15/2009 info ISVLAB
1.105 6/18/2009 Added Image Quality and Security tab ISVLAB
Should you have questions or
comments about this workbook please
end an email to "ISVLAB@unisys.com"
You are using Unisys Partner SmartSource Developers
Tips and Performance Guidelines workbook version
1.105 revised Jun-18-2009
If you have questions or need further technical information regarding the SmartSource, please contact the
Unisys ISVLab at ISVLAB@unisys.com
Tab (worksheet) Description
Change Control History of version control
Overview This worksheet page - provides brief description and link to additional
worksheets.
Common Issues List of common problems and associated causes
Developer Tips List of developer topics with references to additional information sources
Optimum Thruput by function Chart depicting the expected throughput for the SS Pro 120 for four
scenarios based on PC configuration and average document length
Performance Guidelines List of topics that impact performance and the associated details
Root Cause Common Issues
Configuration Component required by application not present or mis-configured, including
communication ports, firewalls, antivirus apps
Documentation Error
Missing or Incorrect information provided in Help File, Capabilities manual,
Operator Guide, Programmers Reference Guide or Release Notes
Driver Damaged, missing, or incorrect driver in use
Duplicate previously reported contact
Feature Suggestion New or enhanced feature or capability
Firmware Upgrade Need assistance installing SSX firmware upgrade
Fixed in Release Formerly reported and/or fixed - UCF not Required
Hardware Failure Broken, not working properly hardware
Information Available Guidance provided in Help File, Capabilities manual, Operator Guide,
Programmers Reference Guide or Release Notes
Initialization File Mis-configured or missing .INI file
Installation Error Inappropriate selections or settings during installation
Insufficient Resource Insufficient PC speed, processors, or memory to support selected
capabilities: e.g. 5 images and or OCR on a single processor PC
Insufficient User Rights User has insufficient priviledges to run the application or to write to necessary
files
Internal request Channel or Marketing question
License file request Partner / OEM or Pre-generated license file request
Local Code Application fails to provide proper or timely input
Local Policy Restricted access attributed to local or domain policy setting.
Local SW Environment Missing file, Anti-virus interfering, Power/Screen saver settings, Missing
components (e.g .NET)
Windows Desktop Search (WDS) on XP set to automatic start OR
HTTP SSL Service set to Manual
Media Documents are out of specification for weight, grain, length, height, printing or
handwriting
Mis-directed Request Need something from Marketing, BI, etc.
Operator Training/Error Inexperienced or untrained operator
Product Bug Reproducible problem attributable to Unisys product/level needs UCF
Request SW Emergency or beta copy of software required
Request Training TOI or client training
Unsupported Os Operating system not supported for this product and feature set
Work Preparation Documents mis-aligned, mis-oriented, torn, damaged etc.
Typical Symptom
"I can't get ….. to work according to the instructions"
"I can't get ….. to work according to the instructions"
Failure to connect to the device
tell me again…
Need it bigger, faster, clearer, etc.
Can't upgrade my SSX firmware
MJE cartridge failure, etc
"How do I…"
Inability to use a device (Image, endorse, etc.)
"After installing, this or that doesn't work"
Performance issues
Fail to access or store images or codelines
How do I get help? Who answers phone?
I need a license file
Performance issues
Failure to complete installation or start application
Failure to connect / loss of connection / Wont run at all
.
Very slow boot with Device Suite (5 minutes+)
Jams / frequent stops
"I need another loaner SmartSource…"
Feeder / pocket issues; ink; image quality
various
"I need a CD, or link to Software…"
"How do I…Please train me…
Failure to complete installation or start application
Double documents, Feeder or pocket issues
Unisys SmartSource Professional/Value Series
Developer TIPS
Topic Comments - Contact ISVLAB@unisys.com for assistance WDS Middleware CAPI
Discovery Service Discovery-Service-PREF x
Domain Participation May affect ability to connect x
Endorser fonts / maintenace / Clean with dampened cloth
x x x
training Print Density
Environment - HW and OS SmartSourceTM Series - Capabilities Overview
x
Device Suite - Installation and Administration Guide
Eventing Eventing-Service-PREF x
INI file setup CAPI Pref x
Licensing 1. Trial license (Device Suite Pro) for 45 days reverts to DS
Standard.
2. Request Activation via License Manager Utility and email to x
ISVLAB
3. Pre-generated License file - request via Unisys Mkt Rep.
Network tools Netstat - TCPView - TCP Monitor - WireShark x
Operator Maintenance Operation and Implementation Manual
x x x
Operator Training Video orderable and on ftp site
Performance / Throughput See Performance Guidelines worksheet x x x
Page 6 of 15
UNISYS CONFIDENTIAL DRAFT printed: 7/3/2011 2:04 PM
Unisys SmartSource Professional/Value Series
Developer TIPS
Port assignments and conflicts Use a network tool to view port assignments and identify conflicts.
Netstat is a command line too that displays active TCP connections,
ports on which the computer is listening, Ethernet statistics, the IP
routing table, IPv4 statistics (for the IP, ICMP, TCP, and UDP protocols),
and IPv6 statistics (for the IPv6, ICMPv6, TCP over IPv6, and UDP over
IPv6 protocols). Used without parameters, netstat displays active TCP
connections.
TCP Monitor - www.itsamples.com - a Windows application that will
show you detailed listings of all TCP endpoints on your system, including
x
names of remote servers and state of TCP connections.Under Windows
XP or 2003 TCP Monitor does allow to show all network processes and
kill them, if needed.Additionally, "BlackList" option is available for TCP
endpoints control.
TCPView - www.sysinternals.com - a Windows program available from
that will show you detailed listings of all TCP and UDP endpoints on your
system, including the owning process name, remote address and state
of TCP connections. TCPView provides a conveniently presented subset
of the Netstat program that ships with Windows NT/2000/XP.
Pre-Requisites WDS-Pre-Install Diagnostic Tool
SmartSourceTM Series - Capabilities Overview x
Device Suite - Installation and Administration Guide
Processing Rules / Plug-ins SOA Vision Programming Reference Guide x
Sample Code Installs to: C:\Program Files\Unisys\WebDevice Suite\Sample Code x
Silent Install / Small Footprint Requires Pre-generated License file
x x
Device-Suite-Small-Footprint-Install.pdf
SOA background/experience x
Subscriptions (persistance) Eventing-Service-PREF x
Training and Documentation Installs to: C:\Program Files\Unisys\WebDevice Suite\Documentation x
Troubleshooting See SmartSource Troubleshooting & Triage document also - see
Connection, Jams, Network Tools on this page x x x
Reader, Imaging, Endorsing
WDS Configuration SOA Vision Programming Reference Guide x
Web-Hosting SOA Vision Programming Reference Guide x
Page 7 of 15
UNISYS CONFIDENTIAL DRAFT printed: 7/3/2011 2:04 PM
7/3/2011 03087535-4ba0-4280-a20d-0beffa99ec8b.xls - Image Quality and Security
Image Security Platform (Digital Signature Generation)
What is required to add Quality/Security to the SmartSource Environments
Order These Styles
Software/API Quality Security SW USB Security Token
Expert Series Note 1
SSX1-EM (CAPI) NA NDP888-TKN
SSX1-EM (DLL/SDLL) SSX1-QS (Note 3 & 4) NDP888-TKN
SSX1-PRO (Embedded DeviceSuite) NA (included in SSX1-PRO embedded) NA (Virtual token included)
Professional Series
SSP1-EM (Emulator) SSP1-QS NDP888-TKN
SSP1-EMC (CAPI) SSP1-QS (Note 3) NDP888-TKN
WDS1-PRO (Device Suite on the PC) NA NDP888-TKN
WDS1-STD (Device Suite on the PC) WDS1-PRO NDP888-TKN
Value Series
SSV1-EM (Emulator) SSV1-QS NDP888-TKN
SSV1-EMC (CAPI) SSV1-QS (Note 3) NDP888-TKN
WDS1-PRO (Device Suite on the PC) NA NDP888-TKN
WDS1-STD (Device Suite on the PC) WDS1-PRO NDP888-TKN
Notes:
1 The NDP888-TKN is a USB Security Token which must be plugged into a USB port on the PC running
the Application; OTC = $45
2 SSP1-QS for Pro & SSV1-QS for Value are Stand-alone Quality/Security SW packages; OTC = $15
3 QS Library does not provide for storage of the Digital Signature nor Certificate in the Unisys
proprietary TIFF tags. The vendor/integrator needs to develop their own way to store these items for
each image/document.
4 SSX1-QS for Expert is not in price book
5
6
Image Security Certificate Authority (CA)
Order one certificate for each scanner / transport;
certificates expire yearly and must be renewed
Verisign Certificate Styles NDP888-CEB; OTC = $100
Image Security Verification (Digital Signature Verification)
–Certicom Check21 Toolkit
$35K as a one time Check21 toolkit charge and then 25% annual support with upgrades. $45K if with GSE-C,
the FIPS validated crypto provider, substituted for the commercial Crypto-C version in the standard Check21
package. This includes 2 developer seats. Site licenses, multiple platforms (Linux/86, AIX/PPC, HPUX etc)
and applications (ie projects), extra dev seats, etc, are available on request.
Annual Run Time Royalties per project/site based on daily volume of images processed;
– <100,000 per day $1,000 per year
– >100,000 per day $4,000 per year
– >10M per day $10,000 per year
– >50M per day $25,000 per year
Click on image to go to tool site
o tool site
Unisys SmartSource Professional/Value Series
Optimum Thruput by function
Config A 3 images-MICR-Single line endorse
P4 P4 P4 P4 Duo Core
Average Doc Length
2 GHZ 2.8 GHZ 3.2 GHZ 3.2 GHZ 2.4GHZ
in inches
.5GB .5GB .5GB 1GB 1GB
6 110 113 120 120 120
7 94 97 103 103 103
8.5 77 80 85 85 85
This chart represents optimum expected throughput of a SSP-120 for 4
scenarios based on PC configuration and average doc length
To use, click anywhere in the Orange BANNER and select from the
drop-down list
Page 11 of 15
UNISYS CONFIDENTIAL DRAFT Printed 7/3/2011 2:04 PM
To grant Administrative rights to a user
Non-Administrator users Log on to the user’s computer as an administrator. Click Start, and then click Run.
In the Open box, type cmd, and then press Enter.
Obtain the domain and username by entering: whoami /user /noverbose<enter>at
the command prompt.
XP command: httpcfg set urlacl /u http://+:,<portnumber>/ /a
D:(A;;GX;;;<domain\user>)
example XP1: httpcfg set urlacl /u http://+:6090/ /a D:(A;;GA;;;BU)
gives all users the right to create services that listen on any fully-
qualified URL with port 6090
VISTA command: netsh http add urlacl url=http://+:<portnumber> /
user=<domain>\<UserName>
<portnumber> refers to the port to be granted access to, examples include:
nnnn your application port
6090 Unisys Device Suite Configurator and Exerciser
For more information about configuring administrator privileges, see the MSDN
article Limited User Problems and Split Knowledge, available at
http://msdn.microsoft.com/en-us/magazine/cc163531.aspx.
The netsh command uses the Security Descriptor Definition Language (SSDL) to
implement the changes. For more information about using SDDL, see the MSDN
article SDDL for Device Objects, available at http://msdn.microsoft.com/en-
us/library/ms794693.aspx.
Unisys SmartSource Professional/Value Series
Performance Guidelines
Topic Comments - Contact ISVLAB@unisys.com for assistance Source
Configuration - Application The following will reduce throughput:
Any OCR reader enabled SmartSource Series
Doc length > 6" Capabilities Overview
Exceeding maximum process time for 6" items
(50 ms for Pro Series / 10 ms for Expert Series)
More than 3 images
Hi-res Snippet
Color Image
The following may reduce throughput: ISVLAB
Anti-virus software
In-line recognition
Network traffic/access
Processing Rules (WDS)
Power saver settings
Program efficiency
Excessive file OPEN-CLOSE (e.g.: overwriting images to same file)
Screen-savers
Complex Table lookup
Configuration - CPU - 3 CCITT or JPEG compressed images per document require a 3.2-GHz Pentium 4 SmartSource Series
processor with 1 GB of memory to support the maximum processing throughput rate of 120 Capabilities Overview
Operating System: Windows XP Pro or Vista Business
dpm.
Processor: Pentium 4, 2GHz, PCI bus
- 4 or 5 CCITT or JPEG compressed images per documentor require a 2.4-GHz, Core 2 Duo
Memory: 512MB RAM minimum
processor with 1 GB of memory to support the maximum processing throughput rate of 120
Disk Drives:
dpm.
40GB hard drive with at least 15GB of available space
CD-ROM drive - MICR/OCR combine read or in-line OCR processing throughput is highly dependent on the
Graphics Processor: Default per Windows specs host PC processor speed. Using a 2.4-GHz, Core 2 Duo processor with 1 GB of memory,
processing throughput is slightly over 100 dpm.
Other: USB 2.0 high-speed
- Color Image Capture
Document Length All throughput performance is based on six inch documents.
Longer items will reduce throughput proportionally
6.0" ~ 120 DPM
7.0" ~110 DPM
8.5" ~ 95 DPM optimum
additional degradation will occur based on CPU config
Page 13 of 15
UNISYS CONFIDENTIAL DRAFT printed: 7/3/2011 2:04 PM
Unisys SmartSource Professional/Value Series
Performance Guidelines
Operator Consumable replacement Operator Training Video
Daily maintenance - cleaning, etc. orderable and on ftp site
Doc preparation (Double Doc)
Ink Cartride Cleaning (Most common cause of excessive cartridge use)
Page 14 of 15
UNISYS CONFIDENTIAL DRAFT printed: 7/3/2011 2:04 PM
Unisys SmartSource Professional/Value Series
Performance Guidelines
Ensure you are running the latest System Software
Eliminate screensavers, power savers and
hibernation options where possible.
See the Microsoft KB article USB port may stop
working after you remove or insert a USB device
Ensure that the SmartSource Drivers are not
overwritten when installing other USB devices (such
as pen drives)
Review the SmartSource Troubleshooting & Triage
document to isolate problems and attempt simple
user-procedures to correct the issue and avoid an
unnecessary depot service repair.
Page 15 of 15
UNISYS CONFIDENTIAL DRAFT printed: 7/3/2011 2:04 PM
