Docstoc

SmartSource Developer Tips and Performance Guidelines

Document Sample
SmartSource Developer Tips and Performance Guidelines Powered By Docstoc
					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 wor
    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
    1.100    4/30/2009   and conflicts to Developer TIPS sheet          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: 4/29/2011 9:21 AM
                                      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: 4/29/2011 9:21 AM
          4/29/2011            e84f52fb-14c8-477e-8653-3c72634ebe92.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 4/29/2011 9:21 AM
                          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 processor     SmartSource Series
                                                        with 1 GB of memory to support the maximum processing throughput rate of 120 dpm.          Capabilities Overview
Operating System: Windows XP Pro or Vista Business
                                                        - 4 or 5 CCITT or JPEG compressed images per documentor require a 2.4-GHz, Core 2 Duo
Processor: Pentium 4, 2GHz, PCI bus
                                                        processor with 1 GB of memory to support the maximum processing throughput rate of 120
Memory: 512MB RAM minimum
                                                        dpm.
Disk Drives:
40GB hard drive with at least 15GB of available space    - MICR/OCR combine read or in-line OCR processing throughput is highly dependent on the
CD-ROM drive                                            host PC processor speed. Using a 2.4-GHz, Core 2 Duo processor with 1 GB of memory,
Graphics Processor: Default per Windows specs           processing throughput is slightly over 100 dpm.
                                                        - Color Image Capture
Other: USB 2.0 high-speed




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: 4/29/2011 9:21 AM
                        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: 4/29/2011 9:21 AM
                      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: 4/29/2011 9:21 AM

				
DOCUMENT INFO
Shared By:
Categories:
Stats:
views:64
posted:4/29/2011
language:English
pages:15