G3 Administrators Guide
G3 Administrators Guide
G3 Administrators Guide
Administrators Manual
D60603-07 August 2010
Trademarks: SafeCom, SafeCom Go, SafeCom P:Go, SafeCom ePay and the SafeCom logo are trademarks of SafeCom a/s. Company and product names mentioned in this manual are trademarks or registered trademarks of their respective owners. SafeCom a/s cannot be held responsible for any technical or typographical errors and reserves the right to make changes to products and documentation without prior notification. Patent: SafeCom has received the following British patent GB 2350 713 B, US patent US 6,952,780 B2 and Europe patent EUR EP1 120 701. Feedback: If you have any feedback or ideas concerning this manual or the SafeCom product, then please send an e-mail to [email protected] Copyright 1999 - 2010 SafeCom a/s
SafeCom a/s
Energivej 15 DK-2750 Ballerup Denmark Phone: +45 4436 0240 E-mail: [email protected] Web: safecom.eu
D60603-07
Table of contents
1 Introduction .......................................................................................... 12 1.1 SafeCom Smart Printing ................................................................. 12 1.2 Components overview ................................................................... 12 1.3 Database component .................................................................... 12 1.4 SafeCom components.................................................................... 13 1.5 SafeCom Pay components .............................................................. 14 1.6 SafeCom APIs ............................................................................. 14 1.7 SafeCom Service and other services .................................................. 14 1.8 Pull Printing explained .................................................................. 15 1.9 Terms and definitions ................................................................... 16 1.10 System requirements .................................................................... 21 1.10.1 Server ...................................................................... 21 1.10.2 Clients ...................................................................... 22 1.10.3 Printers and MFPs ........................................................ 22 1.10.4 Network ports ............................................................. 22 1.10.5 SafeCom ID Devices ...................................................... 23 1.11 Available documentation ............................................................... 24 1.12 About this manual........................................................................ 26 1.13 Document history ........................................................................ 27 Frequently asked questions ...................................................................... 29 2.1 What are the benefits of Pull Printing? .............................................. 29 2.2 What devices are supported? .......................................................... 30 2.3 Is Copy Control supported? ............................................................. 30 2.4 Is it possible to charge for print costs? ............................................... 30 2.5 Is it necessary to install software on the users computers? ..................... 30 2.6 How are users identified? ............................................................... 31 2.7 How are users managed? ................................................................ 31 2.8 How are users with the same name handled? ....................................... 31 2.9 How many users, printers and documents can a server handle? ................. 31 2.10 Can access to devices be restricted? ................................................. 31 2.11 Are SafeCom solutions scalable? ...................................................... 32 2.12 How does a solution with multiple servers work? .................................. 32 2.13 Can documents be printed securely? ................................................. 33 2.14 What happens to uncollected documents? .......................................... 33 2.15 Is it always possible to print? .......................................................... 33 2.16 Can print usage be tracked without hardware? ..................................... 33 2.17 Can a Pull Printer be used for Push tracking? ....................................... 34 2.18 What happens if the SafeCom solution stops working? ............................ 34 2.19 What is the administrative overhead? ................................................ 34 2.20 What about integration with other systems? ........................................ 35 2.21 Does it pay to apply a SafeCom solution? ............................................ 35 Planning your SafeCom solution ................................................................. 36 3.1 Introduction ............................................................................... 36 3.2 Checklist to help you on the way .................................................... 37 3.3 User identification by card or user code ............................................. 38 3.4 User creation and management ....................................................... 38 3.4.1 Import user data from other systems ................................. 39 3.4.2 Create users at first print ............................................... 39 3.4.3 Let users associate themselves with their card ..................... 40 3.4.4 Let users associate themselves with their user code .............. 40 3.4.5 Let administrator associate users with their card .................. 41 3.4.6 Let administrator associate users with their ID code .............. 41 3.4.7 Allow users to change their PIN code ................................. 41 3.4.8 Determine users home server ......................................... 42
D60603-07
3.5
3.6
3.7
3.8
3.9
3.10
3.11 4
Overview of software installation ..................................................... 42 3.5.1 Server installation ........................................................ 43 3.5.2 Multi server installation ................................................. 43 3.5.3 Disk space considerations ............................................... 43 3.5.4 Shared SafeCom Pull Printer ........................................... 44 3.5.5 Local SafeCom Pull Printer ............................................. 44 3.5.6 SafeCom printers can reference multiple servers .................. 44 3.5.7 Printer driver and document fidelity considerations .............. 45 3.5.8 High Speed Print considerations ....................................... 45 Print from other systems ............................................................... 46 3.6.1 Print from Apple Mac .................................................... 46 3.6.2 Print from UNIX ........................................................... 46 3.6.3 Print from Novell ......................................................... 46 3.6.4 Print from Host systems (mainframe) ................................ 46 Roll out considerations .................................................................. 47 3.7.1 Test solution prior to roll out .......................................... 47 3.7.2 Inform and prepare your users ......................................... 47 3.7.3 Clearly define responsibilities and procedures ..................... 47 Preemptive support and diagnostic tools ............................................ 48 3.8.1 Event log and e-mail notification ..................................... 48 3.8.2 scping ....................................................................... 49 3.8.3 SafeCom Service and processes ........................................ 49 3.8.4 TCP and UDP port numbers used by SafeCom ....................... 50 3.8.5 SafeCom SQL databases ................................................. 52 3.8.6 SafeCom database update log ......................................... 52 3.8.7 Windows registry settings ............................................... 53 Backup and restore ...................................................................... 53 3.9.1 Standby computer equipment.......................................... 53 3.9.2 SafeCom Windows registry settings ................................... 54 3.9.3 Customized SafeCom files .............................................. 55 3.9.4 Printer configurations ................................................... 55 3.9.5 SafeCom databases ...................................................... 56 3.9.6 scBackup ................................................................... 57 3.9.7 Backup and restore the replication ................................... 57 SafeCom server trace facility .......................................................... 58 3.10.1 Enable trace ............................................................... 58 3.10.2 Trace files ................................................................. 59 3.10.3 TELNET interface ......................................................... 60 SafeCom device trace facility ......................................................... 61
Installation............................................................................................ 62 4.1 Introduction ............................................................................... 62 4.2 The install program ...................................................................... 62 4.2.1 Server installation (Basic) .............................................. 62 4.2.2 Server installation (Advanced) ......................................... 63 4.2.3 Client installation ........................................................ 64 4.2.4 Tools installation ......................................................... 64 4.2.5 Windows Firewall - Ports that must be opened ..................... 65 4.2.6 Windows Firewall - Make SQL use fixed port ........................ 65 4.2.7 After installation security checkup ................................... 67 4.2.8 Scripts to manually create the databases ........................... 67 4.2.9 SQL collation .............................................................. 68 4.2.10 Create intermediate SQL 2008 user: safecominstall ............... 68 4.2.11 Delete intermediate SQL 2008 user: safecominstall ............... 70 4.2.12 Create intermediate SQL 2005 user: safecominstall ............... 71 4.2.13 Delete intermediate SQL 2005 user: safecominstall ............... 73 4.2.14 Do not modify SQL user: safecom ..................................... 73 4.2.15 Enable TCP/IP protocol on SQL 2008 and 2005 ..................... 74 4.2.16 Register sqldmo.dll on SQL 2008 Server .............................. 74 4.2.17 Determine physical and virtual memory on the server ............ 74
D60603-07
4.3
4.4
4.5
4.6
4.7
4.8 4.9
4.13
4.14
4.2.18 Store print files on an external file share ........................... 75 4.2.19 Change location of SafeCom print files .............................. 76 4.2.20 Update SafeCom software single server ............................ 77 4.2.21 Uninstall SafeCom software ............................................ 78 4.2.22 Uninstall Microsoft SQL Server 2008 R2 Express .................... 78 SafeCom Print Client .................................................................... 79 4.3.1 Installation ................................................................ 79 4.3.2 Deployment to computers .............................................. 80 4.3.3 scPrintClient.ini file ..................................................... 80 4.3.4 Trace facility .............................................................. 80 4.3.5 Command line parameters .............................................. 82 SafeCom Application Print .............................................................. 84 4.4.1 Manual installation ....................................................... 84 4.4.2 Deployment to computers .............................................. 85 4.4.3 Trace facility .............................................................. 85 4.4.4 Windows registry settings ............................................... 86 Upgrade from Express to Microsoft SQL Server ..................................... 87 4.5.1 Stop the SafeCom Service .............................................. 87 4.5.2 Change Windows Registry to reference SQL Server ................ 87 4.5.3 Change the dependencies on the SafeCom Service ................ 88 Multi server installation ................................................................. 89 4.6.1 Overview ................................................................... 90 4.6.2 Set SQL Server Agent to automatic startup .......................... 90 4.6.3 Add the other servers to the master servers group ............... 90 4.6.4 Check that the replication is working ................................ 91 4.6.5 What happens if servers or network connections are down? ..... 93 4.6.6 Reinitialize the subscription............................................ 94 4.6.7 Prevent the subscription from expiring .............................. 94 Update multi server installation ...................................................... 94 4.7.1 Introduction ............................................................... 94 4.7.2 Update SafeCom software .............................................. 95 4.7.3 Update SafeCom software old versions ............................. 96 Cluster installation ...................................................................... 97 Install the SafeCom license key code ................................................. 97 4.9.1 Determine the Computer Name ....................................... 97 4.9.2 Determine the Cluster Name ........................................... 98 4.9.3 Understanding the license key code .................................. 98 4.9.4 Device license and user settings dependencies ..................... 99 User rights required when adding printers ......................................... 101 Add a SafeCom Pull Printer on Windows 2008 and 2003 ......................... 103 Add a SafeCom Pull Printer on client computers .................................. 104 4.12.1 Install SafeCom client .................................................. 104 4.12.2 Add a local SafeCom Pull Printer on Windows 7 ................... 105 4.12.3 Add a local SafeCom Pull Printer on Windows XP ................. 106 4.12.4 Add a local SafeCom Pull Printer on Windows Vista .............. 107 SafeCom Pull Port ....................................................................... 108 4.13.1 Enable printer pooling .................................................. 108 4.13.2 Configure the SafeCom Pull Port ..................................... 109 4.13.3 Edit SafeCom servers dialog ........................................... 110 4.13.4 SafeCom Authentication dialog ....................................... 112 4.13.5 Customize the SafeCom Authentication dialog .................... 112 4.13.6 Force focus on the SafeCom Authentication dialog ............... 113 4.13.7 Configure Use job data logon ......................................... 114 SafeCom PopUp scPopUp.exe ....................................................... 116 4.14.1 Setup SafeCom PopUp .................................................. 116 4.14.2 SafeCom PopUp examples ............................................. 118 4.14.3 Configure SafeCom PopUp ............................................. 120 4.14.4 Force SafeCom Port Monitors to use SafeCom PopUp ............. 121 4.14.5 Control dialog timeout ................................................. 122 4.14.6 Charging scheme on SafeCom Pull Port ............................. 122
D60603-07
Printing encrypted documents ........................................................ 124 Printing in Citrix and Windows Terminal Service environments ................ 125 Make all printing go through the SafeCom solution ............................... 125 Install a card reader on a computer ................................................. 126 Update selected SafeCom components ............................................. 126 4.19.1 Update SafeCom Administrator ....................................... 126 4.19.2 Update SafeCom Port Monitors ....................................... 127 4.19.3 Update scJobServer.exe ............................................... 127 4.19.4 Update scSecureLib.dll ................................................. 127 4.19.5 Update filtercard.dll .................................................... 128
SafeCom Administrator .......................................................................... 129 5.1 Introduction .............................................................................. 129 5.2 Install SafeCom Administrator ........................................................ 130 5.3 Login to SafeCom Administrator ...................................................... 130 5.3.1 SafeCom Assistant ....................................................... 131 5.3.2 Change password ........................................................ 134 5.3.3 Test server................................................................ 134 5.3.4 Menus and commands .................................................. 135 5.3.5 Server group and server icons ......................................... 137 5.3.6 User icons ................................................................. 137 5.3.7 Device icons .............................................................. 137 5.3.8 Document icons .......................................................... 138 5.3.9 Other icons ............................................................... 138 5.3.10 Built-in user accounts .................................................. 138 5.4 System overview ........................................................................ 139 5.4.1 Manuals.................................................................... 139 5.4.2 Users ....................................................................... 139 5.4.3 Devices .................................................................... 140 5.4.4 Servers .................................................................... 140 5.4.5 Collect system info ...................................................... 140 5.4.6 Check for updates ....................................................... 140 5.4.7 Save-o-meter ............................................................. 140 5.5 License .................................................................................... 141 5.6 Server group properties ................................................................ 142 5.7 Server properties ........................................................................ 143 5.7.1 Server ..................................................................... 143 5.7.2 Users ....................................................................... 145 5.7.3 Devices .................................................................... 147 5.7.4 E-mail ..................................................................... 148 5.7.5 Tracking ................................................................... 150 5.7.6 Billing ...................................................................... 151 5.7.7 Encryption ................................................................ 152 5.7.8 Customize and translate e-mail messages .......................... 154 5.8 User properties .......................................................................... 157 5.8.1 Identification............................................................. 157 5.8.2 Settings.................................................................... 159 5.8.3 ID code .................................................................... 160 5.8.4 Rights ...................................................................... 162 5.8.5 Member of ................................................................ 164 5.8.6 Aliases ..................................................................... 165 5.8.7 Account ................................................................... 166 5.9 Device properties ....................................................................... 167 5.9.1 Settings.................................................................... 167 5.9.2 Charging scheme ........................................................ 168 5.9.3 License .................................................................... 169 5.9.4 Statistics .................................................................. 170 5.10 Options dialog ........................................................................... 171 5.10.1 General .................................................................... 171 5.10.2 Card reader ............................................................... 172
D60603-07
5.11
5.12
5.13
5.10.3 Network ................................................................... 174 5.10.4 Maintenance .............................................................. 175 5.10.5 Server group info ........................................................ 176 Branches .................................................................................. 177 5.11.1 Administrator rights..................................................... 178 5.11.2 Add a branch ............................................................. 178 5.11.3 Delete a branch .......................................................... 178 5.11.4 Add a device to a branch .............................................. 178 5.11.5 Remove a device from a branch ...................................... 179 5.11.6 Computer properties.................................................... 180 5.11.7 Add a computer to SafeCom solution ................................ 181 5.11.8 Add a computer to a branch at first print .......................... 181 5.11.9 Add a computer to a branch manually .............................. 181 5.11.10 Import computers ....................................................... 181 5.11.11 Remove a computer from a branch .................................. 181 5.11.12 Delete a computer from the SafeCom solution .................... 181 Organizational units .................................................................... 182 5.12.1 Add an organizational unit............................................. 183 5.12.2 Delete an organizational unit ......................................... 183 5.12.3 Restrict access to devices ............................................. 184 Groups..................................................................................... 185 5.13.1 Add groups manually .................................................... 185 5.13.2 Group properties dialog ................................................ 186 5.13.3 Delete groups ............................................................ 187 5.13.4 Add members to a group ............................................... 187 5.13.5 Remove users from a group ........................................... 188 5.13.6 Select rules to be used on a group ................................... 189 5.13.7 Group print ............................................................... 190 Statistics .................................................................................. 192 Event log .................................................................................. 193 Export data ............................................................................... 195 5.16.1 Export users .............................................................. 195 5.16.2 Export servers ............................................................ 196 5.16.3 Export devices ........................................................... 197 servers .................................................................................... 198 Introduction .............................................................................. 198 Which server is master? ................................................................ 198 Add server group ........................................................................ 198 Remove server group ................................................................... 199 Add server ................................................................................ 199 Delete server ............................................................................ 201 Failover servers.......................................................................... 202 users ....................................................................................... 205 Introduction .............................................................................. 205 Default user .............................................................................. 205 Import users .............................................................................. 207 7.3.1 Overview .................................................................. 209 7.3.2 Server ..................................................................... 212 7.3.3 Import source ............................................................ 213 7.3.4 File source (CSV file and XML file) ................................... 214 7.3.5 Properties (Active Directory) .......................................... 215 7.3.6 Properties (Novell eDirectory) ........................................ 216 7.3.7 Properties (LDAP server) ............................................... 217 7.3.8 Configuration (CSV) ..................................................... 218 7.3.9 Configuration (XML) ..................................................... 220 7.3.10 Configuration (Active Directory)...................................... 221 7.3.11 Configuration (Novell eDirectory) .................................... 224 7.3.12 Configuration (LDAP server) ........................................... 226
Manage 6.1 6.2 6.3 6.4 6.5 6.6 6.7 Manage 7.1 7.2 7.3
D60603-07
7.4 7.5 7.6 7.7 7.8 7.9 7.10 7.11 7.12 7.13 7.14 7.15 8 Manage 8.1 8.2 8.3 8.4 8.5 8.6 8.7 8.8 8.9
7.3.13 Rules ....................................................................... 227 7.3.14 Extra ....................................................................... 230 7.3.15 Schedule .................................................................. 231 7.3.16 User import log file ..................................................... 232 7.3.17 Search filter .............................................................. 233 7.3.18 Install certificate ........................................................ 234 7.3.19 Conversion of magnetic ID codes ..................................... 234 Create users at first print ............................................................. 235 Add users manually ..................................................................... 235 Find users ................................................................................. 235 Customize the user list view .......................................................... 236 Edit the properties of multiple users ................................................ 237 Delete users .............................................................................. 237 List of aliases ............................................................................ 238 7.10.1 Save aliases to file ...................................................... 238 List of ID codes .......................................................................... 239 7.11.1 Save ID codes to file .................................................... 240 User has lost ID card .................................................................... 240 User has forgotten ID code ............................................................ 240 User has forgotten PIN code .......................................................... 240 Delete a users print jobs (documents) ............................................. 241 devices .................................................................................... 242 Introduction .............................................................................. 242 Device license ........................................................................... 243 Add device ............................................................................... 243 Find devices .............................................................................. 248 8.4.1 Simple search ............................................................ 248 8.4.2 Advanced search Device licenses ................................... 249 Broadcast for devices .................................................................. 250 Customize the device list view ....................................................... 250 Edit the properties of multiple devices ............................................. 251 Delete devices ........................................................................... 252 Update software ........................................................................ 252 8.9.1 Location of device software ........................................... 254 8.9.2 Single device software update ........................................ 255 8.9.3 Multiple devices software update .................................... 256 Monitor device status .................................................................. 257 8.10.1 Look at device statistics ............................................... 258 Restart devices .......................................................................... 260 Open in web browser ................................................................... 260 Restrict users access to devices ..................................................... 261 DHCP server .............................................................................. 261 Shorten job names in document list ................................................. 262
SafeCom Tracking ................................................................................. 263 9.1 Introduction .............................................................................. 263 9.2 Pull print tracking ....................................................................... 263 9.3 Push print tracking ...................................................................... 264 9.3.1 Printing directly ......................................................... 264 9.3.2 Printing via a second printer .......................................... 265 9.3.3 Set TCP port to another value than 9100 ........................... 265 9.3.4 Allow printing at all times ............................................. 266 9.3.5 Configure SafeCom Push Port dialog ................................. 267 9.3.6 Edit SafeCom servers dialog ........................................... 269 9.4 SafeCom Port Configurator ............................................................ 270 9.5 Copy tracking ............................................................................ 270 9.6 Fax, Scan and E-mail tracking ........................................................ 271 9.7 Post track ................................................................................. 271 9.8 Planning your SafeCom Tracking solution .......................................... 272
D60603-07
9.12 9.13
9.14 9.15
9.16 10
9.8.1 Defining print costs via charging schemes .......................... 272 9.8.2 Track deleted jobs ...................................................... 274 9.8.3 Backup and restore ..................................................... 274 9.8.4 Using tracking data ..................................................... 274 Multiple servers: Online or offline tracking ........................................ 275 9.9.1 Configure SafeCom master server .................................... 276 9.9.2 Configure SafeCom slave servers ..................................... 277 Configuration overview ................................................................ 277 Charging schemes ....................................................................... 278 9.11.1 Add charging scheme ................................................... 278 9.11.2 Sample charging calculation .......................................... 282 9.11.3 Charging scheme properties ........................................... 282 9.11.4 Associate charging scheme with device ............................. 283 9.11.5 Default charging scheme for new devices .......................... 284 9.11.6 Delete a charging scheme ............................................. 284 Change cost control to tracking ...................................................... 285 SafeCom Reports ........................................................................ 286 9.13.1 Install SafeCom Reports ................................................ 286 9.13.2 Start SafeCom Reports ................................................. 286 9.13.3 Make a report ............................................................ 286 Work with the tracking data .......................................................... 287 9.14.1 Export tracking data .................................................... 287 9.14.2 Delete tracking data .................................................... 288 SafeCom Data Mining ................................................................... 289 9.15.1 Main tracking ............................................................. 290 9.15.2 User statistics ............................................................ 291 9.15.3 Device statistics ......................................................... 292 9.15.4 Billing statistics .......................................................... 293 9.15.5 Job list .................................................................... 294 9.15.6 Tracking record dialog ................................................. 295 Update scParser.dll ..................................................................... 298
SafeCom Rule Based Printing (RBP) ........................................................... 299 10.1 Introduction .............................................................................. 299 10.2 Planning your SafeCom RBP solution ................................................ 299 10.3 Creating the rules ....................................................................... 300 10.4 Select rules to be used on group ..................................................... 306 10.5 What if the rule does not work? ...................................................... 308 10.6 How to determine the application ................................................... 308 10.7 Update scRuleExecuter.dll ............................................................ 309 SafeCom Client Billing ........................................................................... 310 11.1 Introduction .............................................................................. 310 11.2 Planning your SafeCom Client Billing solution ..................................... 310 11.3 Configuration overview ................................................................ 311 11.4 Configure SafeCom Client Billing ..................................................... 312 11.5 Allow use of billing codes .............................................................. 313 11.6 Edit the template for billing reminder .............................................. 314 11.7 Import billing codes .................................................................... 315 11.7.1 Billing code import log file ............................................ 322 11.8 Add billing codes manually ............................................................ 323 11.9 Find billing codes ....................................................................... 323 11.10 Delete billing codes ..................................................................... 323 11.11 Modify billing codes..................................................................... 323 SafeCom Pay ....................................................................................... 324 12.1 Introduction .............................................................................. 324 12.2 Planning your SafeCom Pay solution ................................................. 324 12.2.1 Accounting policy ....................................................... 324 12.2.2 Ensure users pay ......................................................... 325
11
12
D60603-07
12.2.3 Cashless solution ........................................................ 325 Change cost control to pay ............................................................ 326 Credit schedule .......................................................................... 327 Cashier How to......................................................................... 330 12.5.1 Login to SafeCom Administrator in Cashier mode ................. 330 12.5.2 Find user .................................................................. 331 12.5.3 User properties dialog .................................................. 332 12.5.4 View user transactions ................................................. 333 12.5.5 Issue a new PIN code ................................................... 333 12.5.6 Unlock user ............................................................... 334 12.5.7 Deposit credits ........................................................... 334 12.5.8 Withdraw credits ........................................................ 334 12.5.9 Set low limit .............................................................. 334 12.5.10 Free reserved credits ................................................... 334 12.5.11 Reset cash cards ......................................................... 335 12.5.12 Detect attempt to avoid paying ...................................... 335 12.5.13 Print reports .............................................................. 335 Account status ........................................................................... 336 Cash flow report ........................................................................ 337 Money loader log ........................................................................ 338 User transactions dialog ............................................................... 339 Prevent cheating ........................................................................ 340 12.10.1 E-mail template for an unfinished job .............................. 340 12.10.2 Difference between print and copy .................................. 341 Job name pricing ........................................................................ 341 12.11.1 JobNamePricing.txt ..................................................... 342
SafeCom Device Utility .......................................................................... 343 13.1 Introduction .............................................................................. 343 13.2 Starting SafeCom Device Utility ...................................................... 343 13.3 Menus and commands .................................................................. 344 13.4 Populate list of devices ................................................................ 344 13.5 Working with configurations .......................................................... 345 Format 14.1 14.2 14.3 of tracking data ......................................................................... 346 Introduction .............................................................................. 346 Format history ........................................................................... 346 Format .................................................................................... 347
14
15
SafeCom ID Devices ............................................................................... 351 15.1 Introduction .............................................................................. 351 15.2 SafeCom AWID Reader ................................................................. 351 15.3 SafeCom Barcode Reader .............................................................. 351 15.4 SafeCom Casi-Rusco Reader ........................................................... 351 15.5 SafeCom EM Reader .................................................................... 352 15.6 SafeCom HID Reader .................................................................... 352 15.7 SafeCom iCLASS Reader ................................................................ 352 15.8 SafeCom Indala Reader ................................................................ 352 15.9 SafeCom Keypad ........................................................................ 353 15.10 SafeCom Legic Reader ................................................................. 353 15.11 SafeCom Magnetic Card Reader ...................................................... 353 15.12 SafeCom Magnetic Card Reader DD .................................................. 353 15.13 SafeCom Mifare Reader ................................................................ 354 Troubleshooting ................................................................................... 355 16.1 SafeCom Help Desk Assistant ......................................................... 355 16.2 SafeCom Administrator: Login failed ................................................ 355 16.3 SafeCom Administrator: Unable to locate all SafeCom servers ................. 355 16.4 SafeCom Administrator: Unable to locate all SafeCom devices ................ 356 16.5 SafeCom Administrator: Users are missing ......................................... 356
16
D60603-07
10
16.6 16.7 16.8 16.9 16.10 16.11 16.12 16.13 16.14 16.15 16.16 16.17 16.18 16.19 16.20 16.21 16.22 16.23 16.24 16.25 16.26 16.27 16.28 16.29 16.30 16.31 16.32 16.33 16.34 16.35 16.36 16.37 17
SafeCom Administrator: Add user failed and Add alias failed .................. 356 SafeCom Administrator: License does not take effect ........................... 356 SafeCom Administrator: Controls in dialog are not visible ...................... 356 User is not created at first print ..................................................... 357 Device web interface: Displayed incorrectly or settings not saved ............ 357 At the printer: Out of order ........................................................... 357 At the printer: User unknown ......................................................... 358 At the printer: Login denied .......................................................... 358 At the printer: Restricted access ..................................................... 358 At the printer: Error printing document ............................................ 358 At the printer: Question mark before the document name ..................... 358 At the printer: Printer busy, retry later ............................................ 358 At the printer: Printer keeps rebooting ............................................. 359 At the printer: Copy not allowed..................................................... 359 At the printer: Login error <number> ............................................... 359 At the printer: Error printing: General Failure .................................... 359 At the printer: Card reading not working ........................................... 359 Document is not printed ............................................................... 359 Some documents are missing ......................................................... 359 Document is printed wrongly ......................................................... 360 Nothing is copied ........................................................................ 360 Driver names are missing .............................................................. 360 Add Printer Wizard: Specified port cannot be added............................. 360 Local SafeCom Pull Printer is unable to print ...................................... 361 How to restart the SafeCom Service ................................................. 361 How to restart the Print Spooler ..................................................... 361 Users computer: Unable to connect to SafeCom server ........................ 362 Users computer: Please contact your administrator! ............................ 362 Import users: No users imported ..................................................... 363 Multi server installation ................................................................ 363 Restore SafeCom server ................................................................ 363 scPopUp: The publisher could not be verified ..................................... 363
Administrators installation notes ............................................................. 365 17.1 Introduction .............................................................................. 365 17.2 Servers .................................................................................... 365 17.2.1 SafeCom master server ................................................. 366 17.2.2 SQL master server ....................................................... 367 17.2.3 SafeCom slave server ................................................... 368 17.2.4 Failover servers .......................................................... 369 17.3 User identification ...................................................................... 369 17.4 Devices .................................................................................... 370 17.5 Printer drivers ........................................................................... 370 Index ................................................................................................. 371
18
D60603-07
11
1 Introduction
1
1.1
Introduction
SafeCom Smart Printing
SafeCom Smart Printing solutions are intelligent solutions designed to help companies and organizations gain control over their printing costs and document security. SafeCom is a modular system that can be enhanced with add-on modules to build customer specific and scalable solutions.
1.2
Components overview
1.3
Database component
Database. A SafeCom server depends on the availability of its database. In most cases the provided database can be used (SQL Server 2008 R2 Express). In a solution with multiple SafeCom servers the master SQL server must run Microsoft SQL Server 2008 or 2005.
D60603-07
12
1 Introduction
1.4
SafeCom components
SafeCom Go offers user authentication at the device and integrates with the touch-screen control panel on selected multi function printers (MFPs) from Canon, Lexmark, HP, Ricoh, Sharp and Xerox. Authentication by card is possible by connecting a SafeCom ID Device (card reader). SafeCom P:Go offers user authentication at single function printers and is typically used to print all documents at login. SafeCom Controller / SafeCom Color Front-end (combined touch-screen and card reader) is the printer manufacture independent and external solution that is used to support devices not supported by SafeCom Go/SafeCom P:Go. SafeCom Device Server is a web server based component that is used to offer SafeCom Go functionality on selected devices from Konica Minolta, Oc and other vendors. It uses SOAP and XML to communicate with the device. No SafeCom software is installed on the device. SafeCom G3 is the server software that comes with a database (SQL Server 2008 R2 Express) for storing user and tracking information. Users are added to the database the first time they print, but they can also be imported from for example Active Directory. It can also work with Microsoft SQL. SafeCom Administrator is the application that is used to configure and administrate the SafeCom solution, including remotely updating SafeCom software on devices. SafeCom Reports is used to generate reports based on tracking data collected for printer, copied and deleted documents. Use it to report cost and environmental savings. SafeCom Web Interface offers users self service through a web browser. Users can delete or retain documents etc. Runs on Microsoft Internet Information Server (IIS). SafeCom Port Configurator is used to conveniently convert direct TCP/IP printers on print server to Push printers and thus allow tracking of documents sent directly to devices. The printers can be reverted back to TCP/IP printers if required. SafeCom Push Port is the port monitor that tracks directly printed documents. SafeCom Pull Port is a port monitor that tracks and stores the users documents. Documents are stored on the SafeCom server. With SafeCom Print Client documents can optionally be stored on the hard disk drive of the users computer. SafeCom Print Client allows documents to be stored on the hard disk drive of the computer that it is installed onto.
D60603-07
13
1 Introduction
1.5
1.6
SafeCom APIs
In addition to being a modular solution, the SafeCom Smart Printing solution also features a number of optional Application Programming Interfaces (APIs). SafeCom Administrator API is an XML-based tool that makes it possible to manipulate multiple users, automate tasks and integrate your SafeCom Smart Printing solution with other systems. SafeCom Batch Print API is an XML-based tool used to integrate the SafeCom solution with other systems, such as document archiving systems.
1.7
D60603-07
14
1 Introduction
1.8
From the administrators point of view: 1. SafeCom solutions require only software to be installed on a Windows 2008 or 2003 server; there is no need to install software on the users computers. It is sufficient to add or modify a shared printer on the server.
From the systems point of view: 1. 2. 3. The Windows print queue is using the port monitor SafeCom Pull Port to analyze the document to determine owner and job characteristics. The SafeCom Pull Port transfers the formatted document and the resulting data to the SafeCom server. When the user login at the printer documents are released for printing. Documents that do not match the printer can be filtered from the list of documents in advance (3.5.7).
D60603-07
15
1 Introduction
1.9
D60603-07
16
1 Introduction
Home server The SafeCom server the user belongs to and where the list of the users print jobs is maintained. See also: Multi Server Support. LDAP Lightweight Directory Access Protocol. License key code A code that is provided by the supplier of your SafeCom solution. Master server If the server group includes multiple SafeCom servers, then one is appointed the role of being the master server. All system and user data are synchronized and distributed from the SafeCom master server. See also: Multi Server Support. MFP Multi Function Printer. A printer that can also scan and copy. Multi Server Support Enables two or more SafeCom servers to work together. Users can roam between locations to collect their documents at any SafeCom-enabled printer and at any location regardless of to which SafeCom server the document was printed (2.11). See also: Home server and Master server. MSCS Microsoft Cluster Service. Organizational unit Organizational unit (Org. unit) is an attribute that describes to which part of the organizational tree users, devices and servers belong (5.12). PIN code PIN (Personal Identification Number) is a personal code consisting of four (4) digits. To increase security users are requested to login by means of both the personal card (or user code) and the PIN code. The default PIN code is 1234. Port Configurator See: SafeCom Port Configurator. Port monitor Port monitor is a component in the Windows print process that is responsible for the communication to the physical printer. When you do a Server installation or Client installation you also install two special port monitors: SafeCom Pull Port and SafeCom Push Port. PUK code PUK (Personal Unblocking Key) is an 8-digit code that associates users with their card (or user code).
D60603-07
17
1 Introduction
Pull Print The process where users login at the printer before the submitted documents are printed. See also: SafeCom Pull Printer. Push Print The process where submitted documents are sent directly to the printer. See also: SafeCom Push Printer. RBP Rule Based Printing. Rule Based Printing See: SafeCom Rule Based Printing. SafeCom Administrator The application you use to configure and administrate a SafeCom solution. SafeCom Administrator API (option) An XML-based tool that makes it possible to manipulate multiple users, automate tasks and integrate the SafeCom solution with other systems. Is available in the form of an executable and a dynamic link library (DLL). Refer to SafeCom G3 Administrator API Reference Manual D60822. SafeCom Batch Print API (option) An XML-based tool used to integrate the SafeCom solution with other systems, such as document archiving systems. Refer to SafeCom G3 Batch Print API Reference Manual D60823. SafeCom Broadcast Server A server process that enables the various SafeCom applications to find and connect to the relevant servers. SafeCom Client A computer, where a local SafeCom printer is installed. SafeCom Client Billing (option) Allows users to associate billing codes with any print, copy and possibly also fax, scan and e-mail jobs performed on MFPs. With billing codes it is possible to get a very detailed breakdown of printer and MFP usage and possibly recover these expenses by invoicing clients. Requires SafeCom Tracking.
D60603-07
18
1 Introduction
SafeCom Controller Hardware that connects directly to the Ethernet network and provides network access for the SafeCom ID Device. SafeCom Devices The SafeCom Controller, SafeCom Go and other devices that support the SafeCom protocol. Communicates with the SafeCom Job Server. SafeCom ePay (option) Allow users to transfer money from their bank account to their SafeCom account via the Internet. SafeCom Front-end Hardware that is used to identify users at the printer. It is a card reader with touch-screen (1.10.5). SafeCom Go Internal SafeCom solution for MFPs (1.10.3). SafeCom ID Device Hardware that is used to identify users at the printer (1.10.5). SafeCom Job Server A server process that stores user data, device data and print job references in the SafeCom Job database. Configuration data is also stored for the whole SafeCom solution. SafeCom Money Loader (option) SafeCom Money Loader is a steel cabinet (safe) equipped with touchscreen, receipt printer, a note acceptor and a coin acceptor. Allow users to deposit cash money to their account without the presence of staff. Requires SafeCom Pay. SafeCom Money Server A server process that controls access to the SafeCom Money database that stores transactions made on the users accounts. Requires SafeCom Pay. SafeCom Port Configurator A wizard-based tool for converting existing TCP/IP1 printers to SafeCom Push printers and revert SafeCom Push printers back to their original TCP/IP settings. SafeCom Pull Printer (uses SafeCom Pull Port) A printer defined in Windows that parses the printed document and transfers the printed document and tracked data to the SafeCom server. Subsequently the user can login at any SafeCom-enabled printer to collect the document.
A TCP/IP printer is a Windows print queue that uses the Standard TCP/IP port monitor.
D60603-07
19
1 Introduction
SafeCom Push Printer (uses SafeCom Push Port) A printer defined in Windows that parses the printed document, transfers the tracked data to the SafeCom server, and forwards the printed document either directly to the physical printer or to another Windows print queue. Requires SafeCom Tracking or SafeCom Pay. SafeCom Print Client SafeCom Print Client allows documents to be stored on the hard disk drive of the computer that it is installed onto. SafeCom Reports (option) SafeCom Reports enables viewing of main tracking statistics, user statistics, device statistics, client billing statistics and job list. SafeCom Reports includes a number of predefined and parameterized reports. Requires SafeCom Tracking. SafeCom Rule Based Printing (RBP) (option) Allows print cost savings by offering management a method for enforcing policies for printing. Rules can be applied to groups of users. Existing user grouping can be imported from Windows. Requires SafeCom Tracking. SafeCom Server The computer where the SafeCom Server software is installed. SafeCom Tracking Server A server process that controls access to the SafeCom Tracking database that stores information about who printed what on which printer and at what time. The tracking record includes information about paper size, number of pages and possible use of color and duplex (double-sided print). Requires SafeCom Tracking or SafeCom Pay. SafeCom Web Interface With SafeCom Web Interface users can use a standard web browser to see a list of their documents on the SafeCom server. In SafeCom Pay environments users can see their current balance and transactions made on their SafeCom account. Refer to SafeCom G3 Web Interface Administrators Manual D60604. Server group name A unique name used by SafeCom components to reference a group of one or more SafeCom servers. Maximum is 19 characters. Virtual server Microsoft Cluster Service (MSCS) enables the creation of virtual servers. Unlike a physical server, a virtual server is not associated with a specific computer, and can failover from one node to another. SafeCom configurations must reference the virtual server rather than the physical servers. Requires SafeCom Cluster Server license.
D60603-07
20
1 Introduction
1.10
System requirements
Consider the hardware and operating systems on your server and clients before installing SafeCom G3.
1.10.1 Server
Windows 2008 and 2003 SP1 (both 32-bit and 64-bit). For demo purpose it can also run on Windows 7, Windows Vista and Windows XP SP2. Virtualization software, such as VMware and Microsoft Virtual Server, is supported as long as it supports the Operating System. 1.4 GHz CPU (recommended 2 GHz or faster) and 2 GB RAM or greater. To take advantage of 4 GB or more physical memory it is necessary enable PAE X86 (Physical Address Extension) on 32-bit Windows systems. Refer to microsoft.com. 5 GB or more to allow database growth. TCP/IP protocol installed and configured. SafeCom license key code (4.9).
Database Microsoft SQL Server 2008 R2 Express is distributed with the software and REQUIRES Microsoft .Net Framework 3.5 SP1 and Windows Installer 4.5. Please visit microsoft.com to download and install these prior to the installation of SafeCom G3. In a SafeCom multi server installation the master server must run Microsoft SQL Server 2008 or 2005.
The SafeCom server and the SafeCom printers on Windows 2008 and 2003 are cluster-aware (requires a SafeCom Cluster Server license). If one server in the failover cluster goes down another takes over. This gives unprecedented high availability. Refer to microsoft.com for additional information on the resulting hardware and software requirements. Note: The above is to be considered rules of thumb in terms of the configuration of the SafeCom servers (CPU, RAM and disk space). The load on the system is very difficult to predict since it depends on so many things, including, number, size and type of documents to be printed, printer driver, number and types of printers, number of users etc. Refer to 2.11 for information on scalability.
D60603-07
21
1 Introduction
1.10.2 Clients
Windows 7, Windows Vista, Windows XP SP2, 2008 and 2003. Clients running Citrix and Windows Terminal Service (WTS). 1 GHz CPU and 1 GB RAM or greater (minimum 2 GB RAM if 64-bit). 1 GB free disk space (or more depending on the amount of printing). TCP/IP protocol installed and configured.
Printing via LPD/LPR from Apple MAC, UNIX, Novell and Host systems (mainframe) is possible to a shared SafeCom Pull Printer, but may require additional software (3.6).
SafeCom Controller offers user authentication and Pull Printing independent of printer manufacturer. Users login either through the attached SafeCom Color Front-end or stand-alone SafeCom ID Device. If pages are to be counted SafeCom Tracking is required and the print job must be processed by a driver that support PCL5, PCL5c, PCL5e, PCL6, PCL XL or PostScript level 2 or 3.
D60603-07
22
1 Introduction
Table 1 shows the supported identification methods. The ID device is either fitted or supplied with a 1.8 - 2.0 m cable. Additional information about the ID devices is available in chapter 15 SafeCom ID Devices. If your method of identification is not in the table, then please contact [email protected] to hear about support. You are also welcome to send cards to SafeCom a/s so we can verify that reading is possible.
D60603-07
23
1 Introduction
1.11
Available documentation
SafeCom Smart Printing SafeCom Smart Printing Administrators Quick Guide D10600 How to install a SafeCom Smart Printing solution. SafeCom G3 SafeCom G3 Administrators Manual D60603 (this manual) A comprehensive Manual (376 pages) that the administrator should consult to make a successful SafeCom solution. Includes information about SafeCom Tracking, SafeCom Rule Based Printing, SafeCom Client Billing and SafeCom Pay. SafeCom G3 Cluster Administrators Manual D60620 How to install on a cluster. SafeCom G3 Client Billing Users Quick Guide D60627 How to associate billing codes with jobs. SafeCom G3 Web Interface SafeCom G3 Web Interface Administrators Manual D60604 How to install and customize the Web Interface and SafeCom ePay. SafeCom Reports SafeCom Reports Administrators Manual D60609 How to install and use SafeCom Reports. SafeCom Controller SafeCom Controller Administrators Manual D60700 Manual (pages 42) on how to install, configure and use SafeCom Controller and SafeCom Color Front-end. SafeCom Controller Users Guide D20700 User's Guide on how to use SafeCom Controller and SafeCom Color Frontend. SafeCom Go Canon SafeCom Go Canon Administrators Manual D60707 Manual (28 pages) on how to install, configure and use SafeCom Go Canon. SafeCom Go Canon Users Guide D20707 User's Guide on how to use SafeCom Go Canon. SafeCom Go HP SafeCom Go HP Administrators Manual D60701 Manual (106 pages) on how to install, configure and use SafeCom Go HP. SafeCom Go HP Hardware Quick Guide D10702 Quick Guide (44 pages) on how to install the SafeCom Go HP hardware. SafeCom Go HP Users Guide D20701 User's Guide on how to use SafeCom Go HP.
D60603-07
24
1 Introduction
SafeCom Go Konica Minolta SafeCom Go Konica Minolta Administrators Manual D60713 Manual (24 pages) on how to install, configure and use SafeCom Go Konica Minolta. SafeCom Go Konica Minolta Users Guide D20713 User's Guide on how to use SafeCom Go Konica Minolta. SafeCom Go Lexmark SafeCom Go Lexmark Administrators Manual D60711 Manual (32 pages) on how to install, configure and use SafeCom Go Lexmark. SafeCom Go Lexmark Users Guide D20711 User's Guide on how to use SafeCom Go Lexmark. SafeCom Go Oc SafeCom Go Oc Administrators Manual D60715 Manual (24 pages) on how to install, configure and use SafeCom Go Oc. SafeCom Go Oc Users Guide D20715 User's Guide on how to use SafeCom Go Oc. SafeCom Go Ricoh SafeCom Go Ricoh Administrators Manual D60703 Manual (28 pages) on how to install, configure and use SafeCom Go Ricoh. SafeCom Go Ricoh Users Guide D20703 User's Guide on how to use SafeCom Go Ricoh. SafeCom Go Sharp SafeCom Go Sharp Administrators Manual D60709 Manual (32 pages) on how to install, configure and use SafeCom Go Sharp. SafeCom Go Sharp Users Guide D20709 User's Guide on how to use SafeCom Go Sharp. SafeCom Go Xerox SafeCom Go Xerox Administrators Manual D60705 Manual (32 pages) on how to install, configure and use SafeCom Go Xerox. SafeCom Go Xerox Users Guide D20705 User's Guide on how to use SafeCom Go Xerox. SafeCom Money Loader SafeCom Money Loader Reference Manual D60605 How to install and configure the SafeCom Money Loader.
D60603-07
25
1 Introduction
Other manuals SafeCom G3 Administrator API Reference Manual D60822 Describes how to use the Administrator API to add, delete and modify users and how to export tracking data. SafeCom G3 Batch Print API Reference Manual D60823 Describes how to integrate SafeCom with other systems, such as document archiving systems. SafeCom G3 Administrator DLL Programmers Manual D60824 Describes the SafeCom Administrator DLL, a C programmers interface that can be used to automate SafeCom administration tasks and integrate SafeCom with existing systems. SafeCom G3 Disaster Recovery Manual D60621 Describes disaster recovery process for a SafeCom single server solution. SafeCom G3 Enterprise Disaster Recovery Manual D60622 Describes disaster recovery process for a SafeCom multi server solution.
1.12
D60603-07
26
1 Introduction
Chapter 8 Manage devices describes how to manage devices from within SafeCom Administrator. Chapter 9 SafeCom Tracking describes how tracking is done, how to plan and configure the tracking solution, define costs via charging schemes and how to work with the tracking data. Chapter 10 SafeCom Rule Based Printing (RBP) describes how to plan and configure rule based printing. Chapter 11 SafeCom Client Billing describes how to plan and configure your billing solution, including how to import and work with billing codes. Chapter 12 SafeCom Pay describe how to plan and configure your pay solution, choose accounting policy, ensure users pay and use deposit and withdraw credits from users accounts. Chapter 13 SafeCom Device Utility describes how to use SafeCom Device Utility to load device software and configure devices. Chapter 14 Format of tracking data describes the format of the exported tracking data. Chapter 15 SafeCom ID Devices contains brief description of the standalone card readers and their status signals. Chapter 16 Troubleshooting, contains hints for troubleshooting. Chapter 17 Administrators installation notes, contains forms that can be used to record information about the SafeCom solution.
1.13
Document history
Revision D60603-07 SafeCom G3 Server version S82 070.400*03 Update of multi server solutions should only be conducted as described in section (4.7.3). Updated to reflect that SQL Server 2000 is not supported.
Revision D60603-06 SafeCom G3 Server version S82 070.400*02 Important note added to section Update multi server installation (4.7)
Revision D60603-05 SafeCom G3 Server version S82 070.400*02 Start SafeCom Service after restarting SQL server (4.2.6).
Revision D60603-04 SafeCom G3 Server version S82 070.400*02 Force SQL Server 2008 R2 to use fixed TCP port 1433 (4.2.6).
D60603-07
27
1 Introduction
Revision D60603-03 SafeCom G3 Server version S82 070.400*02 Updated to reflect use of SQL Server 2008 R2 Express and new installer. New section: Update multi server installation (4.7).
Revision D60603-02 SafeCom G3 Server version S82 070.400*02 How to use SafeCom Administrator as a Cashier user (12.5). SafeCom Device Utility (13).
Revision D60603-01 SafeCom G3 Server version S82 070.400*01 SafeCom Print Client installation (4.3). SafeCom Application Print (4.4). Branches (5.11).
D60603-07
28
2.1
In addition to these benefits you should consider the additional benefits you can gain by installing any SafeCom add-on modules: SafeCom Tracking (9), SafeCom Rule Based Printing (10), SafeCom Client Billing (11) and SafeCom Pay (12).
D60603-07
29
2.2
2.3
2.4
With SafeCom Pay (12), an add-on to SafeCom Tracking (9), users can be required to pay upfront for printing and copying. With SafeCom Money Loader and/or SafeCom ePay users can revalue their account.
2.5
Tracking of Push Print does not require SafeCom hardware at the printer.
D60603-07
30
2.6
2.7
2.8
2.9
2.10
D60603-07
31
2.11
2.12
A users home server denotes the SafeCom server the user belongs to and where the users print jobs are stored. Because data about users and devices is known on all servers, only the users and devices belonging to a particular slave server (home server) will be affected if that server goes down. Enterprise customers where printing is mission critical often use Microsoft Cluster Service (4.8) to further ensure the availability of the SafeCom servers. SafeCom print queues can be installed on any of the SafeCom servers, but most enterprise customers choose to install print queues on the SafeCom slave servers only and keep the master server free from print processing tasks so it only needs to replicate data (and collect tracking data from the slaves). It is possible to distribute the print-processing task to ordinary Windows print servers by doing a SafeCom client installation (4.2.3) on these. However, this will increase the network load, as Pull Print jobs will have to go onto the network an extra time (to get transferred from the Windows print server to the users home server). This may slow performance if the resulting print jobs tend to be big in terms of file size. One cannot assume that the print job will be small in file size, just because the original document is small. We have seen examples where a 1Mb (2-page) PDF file grew to +500Mb. This is very printer driver dependent.
D60603-07
32
2.13
2.14
2.15
2.16
D60603-07
33
2.17
2.18
2.19
D60603-07
34
2.20
2.21
D60603-07
35
3
3.1
D60603-07
36
3.2
Other factors Are there any other factors that may influence the success of the SafeCom solution?
D60603-07
37
3.3
3.4
The legislation in some countries does not allow the use of social security numbers.
D60603-07
38
3.4.1
3.4.2
Prerequisites: The user logon (JS) and the e-mail domain (safecom.eu) can be combined into the users valid e-mail address ([email protected]). The user must be able to enter the e-mailed 8-digit PUK code, which is used to associate the user with the card (or user code).
D60603-07
39
3.4.3
Prerequisites: Users must be able to enter PUK code at the device, for example by having at least one MFP with SafeCom Go or a printer equipped with a SafeCom Color Front-end.
3.4.4
4. 5.
Prerequisites: All devices must allow users to enter PUK codes and user codes.
D60603-07
40
3.4.5
Prerequisites: The computer must have a card reader installed (4.18). Users must turn up in person to have their card read and a person with administrator rights must be present to operate the computer. Administrator must inform the user of his PIN code.
3.4.6
Prerequisites: Administrator must inform the user of his user code and PIN code.
3.4.7
D60603-07
41
3.4.8
3.5
D60603-07
42
3.5.1
Server installation
You need to make a SafeCom Server installation on a server computer. Just insert the SafeCom CD and select Server installation (4.2.2). This will install all the required software, including the port monitor SafeCom Pull Port and the administrative application SafeCom Administrator. Refer to 1.10.1 for a description of the server requirements. The Server installation allows you to specify two destination folders; one for the program files and another for the print jobs. You may wish to locate the print jobs on a hard disk equipped with RAID or similar technology. The default installation folder is: C:\Program Files\ SafeCom\SafeComG3 On Windows 64-bit: C:\Program Files (x86)\ SafeCom\SafeComG3
3.5.2
3.5.3
D60603-07
43
3.5.4
To avoid interfering with your users while you test your SafeCom solution, it is recommended to leave your shared printers as they are and just add a few new shared SafeCom Pull Printers, dedicated to the testing of SafeCom.
3.5.5
Installing local SafeCom Pull Printers is relevant if your SafeCom solution include SafeCom Encryption (4.15).
3.5.6
D60603-07
44
3.5.7
3.5.8
D60603-07
45
3.6
3.6.1
If the user logon on Windows differs from the one on the Mac, then the user logon on the Mac must be on the users list of aliases (5.8.6).
3.6.2
If the user logon on Windows differs from the one on UNIX, then the user logon on UNIX must be on the users list of aliases (5.8.6).
3.6.3
3.6.4
D60603-07
46
3.7
3.7.1
3.7.2
3.7.3
D60603-07
47
You can also include the help desk contacts on the OUT OF ORDER screen, which the SafeCom Front-end displays when communication is lost to the SafeCom server. The SafeCom Front-end returns to normal operation by itself a couple of minutes after communication has been restored. The person responsible for the SafeCom solution should ensure that administrative procedures are in place for the following: Backup and restore (3.9). When you need to add new users (7.5). When users lose their card (7.12). When users forgets their user code (7.13). When users forget their PIN code (7.14).
3.8
3.8.1
D60603-07
48
3.8.2
scping
Use the supplied command line utility scping to search for SafeCom servers. Syntax: scping [Group|Ip|-h:Host|-b:IpMask [-c]] [-x:Host:Port] [/?] Group Ip -h:Host -b:IpMask -c -x:Host:Port Examples: scping scping scping scping scping MyServerGroup 10.0.0.10 -c -h:MyServer -c -b:10.255.255.255 -x:MyServer:7700 Broadcast for server group. Ping server on specified IP address. Ping server on specified host. Broadcast for servers on specified subnet. Try to connect server to confirm it's running. Try to establish a connection to Host using Port.
3.8.3
The SafeCom Service launches the following processes: scBroadcastServer.exe scJobServer.exe scMoneyServer.exe scTrackingServer.exe
D60603-07
49
3.8.4
7723 7700
TELNET SafeCom
D60603-07
50
Usage Used by the SafeCom Job Server, SafeCom devices and SafeCom applications to find each other via the SafeCom Broadcast Server. Used between the SafeCom Administrator and SafeCom devices. Used between the SafeCom Administrator and SafeCom devices when adding devices or retrieving status. Used by Port Monitor if SNMP status is enabled.
The table below contains some typical SafeCom server and client installations and lists what inbound ports should be open if a firewall, such as Windows Firewall (4.2.5), is installed on the computer. SafeCom installation type SafeCom master server SafeCom slave server SafeCom Print Client Client with local SafeCom printers Client with scPopUp Client with SafeCom Administrator TCP 7400, 7500, 7700, 7900 7500, 7700 7600 5740 UDP 5742 5742
The figure shows the connections between the different SafeCom components and the TCP and UDP ports used for communication.
SafeCom Job Server (slave) TCP 7700 pay solution only online tracking only Mail Server
TCP 7700
TCP 25
scEvent
scCore
scTracking
scPurse
SafeCom Administrator TCP 80 5742 SafeCom Devices TCP 25 UDP 161 5741
SafeCom APIs
Mail Server
D60603-07
51
If multiple servers are used each SafeCom slave server will use TCP port 7900 to deliver tracking data to the SafeCom Tracking server on the SafeCom master server, either continuously (online tracking) or scheduled (offline tracking). Refer to 9.9. There is only one SafeCom Money Server and it resides on the SafeCom master server. SafeCom slave servers will use TCP port 7400 to communicate with the SafeCom Money Server on the SafeCom master server.
3.8.5
Each SafeCom server in the server group has its own SafeCom Job Database and SafeCom Event Log. Events older than one year are automatically deleted from the database. The SafeCom Tracking Database is only relevant if your solution includes the SafeCom Tracking or SafeCom Pay. The SafeCom Money Database is only relevant if your solution includes the SafeCom Pay. A server group should only use one SafeCom Money Server. This is located on the SafeCom master server by default.
3.8.6
D60603-07
52
3.8.7
Settings for the SafeCom Port Monitors are stored at: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Print\Monitors\SafeCom Pull Port HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Print\Monitors\SafeCom Push Port
3.9
Note: The described processes do not include backup and restore of users uncollected and retained documents.
3.9.1
D60603-07
53
The SafeCom Server software must be the same version as on the computer it is to replace. This is particularly important in a multi-server solution where all the computers in the SafeCom group must be on the same SafeCom server version. Refer to chapter 4 Installation. To secure smooth transition to the new server it should inherit the Server address and the computer name of the one it is replacing. That way all references from SafeCom-enabled devices and SafeCom ports to the SafeCom server will remain valid. You should either secure that your DHCP server will give the new server the same IP address or you should give it a static IP address. You can further reduce downtime if the standby computer is already updated with the more static SafeCom Windows registry settings (3.9.2), customized SafeCom files (3.9.3) and printer configurations (3.9.4). That way you can reduce the restore process to perhaps restoring the backup of the SafeCom databases. If the computer is a SafeCom slave server it will automatically get its SafeCom databases restored, as the SafeCom master server sees to this as part of the replication process. It is recommended to reinitialize the subscription (4.6.6).
3.9.2
To restore: 1. Double-click the backup registry file and answer Yes when asked to update the Windows registry.
D60603-07
54
3.9.3
3.9.4
Printer configurations
The Microsoft Print Migrator 3.1 available at microsoft.com/printserver can be used to back up and restore all print shares and user permissions. Print Migrator does not back up the actual SafeCom Pull Port and SafeCom Push Port monitors, only the port attributes. Prior to the restore operation, you must reinstall the original set of SafeCom port monitors to ensure complete functionality. Print Migrator comes with a command line interface printmig that takes these switches: -? Help, -b Backup and r Restore. If the computer is clustered you must backup the clusters virtual server. printmig b \\filesrv\backup\printers.cap \\clustergroupname where clustergroupname is the Network Name of the virtual server that contains the Print Spooler resource. The printmig can be integrated into a jobscheduler, such as the Scheduled Task mechanism in Microsoft Windows. Please refer to online help in Windows.
D60603-07
55
3.9.5
SafeCom databases
This section explains how to backup and restore the SafeCom databases. SafeCom can work with the below two versions of the SQL databases. To backup the database you can use the supplied SafeCom command line utility scBackup (3.9.6). Microsoft SQL Server Must be purchased and licensed from Microsoft. Backup can be performed by use of Microsoft SQL Server Management Studio, or an SQL client tool that comes with the Microsoft SQL Server. Alternatively you can use the Transact-SQL BACKUP DATABASE statement, and run the SQL command line utility, osql.exe. Microsoft SQL Server 2008 R2 Express This is distributed with SafeCom. No license is required from Microsoft. Database size is limited to 10 GB.
Please refer to microsoft.com for more information on the Microsoft SQL tools and utilities mentioned above. All SafeCom print files are by default stored in the folder: C:\Program Files\ SafeCom\SafeComG3\Data On Windows 64-bit: C:\Program Files (x86)\ SafeCom\SafeComG3\Data The database files are by default stored in the folder: C:\Program Files\ Microsoft SQL Server\MSSQL10_50.SAFECOMEXPRESS\ MSSQL\DATA On Windows 64-bit: C:\Program Files (x86)\ Microsoft SQL Server\MSSQL10_50.SAFECOMEXPRESS\ MSSQL\DATA
D60603-07
56
3.9.6
scBackup
As mentioned in 3.9.5 you can use the supplied command line utility scBackup to backup the SafeCom databases. scBackup must be Run as administrator. Syntax: scBackup.exe b | -r <path> Where b specifies to backup data in the specified path and r specifies to restore data from the path. The backup results in the files: sccore.bak, scevent.bak, scpurse.bak and sctracking.bak. To restore successfully the SafeCom server version must NOT change from the time of backup to the restore is performed. Example: scBackup.exe b C:\backup During restore (-r) scBackup will attempt to stop the SafeCom Service and subsequently restart the SafeCom Service. This will not work in a MS Cluster environment or if other services depend on the SafeCom Service. In such cases the SafeCom Service must be manually stopped and started. The scBackup can be integrated into a job-scheduler, such as the Scheduled Task mechanism in Microsoft Windows. Please refer to online help in Windows.
3.9.7
To restore the replication: 1. 2. 3. 4. 5. Open the SQL Server Management Studio. Login to the SQL server and browse to master under Databases. On the Tools menu click SQL Query Analyzer. Enter the path to the file that contains the backed up replication. Run the file.
D60603-07
57
3.10
Stopping the SafeCom Service and the Print Spooler and then deleting the folder c:\safecom_trace will disable the trace again. The trace files (3.10.2) will by default occupy maximum 220Mb of disk space. Trace can also be turned on/off without disrupting the SafeCom Service through a TELNET interface (3.10.3). This interface can also be used to configure the trace facility, including the size and location of the trace files. The SafeCom Service executes the supplied scStartup.cmd file in the installation folder just before starting. By editing the scStartup.cmd file it can be made to copy (and compress) the trace files before they are reset.
D60603-07
58
Restarting the SafeCom Service clears the trace files (*.trc). You should only enable the trace facility if advised to do so by SafeCom support personal.
D60603-07
59
D60603-07
60
3.11
D60603-07
61
4 Installation
4
4.1
Installation
Introduction
The installation of software and hardware is described in the SafeCom Go Administrators Manual and SafeCom Controller Administrators Manual. Refer to section 1.11 for a complete list of these documents. This chapter contains more advanced installation related topics that were excluded from the Quick Guide, including multi server (4.5.1) and cluster installation (4.8). Note: In chapter 17 there are forms you can use to record information about your SafeCom solution.
4.2
4.2.1
D60603-07
62
4 Installation
4.2.2
8. 9. 10. 11.
Current settings are displayed. Click Install to accept and start the installation. The Print Spooler is restarted at the end of this process. Click Finish to launch SafeCom Administrator (5.1). If using SQL 2008 then remember to register sqldmo.dll on the SQL 2008 Server (4.2.16). If Windows Firewall is on, then open the ports as specified (4.2.5) and make the SQL Server use the fixed TCP port 1433 (4.2.6).
D60603-07
63
4 Installation
4.2.3
Client installation
A Client installation is relevant if you intend to: Create a shared SafeCom Pull Printer (3.5.4) or SafeCom Push Printer on a Windows print server. Create a local SafeCom Pull Printer (3.5.5) or SafeCom Push Printer on clients.
Follow these steps to make a Client installation. 1. 2. 3. 4. 5. 6. 7. Insert the SafeCom CD or download the safecom_g3_xxx.exe file from the link supplied to you. The installation must be Run as administrator. When the installation program is launched click Next. Read and accept the end-user license agreement. Click Next. Click Advanced installation. Click Next. Click Client. Click Next. Select the location for the SafeCom program files. Click Next. Current settings are displayed. Click Install to accept and start the installation. The Print Spooler is restarted at the end of this process. Click Finish.
4.2.4
Tools installation
You only need to do a Tools installation if you want to administrate your SafeCom solution from multiple computers. Follow these steps to make a Tools installation. Installing SafeCom Administrator will also install the files required to run SafeCom Administrator API (AdmClient.exe) and SafeCom Batch Print API (SCClient.exe). Check SafeCom Port Configurator to install it. Note: If you intend to make a Client and Tools installation on the same computer, you should make the Client installation (4.2.3) first. 1. 2. 3. 4. 5. 6. 7. 8. Insert the SafeCom CD or download the safecom_g3_xxx.exe file from the link supplied to you. The installation must be Run as administrator. When the installation program is launched click Next. Read and accept the end-user license agreement. Click Next. Click Advanced installation. Click Next. Click Tools. Click Next. Check the tools you wish to add. Click Next. Select the location for the SafeCom program files. Click Next. Current settings are displayed. Click Install to accept and start the installation. If the installation includes SafeCom Port Configurator the Print Spooler is restarted at the end of this process. Click Finish.
Users who are to use the SafeCom Administrator on the computer MUST have permission to the Windows registry: HKEY_LOCAL_MACHINE\SOFTWARE\SafeCom\SafeComG3
D60603-07
64
4 Installation
4.2.5
Note: If users are to be imported from Active Directory you will need to add TCP port 389 (or 636 if the import is to be secure via SSL/LDAPS). For a complete list of ports that need to be open refer to 3.8.4.
4.2.6
Following the instruction below to make the SQL server used a fixed port. 1. Click Start, point to All Programs, Microsoft SQL Server 2008 R2, Configuration Tools and SQL Server Configuration Manager.
2.
D60603-07
65
4 Installation
3.
4. 5. 6.
Clear TCP Dynamic Ports and set TCP Port to 1433. Click OK. Click SQL Server Services.
7. 8.
Right-click SQL Server (SAFECOMEXPRESS) and click Restart. Start the SafeCom Service.
D60603-07
66
4 Installation
4.2.7
4.2.8
If the distribution includes any of the files below these must be executed last. sccoreadapt.scs sceventadapt.scs scpurseadapt.scs sctrackingadapt.scs
D60603-07
67
4 Installation
4.2.9
SQL collation
The databases created by the SafeCom system use the collation: SQL_Latin1_General_CP1_CI_AS. Use of other collations has not been tested and is as such not supported. Using another collation may perhaps reveal situations where case sensitivity could cause problems. To use another SQL collation, do the following, before the databases are created: 1. On the SafeCom master server make a backup of the files: 2. sccore.scs scevent.scs scpurse.scs sctracking.scs
Edit each of the above *.scs files to reference the appropriate SQL collation. Look for the text string: SQL_Latin1_General_CP1_CI_AS Note: The corresponding *def.scs should NOT be edited.
If the solution is a multi server installation the modified *.scs files must also be used on the SafeCom slave servers. This implies that the modified *.scs files must be copied to the SafeCom slaver server before the slave creates its database.
D60603-07
68
4 Installation
2.
3.
D60603-07
69
4 Installation
4.
On the General page set Login name to safecominstall. Check SQL Server authentication and set Password to safecom_2_DB. Clear Enforce password policy. Click on the Server Roles page.
5.
6.
Give the SQL user the required rights by checking sysadmin. Click OK. Remember that the safecominstall SQL user is a temporary user and you can delete the user later on as described in 4.2.11.
D60603-07
70
4 Installation
D60603-07
71
4 Installation
3.
4.
On the General page set Login name to safecominstall. Check SQL Server authentication and set Password to safecom_2_DB. Clear Enforce password policy.
D60603-07
72
4 Installation
5.
6.
Give the SQL user the required rights by checking sysadmin. Click OK. Remember that the safecominstall SQL user is a temporary user and you can delete the user later on as described in 4.2.13.
D60603-07
73
4 Installation
If you get an error message then install SQLServer2005_BC.msi and run the above command again.
If you see a little balloon in the bottom right-hand corner of the screen announcing Windows Virtual Memory Minimum Too Low Windows is increasing the virtual memory, but during this process, memory requests for some applications, such as the SafeCom server may be denied and these applications may potentially become unstable.
D60603-07
74
4 Installation
How to adjust the virtual memory: 1. 2. 3. 4. 5. 6. 7. 8. Login with administrator privileges on the server. Open the Control Panel on the computer where the SafeCom server software is installed. Click Administrative Tools. Click Computer Management. Click on the Advanced tab. In Performance click Settings. In Virtual memory click Change. In the Drive list, click the drive that contains the paging file you want to change. Under Paging file size for selected drive, type a new paging file size in megabytes in the Initial Size (MB) or Maximum Size (MB) box, and then click Set. If you increase the sizes you are normally not required to restart the computer. Note: The initial size is normally equivalent to 1.5 times the amount of physical RAM on the system. If the Task Manager (see below) indicates that the Peak memory use is close to the maximum it is recommended to change the initial size to 1.5 times the current maximum and to increase the maximum to 2 or more times the current maximum. Example: Initial size is 2 GB and maximum is 4 GB. If Peak gets close to 4 GB then increase Initial size to 6 GB and maximum to 8 GB. How to check peak memory usage: 1. 2. 3. Right-click an empty space on the Taskbar and click Task Manager. Click on the Performance tab. In Commit Charge (K) you can see the Peak memory usage. Peak memory usage on a SafeCom server is typically reached when there is high print activity and/or when user data is imported.
D60603-07
75
4 Installation
D60603-07
76
4 Installation
Follow these steps to update a single server: 1. 2. 3. 4. Click Start, type services.msc into the Search box and press ENTER. Stop the SafeCom Service and the Print Spooler, and any other services that depend on the Print Spooler. Update the SafeCom G3 software. Check Yes, I want to restart my computer now5. Click Finish. This will restart the computer (and the SafeCom Service and Print Spooler).
The update procedure for multi server installation is covered in 4.7. The update procedure for a cluster installation is covered in SafeCom G3 Cluster Administrators Manual D60620. If you are updating from a SafeCom G2 version older than S82 070.340*05 you are advised to update to SafeCom G2 version S82 070.380*09, before updating to SafeCom G3. If in doubt, contact [email protected].
It is recommended to restart the computer, but in most cases it is sufficient to restart the SafeCom Service and Print Spooler.
D60603-07
77
4 Installation
Please observe that uninstalling the database will not remove the data folder: C:\Program Files\ Microsoft SQL Server\MSSQL10_50.SAFECOMEXPRESS\ MSSQL\DATA On Windows 64-bit: C:\Program Files (x86)\ Microsoft SQL Server\MSSQL10_50.SAFECOMEXPRESS\ MSSQL\DATA During installation (4.2.2) you may have chosen an alternative location for the SQL database files. The DATA folder contains SafeCom SQL database files (sc*.mdf and sc*.ldf). The files may be deleted manually. A re-installation of SafeCom software will rename the files to *.old before installing a new set of SafeCom SQL database files.
D60603-07
78
4 Installation
4.3
4.3.1
Installation
1. 2. 3. Insert the SafeCom CD or download the safecom_print_client_xxx.exe file from the link supplied to you. The installation must be Run as administrator. Click Next. Enter SafeCom server address. The address can be in form of the hostname or IP address. Use semicolon as separator if multiple servers7 are entered. Click Next. Click Install to copy the files to their location: %PROGRAMFILES%\SafeCom\SafeComPrintClient which normally maps to: C:\Program Files\SafeCom\SafeComPrintClient Click Finish. The following changes have been applied to the system: New service named: SafeCom Print Client. New port (scPull) that uses the SafeCom Pull Port (4.13.2). The SafeCom PopUp (4.14) is also installed and started. If Windows Firewall is on, then open inbound TCP port 7600.
4. 5.
Print test page: 6. Use one of these methods to make a printer use SafeCom Print Client: Modify an existing local printer to use the new port. In the Print properties dialog click on the Ports tab and check the scPull port. Add a new local printer and make it use the new port. Please refer to these sections for instructions: Windows 7 (4.12.2), Windows XP (4.12.3) and Windows Vista (4.12.4).
7.
The creation of the SafeCom Pull Port (scPull) requires User Account Control to be turned off. 7 In a SafeCom multi server solution the SafeCom Print Client and the SafeCom Pull Port (4.13.2) will use the list of servers to failover to the server in the order they are listed.
D60603-07
79
4 Installation
4.3.2
Deployment to computers
The IT administrator can deploy the SafeCom Print Client software to computers silently by following these steps: 1. 2. Create a folder and copy safecom_print_client_xxx.exe and scPrintClient.ini (4.3.3) into the folder. Edit the DefaultServerAddress= entry in the scPrintClient.ini to include the address (hostname or IP address) of the SafeCom server(s). DefaultServerAddress=slave1;slave2 It is possible to specify multiple servers, separating these with a semicolon (;). This would be relevant for a SafeCom multi server solution, where you would perhaps reference a couple of SafeCom slave servers, similar to what you might do for the purpose of failover (6.7). To control the location of print job files edit the parameter: JobStoragePath= 3. 4. Save the scPrintClient.ini. To suppress dialogs invoke the safecom_print_client_xxx.exe file with the command line parameters (4.3.5): /VERYSILENT /NORESTART /SUPPRESSMSGBOXES To install in a specific folder use the /DIR="x:\pathname" command line parameter. A fully qualified pathname must be specified.
4.3.3
scPrintClient.ini file
[scPrintClient] DefaultServerAddress= DefaultServerPort=7500 PCPort=7600 JobServerConnTimeOutMS=10000 JobStoragePath=C:\Program Files\SafeCom\SafeComPrintClient\JobFiles\ ScReconnectRetryWaitMs=120000 CleanUpTaskInterval=7200000 CleanUpTaskIntervalRnd=3600000
4.3.4
Trace facility
The SafeCom trace facility is useful in troubleshooting situations, but it should only be enabled upon request from SafeCom support personnel. 1. On the computer create the folder c:\safecom_trace
The trace file scPrintClient<no>.trc contains a number as part of the filename. When a trace file reaches the maximum size (10 MB) a new one is created and the number is incremented with one. The trace folder will hold the current and previous version of the trace file. Older files are automatically deleted. D60603-07 80
4 Installation
Restarting the SafeCom Print Client Service will by default reset the trace files.
D60603-07
81
4 Installation
4.3.5
5 message boxes are not suppressible: The About Setup message box. The Exit Setup? message box. The FileNotInDir2 message box displayed when Setup requires a new disk to be inserted and the disk was not found. Any (error) message box displayed before Setup (or Uninstall) could read the command line parameters. Any message box displayed by [Code] support function MsgBox.
/LOG Causes Setup process to create a log file in the user's TEMP directory detailing file installation and [Run] actions taken during the installation process. This can be a helpful debugging aid. For example, if you suspect a file is not being replaced when you believe it should be (or vice versa), the log file will tell you if the file was really skipped, and why.
D60603-07
82
4 Installation
The log file is created with a unique name based on the current date. (It will not overwrite or append to existing files.) The information contained in the log file is technical in nature and therefore not intended to be understandable by end users. Nor is it designed to be machine-parseable; the format of the file is subject to change without notice. /LOG="filename" Same as /LOG, except it allows you to specify a fixed path/filename to use for the log file. If a file with the specified name already exists it will be overwritten. If the file cannot be created, Setup will abort with an error message. /NOCANCEL Prevents the user from cancelling during the installation process, by disabling the Cancel button and ignoring clicks on the close button. Useful along with '/SILENT' or '/VERYSILENT'. /NORESTART Instructs Setup process not to reboot even if it's necessary. /RESTARTEXITCODE=exit code Specifies the custom exit code that Setup process is to return when a restart is needed. Useful along with '/NORESTART'. Also see Setup Exit Codes. /LOADINF="filename" Instructs Setup process to load the settings from the specified file after having checked the command line. This file can be prepared using the '/SAVEINF=' command as explained below. Don't forget to use quotes if the filename contains spaces. /SAVEINF="filename" Instructs Setup process to save installation settings to the specified file. Don't forget to use quotes if the filename contains spaces. /LANG=language Specifies the language to be used. Language states the internal name of the language as specified in a [Languages] section entry. When a valid /LANG parameter is used, the Select Language dialog will be suppressed. /DIR="x:\dirname" Overrides the default directory name displayed on the Select Destination Location wizard page. A fully qualified pathname must be specified. /GROUP="folder name" Overrides the default folder name displayed on the Select Start Menu Folder wizard page. If the [Setup] section directive DisableProgramGroupPage was set to yes, this command line parameter is ignored. /NOICONS Instructs Setup to initially check the Don't create a Start Menu folder check box on the Select Start Menu Folder wizard page.
D60603-07
83
4 Installation
4.4
4.4.1
Manual installation
Download the SafeCom Application Print software safecom_app_print_xxx.exe from the link provided to you. On Windows 7 and Vista the installation must be Run as administrator8. 1. 2. Insert the SafeCom CD or download the safecom_app_print_xxx.exe.exe file from the link supplied to you. The installation must be Run as administrator. Click Next to copy the files to the destination folder: %PROGRAMFILES%\SafeCom\SafeComAppPrint which normally maps to: C:\Program Files\SafeCom\SafeComAppPrint Click Finish.
3.
Note: The SafeCom Application Print file scAppPrintLib.dll need to be loaded by the printing applications on the computer and this requires a restart of the computer.
8 The installer needs access to restricted area in the Windows registry, therefore installation as Administrator is recommended on all platforms.
D60603-07
84
4 Installation
4.4.2
Deployment to computers
The IT administrator can deploy the SafeCom Application Print software to computers silently by: 1. To suppress dialogs invoke the safecom_print_client_xxx.exe file with the command line parameters (4.3.5). /VERYSILENT /NORESTART /SUPPRESSMSGBOXES To install in a specific folder use the /DIR="x:\pathname" command line parameter. A fully qualified pathname must be specified. The SafeCom Application Print software reads the configured settings of the selected printers SafeCom Pull Port or SafeCom Push Port to determine which SafeCom server to use. Additional information: Trace facility (4.4.3). Windows registry settings (4.4.4). Command line parameters (4.3.5).
4.4.3
Trace facility
The SafeCom trace facility is useful in troubleshooting situations, but it should only be enabled upon request from SafeCom support personnel. 1. On the computer create the folder c:\safecom_trace
The trace file scAppPrint<no>.trc contains a number as part of the filename. When a trace file reaches the maximum size (10 MB) a new one is created and the number is incremented with one. The trace folder will hold the current and previous version of the trace file. Older files are automatically deleted.
D60603-07
85
4 Installation
4.4.4
Default behavior (OK or Cancel): The OK button is the default. To make the Cancel button the default: 1. Open the Registry Editor and browse to: HKEY_LOCAL_MACHINE\SOFTWARE\SafeCom\SafeComAppPrint 2. Create a new DWORD named DialogDefaultOk. Specify 0 to make the Cancel button the default.
Note: The text on the OK and Cancel buttons is inherited from the language settings of Windows.
D60603-07
86
4 Installation
4.5
Note: For this to take effect you MUST restart the computer. Once you have performed the above successfully you may uninstall the SQL Server 2008 R2 Express database as described in 4.2.22.
4.5.1
4.5.2
D60603-07
87
4 Installation
2.
3.
Change the value from: computername\SAFECOMEXPRESS to one of the below two. It is NOT possible to specify the IP address instead of the computername. computername You only need to specify the computername if there is no named instance of the SQL Server. There is no named instance of the SQL Server if Services only lists MSSQLSERVER. computername\instancename You need to specify both computername and instancename if there is a named instance of the SQL Server. The instance name can be seen in Services. The named service will appear in Services as MSSQL$instancename. The instance name is case sensitive.
4. 5. 6.
Click OK to save the settings. Repeat step 3-4 for the remaining registry settings. Exit the Registry Editor.
4.5.3
D60603-07
88
4 Installation
4.6
D60603-07
89
4 Installation
4.6.1
Overview
1. 2. 3. 4. 5. 6. 7. Do a SafeCom Server installation on each slave server (4.2.2). Do a SafeCom Server installation on the master server. Select Advanced installation and Use an existing SQL Server (4.2.2). Use SafeCom Administrator to install the license key code on the master server (4.9). Set SQLSERVERAGENT to automatic startup (4.6.2). Add the other servers to the master servers group (4.6.3). Delete intermediate SQL user: safecominstall (4.2.13). Check that replication is working (4.6.4).
The Microsoft SQL Server is installed in the folder: C:\Program Files\ Microsoft SQL Server\MSSQL On Windows 64-bit: C:\Program Files (x86)\ Microsoft SQL Server\MSSQL
4.6.2
4.6.3
D60603-07
90
4 Installation
4.6.4
If the replication is working status symbols should be colored green only and NOT red. To check any latency click on the Tracer Tokens tab and click Insert Tracer. Click on the Agents tab and check that agents are running.
D60603-07
91
4 Installation
The following tables must be selected for replication: scAliases scBillingCodes scBillingUserInfo scCardInfo scDeviceInfo scDomainInfo scGroupInfo scGroupMembers scGroupRbpRule scMainSettings scMasterServerVersion scPriceScheme scRbpAction scRbpCondition scRbpRuleInfo scScheduleInfo scServerInfo scServerSettings scTreeView scUserInfo
D60603-07
92
4 Installation
4.6.5
D60603-07
93
4 Installation
4.6.6
4.6.7
4.7
4.7.1
D60603-07
94
4 Installation
4.7.2
During the period of updating from SafeCom G2 to SafeCom G3 the following applies: Two core databases are used. Once the update is completed it is only the new database (scCoreU) that is used. The collection of tracking data from slave servers continues to work. If the time to convert the master tracking database to the new format is judged to exceed 40 minutes, then a new database (scTrackingU) is created to store new records. Use of passwords with Unicode characters is not allowed. Insertion of rows in replicated tables take 3-times longer. Devices must be referenced by their IP address. Adding a SafeCom G2 slave is possible, but a server test will fail and the computer name must not contain Unicode.
You may want to use the table below to help you through the update process. No M No 1 2 3 4 5 6 Slave server address 1. Stop services 2. Update software 3. Start services Version Master server address 1. Stop services 2. Update software 3. Start services Version
D60603-07
95
4 Installation
4.7.3
Note: How to update a SafeCom cluster installation is covered in SafeCom G3 Cluster Administrators Manual D60620. The update should be completed outside normal working hours, as printing will be unavailable during the update process. You may want to use the table below to help you through the update process. No 1 2 3 4 5 6 No M After the update has been completed you should check that the replication from the master server is still working. Refer to 4.6.4. You may also wish to view the scdbu*.log files that were created during the update process. Refer to 3.8.6. Master server address 1. Stop services 2. Update software 3. Start services Version Slave server address 1. Stop services 2. Update software 3. Start services Version
It is recommended to restart the computer, but in most cases it is sufficient to restart the SafeCom Service and Print Spooler.
D60603-07
96
4 Installation
4.8
Cluster installation
Cluster installation is covered in SafeCom G3 Cluster Administrators Manual D60620.
4.9
4.9.1
D60603-07
97
4 Installation
4.9.2
Windows 2003: 1. 2. 3. 4. 5. Open Cluster Administrator. Browse to Groups, Cluster Group. Right-click Cluster Name and select Properties. Click on the Parameters tab. Name contains the cluster name.
4.9.3
D60603-07
98
4 Installation
4.9.4
No encryption
Tracking (9) and Pay (12) Tracking data is recorded if the device has a SafeCom Tracking license and the user is set to cost control Tracking or Pay. If the user is set to No cost control tracking data is not recorded. A Pay user (cost control is Pay) can login to a device with a SafeCom Pay license and to a device with a Tracking license provided Allow Pay user is checked on the device. When Allow Pay user is checked the Pay user is not charged. Table 4 Device license and user cost control settings Device \ User No cost device Tracking device Pay device No cost user Tracking User Pay User No tracking and reject login unless Allow Pay user is checked Tracking and reject login unless Allow Pay user is checked Pay
No tracking
No tracking
No tracking
Tracking
No tracking
Tracking
D60603-07
99
4 Installation
Rule Based Printing (10) Tracking and Pay users are subjected to Rule Based Printing on devices with a SafeCom Rule Based Printing license. Client Billing (11) A Billing user (set to Bill clients for costs) can associate billing codes with jobs that are tracked on devices with a SafeCom Client Billing license. If the Billing user uses a device with no SafeCom Client Billing license the job is tracked without the possibility to associate a billing code. Table 5 Device license and user billing settings Device \ User No billing device Billing device No bill clients for cost Bill clients for cost
No billing
No billing
No billing
Billing
D60603-07
100
4 Installation
4.10
On node 1 and 2 grant permissions in Local Security: 1. 2. 3. 4. 5. Open the Control Panel. Click Administrative Tools and Local Security Policy. Browse to Local Policies, User Rights Assignment and double-click Load and unload device drivers. Click Add User or Group and add the local Power Users group. Repeat step 1-4 on the other node.
D60603-07
101
4 Installation
On node 1 grant permission in cluster: Windows 2008: 1. 2. 3. Open Failover Cluster Management. Right-click [Cluster] and click Properties. On the Cluster permissions tab add the local Power Users group and grant Full Control.
Windows 2003: 1. 2. 3. Open Cluster Administrator. Right-click [Cluster] and click Properties. On the Security tab add the local Power Users group and grant Full Control.
On node 1 grant permission in Registry: 1. Open the Registry Editor and browse to: HKEY_LOCAL_MACHINE\SYSTEM\Cluster\Resources 2. 3. Right-click Resources and click Permissions. Add the local Power Users group and grant Full Control.
Restart the Print Spooler: 1. To take effect on the changes, open Cluster Administrator to restart Print Spooler. Locate Print Spooler service, right-click and choose Take Offline, wait for status changed to Offline. Then right-click Print Spooler again and choose Bring Online to start service.
D60603-07
102
4 Installation
4.11
D60603-07
103
4 Installation
4.
Click OK.
For high load systems you can minimize the wait for documents to be processed and transferred to the SafeCom server by checking Enable printer pooling (4.13.1) on the Ports tab and add multiple identically configured SafeCom Pull Ports. In our experience 1-4 ports is sufficient and no more than 12 ports should be added.
4.12
The SafeCom Pull Port is now installed on the client computer. Next you need to either modify an existing local printer or add a new local printer. When you do this you should make sure that: The printer is not shared. The printer uses the SafeCom Pull Port, which sees to the transfer of documents to the SafeCom server from the SafeCom Pull Printer. The SafeCom Pull Port is configured correctly (4.13.2).
D60603-07
104
4 Installation
Add the printer: 1. 2. 3. 4. Click Start and Devices and Printers. Click Add a printer. Click Add a local printer. Choose Create a new port and select SafeCom Pull Port from the dropdown list. Click Next. Note: If you have installed SafeCom Print Client (4.3.1), you can choose Use an existing port and select scPull from the dropdown list. Click Next and continue to step 8. 5. 6. 7. 8. 9. 10. Enter a unique name of your choice for the port in Port Name. Click OK. The Configure SafeCom Pull Port dialog (4.13.2) prompts you to enter the hostname or IP address of the SafeCom Server and choose the method of Authentication. Refer to step 5 in 4.13.2. Click OK. The SafeCom User Logon dialog appears. Enter User logon and Password of a user that has SafeCom Administrator or Technician rights. Click OK. Select the manufacturer and printer model. Click Next. Select whether or not you want to keep the existing driver or use the new one. Click Next. Enter a Printer Name. Click Next. Note: If the Installing printer dialog is hanging for more than half a minute it is because User Account Control was NOT turned off. 11. 12. Select Do not share this printer. Click Next. Clear Set as default printer if this printer should be your default Windows printer. Click Print a test page to print a test page to verify the system. You are prompted to confirm that the test page was printed correctly, but the test page is only printed when you login at the device. For now, click Close, and then Finish.
If the SafeCom Pull Port has been configured to show the SafeCom Authentication dialog (4.13.2) or if SafeCom Rule Based Printing is used to ask for print confirmation, then scPopUp.exe (4.14) must be setup to start in each session, either by making a shortcut in the Windows Startup folder or by starting it in a logon script.
D60603-07
105
4 Installation
D60603-07
106
4 Installation
1. 2. 3. 4.
Click Start, Control Panel and Printers. On the File menu point to Run as administrator, and click Add Printer. The User Account Control dialog appears. Click Continue. The Add Printer Wizard welcome screen appears. Click Add a local printer. Choose Create a new port and select SafeCom Pull Port from the dropdown list. Click Next. Note: If Run as administrator was NOT chosen in step 2 Windows will report Specified port cannot be added. Access is denied. Note: If you have installed SafeCom Print Client (4.3.1), you can choose Use an existing port and select scPull from the dropdown list. Click Next and continue to step 8.
5. 6. 7.
Enter a unique name of your choice for the port in Port Name. Click OK. The Configure SafeCom Pull Port dialog (4.13.2) prompts you to enter the hostname or IP address of the SafeCom Server and choose the method of Authentication. Refer to step 5 in 4.13.2. Click OK. The SafeCom User Logon dialog appears. Enter User logon and Password of a user that has SafeCom Administrator or Technician rights. Click OK. Click OK and select the manufacturer and printer model. Click Next. State whether or not you want to keep the existing driver or use the new one. Click Next. Enter a Printer Name and choose whether or not this printer should be your default Windows printer. Click Next. Select Do not share this printer. Click Next. Click Print a test page to print a test page to verify the system. You are prompted to confirm that the test page was printed correctly, but the test page is only printed when you login at the device. For now, click Close, and then Finish.
D60603-07
107
4 Installation
4.13
D60603-07
108
4 Installation
4.
Click Edit servers to add, remove, change or test the connection to the SafeCom server (4.13.3).
D60603-07
109
4 Installation
5.
Select the method of Authentication: Select Use network logon to use your Windows logon as your SafeCom user logon when printing. Select Use specified logon and enter the SafeCom user logon of the user who is to receive all future prints sent to the print queues that uses this Pull Port. This can be combined with Group print (5.13.7) by specifying the name of the group instead of the name of a user. Select Show authentication dialog every time printing if you do not want to use the Windows logon as your SafeCom user logon. A dialog box will ask for your login ID before printing (4.13.4). Select Show authentication dialog on first print only if you only want to be prompted only the first time you print after the print spooler (computer) has been started. Select Use job data logon to extract the logon from the job data (4.13.7). Check Override driver name and enter the driver name. The specified driver name overrides the driver name supplied by the printer driver.
6.
In the Edit SafeCom servers dialog click Test connection to test the communication with the SafeCom server. Click Close.
D60603-07
110
4 Installation
It is NOT possible to edit an entry on the SafeCom server list. Instead select the server and click Remove. Then click Add.
In the Add server dialog enter the SafeCom server address (IP address or hostname). Click OK.
D60603-07
111
4 Installation
You can also customize the Remember text. You may also choose to completely hide the Remember check box. 1. Open the Registry Editor and browse to: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Print\Monitors\SafeCom Pull Port\Ports 2. Double-click any of the below values to modify them. Click OK when finished: AuthDialogStr AuthRememberStr Change Enter your ID to your text. Must be shorter than 30 characters. Change Remember to your text.
D60603-07
112
4 Installation
AuthRememberMe DialogTimeout
Change from 1 to 0 if you wish to hide the Remember check box. Change from 30 to the number of seconds you want as timeout before the dialog is closed. Minimum value is 1 second and maximum is 300 seconds.
The change will take effect once either the computer has been restarted or the Print Spooler service has been restarted. To restart the Print Spooler: 1. 2. Click Start, type services.msc into the Search box and press ENTER. Right-click Print Spooler and click Restart.
Please note that changing the above parameter will affect the behavior of all applications that attempts to take focus.
D60603-07
113
4 Installation
Job data string is the string that precedes the logon. The logon (maximum characters) is extracted as the string that is between the Job data string (with the potential succession of any skip characters and a start character) and the Stop character. Max search length is the number of bytes to search into the job data stream. Typically the job data string is within the first 1000 bytes. Characters to skip can be <None>, <Tab>, <Space> or any entered printable character and defines that any occurrence of this character should be skipped after the Job data string and before the Start character. Start character can be <None>, <Tab>, <Space> or any entered printable character and defines the character in front of the logon.
D60603-07
114
4 Installation
Stop character can be <None>, <Tab>, <Space> or any entered printable character and defines the character after the logon. A carriage return or new line will always terminate the logon string. Use alternative logon can be <None> or Network logon and defines the fallback logon to use in case the logon cannot be extracted from the job data. Here are some examples: Extract from file Job data string Characters to skip Start character Stop character Extracted logon
Date=2007.01.01 Name=JS,File=letter.txt Time: 12:15:32
Name= <None>
JS
D60603-07
115
4 Installation
4.14
D60603-07
116
4 Installation
1.
Start scPopUp.exe. It is recommended to setup scPopUp.exe to start in each session, either by making a shortcut in the Windows Startup folder or by starting it in a logon script. Invoke it with the command: scPopUp.exe /T Leave out the /T argument if you are in a Citrix or Windows Terminal Service (WTS) environment and wish to use named pipes instead. The following arguments are supported: /T /K /P /C Use TCP and PIPE connection. The /T argument should be used in most cases. For backward compatibility the tcp argument is still accepted. Set OK as default on dialog timeout, no configuration screen is shown. Mask login credentials entered by user. Configure scPopUp (4.14.3).
D60603-07
117
4 Installation
When scPopUp is started the startup message appears for a few seconds.
After start the scPopUp icon appears in the Windows system tray. 2. Click the scPopUp icon and click Status. Click Quit to close the menu. Clicking Disable PopUp will stop the scPopUp.exe process.
3.
The SafeCom PopUp dialog appears with status and version information.
D60603-07
118
4 Installation
SafeCom Push Port If Show job price before printing is enabled on the SafeCom Push Port (9.3.5).
SafeCom Rule Based Printing If the rule has Notify by popup enabled and/or includes the action Confirm pull job. Message: text or Confirm push job. Message: text (10.3).
D60603-07
119
4 Installation
Check Auto start the scPopUp.exe program is started whenever the computer
is started. Check Use TCP to use TCP and PIPE connection. This is the same as specifying the /T argument on the command line when starting scPopUp. Check Set OK as default on dialog timeout to set OK as default on dialog timeout. This is the same as specifying the /K argument on the command line when starting scPopUp. These choices are saved in the Windows Registry: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run HKEY_CURRENT_USER\Software\SafeCom\SafeComG3\ScPopUp The settings from the Windows Registry are ORed with the arguments given on the command line. This means that OK will be the default on dialog timeout if either Set OK as default on dialog timeout is checked (specified in the Windows Registry) or if the /K argument is specified on the command line when starting scPopUp.
D60603-07
120
4 Installation
Note: Client installations running Windows 7, Windows Vista and Windows 2008 rely on the use of scPopUp.exe as the sole way of presenting a dialog to the user. On client installations running Windows 2003, Windows 2000 and Windows XP failing to connect to scPopUp.exe will cause the build-in Windows dialog to be used to interact with the user.
D60603-07
121
4 Installation
D60603-07
122
4 Installation
2.
3. 4.
Change the ShowChargingSchemes setting from 0 to 1 to allow selection of charging scheme in the Configure SafeCom Pull Port dialog. The database ID of the selected charging scheme is stored in Windows Registry setting ChargingScheme. Restart the Print Spooler (16.31). Open the Configure SafeCom Pull Port dialog (4.13.2) to select the charging scheme from the drop down list in the Miscellaneous section.
5.
Click OK. The SafeCom User Logon dialog appears. Enter User logon and Password of a user that has SafeCom Administrator or Technician rights. Click OK.
D60603-07
123
4 Installation
4.15
D60603-07
124
4 Installation
4.16
The steps: 1. Add a local SafeCom Pull Printer on the Windows server running Citrix or WTS (4.12). Check Enable printer pooling (4.13.1) to minimize the possibility of users having to wait until other users have responded to the SafeCom Authentication dialog. Configure the SafeCom Pull Port to Show authentication dialog (4.13.2). Optionally you may wish to customize the SafeCom Authentication dialog as described in 4.13.5. Setup scPopUp.exe to start as described in 4.14.
2. 3. 4.
4.17
D60603-07
125
4 Installation
4.18
4.19
Note: If the server is clustered use the Cluster Administrator to move the virtual server as you update scAdministrator.exe on the nodes. Note: To determine the version right-click the scAdministrator.exe file, click Properties and click on the Version tab. D60603-07 126
4 Installation
Note: If any of the servers are clustered use the Cluster Administrator to move the virtual server as you update scPullPM2k.dll and scPushPM2k.dll on the nodes. Note: To determine the version right-click the scPullPM2k.dll and scPushPM2k.dll files, click Properties and click on the Version tab.
Note: If any of the servers are clustered use the Cluster Administrator to move the virtual server as you update the scJobServer.exe on the nodes. Note: To determine the version right-click the scJobServer.exe file, click Properties and click on the Version tab.
2.
Note: If any of the servers are clustered use the Cluster Administrator to move the virtual server as you update the scSecureLib.dll on the nodes. Note: To determine the version right-click the scSecureLib.dll file, click Properties and click on the Version tab.
D60603-07
127
4 Installation
The above steps should be performed on all SafeCom servers. It should also be performed on all the computers that have SafeCom Administrator installed and a card reader connected (4.18).
D60603-07
128
5 SafeCom Administrator
5
5.1
SafeCom Administrator
Introduction
SafeCom Administrator is the application you use to configure and administrate your SafeCom solution. SafeCom Administrator can be installed on any Windows computer and used to administrate all the SafeCom servers within TCP/IP range of the computer. When you login to SafeCom Administrator it will present the SafeCom Assistant (5.3.1). This will guide you through the steps needed to make your devices part of the SafeCom solution.
D60603-07
129
5 SafeCom Administrator
5.2
5.3
Once you are logged in, you can change the user logon and password. Note: If the user belongs to a domain the domain followed by a slash (/) or a backslash (\) must be specified in front of the users logon. Example: MYDOMAIN\JS. Alternatively you can specify user logon followed by (@) and the domain, like this JS@MYDOMAIN.
D60603-07
130
5 SafeCom Administrator
5.3.1
SafeCom Assistant
When you login to SafeCom Administrator it will present the SafeCom Assistant. However, it is NOT present in multi server solutions. The SafeCom Assistant will guide you through a 3-step process to make your devices part of the SafeCom solution. You can jump between the steps by clicking on the title, for example 2 Add SafeCom Pull Printer. Clear Show the screen at login if you do not want the SafeCom Assistant to open at login. 1. Devices Select device type Click the type of SafeCom device; SafeCom Go (Canon, HP, Konica Minolta, Lexmark, Oc, Ricoh, Sharp, Xerox, ) or SafeCom Controller (Other).
D60603-07
131
5 SafeCom Administrator
Download device manuals and software Download is required if the manuals and device_software (8.9.1) subfolders does not contain the required files10. Click Next.
Open device manual (and install device hardware etc.) The relevant device manual appears11. Open the manual, as you may need to consult it in order to install device hardware and/or send software to the device. The manual is in PDF format and requires Adobe Reader. Click Next.
10 11
To get future updates use Check for updates in the System overview (5.4). The manual is also added to the list of manuals in the System overview (5.4).
D60603-07
132
5 SafeCom Administrator
2.
Add a SafeCom Pull Printer Add a SafeCom Pull printer Click Windows Add Printer Wizard to open this and add a shared printer to be used for Pull printing. Follow the instructions in the device manual or as documented in section 4.11. If a SafeCom Pull Printer is already added you do not need to do this.
Add device Click Add device to add the physical device to the SafeCom solution. On SafeCom Go HP, SafeCom Go Lexmark and SafeCom Go Ricoh the steps include sending software to the device. Complete the steps according to the device manual or as documented in section 8.3.
3.
Add a SafeCom Push Printer Open SafeCom Port Configurator If you have an existing TCP/IP printer and wish to convert this to a SafeCom Push printer and thus also be able to track documents that are printed directly. Click Close and complete the steps in SafeCom Port Configurator (9.4).
D60603-07
133
5 SafeCom Administrator
5.3.2
Change password
1. 2. 3. On the Users menu, click Change password. Enter your Old password and New password and Confirm new password. Click OK.
The password can also be changed in the User properties dialog (5.8.4).
5.3.3
Test server
1. 2. On the Actions menu, click Test server Enter the Server address (IP address or hostname) and click Test.
The connection can also be tested in the Server properties dialog (5.7.1) and by right-clicking a SafeCom server and click Test server The Loop check box and Server address are only present when the Test server dialog is opened from the Actions menu.
D60603-07
134
5 SafeCom Administrator
5.3.4
Users
INS DEL ALT+ENTER 7.15 F5 DEL ALT+ENTER F5 INS DEL 5.3.2 5.8 8.3 8.8 8.9 8.9 8.11 8.12 8.10 9.11
Devices
ALT+ENTER
5.9
D60603-07
135
5 SafeCom Administrator
Servers
Refresh Add server Delete server License Branches Add branch Delete branch Branch properties Organizational units Add org. unit Delete org. unit Org. unit properties Rule Based Printing Client Billing Billing codes Import billing codes Schedule billing code import Tracking data Export tracking data Import tracking data codes Statistics Event log Server properties
View
SafeCom Assistant Toolbars Users Devices Servers Charging schemes Search Tools View server group info Expand server view at login All Branches Groups Servers Account status Cash flow report Money loader log SafeCom online About
5.3.1
5.10.5
Cashier
Help
D60603-07
136
5 SafeCom Administrator
5.3.5
5.3.6
User icons
Standard user Default user Locked user (login prevented) User with no defined home server User has been moved to a failover server Technician Cashier user (requires SafeCom Pay) Administrator Administrator with limited rights
5.3.7
Device icons
Printer with SafeCom Controller MFP with SafeCom Go Canon (internal) MFP with SafeCom Go HP (internal) Printer with SafeCom P:Go HP(internal) MFP with SafeCom Go High-end HP (internal) MFP with SafeCom Go Lexmark (internal) Printer with SafeCom P:Go Lexmark (internal) MFP with SafeCom Go Ricoh (internal) Printer with SafeCom P:Go Ricoh (internal) Printer with SafeCom Go Xerox or Sharp (embedded) Push Printer Device with no defined home server Device not registered in the SafeCom solution
D60603-07
137
5 SafeCom Administrator
5.3.8
Document icons
Document Retained document Group printed document Retained group printed document Print once group printed document
5.3.9
Other icons
Branches (top level) Branch Computer in branch Groups (top level) Group Organizational units (top level) Org. unit Servers (top level) Standard charging scheme (requires SafeCom Tracking) Default charging scheme (requires SafeCom Tracking)
D60603-07
138
5 SafeCom Administrator
5.4
System overview
Click the server group to open System overview, which provides easy access to system information, manuals, updates and common tasks.
5.4.1
Manuals
List the relevant manuals. Click the manual title to open it in Adobe Reader. Click the Manuals arrow icon to configure the manuals of interest. SafeCom G3 Administrators Manual D60603 (this manual) is the initially listed manual. Relevant SafeCom Go Administrators Manuals and others are added to the list as you use the SafeCom Assistant (5.3.1).
5.4.2
Users
Show the total number of users (initially two). Click the Users arrow icon to open the list of users on the master server. Default user shows the user logon of the defined default user (7.2). Click the user logon to open the User properties dialog. Click User import to open the Scheduled user import dialog (7.3). The date and time of the next scheduled user import is shown.
D60603-07
139
5 SafeCom Administrator
5.4.3
Devices
Show the total number of devices. Click the Devices arrow icon to open the list of devices on the master server. Default charging scheme 1 and Default charging scheme 2. Click the respective names to open the Charging scheme dialog (9.11). Click Add device (8.3) to configure and register the device on the SafeCom master server. This function is not available in a multi server solution, as you would normally have devices registered on the slaves. Refer to 8.3. Click Windows Add Printer Wizard to open this. Click SafeCom Port Configurator to open this (9.4).
5.4.4
Servers
Servers show information about the master (and slave) servers. Click the Servers arrow icon to open the list of servers. Click the License arrow icon to open the License dialog (5.5).
5.4.5
5.4.6
5.4.7
Save-o-meter
Save-o-meter is using the default primary charging scheme. If there is no default primary charging scheme or it is empty (all values are zero), then it will use the sheet count and ignore the information about impressions. Example: Saved 10 sheets, Consumed 90 sheets, Savings: 10% For the Save-o-meter to work you must check Track deleted print jobs on the Tracking tab in the Server properties dialog (5.7.5).
D60603-07
140
5 SafeCom Administrator
5.5
License
The License dialog can be accessed from the Servers menu. The License dialog shows the number of licensed server features, devices and device features and it allows you to install license upgrades in the form of a key code. More information about license key codes is available in 4.9.
Enter your key code in Enter key code and click Apply. Current key displays the license key code currently used by the SafeCom server. Listing features displays the features activated by the current license key code. Refer to section 8.4.2 to see how the Find devices function can be used to see which device is using which device license.
D60603-07
141
5 SafeCom Administrator
5.6
Click Search to search for server groups. Search result is shown in the dialog. Click Test to test the connection.
D60603-07
142
5 SafeCom Administrator
5.7
Server properties
The Server properties dialog can be accessed from the Servers menu, the Server tool button and by right-clicking the server in the Server groups pane. The dialog comprises the tabs: Server (5.7.1) Users (5.7.2) Devices (5.7.3) E-mail (5.7.4) Failover (6.7) Tracking (5.7.5 and 9.9.1) Billing (5.7.6 and 11.4) Encryption (5.7.7)
5.7.1
Server
Server group is the name of the server group. Computer name must match the computer name of the SafeCom server. Refer to 4.9.1. D60603-07 143
5 SafeCom Administrator
Org. unit is the organizational unit the SafeCom server belongs to (5.12). Server address is the address of the SafeCom server. Click Test server to test the connection (5.3.3). Check Write event to Windows event log (5.15) if you wish to be able to use the Window Event Viewer to view event log messages from the SafeCom solution. Database integrity check verifies the consistency between document references in the SafeCom database and executes the delete document functionality. The check can take place on selected weekdays (Monday, Tuesday, , Sunday) at a specific time or at a regular predefined intervals starting at a specific time. The available intervals are every 10, 20, or 30 minutes, or every 1, 2, 3, 4, 6, 8 and 12 hours. Every 2 hours on all weekdays is default. Check Delete print jobs after to keep the print in the SafeCom solution for the specified number of day(s), hour(s) and min(s). The default is 1 day.
D60603-07
144
5 SafeCom Administrator
5.7.2
Users
In Automation you can choose to Create users at first print (7.4). This means that a new user account is created in the database the first time the new user prints with the SafeCom solution. Check Same ID code as User logon if the newly created user is to login at the device by entering his user logon (JS). Check Generate PUK on Pull print if the PUK code should be generated on Pull print. The PUK code can be e-mailed (5.7.4). Check Create e-mail addresses with domain to combine the user logon (JS) and the E-mail domain (safecom.eu) into the users valid e-mail address ([email protected]). Check Release credits reserved on error to give back users reserved credits if an error occurs. This is only relevant if SafeCom Pay (12.2.2) is used.
D60603-07
145
5 SafeCom Administrator
In Security you can specify Max login attempts to control the number of times the user can try to log on with an invalid PIN code, before the account is locked. The default is 3 times. The Administrator can unlock a locked user account by clearing Prevent login on the Identification tab in the User properties dialog (5.8.1). Note: The max login attempts do not apply to users with Administrator rights. Check Allow users to change PIN code to allow users to change their PIN code through the SafeCom G3 Web Interface and SafeCom-enabled devices (restrictions may apply). You should not check this if you wish to manage PIN codes centrally. In IDs you can specify the Max IDs per user. By default there is one ID per user. The IDs control is not present in the Server properties dialog of SafeCom slave servers. In Default settings it shows if a default user is defined (7.2). If there is a default user you can choose to Keep default user and use settings when creating new users. You can select the Default user by right-clicking a user with Standard rights in the list of users. In the list of user the default user is shown with a cross: Initial account 2 is only relevant if SafeCom Pay (12.2.2) is used.
D60603-07
146
5 SafeCom Administrator
5.7.3
Devices
As discussed in 3.5.7 Document fidelity is determined by comparing the name of the printer driver embedded in the print job with the list of driver names returned by the SafeCom Controller or SafeCom Go. You may choose among the following options: No fidelity check All the users documents can be collected at the device. Show fidelity warning All the users documents can be collected at the device. If a SafeCom Front-end is used a warning dialog will appear whenever the user attempts to print a document that was generated with a driver that is not included on the SafeCom Controllers list of driver names. Filter document list Only those of the users documents with a matching driver name can be collected at the device.
D60603-07
147
5 SafeCom Administrator
Touch tone controls if touching the touch-screen should cause a beep sound. The change takes effect the next time someone login at the SafeCom Frontend. It also applies to selected SafeCom ID devices. The SafeCom Front-end will still use two beeps to indicate a card read error and one beep 10 seconds prior to automatic logout.
5.7.4
SMTP mail server shows the hostname or the IP address of the mail server that is used to send outgoing mails. Port is 25 by default. Reply address is used by the SafeCom auto-mailer when sending e-mails. Some mail servers require a valid reply address in order to deliver the mail. The default [email protected] satisfies this syntax check. E-mail address is the address at which the administrator of the SafeCom solution will receive optional messages: Event and Credits reserved notification. Receiving these messages enables the administrator to be proactive in respect to potential problems. The message could for example
D60603-07
148
5 SafeCom Administrator
inform the administrator, that a trial license is about to expire in a couple of days. The administrator can also look in the Event log (5.15). If you check E-mail PUK code when generated the PUK code is automatically sent to the user via e-mail using the template EmailPUK.txt (5.7.8). The PUK code can be generated in the following ways: If Generate PUK on Pull print is checked on the Users tab in the Server properties dialog (5.7.2). When generating a PUK code on the ID code tab in the User properties dialog (5.8.3). When importing users and Generate PUK is checked in the step (7.3). Note: No e-mail is sent if the PUK is generated from the SafeCom G3 Web Interface. If you check E-mail welcome message to new users a welcome message is automatically sent to the user via e-mail using the template EmailWelcome.txt (5.7.8). If you check E-mail job deletion note to author of job the author will receive an e-mail when a document has been deleted. See EmailJobDelete.txt in 5.7.8. In E-mail delete warning to: you can check Author of job and/or Recipients of job. If checked an e-mail warning is sent the specified length of time prior to deletion. See EmailWarning.txt 5.7.8.
D60603-07
149
5 SafeCom Administrator
5.7.5
Tracking
Check Track deleted print jobs to have the SafeCom solution track deleted jobs and to see the effect in the Save-o-meter (5.4.7). Check Allow money server to be unavailable if you want pay users to be able to print and login to devices even if it is not possible to charge the user for the jobs produced by the user. Check Allow tracking server to be unavailable if you want tracking users to be able to print and login to devices even if it is not possible to track the jobs produced by the user. The tracking server can only be allowed unavailable if the money server is allowed unavailable.
D60603-07
150
5 SafeCom Administrator
How it works: A severity 2 event (error) is created in the SafeCom event log (5.15) when the first pay user login while the money server is unavailable. The user is treated as a tracking user. If the tracking server is unavailable the user is treated as a no cost user.
A severity 5 event (information) is created in the SafeCom event log (5.15) when the first user login and the servers are available again. In a multi server solution the Tracking tab looks different on the master server (9.9.1) and the slave server (9.9.2).
5.7.6
Billing
Check Store tracking data temporarily to allow users to apply billing codes. Chose the number period you want to elapse before the billing data is committed and when the billing data should be moved to the tracking data. Refer to section 11.4 for additional information.
D60603-07
151
5 SafeCom Administrator
5.7.7
Encryption
All control data that is exchanged using the SafeCom protocol is encrypted according to the choice of cipher. This includes login requests with user details such as user logon, card numbers, PIN codes and passwords. Other data that is encrypted include List of documents, tracking data, event log information etc. Asymmetric. RSA is used for asymmetric encryption and for exchange of the symmetric keys. RSA is a very slow encryption algorithm and is not suited to encrypt and decrypt bulk data efficiently. The default is RSA 512-bit encryption. Symmetric. Encryption of bulk data is done using more efficient algorithms, either AES (Rijndael algorithm) or TwoFish, a proposal by NIST (National Institute of Standards and Technology) for an Advanced Encryption Standard. The default is AES 128-bit encryption.
D60603-07
152
5 SafeCom Administrator
Pending documents are always encrypted using 128-bit encryption. Pull print data is always encrypted on the network while travelling to the server. Pull print data travelling to a device is encrypted if:
Encrypt documents is enabled for the user (5.8.2). Encryption is enabled for the device (5.9.3). By default any client will try to honor the encryption method and size that has been specified on the server. Clients include the SafeCom Print Client, SafeCom Pull Port, SafeCom Push Port, SafeCom Administrator, SafeCom Reports, SafeCom Web Interface and SafeCom Go devices. The SafeCom Go devices will take the processing power and memory of the device into consideration. This means that in most cases no additional configuration steps are required on the device. Refer to the relevant SafeCom Go Administrators Manual for additional information. The choice of encryption on the server take effect once the SafeCom Service has been restarted on the server. When a slave server is added it will by default get the same encryption settings as that of the master server.
D60603-07
153
5 SafeCom Administrator
5.7.8
The files are located in the %SafeCom%\Templates folder, normally C:\Program Files\ SafeCom\SafeComG3\Templates On Windows 64-bit: C:\Program Files (x86)\ SafeCom\SafeComG3\Templates The E-mail templates: EmailWelcome.txt Send welcome message to new user if E-mail welcome message to new users is checked on the E-mail tab in the Server properties dialog (5.7.4). EmailPUK.txt Send PUK code to user if E-mail PUK code when generated is checked on the E-mail tab in the Server properties dialog (5.7.4). EmailCode.txt Send code to user if the EmailCode.txt file is located in the SafeCom installation folder. The E-mail is sent if the code is added in SafeCom Administrator, through APIs or via an import. If the user gets for example two codes during an import, then the user will receive two e-mails, one with each code. EmailJobDelete.txt Send note to author about document that has been deleted if E-mail job deletion note to author of job is checked on the E-mail tab in the Server properties dialog (5.7.4). EmailWarning.txt Send warning to author and/or recipients about document to be deleted if E-mail delete warning is checked on the E-mail tab in the Server properties dialog (5.7.4).
D60603-07
154
5 SafeCom Administrator
In the EmailWelcome.txt and EmailPUK.txt file it is possible to use the tags: <%ACCOUNTINGMODEL="No|Tracking|Pay For Print"%> <%CREDITS%> <%ENCRYPTION="No|Yes"%> <%GROUPNAME%> <%LOGINWITHOUTPIN="No|Yes"%> <%PIN%> <%PRINTALL="No|Yes"%> <%PUK%> EmailWelcome.txt <%SUBJECT="Welcome to SafeCom"%> Dear <%USER%>, You have been added as a user to the SafeCom solution. You are about to experience the patented SafeCom Pull Print technology. It gives you the freedom to collect your documents at any SafeCom-enabled printer when it suites you. When you print via SafeCom uncollected documents are deleted after <%JOBDELETEDAYS%> day(s), <%JOBDELETEHOURS%> hour(s) and <%JOBDELETEMINUTES%> min(s). www.safecom.eu EmailPUK.txt <%SUBJECT="SafeCom PUK code"%> Dear <%USER%>, Your PUK code is: <%PUK%> When you present the card at a SafeCom-enabled printer you will be prompted for the above PUK code. Write down the PUK code and bring it with you so you can enter it when you are at the printer. Once you have entered the PUK code, you do not need the PUK code any longer. www.safecom.eu EmailCode.txt <%SUBJECT="SafeCom user code"%> Dear <%USER%>, You have been granted the following user code: <%CardNo%> To login at the SafeCom-enable printer you can enter the above code.
www.safecom.eu
D60603-07
155
5 SafeCom Administrator
EmailWarning.txt <%SUBJECT="[SafeCom] Delete warning"%> This mail is to inform you that your document: <%DOCUMENTNAME%> submitted on <%SUBMITDATE%> <%SUBMITTIME%> will be deleted on <%DELETEDATE%> <%DELETETIME%> <%USERLIST TEXT="Document has not yet been collected by:"%> www.safecom.eu EmailJobDelete.txt <%SUBJECT="[SafeCom] Document deleted"%> This mail is to inform you that your document: <%DOCUMENTNAME%> submitted on <%SUBMITDATE%> <%SUBMITTIME%> has been deleted. <%USERLIST TEXT="Document was not collected by:"%> www.safecom.eu
D60603-07
156
5 SafeCom Administrator
5.8
User properties
The User properties dialog can be accessed from the Users menu, the User tool button and by right-clicking a user in the Users list. The dialog comprises the tabs: Identification (5.8.1) Settings (5.8.2) ID code (5.8.3) Rights (5.8.4) Member of (5.8.5) Aliases (5.8.6) Account (5.8.7)
5.8.1
Identification
D60603-07
157
5 SafeCom Administrator
User logon is normally identical to the users Windows logon. The user logon is mandatory, maximum 20 characters and must be unique in regards to other user logons, user aliases and group names. ID is the database ID. Full name is the users name. Home server is the SafeCom server the user belongs to. Only present if SafeCom Multi Server Support is enabled. Org. unit is the organizational unit the user belongs to (5.12). E-mail is the users e-mail address. The SafeCom solution can use the e-mail address to send welcome message and PUK code message. Description can be used to enter a description of the user. Cost code can be used to enter a cost code of the user. The Credits section is only relevant if the Cost control is set to Pay on the Settings tab. Logins failed shows the number of consecutive failed login attempts for the user. Click Clear to set the number to zero. If this number reaches the Max login attempts specified on Users tab of the Server properties dialog, the user is prevented from printing (Prevent login is checked). If you check Prevent login, the user is unable to login at the device. A user that is prevented from printing is shown as in the User list. Clearing Prevent login will automatically set Logins failed to zero. Check Login without PIN code if the user needs to enter a 4-digit PIN code at the device (restrictions may apply). Source ID indicates from which source the user was imported. A value of zero indicates that the user was manually created.
D60603-07
158
5 SafeCom Administrator
5.8.2
Settings
For additional information about Bill clients for cost refer to chapter 11 SafeCom Client Billing. Encrypt documents is only relevant if encryption of document is indeed possible (4.15). Allow retain documents shows if the user is allowed to keep documents on the server so they can be printed multiple times. Print all at login shows if all the users documents should be printed as soon as the user login at the device. Documents are printed in chronological order (oldest first). For additional information about Cost control refer to chapter 9 SafeCom Tracking and 12 SafeCom Pay.
D60603-07
159
5 SafeCom Administrator
5.8.3
ID code
By default there is one ID (card or user code) per user. The maximum IDs per user can be specified on the Users tab in the Server properties dialog (5.7.2) of the SafeCom master server. Enter the ID code and click Add. A warning appears when the maximum number of IDs per user is reached. Check Temporary ID if the ID is to be valid for a restricted period. Expired IDs are deleted from the SafeCom solution automatically within 10 minutes. Choose from the popular dates: Today, Today and tomorrow, This week (End date is the coming Sunday at midnight), This month (End date is the last day of the month at midnight) or Specify dates. Choose Specify dates and specify the Start date, End date and Time. Click the calendar icon to open Choose date dialog for easy date selection. Click Listen for ID if a card reader is installed on the computer (4.18).
D60603-07
160
5 SafeCom Administrator
In ID codes the available codes are listed. Start date and End date appear only if Temporary ID was checked when the ID was added. The Source ID indicates from which source the ID was imported. A value of zero indicates that the ID was manually added. Select an ID code and click one of the buttons:
Copy ID code
Modify ID code
Delete ID code
The user can have one PUK code open at a time. The generation of PUK code happens irrespective if you subsequently click Cancel to exit the User properties dialog. The behavior of the Generate PUK button depends on the following: Single ID per user (default) Generating a new PUK code will delete the PIN code and remove any current association with an ID. Multiple IDs per user Generating a new PUK code is possible until the maximum number of IDs has been reached. Otherwise one of the existing IDs must be deleted before a new PUK code can be generated.
PIN code contains the 4-digit PIN code. If a PIN code is assigned when the dialog is opened the field contains ****. Click Random to assign and display a randomly generated PIN code. Click Default to assign and display the default PIN code 1234. Changing the PIN code will automatically clear Prevent login and reset Logins failed to zero on the Identification tab in the User properties dialog. The user has one and only one PIN code.
D60603-07
161
5 SafeCom Administrator
If no PIN code is specified, but only a code, the user is assigned the default PIN code when OK is clicked in the User properties dialog. If allowed (5.7.2) the user may subsequently change the PIN code at the SafeCom G3 Web Interface or at the SafeCom-enabled device (restrictions may apply).
5.8.4
Rights
A standard user can have any server as their home server, whereas users with other rights MUST have the master server as their home server. If you click Technician, the user is given Technician rights, allowing the user to install SafeCom devices. Devices are operable and can be used for Pull Printing once a user with Technician or Administrator rights has logged in at the device. In a SafeCom Pay solution the Technicians (or Administrators) Cost control setting should be set to No control or Tracking because choosing Pay will prevent him from registering SafeCom devices at the device. If you click Cashier user (Requires SafeCom Pay), the user is given Cashier rights, allowing the user to use SafeCom Administrator in Cashier mode. When Administrator, Technician or Cashier user is clicked, two additional password fields are displayed in the dialog: Password If you do not have a password or if you want to change your existent password, enter the new password (of your own choice) here. Confirm Password Re-enter the new password.
D60603-07
162
5 SafeCom Administrator
If you click Administrator, the user is given Administrator rights, allowing the user to modify users, modify devices, group and server. User rights The Full rights allow you to add, modify and delete users. With All rights except export it is possible to do everything except that card data and PUK codes are not included in the export of user data. With Limited rights it is possible to only assign new Code, PIN code and PUK code. You can also clear Logins failed and Prevent login. It is otherwise not possible to add, modify and delete users. Typically you would give Help Desk personnel this type of limited Administrator rights. Device rights The Full rights allow you to add, modify and delete devices. Server rights The Full rights allow you to add, modify and delete servers. Report rights The Full rights allow you to login to SafeCom Reports (9.13).
D60603-07
163
5 SafeCom Administrator
5.8.5
Member of
D60603-07
164
5 SafeCom Administrator
5.8.6
Aliases
As the SafeCom solution supports printing from multiple client operating systems and users often do not have the same user logon on all systems, it is possible to use the aliases mapping feature of the SafeCom solution to allow a user to get his documents into the same SafeCom account from all systems.
Enter the Alias and click Add. To delete an alias, select the alias and click Delete. The alias must be unique in regards to other user aliases, user logons and group names. 20 characters is the maximum length of an alias. Any number of aliases can be entered. In the Aliases overview dialog (7.10) it is possible to see which alias is mapped to which user.
D60603-07
165
5 SafeCom Administrator
5.8.7
Account
Account 1 shows the current amount of money available with the user. Account 2 shows the current available quota available for the user. Low limit is the lowest amount that should be available in order to print (Allows negative figures). Click to edit the Low limit. Reserved is the amount of credits reserved due to a print or copy job that finished in error. It should be 0.00 (zero) most of the time. If the system has reserved any credits you will see a positive amount printed in red color. Click to edit the Reserved. The amount must be greater than 0.00 (zero) and less than or equal to the currently reserved amount of credits. Disposable is equal to Balance minus Low limit and Reserved. Amount indicates the amount to Deposit (insert) on or Subtract (withdraw) from the account. Click Record to make the transaction take place. Comment allows you to add any description (optional).
D60603-07
166
5 SafeCom Administrator
5.9
Device properties
The Device properties dialog can be accessed from the Devices menu, the Device tool button and by right-clicking a device in the Devices list. The dialog comprises the tabs: Settings, Charging scheme and License. Each tab is described subsequently.
5.9.1
Settings
Name is a field for specifying a name for the device (mandatory). Model is a field for specifying the model and/or manufacturer of the device (optional). Home server is the SafeCom server the device belongs to. Only present if SafeCom Multi Server Support is enabled. Org. unit is the organizational unit the device belongs to (5.12). Only present of there are any defined organizational units. Branch is the branch the device belongs to (5.11). Only present if there are any defined branches.
D60603-07
167
5 SafeCom Administrator
Location is a field for indicating the place where the device is physically located (optional). Device address is the hostname or IP address of the device. Capabilities show a number of checkboxes depending on the device and SafeCom license key code. The list of checkboxes includes: Duplex supported, Color supported, Restricted access, Allow Pay user (only available if the server key license allows one or more Pay devices) and Push print. Restricted access can be used to control users access to the device based the organizational relationship (5.12). Click Open in browser if you want to access the devices web interface (8.12). Click Update software to update the software of the device (8.9).
5.9.2
Charging scheme
On the Charging scheme tab in the Device properties dialog it is possible to choose which charging schemes should be used on the device in question.
D60603-07
168
5 SafeCom Administrator
5.9.3
License
On the License tab in the Device properties dialog it is possible to choose which SafeCom features should be enabled on the device in question.
The checked features are only accepted if the license key code allows the device features. Click License to open the License dialog (5.5) to see if the license key code allows the additional features to be enabled for this device.
D60603-07
169
5 SafeCom Administrator
5.9.4
Statistics
On the Statistics tab in the Device properties dialog it is possible to a Textual and Graphical representation of the statistics. The Statistics tab is not presented if you have opened multiple devices.
D60603-07
170
5 SafeCom Administrator
5.10
Options dialog
The Options dialog can be accessed from the Actions menu. The dialog comprises the tabs: General, Card reader, Network and Maintenance. Each tab is described subsequently.
5.10.1 General
Check Remember desktop layout if you want to remember the position and size of SafeCom Administrator when you exit. The next time you start SafeCom Administrator it will appear the same as when you exited. Click Forget now to reset the desktop layout.
D60603-07
171
5 SafeCom Administrator
D60603-07
172
5 SafeCom Administrator
Serial card reader: 1. 2. 3. Choose a Reader type from the drop-down list: None, Generic, Magnetic, Adazzi, HID, Legic and Mifare. Click Support to see the latest list of supported card readers on our web site. Choose a COM port from the drop-down list: COM1, COM2 and COM3. Click Test and use the card to test if reading is possible. If it fails you may need to move the card reader to another COM port.
If your card reader does not match any of the listed reader types you should select Generic and find the correct combination of Baud rate: 4800, 9600, 14400, 19200, 28800, 38400, Bits: 7 or 8 and Parity: No, Even and Odd. Listen timeout can be 10, 20, 30, 40, 50 and 60 seconds. Listen time out determines the maximum number of seconds that may parse from you click Listen for ID on the ID code tab in the Users properties dialog (5.8.3) and until you use the card with the card reader.
D60603-07
173
5 SafeCom Administrator
5.10.3 Network
In Logout if inactive for you can change the automatic logout time. If no activity has been registered in the SafeCom Administrator for the number of minutes shown, all open connections are closed. The default is 15 minutes and the maximum value is 99 minutes. Broadcast timeout is the time in seconds the SafeCom Administrator will search for SafeCom servers and devices on the network. Default is 10 seconds. Transaction timeout is the time in seconds the SafeCom Administrator will maximum wait for a SafeCom server to respond. We recommend that this be only increased in large installations with thousands of users. Default is 60 seconds. Broadcast addresses show the list of network masks for all TCP/IP networks containing SafeCom servers and devices. You must configure this list correctly for the SafeCom Administrator to be able to locate all SafeCom servers and broadcast for SafeCom devices. Note: It is recommended to replace 255.255.255.255 with a list of individual masks, as broadcasting may otherwise not work. If access to the Internet requires use of a Proxy the Check for updates (5.4.6) cannot connect to the SafeCom Update Server to check for new updates of manuals, device software and release notes. Specify the IP address, Port (default 2121) and Type (default FTP) of connection the proxy server is using.
D60603-07
174
5 SafeCom Administrator
5.10.4 Maintenance
In a Pay solution you may wish to delete transaction records older than a certain date. Specify the exact Date or select a date from the drop down list, that includes the selections: 1 month, 2 months, , 11 months, 1 year, 2 years, , 5 years. Check Backup database to have a backup created of the scpurse database before deletion. The users most recent transaction is not deleted. Click Clean up.
D60603-07
175
5 SafeCom Administrator
The Server group info dialog will update its content whenever you select another server and you are not required to login to the server. You can anchor the Server group info dialog to the bottom of the Server groups pane by dragging it to the bottom left corner of the SafeCom Administrator.
D60603-07
176
5 SafeCom Administrator
5.11
Branches
In SafeCom Administrator it is possible to define branches and associate devices and computers to these. This is used to ensure that devices within the branch allow collection of documents only that reside on the computers that belong to the same branch. The table below reflects when printing is possible. Computer belongs to No branch Yes Yes Computer is added to Branch A Yes Computer is added to Branch B Computer belongs to Branch A Yes Yes No Computer belongs to Branch B Yes No Yes
In this context the term computer denotes a computer that is running the SafeCom Client Print software where documents reside on the computers local hard disk drive rather than on a SafeCom server. The maximum number of branches, computer, users and devices is virtually unlimited, but of course subject to the limitations imposed by the size of the database.
1. 2. 3.
4.
Click the Branches icon in the Server groups pane to expand the list of defined branches (in alphabetic order). Two panes appear to the right. The top pane is the Devices pane. The bottom pane is the Computers pane. In the Devices pane click Refresh to retrieve an updated list from the database of all the devices that have not been added to a branch. Rightclick the device and click Properties to open the Device properties dialog (5.9.1). In the Computers pane click Refresh to retrieve an updated list from the database of all the computers that have not been added to a branch. Right-click the computer and click Properties to open the Computer properties dialog (5.11.6).
D60603-07
177
5 SafeCom Administrator
1. 2.
Enter the Name of the branch and an optional Description. Click OK. ID is the database ID of the branch. To associate devices and computers to a branch you can drag and drop these between the branches. Alternatively you can select the branch from the Branch drop down list in the Device properties dialog (5.9) or the Computer properties dialog (5.11.6).
Note: A Branch can only be deleted if no device and computers reference it.
D60603-07
178
5 SafeCom Administrator
D60603-07
179
5 SafeCom Administrator
Computer name is the hostname (FQDN) of the computer. IP address holds the IP address the computer had the last time it was started. Notes hold optional notes that have been entered by the administrator. Branch is the branch the device belongs to. Only present if there are any defined branches. Description holds the description of the computer. Version is the version of the SafeCom Branch software running on the computer. ID is the database ID of the computer. Note: The computer is listed in the SafeCom database by its GUID (globally unique identifier). The Computer name, IP address and Description fields are not editable once the computer has been added. These properties are automatically updated when the SafeCom Branch software is started on the computer. Note: Tracking data is reported to the Home Server of the user printing. The computer has no Home Server itself.
D60603-07
180
5 SafeCom Administrator
D60603-07
181
5 SafeCom Administrator
5.12
Organizational units
With the concept of organizational units you can use SafeCom Administrator to visualize the organizational / departmental relations between users, devices and servers in your SafeCom solution.
There is a strong resemblance between the organizational unit concept and the folder structure on a computer and many of the same rules apply. The organizational path can be up to 255 characters long. The organizational relationship can be used to restrict users access to devices. Refer to 5.12.3.
D60603-07
182
5 SafeCom Administrator
1. 2.
Enter the Name of the organizational unit and an optional Description. Click OK. ID is the database ID of the organizational unit. This corresponds to UserNodeID in tracking records. To associate resources (users, devices and servers) to an organizational unit you can drag and drop these between the organizational units. Alternatively you can select the organizational unit from the Org. unit drop down list in the resources properties dialog.
New users, devices and servers are always created at the root. The relationship to an organizational unit must be done manually using drag and drop. Users, devices and servers can be assigned to one and only one organizational unit.
Note: Organizational units can only be deleted if no user, device, server and organizational unit reference them.
D60603-07
183
5 SafeCom Administrator
Examples: Devices with restricted access in Dept A1 can be used by all users in Dept A1. Devices with restricted access in Dept A can be used by all users in Dept A, Dept A1 and Dept A2. Devices without restricted access in Dept A1 can be used by all users. Devices without restricted access in Dept A can be used by all users.
How it works: The user is not logged in if Restricted access is checked on the Device properties dialog (5.9.1) and the user does not have the device on his organizational path. The user may see the message Restricted Access on the SafeCom Front-end or the devices control panel if a SafeCom Go product is used.
D60603-07
184
5 SafeCom Administrator
5.13
Groups
With the concept of groups you can use SafeCom Administrator to organize users into groups. Information about groups can be imported from and synchronized with Active Directory (7.3.13). However, it is also manually possible to add groups (5.13.1), delete groups (5.13.3) and add members to groups (5.13.4). It is even possible to print to groups (5.13.7).
1. 2.
Enter a Name and an optional Description. Click Add. The name must be unique in regards to other groups, user logons and user aliases. Click Close when finished adding groups.
D60603-07
185
5 SafeCom Administrator
The Group properties dialog includes these menus: General On the General menu you can change the Name and Description of the group and allow Group print (5.13.7). Rules On the Rules menu you can select the rules to be used by the group. For additional information about rules please refer to Chapter 10. Members On the Members menu you select which users are a member of the group (5.13.4). Credit schedule On the Credit schedule menu you can add and subtract credits on a scheduled basis (12.4).
D60603-07
186
5 SafeCom Administrator
Members can be added in only one of the following two ways: Select Users to add users individually. Check All users to include all users as members. Click Add user to open the Add user dialog to select users individually. Select Org. units to add users by org. unit. Selecting an org. unit will also include the users in the sub units.
Note: Any subsequent import of users and groups (7.3) may override your selections.
D60603-07
187
5 SafeCom Administrator
1. 2. 3. 4. 5.
Enter your find criteria and click Find. The find function is using field based case insensitive free text search. Click Select all or press and hold down CTRL, and then click each user. Check Differences to filter away the users who are already member of the group. Click Add. Click Finish when you are done selecting and adding users to the group. In the Group properties dialog click Apply and then OK.
D60603-07
188
5 SafeCom Administrator
3. 4.
Check the rules you want to be used on the group. Click OK.
D60603-07
189
5 SafeCom Administrator
3. 4. 5.
Check Allow group print. Check Print once to delete the document from all members once one member has collected it. Click OK.
One way of submitting a print job to a group is by printing via a computer that has a SafeCom Pull Port (4.12), which is configured to Show authentication dialog every time printing (4.13.4). When the SafeCom Authentication dialog appears you enter the name of the group and click OK.
D60603-07
190
5 SafeCom Administrator
Note: If there is a user with a User Logon identical to the name of the group the print job goes to the user and not to the members of the group.
D60603-07
191
5 SafeCom Administrator
5.14
Statistics
The SafeCom solution collects statistics every time an integrity check is performed (5.7.1). The Statistics dialog can be accessed from the Servers menu. The Statistics dialog will by default show the number of jobs handled today. Period can be Today, One week or One month. Show can be Jobs, Pages or Size. Click Refresh to update the statistics. Jobs that are deleted by users with Administrator rights are tracked as Jobs deleted by system and not as Jobs deleted by user.
D60603-07
192
5 SafeCom Administrator
5.15
Event log
Event log messages are written to the SafeCom event log database and optionally to the Windows event log if this is enabled in the Server properties dialog (5.7.1). SafeCom event log: The Event log dialog can be accessed from the Servers menu and by rightclicking a SafeCom server. If your SafeCom solution does not quite behave the way you expect you should always look at the event log for a possible explanation. In the event log you will for example find information about license issues. The event log records which user with special rights (Administrator, Technician or Cashier) logged in and performed such tasks as: add, modify or delete of users, devices, servers and charging schemes. These events all get severity 6 (Information) and will NOT be forwarded to the administrator by e-mail. 1. 2. 3. 4. Open the Event log dialog. Select the period. A number of predefined periods are available ranging from Today to 7 days back. Choose Specify period to freely specify the beginning (from) and finish (to) of the period. Click Refresh to view the events for the selected period. Click Save to file to save the events as a CSV file with the fields: EventId, UserId, DateTime, Abstract, Module, Severity and Description.
Windows event log: Provided writing events to the Windows event log is enabled (5.7.1) it is possible to use the Windows Event Viewer to see these and also to use Microsoft Operations Manager (MOM) to monitor SafeCom event alert messages. 1. 2. 3. Open the Control Panel on the computer where the SafeCom server software is installed. Click Administrative Tools. Click Event Viewer. Click SafeCom.
D60603-07
193
5 SafeCom Administrator
Note: Messages are stored on a per server basis (and per node basis in a clustered environment). This implies that Microsoft Operations Manager (MOM) should be setup to monitor all SafeCom servers within the solution and not just the SafeCom master. The table below describes how SafeCom event log messages are mapped to the Windows event log. SafeCom Field EventDateTime Severity Windows Field Date Time Type Comment Date. Example: dd-mm-yyyy Time hh:mm:ss Error - SafeCom Severity 1 and 2 Warning - SafeCom Severity 3 and 4 Information - SafeCom Severity 5 and 6 SafeCom Severity 1 -> Windows EventID 10001 2 -> Windows EventID 10002 3 -> Windows EventID 10003 4 -> Windows EventID 10004 5 -> Windows EventID 10005 6 -> Windows EventID 10006 Description of the event
Event ID
Description
Always SafeCom EventLog Always None Always N/A Computer N/A N/A N/A
D60603-07
194
5 SafeCom Administrator
5.16
Export data
Users that are Administrator in the SafeCom solution and have Full user rights can export data about users, devices and servers in XML or CSV format.
Note: When exporting to a CSV file it is only the first AliasName, CardNo and GroupID that is exported for each user. When exporting to an XML file all Aliases, Cards and Groups with additional details are exported. The XML tags are covered in the tables in the following. The CSV column header is the same as the XML tag. Parameter UserID UserLogon FullName HomeServer EMail Description UserNodeID CostCode LoginsFailed UserLocked AvoidPINCode AllowRetainDocuments EnableBillingDialog PrintAll AccountingModel PUKCode Description Database ID of the user Logon name Full name Home server E-mail address Description Database ID of the organizational unit the user belongs to Cost code Number of failed login attempts Prevent login. Values: Yes | No Login without PIN code. Values: Yes | No Allow retain documents. Values: Yes | No Bill client for costs. Values: Yes | No Print all at login. Values: Yes | No Cost control. Values: NONE | PRINT_AND_PAY | PAY_AND_PRINT PUK code
D60603-07
195
5 SafeCom Administrator
Parameter GroupID GroupName GroupDescription Parameter CardID CardNo SourceID TemporaryCard StartDate StartTime EndDate EndTime Parameter AliasID AliasName
Description Database ID of the group Group name Group description Description Database ID of the card Card number Source ID of the card Temporary card. Values: Yes | No Start date, yyyy-mm-dd Start time, hh:mm:ss End date, yyyy-mm-dd End time, hh:mm:ss Description Database ID of the alias Alias name
The XML tags are covered in the table in the following. The CSV column header is the same as the XML tag. Parameter ServerID ComputerName IPAddress MasterServer Description Database ID of the server Computer name IP address Master server. Values: Yes | No
D60603-07
196
5 SafeCom Administrator
The XML tags are covered in the table in the following. The CSV column header is the same as the XML tag. Parameter DeviceID Name Model Type Version HomeServer Location IPAddress DuplexSupport RestrictedAccess ColorSupport PushPrint PullPrint LicenseTracking LicenseClientBilling LicenseRuleBasedPrinting LicensePay LicensePullPrint LicenseEncryption DeviceMac ChargingSchemeID ChargingSchemeType ChargingSchemeName ChargingSchemeDescription Description Database ID of the device Device name Device model Device type. Values: SafeCom Controller | SafeCom Go <vendor> | SafeCom P:Go <vendor> | SafeCom Go High-end HP Version Home server Location IP address Duplex support. Values: Yes | No Restricted access. Values: Yes | No Color support. Values: Yes | No Push print. Values: Yes | No Pull print. Values: Yes | No Tracking license. Values: Yes | No Client Billing license. Values: Yes | No Rule Based Printing license. Values: Yes | No Pay license. Values: Yes | No Pull Print license. Values: Yes | No Encryption license. Values: Yes | No MAC address Database ID of charging scheme Type of charging scheme. Values: Primary (1) | Secondary (2) Charging scheme name Description of charging scheme
D60603-07
197
6 Manage servers
6
6.1
Manage servers
Introduction
SafeCom servers can be organized into two types of server groups: Single server group One group with one server. Multi server group One group with multiple servers, whereof one is a master server. Requires SafeCom Multi Server Support.
The figure to the right shows how groups and servers appear in the Server groups pane in the SafeCom Administrator. In the figure the server group is named SAFECOM4 and consists of the SafeCom servers: SAFECOM4, and SAFECOM5. The first is the master server.
6.2
6.3
Specify the Server address of the SafeCom server you want to have as master server. Click Search to search for server groups.
D60603-07
198
6 Manage servers
6.4
Removing a server group will merely prevent it from appearing in the Server group pane. The group will reappear if you click Server group and Locate server groups on the Actions menu. Removing a server group will not delete the contained servers.
6.5
Add server
When you are logged into a server group you can add a server to the server group in the following way: 1. 2. 3. 4. 5. On the Servers menu, click Add server. Enter Server address. Click Test Server to verify that the SafeCom server to be added is running. Click Close. Enter Computer name. The computer name should match the Group reported in the Test Server dialog. You can copy and paste the name from the Details tab in the Test Server dialog. Click Add. The server is now being added which may take some minutes. Please be patient. When the Test Server dialog on the added server in SafeCom Administrator reports the Server is running properly the database replication from the SQL master server to the SafeCom recovery slave server have completed. Click Close.
D60603-07
199
6 Manage servers
Refer to the Server properties dialog (5.7) for a description of the fields.
D60603-07
200
6 Manage servers
6.6
Delete server
If the server group contains multiple servers you can delete the servers that are not master server. You must be logged into the server group to delete a server. You can delete a server from the server group in the following way: From the Servers menu click Delete server.
Before you can delete the server the following conditions must be met. Slave server must be running The slave server must be running at the time of deletion because otherwise its reference to the master server cannot be removed from its database. No users must have the server as home server You can verify this in SafeCom Administrator by clicking on the server in question and verify that the Users folder is empty. No devices must have the server as home server You can verify this in SafeCom Administrator by clicking on the server in question and verify that the Devices folder is empty.
Note: All Windows print queues that uses a SafeCom Pull Port to connect to the deleted server will stop working until they have been configured to use another server in the group. To remove the SafeCom Server software from the deleted server you must login to the server and uninstall the SafeCom software (4.2.21).
D60603-07
201
6 Manage servers
6.7
Failover servers
In a SafeCom multi server solution additional resilience can be achieved by specifying a prioritized list of servers that users should be moved to in the event that their home server becomes unavailable. The home server is where the users documents remain until they are either collected or deleted. Prerequisites: The SafeCom master server and the SQL master server are available. Users with special rights are not moved as they always have the SafeCom master server as their home server.
The users home server will automatically be reset to the original once the original home server is available again. To avoid excess network load pending documents are not moved when the users home server change. Users may therefore have to submit their documents for printing again. 1. 2. Open the Server properties dialog (5.7). Click on the Failover tab (only available on slave servers).
D60603-07
202
6 Manage servers
3. 4. 3.
Select a server and use the left arrow and right arrow buttons to add and remove server to and from the list of failover servers. Use the up arrow and down arrow buttons on control the priority of the failover servers. The master server will always have lowest priority. Click Apply to accept the changes.
At the end of section 17.2 there is a table that can be used to plan how servers should failover. How it works: When a server goes down the failover process is initiated after approx. 2 minutes and the users home server reference is changed to the failover server with the highest priority. The change sets in on the affected slaves as soon as the changed home server reference has been replicated from the master SQL server to the databases used by the slaves. The failover triggers a severity 2 event (error) in the SafeCom event log (5.15). The event includes the name of the server that went down and the name of the failover server. When the server comes back the users that originally belonged to it are moved back. The fallback triggers a severity 5 event (information) in the SafeCom event log (5.15). The event includes the name of the server that came back up and the name of the failover server that temporarily acted as home server. Status of servers can be viewed by clicking the Servers icon groups pane. Status can be Running, Down or Master. in the Server
D60603-07
203
6 Manage servers
The TELNET interface (3.10.3) can also be used to view the status of the servers. Once logged in use the TELNET command server info. Below is an example of the server status: ServerId 1 2 3 4 ComputerName SAFECOM4 SAFECOM5 SAFECOM6 SAFECOM7 Ip 172.16.6.164 172.16.6.165 172.16.6.166 172.16.6.167 Status MASTER UP DOWN UP UserMovedTo 4 -
In the above example the slave server SAFECOM6 is unavailable and all the users have been moved to SAFECOM7 (ID 4).
D60603-07
204
7 Manage users
7
7.1
Manage users
Introduction
Section 3.4 described the different options for creating and managing users and chapter 5 SafeCom Administrator presented the dialogs of the SafeCom Administrator. This chapter will chain these together.
7.2
Default user
It is possible to define a default user and let new users inherit the properties of this user. Normally there is one default user that resides on the SafeCom master server (perhaps with user logon DEFAULT for ease of convenience). How to create a default user: 1. 2. 3. 4. On the Users menu, click Add user and enter DEFAULT in User logon. On the Identification tab (5.8.1) and Settings tab (5.8.2) check the desired settings. Click Add. Click Finish. Right-click the DEFAULT user and click Set as default user.
Table 6 User properties inherited from the default user Tab Identification (5.8.1) Settings (5.8.2) User Property Low limit Login without PIN code Encrypt documents Allow retain documents Bill clients for cost Print all at login Cost control (No Control, Tracking and Pay) Factory default 0,00 Yes No Yes No No No Control
Table 7 User properties inherited from other sources Tab User Property Factory default 0,00 1234 Standard user
Identification Initial Account 2 (5.8.1) ID code PIN code (5.8.3) Rights Standard user (5.8.4)
Initial Account 2 is specified on the Users tab in the Server properties dialog (5.7.2). This setting is only relevant if Cost control is Pay.
D60603-07
205
7 Manage users
How to delete a default user: 1. 2. 3. Open the Server properties dialog and click on the Users tab (5.7.2). Clear Keep default user and use settings when creating new users and click OK. Right-click the default user and click Delete user.
In a multi server solution there can be a default user per server. Please read the following to understand how the concept of default user comes into play in different situations: Manually added users (7.5) When users that are added manually via the SafeCom Administrator the User properties dialog is pre-filled according to the settings of the default user defined on the SafeCom server they are added to. If there is no default user factory defaults are used. The home server becomes the one they are added to. Users that are added while the Find users list is open will have the User properties dialog pre-filled according to the default user on the master server. Created users at first print (7.4) Users that are created at first print inherit the settings of the default user defined on the SafeCom master server. If there is no default user factory defaults are used. The home server is set to the SafeCom master server. Imported users (7.3) Users that are imported inherit the settings of the default user defined on the SafeCom master server or the settings of a particular user if this is specified for the scheduled import. If there is no default user factory defaults are used. The home server remains undefined until they get in contact with the SafeCom solution in any of the following three ways: Printing If their first action is to print, their home server will be the one referenced by the SafeCom Pull Port. Login at device If their first action is to login at a SafeCom-enabled device their home server will be the one that is referenced by the SafeComenabled device. SafeCom G3 Web Interface If their first action is to login to the SafeCom G3 Web Interface their home server will be the one referenced by the SafeCom G3 Web Interface (typically the SafeCom master server).
D60603-07
206
7 Manage users
7.3
Import users
It is possible to create multiple user import schedules. This gives great flexibility as exemplified in the following bullets. Run now Any user import can be run momentarily by selecting it and click Run now (7.3.1). That way import can be performed without delay during the initial configuration. Import from multiple sources Import some users from for example Active Directory, other users from a file or perhaps another part of the same Active Directory. The possibilities are endless. Default user per import schedule Select Apply settings from default user or choose that settings should be applied from a particular user. Example: An educational institution imports staff from one part12 of Active Directory and set them to Tracking and imports students from another part of Active Directory and has them inherit the settings of a manually13 created user (DEFAULT_STUDENT) which is set to Pay. User handling Users that are created at first print or added manually in SafeCom Administrator can be deleted by a scheduled import only if they have subsequently been part of that scheduled import and is now missing from that particular and same import. Whenever a user is imported the ID of the import schedule is recorded in the database together with the user. A manually added user initially has Source ID 0. User Logon is unique regardless of Source ID. The function Find user (7.6) allows selection of Source ID as criteria.
12 13
Read about search root and search filter in section 7.3.5. A User Logon that starts with DEFAULT_ make it easier to find the user and keeping the user out of any scheduled import prevents unintentional deletion.
D60603-07
207
7 Manage users
ID handling IDs (cards) that are registered at the device or added manually in SafeCom Administrator can be deleted by a scheduled import only if the card number has subsequently been part of that scheduled import and the user is no longer listed together with the ID code in that particular and same import. Whenever an ID code is imported the ID of the import schedule is recorded in the database together with the ID code. A manually added ID codes initially has Source ID 0. In the ID codes overview dialog (7.11) the Source ID can be seen for each ID code. ID code must be unique regardless of Source ID. If Max IDs per user (5.7.2) is greater than 1 then adding of IDs can happen as long as the user has not reached the maximum number of IDs. Should the user be listed with another ID code in the same and subsequent import the original ID code is replace with the new one.
Secondary and primary source Designating a source as secondary means that it is only meant to modify the settings of existing users, typically ID code or cost code. Normally a source is primary if it used to add, modify and delete users and contains User Logon. The secondary source MUST include a unique identifier that can be used as link to the user in the SafeCom database. It is recommended to use the User Logon as it is unique, but Full Name, E-mail or Description could be used as less attractive alternatives (no guaranteed uniqueness). Example: Users and most of their settings are imported (primary source) from Active Directory and card numbers are imported (secondary source) from a CSV file. In the CSV file the users unique employee number is listed together with the ID code. The employee number is imported from the primary source into the Description field of the user and is subsequently used as the unique identifier to link ID code in the CSV file with the users in the SafeCom database.
D60603-07
208
7 Manage users
7.3.1
Overview
1. 2. 3. On the Users menu, click Import users The User import schedules dialog appears. Click Add and proceed to Server (7.3.2).
D60603-07
209
7 Manage users
4.
If at least one scheduled import is defined you can select it. Click Run now to test the import. Click Edit to proceed to Server (7.3.2). Click Delete to delete the scheduled import. When a schedule is deleted the Source ID of the affected users and ID codes are reset to 0.
D60603-07
210
7 Manage users
5.
D60603-07
211
7 Manage users
7.3.2
Server
1. 2. 3. The SafeCom server properties dialog appears. Enter SafeCom group (hostname or IP address), User logon with Administrator rights and Password. Click Next and proceed to Import source (7.3.3). If you are editing an existing schedule you are to click 8. Schedule to jump directly to the Schedule information dialog (7.3.15) and make changes to the name of the schedule or actual schedule. Note: In a multi server installation you should specify the master server for best performance.
D60603-07
212
7 Manage users
7.3.3
Import source
1. 2. 3. The Select import source dialog appears. Select the source of the user import. Click Next and proceed to the relevant bolded sections: CSV file 1. Overview 2. Server 3. Import source 4. File source 4. Properties 5. Configuration 6. Rules 7. Extra 8. Schedule XML file Active Dir 7.3.1 7.3.2 7.3.3 7.3.5 7.3.10 7.3.13 7.3.14 7.3.15 Novell eDir LDAP
7.3.4 7.3.8
D60603-07
213
7 Manage users
Source type can be Primary (standard) or Secondary. Only select Secondary if the import is meant to modify only the settings of existing users, typically card number or cost code. The secondary source MUST include a unique identifier that can be used as link to the user in the SafeCom database. It is recommended to use the User Logon as it is unique, but Full Name, E-mail or Description could be used as less attractive alternatives (no guaranteed uniqueness).
7.3.4
D60603-07
214
7 Manage users
7.3.5
The import can be secure and happen via SSL (LDAPS) and port 636 by preceding the AD server with LDAPS://. If another port is used it must be specified after the hostname or IP address. Example: LDAPS://myserver.mydomain.com:8010 For the secure import to function the AD server must have Certificates Services installed (7.3.18) and running and the SafeCom Server must trust the certificate from the AD server. Check Search root to import all users from the specified organizational unit and below. Search root example: OU=MyDept,OU=MyCompany,DC=MyDomain,DC=com Check Search filter(7.3.16) to import user objects matching the specified filter. Search filter example: (&(objectClass=user)(sAMAccountName=*))
D60603-07
215
7 Manage users
7.3.6
Check Search root to import users or specify the specified organizational unit and below. Search root example: ou=MyDept,o=MyOrg Check Search filter (7.3.16) to import user objects matching the specified filter. Search filter example: (&(objectClass=user)(Uid=*))
D60603-07
216
7 Manage users
7.3.7
Refer to section 7.3.5 if the import needs to be secure. Check Search root to import users from that organizational unit and below. Search root example AD server: OU=MyDept,OU=MyCompany,DC=MyDomain,DC=com Search root example eDir server: ou=MyDept,o=MyOrg
Check Search filter (7.3.16) to import user objects matching the specified filter. D60603-07 217
7 Manage users
7.3.8
Configuration (CSV)
1. 2. 3. The Specify fields in CSV file dialog appear. Check the configuration options as required (see below). Click Next and proceed to Rules (7.3.13).
Specify from which field in the CSV file the values should be retrieved. Leave a field value of 0 to avoid import. Example CSV file with header and two entries: UserLogon;FullName;Email;IDCode JS;John Smith;[email protected];1232 JD;Jane Doe;[email protected];9856 Native Microsoft Excel files with the extension *.csv cannot be used directly. Please open the file in for example Notepad to ensure that it is a plain text file like the example and to determine what Separator character is used (semi-colon is default). If you check First line in file is a header you will need to specify the name of the field rather than the number. The field name is case insensitive. If Code is being imported and the import consists of magnetic card ID codes select the appropriate conversion method (7.3.19).
D60603-07
218
7 Manage users
In Alias you can specify multiple fields, by separating them by semicolon. Example: Alias1; Alias2; Alias3.
D60603-07
219
7 Manage users
7.3.9
Configuration (XML)
There is no XML configuration dialog. Proceed to Rules (7.3.13). The syntax of the XML file is illustrated by this example: <?xml version="1.0" ?> <UserList> <User> <UserLogon>JS</UserLogon> <FullName>John Smith</FullName> <Description>location 1</Description> <EMail>[email protected]</EMail> <CardNo>1232</CardNo> <PINCode>2222</PINCode> <OrgUnit>\MyCompany\MyDepartment</OrgUnit> <Alias>JSmith</Alias> <CostCode>90678</CostCode> </User> </UserList> Parameter UserLogon FullName Description Email CardNo PINCode OrgUnit Alias CostCode Description The users logon name. Maximum 20 characters. The users full name. Maximum 80 characters. Description field. Maximum 80 characters. The users E-mail address. Maximum 80 characters. The ID code. Maximum 39 characters. Refer to 3.3 The 4-digit PIN code. The organization unit. Alias. Maximum 20 characters. Maximum 10 Alias tags. Cost code. Maximum 50 characters. Remark Mandatory Optional Optional Optional Optional Optional Optional Optional Optional Default value None None None None None 1234 None None None
D60603-07
220
7 Manage users
D60603-07
221
7 Manage users
3.
Check Prevent login if account is disabled in AD if users who are disabled14 in Active Directory should be prevented from logging in to the SafeCom solution (Login denied). In SafeCom Administrator this is reflected by the status of the Prevent login check box on the Identification tab of the User properties dialog (5.8.1). Check Import Description and specify the AD field that holds the description. Check Import Code and specify the AD field that holds the ID code. If the import consists of magnetic card ID code select the appropriate conversion method (7.3.19). Check Import PIN code and specify the AD field that holds the PIN code. Check Import Alias and specify the AD field that holds the alias. You can specify multiple alias fields, by separating them by semicolon. Example: Alias1; Alias2; Alias3. Check Import Cost code and specify the AD field that holds the cost code.
14
The user is considered disabled in Active Directory if the UF_ACCOUNTDISABLE bit is set in the userAccountControl attribute.
D60603-07
222
7 Manage users
These standard AD attributes are used during the import: Microsoft Management Console User logon name Display name Description E-mail Account is locked out Org. unit AD Field name sAMAccountName DisplayName Description Mail userAccountControl distinguishedName SafeCom User logon Full name Description E-mail Prevent login Org. unit Alias Cost code Examples JS John Smith location 1 [email protected] ou=MyDept, ou=MyCompany Jsmith
D60603-07
223
7 Manage users
Check Import Description and specify the eDir field that holds the description. Check Import Code and specify the eDir field that holds the ID code. If the import consists of magnetic card ID code select the appropriate conversion method (7.3.19). Check Import PIN code and specify the eDir field that holds PIN code. Check Import Alias and specify the eDir field that holds alias. You can specify multiple alias fields, by separating them by semicolon. Example: Alias1; Alias2; Alias3. Check Import Cost code and specify the eDir field that holds the cost code.
D60603-07
224
7 Manage users
These Novell eDirectory attributes are used during the import: Novell ConsoleOne Unique ID Full name Department E-mail address dn15 eDir Field name Uid FullName Ou Mail Dn SafeCom User logon Full name Description E-mail Org. unit Alias Cost code Examples JS John Smith location 1 [email protected] ou=MyDept, o=MyOrg Jsmith
15
The organizational unit is extracted from the distinguished name in Novell eDirectory and not held in one particular field.
D60603-07
225
7 Manage users
Check User logon and specify the LDAP field that holds the user logon. Check Full name and specify the LDAP field that holds the full name. Check Description and specify the LDAP field that holds the description. Check E-mail and specify the LDAP field that holds the e-mail address. Check Code and specify the LDAP field that holds the ID code. If the import consists of magnetic card ID codes select the appropriate conversion method (7.3.19). Check PIN code and specify the LDAP field that holds PIN code. Check Org. unit and specify the LDAP field that holds organizational unit information. Check Alias and specify the LDAP field that holds alias. In Alias you can specify multiple fields, by separating them by semicolon. Example: Alias1; Alias2; Alias3. Check Cost code and specify the LDAP field that holds the cost code.
D60603-07
226
7 Manage users
7.3.13 Rules
1. 2. 3. The Rules when importing users dialog appears. Check the rules as required (see below). Click Next and proceed to Extra (7.3.14).
Check Add users to have all users imported. Check Apply settings from default user if you want the newly imported users to inherit the settings of the default user. Check Specify user logon and enter the user logon of the user you wish the new users to inherit settings from. In a multi server installation the default user must have the master server as home server. Check Generate PUK code if you want a PUK code to generated. The PUK code can be e-mailed to users (5.7.4). Generate PUK code is dimmed if ID codes are part of the import. Check Generate PIN code and choose between Default: PIN (1234) and Random PIN. Change Initial amount on account 2 to another value than 0.00 only if the solution involves Pay and the initial amount on the account should have the specified value. See also section 12.4 Credit schedule. Check Modify users will modify the settings of any user that were previously imported through this schedule, that is, the schedule ID of the D60603-07 227
7 Manage users
user matches that of the schedule. Check Delete users to delete any existing users that is now missing from this import, but were previously imported through this schedule, that is, the schedule ID of the user matches that of the schedule. The default user and users with special rights (5.8.4) are not deleted. Use Max user deletion as a safety measure to prevent unintentional deletion of users. A value of 0% will cause the import to take place anyhow. A value of 20% will cancel the import if it would result in a deletion of every fifth or more users that were previously imported through this same scheduled import. Use Max ID code deletion as a safety measure to prevent unintentional deletion of ID codes. A value of 0% will cause the import to take place anyhow. A value of 20% will cancel the import if it would result in a deletion of every fifth or more ID code that were previously imported through this same scheduled import. The import of a user will fail if the users ID code is already registered with another user in the SafeCom solution. To resolve this check If ID code exists delete it from previous user. For this to work you are advised to check Modify users and/or Delete users. During the import users are sorted alphabetically based on their user logon and ID codes are being reused in that order. Details are recorded in the log file. Check Org. units to extract organizational units (5.12). Check Aliases will import alias from the list if fields specified in the Alias field. The following two checkboxes are only present when importing from Active Directory. Check Groups to import group (5.13) information from Active Directory and include it in the import. If you check Synchronize groups it is the information in Active Directory that completely controls which groups a user is member of and any local changes made within the SafeCom solution are lost at the subsequent import from Active Directory. Most of the controls are dimmed when Source type is set to Secondary in the Select import source dialog (7.3.3).
D60603-07
228
7 Manage users
D60603-07
229
7 Manage users
7.3.14 Extra
1. 2. 3. The Advanced extra configuration dialog appears. If a special user import module has been supplied you should check Use extra configuration and enter the configuration according to the supplied instructions. Click Next and proceed to Schedule (7.3.15).
D60603-07
230
7 Manage users
7.3.15 Schedule
1. 2. 4. The Schedule information dialog appears. Check the schedule options as required (see below). Click Finish to save the changes return to Overview (7.3.1) where the scheduled import, including its Source ID, is listed and can be Run now.
Enter a meaningful Name. If you leave it empty it will get populated with the text User schedule (date time). It is possible to schedule imports One time only, Daily, Weekly and Monthly. Check End date and specify a date for when the scheduled import should end. Please ensure that the end date does not conflict with the selected frequency options. Otherwise you may risk that the scheduled import will not run.
D60603-07
231
7 Manage users
A log file with the name <Lyyyymmddhhmmss.log>, where yyyy is the year, mm is the month, dd is the day, hh is the hour, mm is the minutes and ss is the seconds. The log file is stored in the logfiles folder below the SafeCom G3 installation folder. The default folder is: C:\Program Files\ SafeCom\SafeComG3\logfiles On Windows 64-bit: C:\Program Files (x86)\ SafeCom\SafeComG3\logfiles During import you may encounter conflicts because either the UserLogon (cc = 58) or the Card number (cc = 60) already exists. Examples: Not able to add new user. Logon <UserLogon>, cc = 58 Not able to add new user. Logon <UserLogon>, cc = 60 Not able to modify user (modify). Logon <UserLogon>, cc = 58 Not able to modify user (modify). Logon <UserLogon>, cc = 60
If the import includes aliases you may also get these messages either because the specified user does not exist (cc = 54) or the specified alias already exists (cc = 73). Examples: Not able to add new alias. User <UserLogon> Alias <Alias>. cc = 54 Not able to add new alias. User <UserLogon> Alias <Alias>. cc = 73
Provided If ID code exists delete it from previous user (7.3.13) was checked during import there will be an entry in the log file for each reused ID code. Example: 27.11.2008 10:16:15: Duplicate card Card3 removed from user USERC 27.11.2008 10:16:15: Duplicate card Card3 given to user USERD D60603-07 232
7 Manage users
Meaning: Search for objectClass=person AND object=user. The ampersand symbol '&' symbol at the start denotes AND. Alternatively,
(|(objectClass=person)(objectClass=user))
Meaning: Search for objectClass=person OR object=user. The pipe symbol '|' denotes OR. Wildcards
(&(objectClass=user)(cn=*Marketing*))
Meaning: Search for all entries that have objectClass=user AND cn that contains the word Marketing. How to match 3 attributes
(&(&(objectClass=user)(objectClass=top))(objectClass=person))
Notice how to weave one query into another. Matching Components of Distinguished Names You may want to match part of a DN, for instance when you need to look for your users in two sub trees of your server.
(&(objectClass=user)(|(ou:dn:=Copenhagen)(ou:dn:=London)))
Meaning: Find users with an OU component of their DN which is either Copenhagen OR London. Using not To exclude entities which match an expression, use '!'.
(&(objectClass=user)(&(ou:dn:=Copenhagen)(!(ou:dn:=Ballerup))))
Meaning: Find all Copenhagen users except those with a Ballerup OU component. Note the extra parentheses: (!(<expression>))
D60603-07
233
7 Manage users
Note: If a one-time import is to be done the certificate must be installed on the computer from where the SafeCom Administrator is used.
D60603-07
234
7 Manage users
7.4
7.5
Refer to the User properties dialog in 5.8 for a description of the fields.
7.6
Find users
1. 2. Click the Find tool button. Change Search in to Users.
3.
Enter search string in Look for and click Find now. The find function uses case insensitive free text search. Click Retrieve all to display all users regardless of their home server. Click Clear to reset the find function. Or Click Find to open the Find users dialog. Enter your find criteria and click Find. The find function is using field based case insensitive free text search, with the exception of ID codes. To find a particular ID code enter the complete ID code in the right case or click Listen for card if a card reader is installed on the computer (4.18).
4.
D60603-07
235
7 Manage users
7.7
D60603-07
236
7 Manage users
7.8
Press ALT+ENTER or right-click the selected user(s) and select User properties. Make the required changes on the Identification and Settings tab. On the Identification tab (5.8.1) it is possible to edit these properties: Domain, Home server, Org. unit, Description and Cost code. It is possible to 1) click Clear to set the number of failed login attempts to zero, 2) Check or uncheck Prevent login and 3) Check or uncheck Login without PIN code. On the Settings tab (5.8.2) it is possible to edit all properties. On the ID code tab (5.8.3) it is possible to 1) click PUK to generate a new PUK code and 2) click PIN code to assign a default PIN code. The PUK code can be e-mailed to users (5.7.4).
5.
Click OK.
When editing multiple properties the following legend applies: Checkboxes can have three states: Checked, clear and dimmed. If it is dimmed it is because the selected users have difference properties. Fields is shown with a light gray background color and the text N/A in black if the selected users have different properties. Drop down lists is shown with a light gray background and the first element in the list.
7.9
Delete users
In the Users list select the users you wish to delete. You can delete the users in the following ways: Right-click the selected user and select Delete user. On the Users menu, click Delete user. Select the user and press the DEL key.
D60603-07
237
7 Manage users
7.10
List of aliases
1. 2. On the Users menu click Aliases The Aliases overview dialog appears.
Click Copy to copy the selected aliases to the clipboard. Click Save to save the list of aliases to file (7.10.1).
The XML tags are covered in the table in the following. The CSV column header is the same as the XML tag. Parameter UserLogon FullName Alias Description Logon name Full name Alias
D60603-07
238
7 Manage users
7.11
List of ID codes
1. 2. On the Users menu click ID codes The ID codes overview dialog appears. The list of temporary IDs is displayed by default.
3.
Click Make permanent to change selected temporary ID(s) to permanent ID(s). Click Copy to copy the selected ID codes to the clipboard. Click Delete to delete the selected IDs from the user(s). Click Save to save the list of ID codes to file (7.11.1).
D60603-07
239
7 Manage users
3.
7.12
7.13
7.14
D60603-07
240
7 Manage users
7.15
D60603-07
241
8 Manage devices
8
8.1
Manage devices
Introduction
From within SafeCom Administrator it is possible to manage SafeCom devices and do the following: Device license (8.2) Choose licenses for the device. Add device (8.3) Register a device in the database. Find devices (8.4) Search the database for devices. Broadcast for devices (8.5) Broadcast on the network to find SafeCom Controllers and devices with SafeCom Go. Customize the device list view (8.6) Edit the properties of multiple devices (8.7) Delete devices (8.8) Remove a single or multiple devices from the database. Update software (8.9) Load new software to a single or multiple devices. Monitor device status (8.10) See the online status of devices. Enable device status logging for troubleshooting purpose. Restart devices (8.11) Restart a single or multiple devices. Open the devices web interface (8.12) The web interface that can be used for configuration.
D60603-07
242
8 Manage devices
8.2
Device license
On the License tab in the Device properties dialog it is possible to choose which SafeCom features should be enabled on the device in question.
The checked features are only accepted if the license key code allows the device features. Click License to open the License dialog (5.5) to see if the license key code allows the additional features to be enabled for this device.
8.3
Add device
It is possible to add devices in the following ways: Right-click in the Device list and select Add device. On the Devices menu click Add device. Click the Add device tool button. In System overview click Add device (only present on single servers).
You need to know the IP address of the device. Alternatively you may try to Broadcast for the device (8.5).
D60603-07
243
8 Manage devices
1.
The Add device wizard is launched. Enter the Device address (hostname or IP address). Click Next.
D60603-07
244
8 Manage devices
2.
D60603-07
245
8 Manage devices
3.
If you agree with the SafeCom type click Next. Otherwise click [change] to change the SafeCom type.
Select the type of SafeCom device; SafeCom Go (Canon, HP, Lexmark, Ricoh, Sharp, Xerox), SafeCom Controller, or SafeCom tracking device (9). Click Next. If you select SafeCom Go Sharp or SafeCom Go Xerox you are prompted for the IP address or hostname of the MFP connected to the SafeCom Controller. You are also prompted for the user name and password needed to login to the MFP. If you select SafeCom Controller you are prompted for the IP address or hostname of the device connected to the SafeCom Controller.
D60603-07
246
8 Manage devices
4.
On the Settings tab (5.9.1) specify the properties of the device (Duplex supported and Color supported).
5.
D60603-07
247
8 Manage devices
8.4
Find devices
Once a device has been registered you can use the find function in SafeCom Administrator to find it. 1. 2. Click the Find tool button. Change Search in to Devices.
3.
Enter text in Look for and click Find now. The find function uses case insensitive free text search. Click Retrieve all to display all registered devices. Click Broadcast to broadcast for devices. Or Click Find to open the Find devices dialog. The Find devices dialog is available in a Simple (8.4.1) and Advanced (8.4.2) search mode. The latter is very useful if you want to search for devices based on their use of device licenses.
4.
8.4.1
Simple search
The Find devices dialog opens in Simple search mode by default. 1. Enter your find criteria and click Find. The find function is using field based case insensitive free text search.
2.
The search result appears with information about version and online status. Click the column label to sort the result. If you would rather see what license is in use by the different devices you can right-click in the Device list and check Show device license.
D60603-07
248
8 Manage devices
8.4.2
2.
The search result appears with information about what license is in use by the different devices. Click the column label to sort the result.
If you would rather see the version and online status of the devices you can right-click in the Device list and clear Show device license.
D60603-07
249
8 Manage devices
8.5
If a device does not appear it could be because it is powered off, not connected or not reachable because the network setup is not reflected by the list of Broadcast addresses (5.10.3). If the device does not appear refer to troubleshooting (16.4).
8.6
D60603-07
250
8 Manage devices
8.7
Press ALT+ENTER or right-click the selected device(s) and select Device properties. Make the required changes on the Settings and Charging scheme tab. On the Settings tab (5.9.1) it is possible to edit these properties: Model, Home server, Org. unit, Location, Duplex supported, Color supported, Restricted access and Disable Pay for Print. On the Charging scheme tab it is possible to edit all properties. On the License tab (5.9.3) it is possible to edit all properties.
5.
Click OK.
When editing multiple properties the following legend applies: Checkboxes can have three states: Checked, clear and dimmed. If it is dimmed it is because the selected devices have difference properties. Fields is shown with a light gray background color and the text N/A in black if the selected devices have different properties. Drop down lists is shown with a light gray background and the first element in the list.
D60603-07
251
8 Manage devices
8.8
Delete devices
In the Devices list select the devices you wish to delete. You can delete the devices in the following ways: Right-click the selected devices and select Delete device. On the Devices menu, click Delete device. Press the DEL key.
8.9
Update software
In the Devices list select the devices you wish to update. The settings of the device are preserved during the software update. You can update the devices in the following ways: Right-click the selected device(s) and select Update software. On the Devices menu, click Device properties. In the Device properties dialog click Update software The SafeCom Controller can also be updated via FTP.
Check the Online status (8.10) in SafeCom Administrator to ensure the device is powered on and ready to receive updated software. SafeCom Controller SafeCom Controller SafeCom Controller 3 Port SafeCom Controller 1 Port Software (*.b80) 508xxx 312xxx 304xxx
D60603-07
252
8 Manage devices
HP MFP and printers CP4025, CP4525 P3015 CP3525 CM3530 MFP CM6030 MFP, CM6040 MFP, CM6049 MFP CP6015 P4014, P4015, P4515 CP3505 CM8050 MFP, CM8060 MFP P3005 M3035 MFP, M4345 MFP, M4349, MFP CM4730 MFP, M5035 MFP, M5039 MFP, M9040 MFP, M9050 MFP, M9059 MFP, 9250C Digital Sender 3000, 3800 4730mfp 4700 4345mfp, 9040mfp, 9050mfp, 9500mfp 2410, 2420, 2430, 4250, 4350 9040, 9050 4650, 5550
SafeCom Go HP (*.b49, *.b89, *.uin) 151xxx 150xxx 141xxx 140xxx 132xxx 131xxx 130xxx 121xxx 120xxx 111xxx 110xxx 102xxx 101xxx 100xxx 090xxx 081xxx 080xxx 075xxx
Note: SafeCom Go HP software can only be updated if a password is set for the admin account. Lexmark MFPs and printers X463de, X464de, X466de, X466dte, X466dwe, X651de, X652de, X654de, X656de, X658de X734de, X736de, X738de, X738dte, X860e, X862e, X864e X642e, X644e, X646e, X646ef, X646dte, X782e, X782e XL, X850e, X854e, X940e, X945e T656dne SafeCom Go Lexmark (*.fls) 021xxx
012xxx 121xxx SafeCom Go Ricoh (*.b87, *.uin) 110xxx 100xxx 090xxx 080xxx 060xxx
Ricoh MFPs and printers SP 4210N, SP C820DN, SP C821DN MP 6001, MP 7001, MP 8001, MP 9001, Pro 907EX, Pro 1107EX, Pro 1357EX MP 2851, MP 3351, MP 4001, MP 5001, MP C2050, MP C2550, MP C2800, MP C3300, MP C4000, MP C5000 SP C420DN MP 2550, MP 3550, MP 4000, MP 5000, MP C6000, MP C7500
D60603-07
253
8 Manage devices
Ricoh MFPs and printers MP 1100, MP 1350, MP 5500, MP 6000, MP 6500, MP 7000, MP 7500, MP 8000, MP 9000, MP C2000, MP C2500, MP C3000, MP C3500, MP C4500 Pro906EX, Pro1106EX, Pro1356E MP 2510, MP 3010, MP 3500, MP 4500, 2051 (DSm651), 2060 (DSm660), 2075 (DSm675), 3025 (DSm725), 3030 (DSm730), 3035 (DSm735), 3224C (DSc424), 3228C (DSc428), 3232C (DSc432), 3235C (DSc435), 3245C (DSc445), 3260C (DSc460), 5560C (CS555)
020xxx
8.9.1
D60603-07
254
8 Manage devices
8.9.2
2.
Click Start to begin the software update process. If you are updating SafeCom Go HP software the Device Authorization dialog appears. Enter User name admin and the Password. Click Close when the software update processes has been completed. After the process completes you can click View log to see the details. If the update process fails, try again. If you are updating SafeCom Go product you should refer to relevant SafeCom Go Administrators Manual for troubleshooting hints.
3.
D60603-07
255
8 Manage devices
8.9.3
2.
If you have selected multiple types of devices you need to specify the Software file(s) for each type. Select <specify software file> and click on the browse button [] to launch an Open dialog. Then browse to and select the software update file matching the select type. Repeat this step for each device type. Max connections specify the maximum allowed devices that can be updated simultaneously. When you open the dialog the maximum connections is set to 10. You can specify a maximum of 1, 5, 10, 20, 50 or 100 connections. This limit is to ensure that the software update process does not occupy all the network bandwidth.
3.
Click Start to begin the software update process. If you are updating SafeCom Go HP software the Device Authorization dialog appears. Enter User name admin and the Password. Click Close when the software update processes has been completed for the selected devices. If the update process fails, try again or refer to Troubleshooting chapter in the appropriate SafeCom Go administrators Manual (See list in section 1.11).
4.
D60603-07
256
8 Manage devices
8.10
Start the device monitor: 1. 2. On the Devices menu click Monitor setup The Device Monitor dialog appears.
3.
The default Poll interval is 5 minutes. Click Start to launch the scDevMonServer.exe process.
D60603-07
257
8 Manage devices
Enable monitoring on selected devices: 1. 2. Use Find devices (8.4) to get a list of relevant devices. In the Devices pane right-click any of the headers (Device name, IP address, ) and check one of the following: Monitored status The Monitored column to appear. An x indicates that the device is monitored and a indicates that the device is not monitored. Monitoring -> Allows you to control what details should be presented in the columns. Choose between Reboots, Uptime, Avg. ping and Normal ping. Select All to choose all of the above.
3.
D60603-07
258
8 Manage devices
3.
D60603-07
259
8 Manage devices
4.
8.11
Restart devices
Devices can be restarted from within SafeCom Administrator in two ways: Right-click in the Device list and select Restart On the Device menu, click Restart
8.12
D60603-07
260
8 Manage devices
8.13
8.14
DHCP server
You can assign a fixed IP address in the DHCP server. If you know the MAC address you can login to the DHCP server to determine which IP address has been assigned. The MAC address of the SafeCom Controller is printed on the white label on the bottom of the SafeCom Controller. The MAC address is a 12digit hexadecimal number. Example: 00C076FF00F2.
D60603-07
261
8 Manage devices
8.15
Note: Subsequent modifications to the file in the %SafeCom% folder will take immediate effect. ExcludeJobNames.txt ;-------------------------------------------------; This file specifies text to be excluded from ; job names in the SafeCom Front-end. ; ; Text is excluded if appearing as the first part ; of the job name. ; ; (c) 2003 SafeCom A/S ;-------------------------------------------------Version="1" Item="Microsoft Word - " Item="Microsoft Excel - " Item="http://"
D60603-07
262
9 SafeCom Tracking
9
9.1
SafeCom Tracking
Introduction
The SafeCom Tracking makes it possible to track print and MFP usage and costs on a per device and user basis. You can use SafeCom Reports (9.13) to view tracking data and generate reports.
9.2
3.
D60603-07
263
9 SafeCom Tracking
9.3
3.
9.3.1
Printing directly
The method of printing directly is illustrated below:
D60603-07
264
9 SafeCom Tracking
9.3.2
When printing via a second printer the printer driver of the first printer formats the document, whereas the printer driver of the second printer (the output device) is not used. The port monitor on the second printer communicates directly with the physical printer. This concept gives you the freedom to use your printer vendor supplied port monitor. Port monitors may support such protocols as: LPR, TCP (port 9100), DLC, PJL, AppleTalk or SCSI. Only the first printer should be shared. Sharing the secondary printer will enable users to print and bypass tracking. Note: There must be one instance of the SafeCom Push Port per physical printer on each machine.
9.3.3
D60603-07
265
9 SafeCom Tracking
9.3.4
Exit the Registry Editor. Start the SafeCom Service and the Print Spooler.
The overall AllowPrintOnServerError setting takes effect, when local PrintOnJdbError for the SafeCom Push Port has a value of 2. Follow these steps to change the port specific PrintOnJdbError setting: 1. 2. Stop the SafeCom Service and the Print Spooler. Open the Registry Editor and browse to: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\ Print\Monitors\SafeCom Push Port\Ports\<port> 0: 1: 2: 3. 4. 5. 6. Do not print on server error. Allow print on server error. Use the over-all setting AllowPrintOnServerError (Default).
Browse to the relevant instance of the port. Right-click PrintOnJdbError select Edit and change the value. Click OK. Exit the Registry Editor. Start the SafeCom Service and the Print Spooler.
D60603-07
266
9 SafeCom Tracking
9.3.5
In SafeCom Server click Edit servers to add, remove, change or test the connection to the SafeCom server (9.3.6).
D60603-07
267
9 SafeCom Tracking
In Output device you need to check Use printer IP/hostname if you are printing directly (9.3.1). Click Test connection to display the Printer properties dialog and to test the connection to the printer. The printer must be online and allow SNMPv1 access via UDP port 161, otherwise you will get the message: Not able to connect to printer. Check SNMP status enabled if you want SNMP status to be reported. If you are printing via a second printer (9.3.2) you need to check Select the printer that this port will use as output device and select one of the output devices. In Select SafeCom printer for tracking you can check Auto-create printer in SafeCom and then enter a Printer name and an optional Printer location. Alternatively you can check Select printer from list and choose a tracking device. Check Show job price before printing if users are to unconditionally see dialog with the cost of the document before they print. If the printer is a shared printer users MUST have SafeCom PopUp (4.14) setup and running on their computer in order to confirm that they wish to print the document.
Check Override user cost code and enter the cost code. The specified cost code overrides the cost code of the user who prints. Example: If John Smith has the cost code 2949 and prints to a Push Port where a cost code of 1009 is specified the resulting UserCostCode parameter in the tracking record will show 1009 and not 2949. Check Override driver name and enter the driver name. The specified driver name overrides the driver name supplied by the printer driver.
D60603-07
268
9 SafeCom Tracking
9.3.6
In the Edit SafeCom servers dialog click Test connection to test the communication with the SafeCom server. Click Close.
It is NOT possible to edit an entry on the SafeCom server list. Instead select the server and click Remove. Then click Add.
In the Add server dialog enter the SafeCom server address (IP address or hostname). Click OK.
D60603-07
269
9 SafeCom Tracking
9.4
The printers can be restored back to their original TCP/IP settings. 1. 2. 3. 4. 5. Start SafeCom Port Configurator. Click Next. Check Restore to TCP/IP. Click Next. The TCP/IP Printer Restore dialog appears with one or more servers, including Local Machine. Check the printers to be restored to TCP/IP. Restore is possible only if the printer has a Yes in the Restorable column. Click Next. A dialog appears with information about the number of reverted printers. Click OK to go to the TCP/IP Printer Restore dialog in step 3.
9.5
Copy tracking
Copy tracking makes it possible to track copy costs on MFPs. Your SafeCom license key code must include Copy Control and the MFP must be networked and in most cases you need a special SafeCom MFP cable. There is a complete list of supported MFPs in SafeCom Controller Administrators Manual D60700.
16
A TCP/IP printer is a Windows print queue that uses the Standard TCP/IP port monitor.
D60603-07
270
9 SafeCom Tracking
9.6
9.7
Post track
Post track affects these tracking data for Pull print jobs: Tracking pages (TrackingPageCount) is adjusted to reflect the actual number of pull printed pages. If a 100 page document is cancelled after 10 pages the job is only tracked (and priced) as 10 pages. Color pages (TrackingColorPageCount) is adjusted to reflect the actual number of pull printed pages with color. Price 1 (JobPrice) and Price 2 (JobPrice2) are adjusted as well to reflect the adjustment of Tracking pages and Color pages. See also 12.2.1 Accounting policy. Toner (TonerCyan, TonerMagenta, TonerYellow and TonerBlack) is tracked. The values are not shown in the Tracking record dialog (9.15.6).
Supported devices and how to enable Post track: Canon MFPs with SafeCom Go Canon version S88 nnn.010*02 or later. On the SafeCom Go Canon Configuration web page check Post track and click Apply. Canon devices (CPCA protocol v.1 and v.2) connected with a SafeCom Controller version S80 nnn.750*61 or later. On the SafeCom Controller Printer web page set Post tracking to YES. Ricoh MFPs with SafeCom Go Ricoh version S82 nnn.010*19 or later. On the SafeCom Go Ricoh Configuration web page check Post track and click Apply. Ricoh devices connected with SafeCom Controller. On the SafeCom Controller Printer web page set Post tracking to YES. HP MFPs and printers with SafeCom Go HP version S89 nnn.030*29 or later. On the SafeCom Go HP Configuration web page check Post track and click Apply. Sharp MFPs with SafeCom Go Sharp version S80 508.780*12 or later. On the SafeCom Controller Printer web page set Post tracking to YES. Xerox MFPs with SafeCom Go Xerox version S80 508.780*36 or later. On the SafeCom Controller Printer web page set Post tracking to YES. Xerox devices connected with SafeCom Controller. On the SafeCom Controller Printer web page set Post tracking to YES.
D60603-07
271
9 SafeCom Tracking
9.8
9.8.1
It is recommended to have the Name and/or Description of the charging scheme reflect if it is a primary or secondary charging scheme. Sample charging scheme: Print Price per job (start-up cost) Price per page Paper size A3 A4 Executive Letter Ledger Other 0.20 Impressions Mono Color 0.20 0.60 0.10 0.30 0.10 0.30 0.10 0.30 0.10 0.30 0.10 0.30
D60603-07
272
9 SafeCom Tracking
Copy Price per job (start-up cost) Price per page Paper size A3 A4 Executive Letter Ledger Other Fax Price per job (start-up cost) Price per page Scan Price per job (start-up cost) Price per page E-mail Price per job (start-up cost) Price per page How to proceed: 1. 2. 3. 4.
0.20 Impressions Mono Color 0.20 0.60 0.10 0.30 0.10 0.30 0.10 0.30 0.10 0.30 0.10 0.30
0.10 0.10
0.10 0.10
0.10 0.10
Make a list of all the relevant printer models in your solution. Calculate the costs for each printer model. Make a proposal for the charging schemes. The charging schemes may require approval from higher management. Use SafeCom Administrator to define the charging schemes (9.11).
Note: Some Windows printer drivers set paper size to Default. The SafeCom solution will map this to Other. For this reason you should set the price of Other to the same price as the most commonly used paper size, typically A4 or Letter. Note: Some MFPs can only report the number of copied pages and does not provide information about paper size or use of color and duplex. In such cases the copy page price is based on the price of A4.
D60603-07
273
9 SafeCom Tracking
9.8.2
9.8.3
9.8.4
D60603-07
274
9 SafeCom Tracking
The tracking data can also be used to invoice users based on what they have printed. If you want users to pay up front you should use the SafeCom Pay module described in chapter 12. You can utilize the Organizational Unit and/or Description properties of users to specify their belonging to cost center, division or department. That way you can invoice the users organizational unit. With the SafeCom Administrator API (option) you can extract tracking data automatically. This XML-based tool is ideal for system integration with financial applications. Refer to SafeCom G3 Administrator API Reference Manual D60822.
9.9
The steps involved: 1. 2. On the SafeCom master server you need to enable and configure the scheduled collection of tracking data (9.9.1). On each SafeCom slave server you need to configure it to use offline tracking (9.9.2).
D60603-07
275
9 SafeCom Tracking
9.9.1
3.
D60603-07
276
9 SafeCom Tracking
9.9.2
3.
9.10
Configuration overview
Before you proceed with the configuration of your SafeCom Tracking solution you should get an overview of the steps involved: 1. 2. Install license key code. Use SafeCom Administrator to install your license key code with tracking enabled. Create charging schemes. Use SafeCom Administrator to create multiple charging schemes to reflect the varying print costs of the different printer models (9.11). Associate charging scheme with device. Use SafeCom Administrator to associate a charging scheme with the device (9.11.4). Change cost control to tracking. Use SafeCom Administrator to change the user property Cost control to Tracking (9.12). Work with the tracking data. Use the Data Mining tool to view the tracking data (9.14).
3. 4. 5.
D60603-07
277
9 SafeCom Tracking
9.11
Charging schemes
In section 9.8.1 we described the concept of charging schemes, dual charging schemes and how you should get them in place. In the following subsections we will describe how you work with charging schemes in SafeCom Administrator.
Name is the unique name of the charging scheme (mandatory). Description is an optional description of the charging scheme. Enter Price per job to charge a Start-up cost per job. Check Subject for job name pricing if you wish to enable pricing based on job name (12.11). Enter Price per page in the form of the price for Sheet (paper), Mono Impression and Color Impression for the paper sizes: A3, A4, Executive, Letter and Legal. Click Set all to quickly enter a price for all paper sizes. The price specified in Other is used when the paper size is unknown (or default).
D60603-07
278
9 SafeCom Tracking
Click the Copy tab to specify the prices for copy jobs.
Note: Some MFPs that are unable to provide information about paper size or use of duplex and color, tries to repair this lack of detail by reporting a higher number of copied pages. A popular method is to report that two pages are copied when actually one monochrome A3 page or one color A4 page is copied. Likewise one color A3 page would be reported as 4 pages.
D60603-07
279
9 SafeCom Tracking
For selected MFPs it is also possible to charge for fax, scan and e-mail. Click the Fax+Scan+E-mail tab to specify these prices.
D60603-07
280
9 SafeCom Tracking
Check Show print and copy tab for OLD device to include a Print+Copy tab for backward compatibility with SafeCom-enabled devices running software dated before September 2007. Newer SafeCom-enabled devices will continue to use the prices and settings on the Print+Copy tab as long as all the prices are set to 0,0000 on the Print and Copy tab of the Primary charging scheme.
Check Charge per page to charge per printed page and paper size. Enter Price per page for the paper sizes: A3, A4, Executive, Letter and Legal. Click Set all prices to quickly enter a price for all paper sizes. The price specified in Other is used when the paper size is unknown (or default). Check Charge per job to charge per job printed according to the price entered in Price per job. Check Subject to job name pricing if you wish to enable pricing based on job name (12.11). Check Duplex and enter the modifier to use when calculating the discount of double sided printing. The modifier is normally between 0,5 and 1. Check Color and enter the modifier to use when calculating the price of color impressions on color devices. The modifier is normally greater than 1.
D60603-07
281
9 SafeCom Tracking
D60603-07
282
9 SafeCom Tracking
3.
Select a charging scheme as Charging scheme 1 (primary). This is used to charge users and possibly invoice departments. Optionally select a charging scheme as Charging scheme 2 (secondary). This is used to reflect the true print costs. Click OK.
D60603-07
283
9 SafeCom Tracking
1. 2. 3.
In SafeCom Administrator open the Server properties dialog and click on the Devices tab. Check Keep default charging scheme 1 and assign it to auto-created devices and optionally check Keep default charging scheme 2 and assign it to auto-created devices. Click OK.
D60603-07
284
9 SafeCom Tracking
9.12
D60603-07
285
9 SafeCom Tracking
9.13
SafeCom Reports
SafeCom Reports is an optional program that enables viewing of main tracking statistics, user statistics, device statistics, client billing statistics and job list. For additional information refer to SafeCom Reports Administrators Manual D60609.
4. 5.
It is possible to schedule one or more reports using the supplied SafeCom Reports command line interface. Refer to SafeCom Reports Administrators Manual D60609.
D60603-07
286
9 SafeCom Tracking
9.14
1. 2. 3. 4. 5. 6.
7. 8.
On the Servers menu, click Tracking data and Export tracking data Select the period. A number of predefined periods are available ranging from Today to 1 year back. Choose Specify period to freely specify the beginning (from) and finish (to) of the period. Enter the path and File name of the export file. You can click Browse to specify the location of the export file. Select File format (XML, TXT or CSV). Select Separator (not needed when using XML). The default value for separator is taken as the List separator setting on the Numbers tab of the Regional settings dialog. Use the default setting if you intend to use Microsoft Excel, since Excel takes its default separator from the same place and the separators need to match. Check Launch Datamining if you want to analyze the data right away. Click OK.
Note: When you export to txt format, two files are created. One is a *.txt (or *.csv) file, the other is a *.sch file. They are automatically placed in the same directory when they are created. The *.sch file is used by Administrators Data mining function as a reference file; it tells Administrator how to interpret each field in the *.txt file. For this reason, you must keep them together in the same directory when using the files for Data mining.
D60603-07
287
9 SafeCom Tracking
1. 2. 3. 4. 5. 6.
7. 8.
On the Servers menu, click Tracking data and Delete tracking data All data before Last date is exported to a file and deleted from the tracking database. Enter the path and File name of the delete file. You can click Browse to specify the location of the export file. Select File format (XML, TXT or CSV). Do not select CSV if you intend to Launch Datamining. Select Separator (not needed when using XML). The default value for separator is taken as the List separator setting on the Numbers tab of the Regional settings dialog. Use the default setting if you intend to use Microsoft Excel, since Excel takes its default separator from the same place and the separators need to match. In chapter 14 there is a complete description of the exported tracking data. Check Launch Datamining if you want to analyze the data (9.15). Click OK.
D60603-07
288
9 SafeCom Tracking
9.15
Using SafeCom Data Mining: 1. 2. 3. 4. 5. On the File menu click Open. Find the SafeCom Data Mining File (*.xml or *.txt) containing the data you want to view. Click Open. Choose either to view All data or Select a Period (click Refresh if you change the Period). Click User Statistics, Device Statistics or Billing statistics tab, according to the data you want to view. If you click Options and select Setup, you can change the following:
You can select whether Completed jobs only, Failed/Interrupted jobs only or All jobs should be included in the statistics. Click Refresh to update the view of the exported statistics according to the changed options.
D60603-07
289
9 SafeCom Tracking
Tracking entries shows the number of Completed jobs, Failed/Interrupted jobs and Total jobs. Tracking load show a graphic representation of the number of tracking jobs as a function of time (the selected period). Summary list the Number of jobs, Size of jobs, Number of pages and the resulting costs as calculated using the primary and secondary charging scheme. The Pull print ratio, Push print ratio, Copy ratio and Fax/Send/E-mail ratio are also listed. The Duplex ratio and Color ratio are also shown. Pull print list the Number of jobs, Size of jobs, Number of pages and the resulting costs as calculated using the primary and secondary charging scheme. Push print list the Number of jobs, Size of jobs, Number of pages and the resulting costs as calculated using the primary and secondary charging scheme. Copy jobs list the Number of jobs, Size of jobs, Number of pages and the resulting costs as calculated using the primary and secondary charging scheme. Fax/Scan/E-mail list the Number of jobs, Size of jobs, Number of pages and the resulting costs as calculated using the primary and secondary charging scheme. Tracking of Fax, Scan and E-mail is only possible on selected HP LaserJet MFPs with SafeCom Go HP installed. D60603-07 290
9 SafeCom Tracking
Click on the Pages header to sort and find who has been producing most pages using the printers and MFPs for the specified period. Click on the Cost header to sort and find who has been spending most credits using the printers and MFPs for the specified period. The listed cost is the cost calculated using the primary charging scheme. Click the selected user to open the Statistics dialog with more detailed statistics, including cost calculated using the secondary charging scheme.
D60603-07
291
9 SafeCom Tracking
Click on the Print pages header to sort and find which device has been printing most pages for the specified period. Click on the Copy pages header to sort and find which device has been copying most pages for the specified period. Click on the Cost header to sort and find which device has been producing most for the specified period. The listed cost is the cost calculated using the primary charging scheme. Click the selected device to open the Statistics dialog with more detailed statistics, including cost calculated using the secondary charging scheme.
D60603-07
292
9 SafeCom Tracking
Click on the Pages header to sort and find who has been producing most pages using the printers and MFPs for the specified period. Click on the Cost header to sort and find who has been spending most credits using the printers and MFPs for the specified period. The listed cost is the cost calculated using the primary charging scheme. Click the selected billing code to open the Statistics dialog with more detailed statistics, including cost calculated using the secondary charging scheme.
D60603-07
293
9 SafeCom Tracking
Click on the User logon header to sort and find the jobs produced by user for the specified period. Click on the Device name header to sort and find the jobs produced by device for the specified period. Click on the Cost header to sort and find which job is the most expensive for the specified period. The listed cost is the cost calculated using the primary charging scheme. Click the selected job to open the Tracking record dialog (9.15.6) with more detailed information, including cost calculated using the secondary charging scheme.
D60603-07
294
9 SafeCom Tracking
D60603-07
295
9 SafeCom Tracking
The tables in the following lists the subset of tracking record fields displayed in the Tracking record dialog. The records are grouped around: Job User Device Page count Cost Miscellaneous
The corresponding XML tag is also listed and can be used to reference the tracking format as described with all fields in section 14.3. A + indicates the field is relevant for the listed job. A - indicates the field is not relevant for the listed job. Job Name <JobName> Generated <JobDate> Size <JobSize> Paper <JobPageFormat> Duplex <JobIsDuplex> Color <JobIsColor> Driver <DriverName> Type <JobType> Destination <JobDestination> PUSH + + + + + + + + PULL + + + + + + + + COPY + + + + + + SCAN + + + + + + + + EMAIL + + + + + + + + FAX + + + + + + + +
User ID <UserID> User logon <UserLogon> Full name <FullName> Description <Description> Cost code <UserCostCode>
PUSH + + + + +
PULL + + + + +
COPY + + + + +
SCAN + + + + +
EMAIL + + + + +
FAX + + + + +
D60603-07
296
9 SafeCom Tracking
Device ID <DeviceID> Name <DeviceName> Model <DeviceModel> Location <DeviceLocation> Duplex <DeviceSupportsDuplex> Color <DeviceSupportsColor> MAC <DeviceMac>
PUSH + + + + + + +
PULL + + + + + + +
COPY + + + + + + +
SCAN + + + + + + +
EMAIL + + + + + + +
FAX + + + + + + +
Page count Tracking state <TrackingState> Tracking pages <TrackingPageCount> Driver pages <DriverPageCount> Parser pages <ParserPageCount> Color pages <TrackingColorPageCount> Sheets <JobSheetCount>
PUSH + + + + + +
PULL + + + + + +
COPY + + + +
SCAN + + + -
EMAIL + + + -
FAX + + + -
Cost Price 1 <JobPrice> Price 2 <JobPrice2> Miscellaneous Start time <StartDate> End time <StopDate> Print queue <PMQueueName> Print computer <PMComputerName>
PUSH + + PUSH + + + +
PULL + + PULL + + + +
COPY + + COPY + + -
SCAN + + SCAN + + -
EMAIL + + EMAIL + + -
FAX + + FAX + + -
D60603-07
297
9 SafeCom Tracking
9.16
Update scParser.dll
The component scParser.dll is responsible for parsing the print data stream. If a new version is made available to you, you should follow the steps below to update. On Windows 32-bit: 1. Backup the existing file scParser.dll from the SafeCom installation folder. The default is: C:\Program Files\SafeCom\SafeComG3\ 2. 3. Stop the SafeCom Service and the Print Spooler. Copy scParser.dll to the SafeCom installation folder. Default is: C:\Program Files\SafeCom\SafeComG3\ 4. Start the SafeCom Service and Print Spooler.
On Windows 64-bit: 1. Backup the existing file scParser64.dll from the SafeCom installation folder. The default is: C:\Program Files (x86)\SafeCom\SafeComG3\ 2. 3. Stop the SafeCom Service and the Print Spooler. Copy scParser64.dll to the SafeCom installation folder. Default is: C:\Program Files (x86)\SafeCom\SafeComG3\ 4. Start the SafeCom Service and Print Spooler.
D60603-07
298
10
10.1
Disclaimer: SafeCom Rule Based Printing needs to modify the print data stream to control: Duplex on/off, Toner save on/off and Force job to b/w. SafeCom does NOT guarantee that these modifications will work and cannot be held responsible if they do not work as expected. SafeCom Rule Based Printing has been tested against PCL5, PCL5c, PCL5e, PCL6, PCL XL and PostScript level 2 and 3 printer drivers from HP using a broad range of HP LaserJets.
10.2
D60603-07
299
10.3
2.
D60603-07
300
3.
On the Conditions tab double-click a condition to apply it. If no conditions are applied the rule will always apply (unconditional). Multiple conditions can be applied. Remove an applied condition by selecting it and then click the left arrow.
Available Conditions: Device [does | does not] support color Allows you to choose if the rule should apply when printing on a device with color capabilities. Device location contains specific text Device location does not contain specific text Allows you to specify a text that will be used for case insensitive matching based on the device location. Device model contains specific text Device model does not contain specific text Allows you to specify a text that will be used for case insensitive matching based on the device model. Device name contains specific text Device name does not contain specific text Allows you to specify a text that will be used for case insensitive matching based on the device name. Job color mode is [b/w | color] Allows you to choose if the rule should apply to a b/w or color job. Job driver name contains specific text Job driver name does not contain specific text Allows you to specify a text that will be used for case insensitive matching based on the job driver name. Job name contains specific text Job name does not contain specific text Allows you to specify a text that will be used for case insensitive matching based on the job name. Jobs printed from Microsoft Internet Explorer and other browsers typically include the text string http. Section 10.6 gives more examples on how the job name can be used to determine the application. 301
D60603-07
Job page count larger than number Allows you to specify a lager than page count. Job page count less than number Allows you to specify a less than page count. Job size larger than number KB Allows you to specify a lager than job size in kilobytes. Job size less than number KB Allows you to specify a less than page job size in kilobytes.
Note: The specific text is used for case insensitive matching. There is NO support for wildcard syntax, such as use of * and ?.
D60603-07
302
4.
On the Actions tab double-click an action to apply it. If no actions are applied there is no action to the rule. Multiple actions can be applied. Remove an applied action by selecting it and then click the left arrow.
Available Actions: Confirm pull job. Message: text When Pull Printing, a popup dialog will appear with the configured message text (max 100 characters). The user can click OK to print or Cancel. One <%pages%> and one <%price%> tag can be included in the text and will be replaced with the number of pages and the price of the job. Requires use of SafeCom PopUp (4.14). Details about the calculation of the price based on charging scheme are in section 4.14.6. Confirm push job. Message: text When Push Printing, a popup dialog will appear with the configured message text (max 100 characters). The user can click OK to print or Cancel. One <%pages%> and one <%price%> tag can be included in the text and will be replaced with the number of pages and the price of the job. Requires use of SafeCom PopUp (4.14). Delete job The job is to be deleted. Duplex on/off The print data is modified to get double-sided print. To avoid 1page documents from using the duplexer it is recommended to combine include the condition: Job page count larger than 1. Force job to b/w The print data is modified to force job to b/w. Hide pull print job The job will not appear on the Pull Print list of documents. Typically combined with the conditions Device supports color and Job color mode is color to ensure that only color jobs can be Pull printed on color devices. If the job is Push Print it is deleted.
D60603-07
303
Redirect to queue name This action applies to Push Print only. The print job will be redirected to the specified destination. Normally the destination is in the form of a printers IP address or hostname. However, it is also possible to redirect to another print queue by for example entering the share name: Example \\SERVER\Printer. If you redirect to a print queue that uses the SafeCom Push Port the print job is tracked again. Redirect to user logon This action applies to Pull Print only. The print job is redirected and stored under the specified user logon. Redirecting to a Group name is not supported. Toner save on/off The print data stream is modified to enable toner save (Economode on b/w HP LaserJets).
D60603-07
304
5.
On the Notification tab check the notification method you want to use and enter the notification message. It is possible to refrain from selecting any of the notification methods to have the rule execute behind the scenes (silently).
The notification message text does NOT support use of tags like <%pages%> and <%price%>. If you require use of these tags then please use the Action: Confirm Pull job or Confirm Push job. The notification will only occur if a notification message text is specified. Notify by: PopUp A popup dialog with a configurable message will appear on the users computer explaining that the rule has been executed. No client installation is required (4.14). E-mail The user receives an e-mail with a configurable message explaining that the rule has been executed. Log file This should only be used during testing. The SafeCom event log will list that the rule was applied. Refer to information about the event log in 3.8.1.
D60603-07
305
6.
On the Rule description tab enter a meaningful Rule name to identify the rule. Click OK.
10.4
D60603-07
306
3.
4. 5.
Check the rules you want to be used on the group. Click Apply and then Close.
D60603-07
307
10.5
Feedback wanted: We would be very grateful if you could send an e-mail to [email protected] with the technical details, including information about the printer model, printer firmware version, driver, driver version, description of rule and document you are printing.
10.6
Note: E-mails printed from Lotus Notes will have the same job name as the subject of the e-mail. It is therefore NOT possible to use the job name to determine that the application is Lotus Notes.
D60603-07
308
10.7
Update scRuleExecuter.dll
The component scRuleExecuter.dll is responsible for modifying the print data stream. If a new version is made available to you, you should follow the steps below to update. On Windows 32-bit: 1. Backup the existing file scRuleExecuter.dll from the SafeCom installation folder. The default is: C:\Program Files\SafeCom\SafeComG3\ 2. 3. Stop the SafeCom Service and the Print Spooler. Copy scRuleExecuter.dll to the SafeCom installation folder. Default is: C:\Program Files\SafeCom\SafeComG3\ 4. Start the SafeCom Service and Print Spooler.
On Windows 64-bit: 1. Backup the existing file scRuleExecuter64.dll from the SafeCom installation folder. The default is: C:\Program Files (x86)\SafeCom\SafeComG3\ 2. 3. Stop the SafeCom Service and the Print Spooler. Copy scRuleExecuter64.dll to the SafeCom installation folder. Default is: C:\Program Files (x86)\SafeCom\SafeComG3\ 4. Start the SafeCom Service and Print Spooler.
D60603-07
309
11
11.1
11.2
D60603-07
310
11.3
Configuration overview
Before you proceed with the configuration of your SafeCom Client Billing solution you should get an overview of the steps involved: 1. 2. 3. 4. 5. 6. Configure SafeCom Tracking. Refer to section 9.8, 9.9 and 9.10. Install the SafeCom G3 Web Interface. Refer to SafeCom G3 Web Interface Administrators Manual D60604. Configure SafeCom Client Billing. Use SafeCom Administrator to change the user property Cost control to Tracking (11.4). Allow use of billing codes (11.5). Edit the reminder template so it references the SafeCom G3 Web Interface, that is, the Billing web page (11.6). Work with the tracking data. Use the Data Mining tool to view the tracking data (9.14).
D60603-07
311
11.4
3.
Check Store tracking data temporarily to allow users to apply billing codes. Chose the number period you want to elapse before the billing data is committed and when the billing data should be moved to the tracking data. Once this is done you will see the tracking records and associated billing codes when you export tracking data (9.14). Click OK. Note: In a multi server environment, tracking data within the billing window will not be collected by the master server.
D60603-07
312
11.5
1. 2. 3. 4.
Open the User properties dialog. Check Tracking (or Pay17) in Cost control. Check Bill clients for cost. Click OK.
17
A Pay user is still charged for the job regardless if a billing code is associated.
D60603-07
313
11.6
1. 2. 3. 4.
Open the EmailBilling.txt file in an editor, such as Notepad. You are free to customize or translate the message to give the users the highest user satisfaction. Replace the http://safecomserver/safecom/ link with the link to the server that hosts the SafeCom G3 web interface. Refer to SafeCom G3 Web Interface Administrators Manual D60604 Customize or translate the message to give the users the highest user satisfaction. Save the file into the %SafeCom% folder. If you leave it in the %SafeCom%\Templates folder it will not take effect.
D60603-07
314
11.7
D60603-07
315
Follow these steps to billing codes: 1. 2. On the Servers menu, click Client Billing and Import billing codes to make a one-time import or click Schedule billing code import to open the Scheduled billing code import dialog and then click Configuration The Billing code import configuration dialog appears. Click Next.
3.
Enter Server group (name or IP address), Login account with Administrator rights and password. In a multi server installation you should specify the master server for best performance. The fields are preconfigured for a one-time import. Click Next.
D60603-07
316
4.
Specify the Name of the file to import from (with full path) as seen from the SafeCom server. The account that runs the SafeCom Service (normally the Local System account) must have read access to the CSV file. Click Next.
Example CSV file with header and two entries: Code;Description;Billable 10102;Human Ressources;0 10103;Acme Project;1 The billing code can consist of maximum 50 characters. The billing code description can consist of maximum 50 characters. The billable field can be 0 (not billable) or 1 (billable).
D60603-07
317
5.
Specify from which field in the CSV file the values should be retrieved. Leave a field value of 0 to avoid import. Open the CSV file in Notepad to determine what Separator character is used (semi-colon is default). Click Next.
If you check First line in file is a header you will need to specify the name of the field rather than the number. The field name is case insensitive.
D60603-07
318
6.
Add billing codes will cause all billing codes in the file to be imported. Modify billing codes will cause any existing billing codes to be modified according to the imported values. Delete billing codes will cause existing billing codes that does not appear in the import to be deleted. Max difference can be used to control if an import should be cancelled if there is too much difference. A value of 0 (zero) will cause the import to take place irrespective of the percentage of difference.
D60603-07
319
7.
If a special billing code import module has been supplied you should check Extra configuration and enter the configuration according to the supplied instructions. Otherwise you should just click Next.
8.
Click Finish.
9.
If you are doing a one-time import you need to click Import in the Billing code import dialog. Otherwise you should click OK in the Scheduled billing code import dialog. The progress bar reflects progress.
D60603-07
320
Click on the Log tab to see a log of the billing code import (11.7.1).
D60603-07
321
A log file with the name <Billingyyyymmddhhmmss.log>, where yyyy is the year, mm is the month, dd is the day, hh is the hour, mm is the minutes and ss is the seconds. The log file is stored in the logfiles folder below the SafeCom G3 installation folder. The default folder is: C:\Program Files\ SafeCom\SafeComG3\logfiles On Windows 64-bit: C:\Program Files (x86)\ SafeCom\SafeComG3\logfiles During import you may encounter conflicts because the billing code (cc = 131) already exists. Examples: Not able to add Billing code <BillingCode>. cc = 131
D60603-07
322
11.8
11.9
D60603-07
323
12 SafeCom Pay
12
12.1
SafeCom Pay
Introduction
The SafeCom Pay module provides total print cost management. In addition to the SafeCom Tracking module described in chapter 9 the module can be used to prevent a user from printing if the balance of his account goes below a specified low limit (default zero credits). The SafeCom Administrator (12.5) can be used to add (deposit) or subtract (withdraw) credits from the users account. Credits are equivalent to money.
12.2
In addition you need to decide if Post track (9.7) should be enabled, in which case, pay users may be charged a different (lower) price compared to the price they were given when they collected their document.
D60603-07
324
12 SafeCom Pay
Educational institutions in particular should inform their users about these counter measures. This will help them limit the number of unfinished jobs that are likely to happen at the start of semester when new students enroll.
D60603-07
325
12 SafeCom Pay
12.3
D60603-07
326
12 SafeCom Pay
12.4
Credit schedule
1. 2. Open the Group properties dialog (5.13.2). Click on the Credit schedule tab.
Enter a meaningful Description. In Transaction select if the members Account 1 or Account 2 should be Set to the specified Amount or changed with the specified amount (Add or Subtract). An optional Comment can be entered.
D60603-07
327
12 SafeCom Pay
Provided the schedule is Enabled it is possible to schedule credits One time only, Daily, Weekly and Monthly. Check End date and specify a date for when the periodic schedule should end. Please ensure that the end date does not conflict with the selected frequency options. Otherwise you may risk that the credit schedule will not run.
In the above example members of the STUDENTS group are having their account 2 set to 100 credits on the first Monday at midnight of each month, except for the three summer months.
D60603-07
328
12 SafeCom Pay
In the above example members of the TRAINEES group are having their account 2 set to 40 credits each weekday at 07:00 am.
D60603-07
329
12 SafeCom Pay
12.5
Cashier How to
The following subsections assume that you are logged into SafeCom Administrator as a user with Cashier rights (5.8.4).
Note: If you belong to a domain the domain followed by a slash (/) or a backslash (\) must be specified in front of the users logon. Example: MYDOMAIN\JS. Alternatively you can specify user logon followed by (@) and the domain, like this JS@MYDOMAIN.
D60603-07
330
12 SafeCom Pay
If only one user is found the User properties dialog (12.5.3) appears. Otherwise double-click a user on the appearing list of users.
D60603-07
331
12 SafeCom Pay
Account 1 shows the current amount of money available with the user. Account 2 shows the current available quota available for the user. Low limit is the lowest amount that should be available in order to print (Allows negative figures). Click to edit the Low limit. Reserved is the amount of credits reserved due to a print or copy job that finished in error. It should be 0.00 (zero) most of the time. If the system has reserved any credits you will see a positive amount printed in red color. Click to edit the Reserved. The amount must be greater than 0.00 (zero) and less than or equal to the currently reserved amount of credits. Disposable is equal to Balance minus Low limit and Reserved. Amount indicates the amount to Deposit (insert) on or Subtract (withdraw) from the account. Click Record to make the transaction take place. Comment allows you to add any description (optional).
D60603-07
332
12 SafeCom Pay
D60603-07
333
12 SafeCom Pay
D60603-07
334
12 SafeCom Pay
D60603-07
335
12 SafeCom Pay
12.6
Account status
1. On the Cashier menu click Account status to view and print the credit status, including: Total credits in the system Total reserved in the system Total temporary cash card18
The Cash card tab is only available if the SafeCom Pay solution stores money on a Smart Card. On the Cash card tab it is possible to see a list of the users who temporarily has had money transferred from their cash card to their SafeCom account on the SafeCom server. This money will be transferred back to the users cash card the next time the cash card is used at one of the SafeCom-enabled printers. 2. Click Print to print a hardcopy of the reports.
18
D60603-07
336
12 SafeCom Pay
12.7
Select the period. A number of predefined periods are available ranging from today to 1 year back. Choose Specify period to freely specify the beginning (from) and finish (to) of the period. Click Refresh to view the transactions for the selected period. Click Print to print the cash flow report.
The cash flow report contains a list of the transactions, detailing the ID, Date/Time, Type (Cashier, Money Loader or ePay), Account, Value and Comment. In case of ePay the comment column contains the ePay order number. Check Personalize if the report should only include transactions conducted by the user that is currently logged into SafeCom Administrator.
D60603-07
337
12 SafeCom Pay
12.8
The money loader log contains a list of the events, detailing, Box ID, Date/Time, Log number, Event (Collect Money, Running, Stop, Warning and Error), Device, Account and Balance. Counters at the bottom of the dialog shows the coin and notes counters that were reported in connection with the recorded event.
D60603-07
338
12 SafeCom Pay
12.9
Current values show the Balance, Low limit, Reserved and Disposable. GID is an identification number for the transaction(s). Date/Time indicates the date and time of the transaction. Author is the User logon of the user who did the transaction. Type indicates the type of transaction. Description shows the description (if any) of the transaction. Value indicates the amount that has been added/subtracted from the account. Account 1 shows the balance on the account with real money. Account 2 shows the balance on the account with quota. Card is only present if the SafeCom Pay solution stores money on a Smart Card. It shows the amount that has been transferred from the cash card to the SafeCom account on the SafeCom server. Check the Merge Cash Card if you want to see the transactions that involves the cash card. Check Show reservations if you want to see reservations as well. D60603-07 339
12 SafeCom Pay
UnfinishedJob.txt <%SUBJECT="[SafeCom Unfinished Job] <%USERLOGON%>"%> This mail is to inform you about an unfinished job. Credits ------Reserved:
<%RESERVEDCREDITS%>
Job properties -------------Job name: <%DOCUMENTNAME%> Pages: <%PAGES%> Date: <%STARTDATE%> Device properties ----------------Device name: <%DEVICENAME%> IP address: <%DEVICEIPADDR%> MAC address: <%DEVICEMAC%> Model: <%DEVICEMODEL%> Location: <%DEVICELOCATION%> User properties --------------User logon: <%USERLOGON%> Full name: <%FULLNAME%> E-mail: <%EMAIL%>
D60603-07
340
12 SafeCom Pay
<%DOCUMENTNAME%> <%PAGES%>
The name of the document. The number of pages in the document. It is not possible to say how many of the pages were actually printed.
D60603-07
341
12 SafeCom Pay
12.11.1 JobNamePricing.txt
The pricing based on job names is controlled from the text file JobNamePricing.txt located in the %SafeCom%\Templates directory. The %SafeCom% indicates the SafeCom installation directory, normally C:\Program Files\ SafeCom\SafeComG3 On Windows 64-bit: C:\Program Files (x86)\ SafeCom\SafeComG3 1. 2. 3. Copy the JobNamePricing.txt file from the %SafeCom%\Templates folder to the %SafeCom% folder. Modify the JobNamePricing.txt file in the %SafeCom% folder to match your requirements. Restart the SafeCom Service (16.30).
Note: Subsequent modifications to the file in the %SafeCom% folder will take immediate effect. You can add as many filters/prices as you want. You can use a maximum of 4 wildcards (*) in a filter. The filters are case sensitive. The price must be specified with a decimal point (.). ;-------------------------------------------------; This file specifies print jobs to be given a ; special price if job name is matching a ; certain filter. ; ; The '*' character is used as wild card. ; Maximum 4 '*' (wild cards) is allowed per filter. ; ; (c) 2003 SafeCom A/S ;-------------------------------------------------Version="1" Price1="0.00" Filter1="Test Page" Price2="0.10" Filter2="http*safecom.eu*" Filter2="safecom*.PDF*"
D60603-07
342
13
13.1
13.2
How to populate the list of devices is covered in section 13.4. Get configuration and Set configuration are covered in section 13.5. Click Status to have enable status updates from the listed devices every 30 seconds. Click Refresh to update the list of devices and their status.
D60603-07
343
13.3
Action
8.12
Help
13.4
D60603-07
344
13.5
3. 4.
Set configuration: The configuration that is currently uploaded can be loaded to one or more selected device(s), provided these are of the same type. This can be used to clone entire configurations from one device to other devices. 1. 2. Click Set configuration to load the current configuration to the selected device(s) of the same type. Enter User name and Password of the device to authorize the download of the configuration. Check Same for all devices if you are updating multiple devices and they are configured with same the user name and password. A SafeCom Controller has adm as default User name and Password.
3. 4.
A dialog will appear saying either Set configuration succeeded! or Set configuration failed! Click OK.
D60603-07
345
14
14.1 14.2
Format history
SafeCom G3 S82 070.400*01 Introduced Unicode support.
D60603-07
346
14.3
Parameter
TrackingID
Format
Description
A unique ID for this tracking record. Name of the computer Contains the value of the ApplyExportTrackingID that was supplied the first time this tracking record was exported. Otherwise it is blank. Maximum 20 characters. A unique ID that can be used to link to corresponding transaction (change of credits). The type of cost control the user was set to when copies were made or the document was printed (collected at the printer). The date when the user started collecting the document at the printer. The date when the users document was printed. The state of the tracking. If the state is interrupted it could indicate that an attempt was made to disconnect or otherwise tamper with the SafeCom equipment to bypass tracking. Number of pages to use for tracking purpose of both print and copy jobs. In case of a print job (see JobType) the number of pages is normally the same as reported by ParserPageCount. However, if TrackingState is INTERRUPTED then TrackingPageCount can be less than ParserPageCount. Number of pages as counted by the used SafeCom Pull Port and SafeCom Push Port. This is 0 in case of a copy job (see JobType). The status of the parsing can be seen from PageCountStatus. Number of pages as reported by the Windows printer driver (see DriverName). This is 0 in case of a copy job (see JobType).
Default value
ComputerName ExportTrackingID
TransactionID AccountingModelUsed
TRACKING_STATE_COMPLETED TRACKING_STATE_INTERRUPTED
TrackingPageCount
ParserPageCount
DriverPageCount
D60603-07
347
Parameter
JobSubmitLogon
Description
The UserLogon of the user who submitted the document for printing. In case of distribution (P-mail) this will differ from UserLogon. Name of the document. Always Copy job in case of copies. The date when the document was submitted for printing, that is when it arrived in the SafeCom job database. Number of bytes The ID (internal) of the user. The ID (internal) of the domain. The users logon name The users domain The users full name Description field The users e-mail The MAC address of the device. The ID (internal) of the device. The name of the device. The location of the device. The IP address of the device. Weather or not double-sided print is supported. Weather or not color is supported. The Model name listed in the SafeCom Administrators Device properties dialog. This is the driver name. It is identical to the Model name listed in the Windows printer properties dialog. The paper size. Typically, A4, A3 or Letter. Is the job set up for doublesided print? Is the job a color job? Empty. Reserved for future use. Empty. Reserved for future use. The billing code. Maximum of 50 characters. The billing code description. Maximum of 50 characters. If YES the billing code can be used to invoice clients. The cost of the job. Calculated based on charging scheme and job/device attributes.
Default value
JobName JobDate
JobSize UserID UserDomainID UserLogon Domain FullName Description Email DeviceMac DeviceID DeviceName DeviceLocation DeviceIpAddr DeviceSupportsDuplex DeviceSupportsColor DeviceModel DriverName
YES NO YES NO
NO YES
D60603-07
348
Parameter
JobType
Description
The type of job: Pull print, Push print, Copy, Fax, Scan or Email.
Default value
JOB_TYPE_PULL JOB_TYPE_PUSH JOB_TYPE_COPY JOB_TYPE_FAX JOB_TYPE_SCAN JOB_TYPE_EMAIL PAGECOUNT_STATUS_OK PAGECOUNT_STATUS_UNDEFINED PAGECOUNT_STATUS_FAILURE 0
PageCountStatus
UserNodeID
DeviceNodeID
PageCountModel
TrackingColorPageCount JobDestination
TonerSave JobPrice2
PMQueueName
PMPortName PMComputerName
DocComputerName
Indicates the status of the parsing done with the SafeCom Pull Port and SafeCom Push Port. The internal ID of the Organizational unit the user belongs to. The ID can be seen in the Org. unit properties dialog in SafeCom Administrator. The internal ID of the Organizational unit the device belongs to. The ID can be seen in the Org. unit properties dialog in SafeCom Administrator. If pages were counted by software(0) or hardware(1). Pull and Push print jobs are always counted using software method. Number of pages with color. Empty in case of a print or copy job. If a Fax job this is the phone number of the receiver. In a Scan job this is the name of the folder. If an Email job this is the e-mail address of the receiver. Whether or not toner save was invoked. Reserved for future use. The cost of the job. Calculated based on the secondary charging scheme and job/device attributes. The name of the Windows print queue that was used to print the document via the SafeCom Push Port or SafeCom Pull Port. The name of the SafeCom Push Port or SafeCom Pull Port that was used to print. The computer name of the computer with the Windows print queue using either the SafeCom Push Port or SafeCom Pull Port. The computer name of the client from where the document was formatted.
YES NO
D60603-07
349
Parameter
TonerCyan
Description
The toner coverage is recorded as 100 times the coverage in percent. Example: A toner coverage of 2.5% is recorded as the 250. A toner coverage of 10000 is equal to 100%. Toner coverage is tracked for Copy, Scan, E-mail and Fax jobs on selected HP LaserJet MFPs with SafeCom Go. See TonerCyan. See TonerCyan. See TonerCyan. Users cost code. Number of sheets.
Default value
0
0 0 0
D60603-07
350
15 SafeCom ID Devices
15
15.1
SafeCom ID Devices
Introduction
SafeCom offers the following stand-alone card readers. Identification Method SafeCom AWID Reader SafeCom Barcode Reader SafeCom Casi-Rusco Reader SafeCom EM Reader SafeCom HID Reader 35 bit SafeCom HID Reader 37 bit SafeCom iCLASS Reader SafeCom Indala Reader 26 bit SafeCom Indala Reader 29 bit SafeCom Keypad SafeCom Legic Reader SafeCom Magnetic Card Reader (Tr 1) SafeCom Magnetic Card Reader (Tr 2) SafeCom Magnetic Card Reader (Tr 3) SafeCom Magnetic Card Reader DD (Tr 1) SafeCom Magnetic Card Reader DD (Tr 2) SafeCom Magnetic Card Reader DD (Tr 3) SafeCom Mifare Reader SafeCom Nedap Reader USB USB USB USB USB USB USB USB USB USB USB USB Serial Serial Serial Serial Serial Serial Serial Serial Serial Serial Serial Serial Serial Serial Serial Section 15.2 15.3 15.4 15.5 15.6 15.6 15.7 15.8 15.8 15.9 15.10 15.11 15.11 15.11 15.12 15.12 15.12 15.13
Serial Serial
15.2
15.3
15.4
D60603-07
351
15 SafeCom ID Devices
15.5
SafeCom EM Reader
Dimensions: 5.5 x 9.0 x 2.0 cm. Color is black. Cable length: 2.0 m. Supports the following card technologies: EM41xx, UNIQUE, TITAN, Hitag 1/2/S and Paxton. The card reader can signal status via lights and beeps when used with SafeCom Go: Status Nobody is logged in Card is presented User is logged in Ligths Solid red Flashing green Solid green Beeps Off One Off
15.6
15.7
15.8
D60603-07
352
15 SafeCom ID Devices
15.9
SafeCom Keypad
The SafeCom Keypad USB (p/n 699010) can be used with SafeCom Go HP on the HP Color LaserJet 3000, 3800 and 4700. The SafeCom Keypad is powered from the printers USB port. Dimension: 10.7 x 15.8 x 3.8 cm. Color is black. Cable length: 1.5 m. The SafeCom Keypad Serial (p/n 974010) can be used with SafeCom Go HP on the HP LaserJet 4250, 4350, 4650 and 5550. The SafeCom Keypad is powered from the supplied switch mode power supply (Input: 230V~, 50Hz/145mA, Output: 12V, 1.3A). Dimension: 10.7 x 15.8 x 3.8 cm. Color is black. Cable length: 1.5 m.
are flashing once are flashing twice are flashing six times are flashing six times are flashing six times
D60603-07
353
15 SafeCom ID Devices
D60603-07
354
16 Troubleshooting
16
16.1
Troubleshooting
SafeCom Help Desk Assistant
We want your SafeCom solution to be one that reduces not only print costs, but is also easy to support. In the following you will find useful troubleshoot hints. The most common problems reported by end-users have been compiled into an online SafeCom Help Desk Assistant available at safecom.eu/help
16.2
16.3
D60603-07
16 Troubleshooting
The IP address of the SafeCom server can be obtained by logging into the SafeCom server, start a Command Prompt and type ipconfig -all
16.4
16.5
16.6
16.7
16.8
D60603-07
356
16 Troubleshooting
resolution of the screen is configured for different value than 96 dpi. Please change the resolution to 96 dpi.
16.9
The message is cleared and the device returns to normal operation by itself a couple of minutes after communication has been restored.
D60603-07
357
16 Troubleshooting
If none of the above accounts for the message it could be because the Windows system on the SafeCom server does not allow any more connections. If you also get a Connection error. Login failed when you try to login to SafeCom Administrator, then you should restart the computer.
D60603-07
358
16 Troubleshooting
D60603-07
359
16 Troubleshooting
The printer may have discarded the document due to driver compatibility problems. Try to print the same document directly to the printer to verify that this has nothing to do with SafeCom.
D60603-07
360
16 Troubleshooting
D60603-07
361
16 Troubleshooting
Typical messages: Unable to connect to SafeCom server (16.32). There is not enough disk space on the SafeCom server. Unable to logon to the SafeCom database. SafeCom license violation. You are unknown to the SafeCom solution.
The above SafeCom generated messages will appear after any print notification messages sent by the Windows print subsystem. For this reason we recommend that you disable notification messages from the Windows print subsystem. On the Windows server open the Printers folder. On the File menu, click Server Properties and click the Advanced tab. Refer to online Windows help.
D60603-07
362
16 Troubleshooting
For additional troubleshooting you may wish to consult the log file produced during the attempted import (7.3.16).
D60603-07
363
16 Troubleshooting
4. 5. 6.
Ensure that Include all local (intranet) sites not listed in other zones is checked. Click Advanced. Enter the website (\\share) and click Add. Click Close. Click OK. Click OK.
D60603-07
364
17
17.1
17.2
Servers
If the solution is a multi server solution it is recommended to produce a diagram (using Microsoft Visio or a similar tool). The diagram should include the different servers and ports used. This section contains three types of tables: SafeCom master Server SQL master Server SafeCom slave Server
The right-most column in the tables contains one or more letters. Use the letters with the legend below: Legend: A If the SafeCom server is clustered all other SafeCom components (devices, port monitors, etc.) must reference Virtual Server and not the nodes. Otherwise failover will not function properly. B The SafeCom license key code is based on the Computer Name (4.9.1), unless the master server is clustered in which case it is based on the Cluster Name (4.9.2). C A SafeCom multi server solution requires the SafeCom master server to use Microsoft SQL Server. Enter SQL Server 2008 R2 Express or SQL. If the SQL server resides on another server then added the word Remote and fill-in the SQL master server table. D Enter the SafeCom G3 version. Example: S82 070.400*01. E Enter the Windows OS information. Example: Windows 2003 SP2 64-bit. F Normally a cluster has two nodes. Add more rows if required. G If the SQL server is clustered the reference to the SQL server should be NetworkName\instancename. Otherwise it should be computername\instancename. The instance name is case sensitive. H Normal practice is to install and use SQL Server 2008 R2 Express on SafeCom slave servers.
D60603-07
365
Virtual Server 1
A A F F F F F F
D60603-07
366
G F F F F F F
D60603-07
367
Virtual Server 1
A A
A A F F F F F F
D60603-07
368
17.3
User identification
How are users identified at the devices? Identification Method User code SafeCom Casi-Rusco Reader SafeCom Cotag Reader SafeCom Deister Reader SafeCom EM Reader SafeCom Felica Reader SafeCom HID Reader 35 bit SafeCom HID Reader 37 bit SafeCom iCLASS Reader SafeCom Indala Reader 26bit SafeCom Indala Reader 29bit SafeCom IoProx SafeCom Legic Reader SafeCom Magnetic Card Reader, Track 1 SafeCom Magnetic Card Reader, Track 2 SafeCom Magnetic Card Reader, Track 3 SafeCom Magnetic Card Reader DD, Tr 1 SafeCom Magnetic Card Reader DD, Tr 2 SafeCom Magnetic Card Reader DD, Tr 3 SafeCom Mifare Reader SafeCom NEDAP Reader SafeCom NexWatch Reader
D60603-07
369
17.4
Devices
Devices can be SafeCom-enabled by means of: External solution Involves the SafeCom Controller and a SafeCom ID Device (normally the SafeCom Front-end). This solution is pretty independent of the printer firmware version. Internal solution Involves the SafeCom Go series. Available for Canon, HP and Ricoh. SafeCom software is installed on the devices hard disk or on a memory module. Attaching a SafeCom ID Device (card reader) may require a SafeCom ID Kit. Always check if there are any dependencies of the printer firmware version. Embedded solution Involves the SafeCom Go series for Xerox. User interaction is via the devices control panel, but SafeCom communication happens via the SafeCom Controller. Always check if there are any dependencies of the printer firmware version.
Use the table below to record the SafeCom device and printer firmware level. Device Model HP Color LaserJet CM4730 MFP Xerox WorkCentre Pro 255 Firmware 50.011.6 14.60.22.000 Ext. SafeCom Int./ Emb. X X Version S89 110.030*42 S80 508.770*42
17.5
Printer drivers
Printer driver HP Color LaserJet 4730mfp PS Version 60.52.262.32
D60603-07
370
18 Index
18
Index
Color supported, 167 Commit billing codes, 312 Completed jobs, 289 Computer name, 97 Configure SafeCom Pull Port, 109 Copy Control, 167 Cost recovery, 324 Counter measures, 325 Create e-mail addresses, 145 Create users at first print, 39, 145 Customize e-mail messages, 154 Data Mining, 289 Database, 52 Database integrity check, 143 Database update log, 52 Default charging scheme, 284 Default user, 146 Delete billgin codes, 323 Delete charging scheme, 284 Delete devices, 252 Delete print jobs, 143 Delete server, 201 Delete server group, 199 Delete tracking data, 288 Delete users, 237 Deposit, 166 Device properties dialog, 167 Device statistics, 289 Device status, 257 DHCP server, 261 Difference between print and copy, 341 Disk space, 21, 43 Document fidelity, 45, 147 Document history, 27 Document list, 262 Domain, 16 Domains, 31 Driver name, 16, 45, 360 Dual charging scheme, 16, 272 Duplex, 278 Duplex supported, 167 E-mail error messages, 148 E-mail notification on credits reserved, 340 E-mail PUK code to new users, 148 E-mail service messages, 148 EmailBilling.txt, 314 EmailJobDelete.txt, 156 EmailPUK.txt, 155
A3 size, 278 A4 size, 278 Accounting policy, 324 Active scripting, 357 Add billing codes, 323 Add charging scheme, 278 Add device, 243 Add group, 228 Add server, 199 Add server group, 198 Add user, 235 Adjustment of tracking data, 271 ADMIN account, 138 Administrative overhead, 34 Administrator, 162 Aliases, 165 Allow users to change PIN code, 145 Apple Mac, 46 Application Programming Interface, 35 Associate charging scheme with device, 283 Authentication dialog, 109, 112 Awareness, 325 Backup, 56, 274 Benefits, 29 Billing code, 16 Billing codes, 18, 310 Broadcast addresses, 174 Broadcast for devices, 250 Broadcast timeout, 174 Built-in accounts, 138 Card lost, 240 card number conversion, 128 Cashier, 330 Cashless solution, 325 Change location of SafeCom print files, 76 Charge, 166 Charge method, 278 Charge per job, 278 Charge per page, 278 Charging scheme, 16, 272, 278 on SafeCom Pull Port, 122 Cheating, 340 Checklist, 37 Citrix, 125 Client installation, 64 Cluster installation, 97 Color, 278
D60603-07
371
18 Index
EmailWarning.txt, 156 EmailWelcome.txt, 155 Encryption, 16, 124 Error printing document, 358 Event log, 48 Event log dialog, 193 ExcludeJobNames.txt, 262 Export tracking data, 287 External file share, 75 Extract logon, 114 Failed jobs, 289 Failover servers, 202 FAQ, 29 Filter document list, 147 filtercard.dll, 128 Find billing codes, 323 Find devices, 248 Find users, 235 Firewall, 65 Frequently asked questions, 29 Front-end, 19 Full cost recovery, 324 Group info, 176 Group print, 190 Group properties dialog, 142 Help Desk Assistant, 34, 355 Home server, 17, 158 Host access list, 125 Host systems, 46 ID code conversion, 128 ID devices, 23 Import billing codes, 315 Import users, 207 Install a card reader on a computer, 126 Install license key code, 97 Install SafeCom Administrator, 130 Installation, 62 Interrupted jobs, 289 JavaScript, 357 Job data string, 114 Job list, 289 Job name pricing, 341 JobNamePricing.txt, 342 Launch Datamining, 288 LCD, 31 Letter size, 278 License dialog, 141 License key code, 17, 97
Local SafeCom Pull Printer, 44, 104 Login denied, 358 Login without PIN code, 159 Lost card, 240 Low limit, 166, 332 Mac, 46 Mainframe, 46 Manuals, 24 Master server, 17 Max login attempts, 145 Member of, 164 Memory, 74 MFP, 17 Modifier, 278 Modify billing codes, 323 Money Server, 19 Monitor device status, 257 MSCS, 17 Multi Function Printer, 17 Multi server installation, 89 Multi Server Support, 17 Network ports, 22, 50 Notification, 48 Notify administrator, 325 Novell, 46 Offline tracking, 275 Online status, 257 Online tracking, 275 Organizational units, 182, 228 Out of order, 357 PAE X86, 74 Paging file, 74 Paper size, 278 Partial cost recovery, 324 Password, 162 Patent, 2 Pay, 324 PCL, 22, 299, 308 Physical Address Extension, 74 PIN code, 17 Planning, 36, 272, 324 Pooling, 108 Port Configurator, 270 Port monitor, 15, 17 Port numbers, 22, 50 Post tracking, 271 PostScript, 22 Prevent cheating, 340 Print all at login, 159 Print from other systems, 46
D60603-07
372
18 Index
Print once, 190 Print Spooler, 361 Printer pooling, 108 Processes, 49 Proxy server, 174 PUK code, 17 Pull Port Charging scheme, 122 Pull Print, 18, 167 Pull Printing, 15, 263 Push Print, 18, 167, 264 Push tracking, 34, 264 Quota control, 324 RAID, 33 RAM DISK, 359 RBP, 20 Re-installation, 77 Release credits, 325 Release credits reserved on error, 340 Reply address, 148 Reserved, 166, 332 Reserved credits, 341 Resilience, 202 Restart devices, 260 Restore, 56, 274 Restricted access, 31, 167, 184, 261, 358 Retain documents, 159 Roll out considerations, 47 Rule Based Printing, 20 SafeCom Administrator, 129 SafeCom App Print, 84 SafeCom Application Print, 84 SafeCom Billing, 18 SafeCom Client, 18 SafeCom Controller, 19 SafeCom Data Mining, 289 SafeCom Device Utility, 343 SafeCom ePay, 19 SafeCom Front-end, 19 SafeCom Go, 13, 19 SafeCom Help Desk Assistant, 34, 355 SafeCom Job Server, 19 SafeCom Money Loader, 19, 325 SafeCom Money Server, 19 SafeCom Pay, 324 SafeCom PopUp, 116 Configuration, 120 Dialog timeout, 122 SafeCom Port Configurator, 270 SafeCom Print Client, 20, 79 SafeCom processes, 49
SafeCom Pull Port, 109 SafeCom Rule Based Printing, 20 SafeCom Service, 49 SafeCom Tracking Server, 20 SafeCom Web Interface, 20 safecom_trace folder, 58 SAP print, 114 Scalability, 32 scBackup, 57 sccoremssql, 52 scdbu.log, 52 sceventmssql, 52 Schedule billing code import, 315 Scheduled tracking data collection, 276 Scheduled user import, 207 scping, 49 scPopUp.exe, 116 arguments, 117 scpursemssql, 52 scRuleExecuter.dll, 298, 309 scStartup.cmd, 58 sctrackingmssql, 52 Server group name, 20 Server installation, 63 Server properties dialog, 143 Server requirements, 21 Service, 49 Set low limit, 166, 332 Shared SafeCom Pull Printer, 44, 103 Smart Card, 325, 336 SMTP mail server, 148 SQL collation, 68 SQL database, 52 SQL user safecominstall, 68, 71 Standard user, 162 Statistics dialog, 192 Subject for job name pricing, 278 Synchronize groups, 228 System integration, 35 System requirements, 21 Clients, 22 Printers, 22 Server, 21 TCP port numbers, 22, 50 TECH account, 138 Technician, 162 Terms, 16 Test server, 134 Tool installation, 64 Touch tone, 147, 148 Touch-screen, 31 Trace, 58
D60603-07
373
18 Index
scStartup.cmd, 58 Trace facility, 61 Tracking, 263 Tracking data, 287 Tracking data adjustment, 271 Tracking Server, 20 Trademarks, 2 Transactions dialog, 339 Translate e-mail messages, 154 Troubleshooting, 355 UDP port numbers, 22, 50 Unable to connect to SafeCom server, 362 Uncollected documents, 33 Unfinished job, 340 UnfinishedJob.txt, 340 Uninstall SafeCom, 78 SQL Server 2008 R2 Express, 78 UNIX, 46 Update log, 52 Update SafeCom software Multi server installation, 96
Single server, 77 Update software SafeCom devices, 252 Upgrade from Express to SQL, 87 Use job data logon, 114 User account dialog, 166 User code, 38, 40, 41 User created at first print, 357 User creation, 38 User import, 207 User properties dialog, 157 User statistics, 289 User unknown, 358 Virtual memory, 74 Virtual server, 20 Windows Firewall, 65 Windows printer pooling, 108 Windows registry settings, 53 Windows Terminal Service, 125 WTS, 125
D60603-07
374
18 Index
D60603-07
376