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 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

				
DOCUMENT INFO