PaperCut MF - Toshiba MDS V3 Embedded Manual-2018-07-18
PaperCut MF - Toshiba MDS V3 Embedded Manual-2018-07-18
PaperCut MF - Toshiba MDS V3 Embedded Manual-2018-07-18
Manual
Contents
1 Version history .................................................................................................................. 5
2 Overview ........................................................................................................................... 6
2.1 Consistency ................................................................................................................ 6
2.2 Integration ................................................................................................................. 6
2.3 Rate of development ................................................................................................. 6
2.4 Vendor Neutral .......................................................................................................... 6
2.5 Security ...................................................................................................................... 7
2.6 Which version should I install? .................................................................................. 7
2.7 Migrating from SDK 2 to Toshiba v3+ Devices .......................................................... 7
2.8 Installation methodology for Toshiba v3+ Devices ................................................... 8
3 Installation ........................................................................................................................ 9
3.1 Upgrading to a newer version of PaperCut ............................................................... 9
3.2 Requirements ............................................................................................................ 9
3.3 Supported Toshiba Devices ....................................................................................... 9
3.4 Setup Procedure ...................................................................................................... 11
3.4.1 Verify Access to the Toshiba Administrative Web Interface ........................... 11
3.4.2 Log in as device Administrator ........................................................................ 11
3.4.3 Networking/Firewall Configuration ................................................................. 11
4 MFD Device configuration .............................................................................................. 12
4.1 ODCA (Off Device Customization Architecture) (mandatory) ................................. 12
4.2 Set an “Auto Clear” timeout (recommended) ......................................................... 12
4.3 Disable Logout pop-up dialogue display (optional)................................................. 12
4.4 Disable Automatic logout of users during fax send (optional) ................................ 13
4.5 Additional 08 code setting (optional) ...................................................................... 13
4.6 Enable OCR on the device (optional)....................................................................... 13
4.7 Enable Zero Stop functionality for Copy and Scan (optional) ................................. 14
4.8 Disable MFD control of print jobs (mandatory) ...................................................... 14
4.9 Allow anyone to manage print jobs at the MFD (mandatory) ................................ 14
4.10 Allow all users to delete their jobs from the Private/Hold screen on the copier
(mandatory) ........................................................................................................................ 14
4.11 Configure the Web Services Scan Port (optional) ................................................... 15
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 2 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 3 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
1 Version history
PaperCut MF version Date Details
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 5 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
2 Overview
This manual covers the Toshiba MDS V3 embedded MFD setup. For general PaperCut MF
documentation, please see the PaperCut MF manual.
This manual provides an overview of the installation, configuration and operation of PaperCut’s
embedded software MFD (Multi-Function Device) solutions. Today’s MFDs are smarter – they have
touch screens and offer the ability to run applications directly on the device. The goal of PaperCut
Software’s embedded MFD solution is to leverage these smart devices and to provide walk-up copier
users with the same set of rich application features provided in the print control area. These include:
2.1 Consistency
The embedded solutions are developed in-house by the PaperCut Software development team. This
ensures that the copier interface is consistent with the workstation print interface, meaning users
only have to learn one system.
2.2 Integration
PaperCut is a single integrated solution where print, internet and copier control are all managed in
the one system. Users have a single account and administrators have the same level of reporting and
administration for all services. The embedded solution interacts with the PaperCut server using a
Service Oriented Architecture (SOA) and web services based protocols.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 6 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
2.5 Security
A large percentage of PaperCut’s user base is in Education environments where security is
important. All embedded solutions are developed with security in mind. Where security objectives
can’t be satisfied, any known deficiencies are fully disclosed.
To be compatible, devices must support Toshiba Open Platform SDK version 3 or later, and be listed
in “3.3 Supported Toshiba Devices”.
Devices supporting only Toshiba SDK 2 should use PaperCut’s Toshiba V2 embedded software,
documented separately in the manual entitled PaperCut MF - Toshiba SDK2 Embedded Manual.
Devices that support Open Platform SDK version 3 that had previously been installed with PaperCut’s
SDK 2 support, can be migrated using the instructions in “1.7 Migrating from SDK 2 to Toshiba v3+
Devices.
To migrate your current Toshiba SDK2 device (now known as “Toshiba v2”) to MDS V3 device
(known as “Toshiba v3+”):
1. In the PaperCut Admin web interface Device section, take the following screenshots for the
existing Toshiba device:
• Summary
• Charging
• Filters and Restrictions
You will use these as a reference when filling out the new device settings.
2. Delete the existing “Toshiba v2” device.
3. Wait a few minutes so that PaperCut can fully finish all necessary maintenance/uninstall
tasks on the device.
4. Create a new “Toshiba v3+” device with the same name you gave the “Toshiba v2” device;
then apply any relevant settings from the screenshots.
5. To verify that the “Toshiba v3+” has been successfully registered, check the following:
• The External Device List page displays “Started – Awaiting user login” in the Status
column.
• The device panel displays the PaperCut login page (you might need to refresh the
screen by clicking the “Access” hard key button).
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 7 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
NOTE: When the original device is deleted, all historical log records in the PaperCut database will not
be deleted. This data will still be available in all the available usage reports.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 8 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
3 Installation
This section covers the installation of the PaperCut embedded application for compatible Toshiba
devices. The embedded application allows the control, logging, and monitoring of walk-up off-the-
glass copier, fax, and scanner usage, and can serve as a Release Station for network prints (for
information on tracking network printing, see the PaperCut manual).
3.2 Requirements
Ensure that the following points are checked off before getting started:
• PaperCut is installed and running on your network. For more information, see Installation in
the PaperCut manual.
• Ensure that your Toshiba MFD supports Open Platform SDK version 3 and is in the list of
supported devices (see 3.3 Supported Toshiba Devices)
• The Toshiba devices must be directly accessible over the network by the PaperCut server
(i.e. not via a NAT network).
• Verify that the Toshiba Embedded Web Browser (EWB) is enabled on your device. This is
enabled through the “External Interface Enabler” (Code: GS-1020). This is an option in some
markets and you should check with your Toshiba representatives.
• Have available the network name and IP address of the system running PaperCut (e.g. the
print server).
• Ensure that the Toshiba MFD is connected to the network.
• Have available the network address of the Toshiba MFD. It is recommended that the MFD is
configured with a static IP.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 9 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
e-STUDIO 2008A
e-STUDIO 2508A
e-STUDIO 3008A
e-STUDIO 4508A
e-STUDIO 5008A
e-STUDIO 2000AC
e-STUDIO 2505AC
e-STUDIO 3005AC
e-STUDIO 3505AC
e-STUDIO 5005AC
e-STUDIO5508A
e-STUDIO6508A
e-STUDIO7508A T385HD0W1043
e-STUDIO8508A
e-STUDIO5506AC
e-STUDIO6506AC T380HD0W1043
e-STUDIO7506AC
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 10 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• Inbound connections from the Toshiba devices to the PaperCut server on ports:
o 9191 (TCP/HTTP).
o 9292 (TCP/HTTPS).
• Outbound connections from PaperCut to the Toshiba Device on ports:
o 49629 (TCP/HTTP)
o 49630 (TCP/HTTPS)
o 50083 (TCP/HTTP) (or any other customized port for scanning services)
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 11 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 12 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 13 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
4.7 Enable Zero Stop functionality for Copy and Scan (optional)
To enable the Zero Stop functionality for both Copy and Scan walk up functions, “Quota Setting”
needs to be set to “Job Quota”
4.10 Allow all users to delete their jobs from the Private/Hold
screen on the copier (mandatory)
1. Enter FS service mode, enter 08 service mode.
2. Enter “Classic” mode.
3. Enter: 9236, press “Start”.
4. Enter: 3 (default value 1)
5. On the LCD screen, press “OK”.
6. Restart the MFD by holding down the “Main Power” button until it stops.
7. Press “Main Power” again to restart.
Note: print jobs will only need to “managed” after being secularly release from PaperCut.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 14 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 15 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• MDS Mode
• Programmable Hard Key “1”
• EWB Login and Home pages
• MFD security settings
1. In a web browser, log in to the PaperCut Admin web interface (e.g. http://papercut-
server:9191/admin ).
2. Navigate to “Options > Advanced”.
3. In the “External Hardware Integration” area, select “Enable external hardware”.
4. Click “Apply”.
5. Select the “Devices” tab.
6. In the Actions menu, click “Create device”.
7. In “Type”, select “Toshiba v3+”.
8. Enter the device details, including the network address / IP address of the Toshiba device.
9. Select the device functions to control/log (e.g. copying, scan, fax, etc).
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 16 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
5 Post-install testing
After PaperCut MF is installed on the device (i.e. device registration and integration is completed), it
is recommended that you test some common usage scenarios. This is important for two reasons:
This section covers the following post-install testing scenarios for PaperCut MF - Toshiba v3+:
• Simple test user – A user who performs simple printing and copying.
• Advanced test user – A user who performs advanced copying.
5. Navigate to Users.
6. Click Create internal user…
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 17 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
7. Enter the relevant details for the test users as required (simple test user, advanced test
user):
8. Click Register.
To test the simple test scenarios, ensure at least one simple test user is created. For more
information, see 5.1 Test preparation: create test users. Once created, ensure the simple test user is
configured.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 18 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
5. In the Account Selection area’s Print account selection, select Automatically charge to
personal account:
6. Click Apply.
Simple printing does not involve providing the simple test user with a choice of accounts to choose
from. Printing is charged to the simple test user’s default My Personal Account.
To test simple printing, ensure the following test preparation requirements are met:
• Simple test user - A simple test user is created and configured. For more information, see
5.1 Test preparation: create test users and 5.2.1 Test preparation: configure simple test user.
• Printer queue settings - The printer queue’s Hold/Release Queue Settings are configured.
For more information, see the PaperCut MF manual.
To configure the printer queue’s Hold/Release Queue Settings:
1. Log in to the PaperCut MF Admin web interface.
2. Navigate to Printers.
3. Select the Printer that is applicable to the device being tested.
4. In the Hold/Release Queue Settings area, select the Enable hold/release queue.
5. Click Apply.
Print jobs to this printer queue are held until released by a user.
• Device functions – The printing function is enabled.
To enable the printing function:
1. Log in to the PaperCut MF Admin web interface.
2. Navigate to Devices.
3. Select the device being tested.
4. In the Print Release area, select Enable print release.
5. In the This device will display jobs for release from the selected source queues,
select at least one source queue for print release that corresponds to this device’s
configured printer queue.
6. Click Apply.
7. Verify that the Devices > External Device List displays the device with Print Release
in the Function column.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 19 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
2. Print a few jobs to the source queue that was selected in the Devices > External Device
List > Device Details > Print Release > Enable print release area of the device being tested.
3. Log in to the PaperCut MF Admin web interface.
4. Navigate to Printers > Jobs Pending Release.
5. Verify that the print jobs for the simple test user are being held and listed:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 20 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
8. Verify that the print jobs for the simple test user are being held and listed:
Note: You may be able to change the settings of held print jobs on the PaperCut MF Print
Release screen before releasing them. For more information, see 6.5 Held print job settings
at the device.
9. To release one or many held print jobs at once, select all the relevant held print jobs and
click Print.
10. To delete one or many held print jobs at once, select all the relevant held print jobs and click
the Bin icon.
11. To view and take actions on a single held print job, click the chevron:
Note: You may be able to change the settings of held print jobs on the PaperCut MF Print
Release screen before releasing them. For more information, see 6.5 Held print job settings
at the device.
12. Log out of the device.
13. Log in to the PaperCut MF Admin web interface.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 21 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Simple copying does not involve providing the simple test user with a choice of accounts to choose
from. Copying is charged to the simple test user’s default My Personal Account.
To test simple copying, ensure the following test preparation requirements are met:
• Simple test user - A simple test user is created and configured. For more information, see
5.1 Test preparation: create test users and 5.2.1 Test preparation: configure simple test user.
• Device functions – The copying function is enabled. To enable the copying function:
1. Log in to the PaperCut MF Admin web interface.
2. Navigate to Devices.
3. Select the device being tested.
4. In the External Device Settings > Tracking area, select Track & control copying.
5. Click Apply.
6. Verify that the Devices > External Device List displays the device with Copier in the
Function column.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 22 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 23 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
10. After copying is completed, verify that Job Log page displays the test user’s name, simple
test user, in the User column and the Charged To column:
To test advanced copying, ensure the following test preparation requirements are met:
• Advanced test user – An advanced test user must be created. For more information, see 5.1
Test preparation: create test users.
Once created, the advanced test user must be configured.
To configure the advanced test user:
1. Log in to the PaperCut MF Admin web interface.
2. Navigate to Users.
3. From the User List, select the advanced test user.
4. In the Account Details area, set the Balance to $50.00 and select Restricted:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 24 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
5. In the Account Selection area’s Print account selection, select Standard account
selection popup and in Information to show in popup, select all the options:
6. Click Apply.
• Device functions – The copying function is enabled.
To enable the copying function:
1. Log in to the PaperCut MF Admin web interface.
2. Navigate to Devices.
3. Select the device being tested.
4. In the External Device Settings > Tracking area, select Track & control copying.
5. Click Apply.
6. Verify that the Devices > External Device List displays the device with Copier in the
Function column.
• Advanced account – A test account is created.
To create a test account:
1. Log in to the PaperCut MF Admin web interface.
2. Navigate to Accounts.
3. Click Create a new account….
4. In the Details & Balance area’s field Account Name, enter the name of the test
account (test account).
5. Click Apply.
6. Verify that the Accounts > Shared Account List page displays the test account
created.
7. Click the test account.
8. Navigate to Security.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 25 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
9. In the Control access to this account > Groups area, select [All Users]; then click
Add:
10. Verify that the Control access to this account > Groups area displays [All Users]:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 26 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 27 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
6 Configuration
After completing the Installation section and registering the device with PaperCut, it has been
configured with reasonable default settings that are suitable for most environments. This section
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 28 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
covers how to change the default settings. All the following settings are available via the device’s
‘Summary’ tab in the PaperCut administration interface.
To enable HTTPS:
1. You must have an SSL certificate installed on the PaperCut MF Application Server.
The certificate must use the server’s fully-qualified domain name. This must be defined
either in the Common Name (CN) field or included in the Alternative Names (AN) of the
subject of the certificate. Without this, the device cannot connect to the server, since
devices do not work with hostname-only certificates (i.e. not fully qualified).
You may use an official Certificate Authority-signed certificate or a self-signed certificate:
• If you are using an official CA-signed certificate (for example, Verisign, Thawte), it is
likely to use the server’s fully qualified domain name (or wildcard). This is because
Certificate Authorities generally no longer accept certificate requests for either intranet
names or IP addresses.
• If you are using the self-signed certificate that is generated by default when installing
PaperCut MF, ensure to regenerate it for a fully qualified domain name. This is because
the default self-signed certificate generated during PaperCut MF installation (device
registration and integration) is issued using a hostname, instead of the domain name.
Regenerate it using PaperCut MF’s create-ssl-keystore tool in:
[PaperCut MF Install Location]\server\bin\[platform]
Run the following command to regenerate the certificate using the tool:
create-ssl-keystore -f "myserver.fullname.com"
For more information, see the PaperCut MF manual.
After the certificate is regenerated, you must upload it on the device’s web interface
(TOPACCESS). To upload the regenerated certificate on the device’s web interface
(TOPACCESS):
a. Extract the regenerated certificate that is installed on the PaperCut MF Application
Server, using Keystore Explorer (the password is default), as a PEM file. For more
information, see SSL with PaperCut and Keystore Explorer.
b. Log in to the device’s web interface (TOPACCESS) as an administrator.
c. Navigate to Administration > Security > Certificate Management
d. In the CA Certificate section, select CA Certificate (PEM).
e. Click Choose file and follow the prompts to upload the extracted regenerated
certificate (PEM file):
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 29 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
f. Click Save.
2. Use the following config keys:
ext-device.toshiba.secure-odca
ext-device.toshiba.secure-app-server-url
system.network-address
ext-device.toshiba.secure-scanning
For more information, see 6.12 Config Editor.
3. Ensure to enable secure ODCA. For more information, see 6.2 Enable secure ODCA in
PaperCut.
4. Ensure to configure inbound connections to PaperCut MF Application Server. For more
information, see 6.3.1 Inbound connections to PaperCut MF Application Server.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 30 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
To configure PaperCut MF to allow inbound connections from the device to the PaperCut MF
Application Server, use the config key system.network-address. For more information, see 6.12
Config Editor.
To configure PaperCut MF to allow inbound connections from the device to PaperCut MF Site
Servers on the PaperCut MF Admin web interface:
1. Site Servers must already be installed and configured. For more information, see the
PaperCut MF manual.
2. Log in to the PaperCut MF Admin web interface.
3. Navigate to Sites.
4. Select the Site Server.
5. In the Configuration area, enter the network IP address (if using HTTP) or DNS name (if using
HTTP or HTTPS) of the PaperCut MF Site Server that the device uses to make inbound
connections.
6. Click Apply.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 31 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Track & control copying The device will track walk-up off-the-glass copying and on-device
printing.
Track & control scanning The device will track scanning such as scan-to-email or scan-to-file.
Track & control faxing The device will track the sending of faxes.
Enable release station The device will act as a print Release Station.
• 6.5.1 Held print jobs settings that can be changed at the device
• 6.5.2 Held print jobs settings that can be viewed at the device
6.5.1 Held print jobs settings that can be changed at the device
PaperCut MF allows users to change the settings of held print jobs on the device. Based on the
changes made, PaperCut MF shows the updated cost and savings, to give immediate positive
feedback to the user, encouraging behavior change.
Users can make the following changes to print settings for multiple jobs on the device:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 32 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Clicking the chevron of a held print job displays all the settings for the individual job, allowing users
to make the following additional changes:
• Copies
• Duplex mode (from 1-sided to 2-sided)
• Color mode (from color to grayscale)
• Account
If required, you can however, prevent users from being able to change print settings on the device.
For more information, see the PaperCut MF manual
6.5.2 Held print jobs settings that can be viewed at the device
By default, PaperCut MF displays the following print settings for individual jobs on the device:
• Account
• Balance
• Cost
PaperCut MF also displays the total cost for multiple jobs on the device.
If required, you can however, prevent users from being able to view print settings on the device. For
more information, see the PaperCut MF manual
To access the available authentication methods on the PaperCut MF Admin web interface:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 33 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
2. Navigate to Devices.
3. Select the device.
The available authenticate methods are in the Device Details page’s External Device
Settings area:
Note: You may use any one or a combination of all the available authentication methods,
including the anonymous access authentication method. However, you cannot use the guest
access authentication method. For more information, see 8.1 The guest access
authentication method is unavailable.
Authentication Description
Method
Identity number With this method, users use their ID number. For more information,
see the PaperCut MF manual.
Require PIN: With this method, users use their id number and the PIN
associated with the id number.
Note: Users can use an id number with or without a pre-set and
associated PIN. If using an id number without a pre-set and associated
PIN, users are prompted to set a valid PIN to associate with the id
number.
Swipe card With this method, users use their registered swipe card (e.g. magnetic
strip, smart card, RFID). For more information, see the PaperCut MF
manual.
Require PIN: With this method, users use their registered swipe card
and the PIN associated with the card.
Note: Users can use a swipe card with or without a pre-set and
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 34 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Allow guest/anonymous With this method, you may choose to activate guest or anonymous
access access, enabling users to be authenticated as guest or anonymous
users, as per the user specified in the Inherit settings from user field.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 35 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• 6.7.2 By name
• 6.7.3 By code
This is based on a user’s Account Selection setting on the PaperCut MF Admin web interface. To this
on the PaperCut MF Admin web interface:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 36 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
By Name By Code
Users select the relevant shared account by Users select the relevant shared account by
scrolling through a list of all applicable shared using the shared account’s code.
accounts (maximum of 500, with a scroll bar) Note: The user’s My Personal Account and the
or by searching for the shared account using Default Shared Account (if set) is not displayed.
the account’s name.
Note: The user’s My Personal Account and the
Default Shared Account (if set) is always
displayed.
6.7.2 By name
For users who on the PaperCut MF Admin web interface (Users > Details) have Account Selection
set to Show the standard account selection popup and Information to show in popup set to Allow
user to select shared accounts (from list), the PaperCut MF Select Account screen displays only one
method of selecting accounts – by name. Users select the relevant shared account by scrolling
through a list of all applicable shared accounts (maximum of 500, with a scroll bar) or by searching
for the shared account using the account’s name.
Note: The user’s My Personal Account and the Default Shared Account (if set) is always displayed.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 37 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
6.7.3 By code
For users who on the PaperCut MF Admin web interface (Users > Details) have Account Selection
set to Show the standard account selection popup and Information to show in popup set to Allow
user to select shared accounts (using PIN/code), the PaperCut MF Select Account screen displays
only one method of selecting accounts – by code. Users select the relevant shared account by using
the shared account’s code.
Note: The user’s My Personal Account and the Default Shared Account (if set) is always displayed.
The text can be customized by editing the device configuration from the PaperCut administration
interface.
• Create a 24bit PNG image of the logo, which is 230 pixels wide and 55 pixels high.
• Save the image with the filename “logo.png” in the following PaperCut application
directory and subdirectory:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 38 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
To customize the header background color, and the header text color, see the 6.12 Config Editor for
more information about configuring the following:
• ext-device.toshiba.header-background-color
• ext-device.toshiba.header-font-color
Note: Any customizations made (header logo, header background color, header text color) are
globally applied across all the embedded application screens, on all registered Toshiba V3+ devices.
Customizations made are not applied to other Toshiba devices on your network.
• A typical case is the checksum being reported after the card number, separated by an equals
sign, such as in 5235092385=8. PaperCut can handle this case by default; it will extract
the number before the equal sign as the card number: 5235092385.
• For some cases, a “regular expression” that will filter the card number from the complete
string of characters reported by the card reader might be required. Documentation on
regular expressions can be found on the Internet, e.g. at .
o The regular expression must be fashioned so that the card number is returned as the
first match group.
o Usually one regular expression will be used for all the devices managed by PaperCut;
this must be entered in the “Config editor” in the PaperCut Admin Console. Open
the Admin Console and select the Options tab, then select “Config Editor
(Advanced)” from the left menu. The key is called “ext-device.card-no-regex”.
o The global setting however can be overridden on a per-device basis: The key “ext-
device.card-no-regex” can also be found on the “Advanced Config” tab in the device
details screen. This setting will override the global setting unless the keyword
“GLOBAL” is specified.
o PaperCut developers will gladly assist in producing a regular expression when
supplied with a few sample outputs from your card reader. Contact your reseller or
Authorized Solution Center for help with regular expressions. You can find their
contact information in your PaperCut Admin interface on the About page.
o If you would like to write your own regular expressions, here are some examples:
▪ Use the first 10 characters (any character): (.{10})
▪ Use the first 19 digits: (\d{19})
▪ Extract the digits from between the two “=” characters in
“123453=292929=1221”: \d*=(\d*)=\d*
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 39 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
ext-device.id- Customize the "ID Number" field label on the login page.
number.label
An organization might want to do this if, for example, users
need to enter their employee number to log in. Changing the
“ID Number” field label to “Employee Number” makes the user
experience more intuitive.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 40 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
ext-device.toshiba.limit- Used at log in time, to assume what page size the copying is
reference.paper-size going to use. This is used to decide if we have enough quota to
do a single copy. By default, for the United States this size is
Letter and elsewhere it is A4.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 41 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
ext-device.toshiba.port- The port number used for ODCA (Off Device Customization
num Architecture) as set up in TopAccess.
ext-device.toshiba.serial- The serial number of the device that was last queried from the
number device. This is used so that we know if the device changes
across restarts of the PaperCut Application Server.
system.network-address Specify the network IP address (if using HTTP) or DNS name (if
using HTTP or HTTPS) of the PaperCut MF Application Server
that the device uses to make inbound connections.
ext-device.toshiba.secure- When set to “Y”, the MFP will use SSL for EWB (Embedded
app-server-url Web Browser) login/logout events and for integrated scanning
events sent to the PaperCut server.
Default: “N” (EWB requests and events will not be encrypted).
For more information, see 6.1 HTTPS Security (recommended)
ext-device.toshiba.secure- When set to “Y”, PaperCut will use SSL for the SOAP
odca communications with ODCA. This will ensure the setting of
quotas and the Toshiba log information is encrypted.
Default: “N” (ODCA messages will not be encrypted).
For more information, see 6.2 Enable secure ODCA in PaperCut
and 6.1 HTTPS Security (recommended)
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 42 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
ext-device.toshiba.secure- When set to “Y”, PaperCut will use SSL for the SOAP
scanning communications to control integrated scanning. This will, for
example, ensure the retrieval of scanned images are
encrypted.
Default: “N” (Integrated scanning messages will not be
encrypted).
For more information, see 6.1 HTTPS Security (recommended)
ext- Used to reduce the chance of the overrun of zero stop causing
device.toshiba.overrun- the balance to go negative. It works by submitting to the MFD
offset for its quota, the balance of the account minus the overrun
offset. For example, if the account had $2 and the overrun-
offset was $0.20 then the MFD would be told the account has
a balance of $1.80 to make sure it stops printing earlier to
avoid overrun.
NOTE: The problem with modifying this setting is that it can
then prevent the user from doing any printing when they
reach below that threshold. For example, if this amount is set
to $0.20, and they have enough money to print a $0.10 job,
they will be denied (which might not be expected by the user).
Do not change this setting unless you understand the
repercussions.
Default: “0” (Do not subtract anything from the account
balance sent to the MFD)
ext-device.toshiba.login- When set to "Y" it will always do a credit check at login time to
credit-check decide whether to allow the user copier access. If set to "N",
then PaperCut will rely on the zero-stop mechanism on the
device to prevent doing a copier function without enough
credit. Since zero-stop is not supported for Faxing, having this
configuration enabled might be useful to prevent users from
faxing without enough credit.
Default: N (don't do credit check on login; rely on zero-stop)
ext-device.toshiba.show- When set to "Y", MFD errors will be shown on the Print
printer-errors Release page.
Default: Y
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 43 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
ext-device.toshiba.no- When set to "Y", MFD errors will be shown on the Welcome
access-on-printer-errors page and the MFD will be locked down so that no operations
are allowed.
Default: N
ext-device.toshiba.delete- When set to "Y", any jobs in suspended state on the MFD (such
suspended-jobs-on-logout as jobs which cannot continue because of an error on the
MFD) will be deleted when the user logs out.
Default: N
ext- When set to "Y", we will only consider the MFD to be in "No
device.toshiba.calculate- Paper" error state if all the trays of a particular paper size are
printer-errors-using-tray- out of paper. When set to "N", any tray out of paper will cause
data the MFD to be in error.
Default: Y (always look at the MFD's tray data to determine
"No Paper")
ext-device.toshiba.scan- The Web Services Scan port as configured on the Toshiba MFD.
port-num On eBN devices, the value is updated automatically to reflect
the value read from the device. On eBX devices, the value
needs to be updated manually, depending on the value set.
ext-device.block-release- Defines the error types that will block the release of jobs from
on-error.snmp-error-list the MFD Print Release. Valid values:
ext-device.toshiba.initial- Choose the first native device screen that is displayed, when
native-screen the user clicks Access Device from the PaperCut Home screen.
The native device screens available are: Menu, Home, Scan,
Fax, Print, eFiling, and Copy.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 44 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Values: Y, N, Default
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 45 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
ext-device.toshiba.show- Configure the PaperCut Print Release page to display the Job
job-status-button Status button on the Print Release page to allow users to
access the native device’s job status page and view the status
of print/fax/scan jobs.
Values: Y, N, Default
Values: Y, N
Default: N
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 46 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Set this global config key in the PaperCut MF Admin web interface:
Options > Config editor (advanced).
Values: Y, N
Default: N
Values: Y, N
Default: N
Values: Y, N
Default: N
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 47 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• ext-device.toshiba.app-button1.label
• ext-device.toshiba.app-button1.url
• ext-device.toshiba.app-button2.label
• ext-device.toshiba.app-button2.url
Default: NONE
ext-device.toshiba.app- Specify the relevant third party application’s URL that the the
button1.url additional button on the PaperCut MF Home screen links to.
Default: NONE
Default: NONE
ext-device.toshiba.app- Specify the relevant third party application’s URL that the additional
button2.url button on the PaperCut MF Home screen links to.
Default: NONE
ext-device.toshiba.release- Toggle the display of the cost of held print jobs on the PaperCut MF
show-cost Print Release screens on the device.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 48 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• Values: Y, N
• Default: Y
Note: Setting this to N also hides the account balance and does not
display the savings based on other changes made to held print job
settings. For more information, see 6.5 Held print job settings at
the device.
ext-device.toshiba.login- Customize the text that appears on the PaperCut MF Login screen.
instruction For example, instructions to help users log in to PaperCut MF on the
device.
Values: Y, N, DEFAULT
Default: 60 (seconds)
Note: This comes into effect only if it is lower than the value of the
device’s timeout. However, if it is higher, then it is overridden by the
lower value of device’s timeout.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 49 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
process of sending the completed scan job to the user (scan transfer)
is also automatically initiated, and the user is logged out.
ext-device.toshiba.guest- Customize the text of the Guest button that appears on the
access.label PaperCut MF Login screen.
Note: The limit quota reference configurations are used in a different way than the standard limit
references, such as, ext-device.toshiba.limit-reference.duplex. The standard ones are used at log in
time to decide if the user has permission to do copies, assuming they are going to try to do at least
one page of a certain page size and whether it will be duplex or not. The limit quota reference
configurations are used to set the page costs for quotas on the copier. For example, if PaperCut is
told to charge $0.50 for A3 pages, and ext-device.toshiba.limit-reference.quota.large-paper-size is
set to A3, then this will tell the copier that large-pages cost $0.50.
7 Scanning
There are now 2 choices regarding scanning in PaperCut:-
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 50 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• MFD Native Scanning the user will be required to leave the PaperCut interface however it
does support address book
• PaperCut Integrated Scanning provides an excellent user experience as all functions are
available in a unified interface and where administration is managed centrally.
Although it is technically possible to offer a hybrid of both Toshiba Native Scanning and PaperCut
Integrated Scanning, the overall user experience needs to be considered after consultation with your
client.
Irrespective of method chosen please be sure to have the latest MFD firmware is installed.
Toshiba devices can be configured to scan to network folders that can be predetermined for each
user. This functionality requires PaperCut MF version 16.4 or later. To configure scan to network
folders:
3. Click “Save”.
4. Under the Toshiba TopAccess configuration, navigate to Administration > Setup > Save As
File.
5. In the “Destination” area:
a. Select “Use Network Folder Destination”
b. Set “Default file path” to “Remote 1”.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 51 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
a. Complete the settings under “Remote 1”. This is the network location that will be
overwritten by the user’s home directory attribute. This is used as the default if the
user’s home directory is not specified in PaperCut.
b. Enter the Login User Name and Password for a user account that has read/write
permissions to all user home directories. These credentials are used to authenticate
to the shared drive if the user authenticates with card authentication. If the user logs
into the device with standard credentials, those will be used to authenticate against
the network folder.
c. Click “Save”.
7. Optionally, you can configure the device to skip showing a warning message on login when
the user has no home directory specified by setting the 08 code “8722” to “1”.
Toshiba devices can be configured to scan to e-mail addresses that can be predetermined for each
user. This functionality requires PaperCut MF version 16.4 or later. The process to configure this
functionality is:
If the “Use Email Address which was registered Local User” option is not available under “From
Address” (on older devices), then the device still needs an LDAP server to detect the user’s email
address. In this case, refer to the Toshiba SDK v2 manual - Enable LDAP User Authentication for how
to set up an email address.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 52 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
MFD settings:
Enable the device "Web Services Scan" service and allow it to accept any job:
Note: If MFD Embedded OCR is installed, see 4.6 Enable OCR on the device (optional).
PaperCut MF settings:
Enable Integrated Scanning for each device (PaperCut MF Admin web interface):
1. Click the “Devices” tab. The External Device List page is displayed.
2. Select a device. The Device Details page is displayed.
3. In the Integrated Scanning area, select the “Enable Integrated Scanning” check box.
4. Click “OK”.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 53 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• The copier does not seem to stop immediately when limits are reached for copying. There is
a small delay meaning that users can overrun their account below zero by about 2 pages.
This can be avoided by using ext-device.toshiba.overrun-offset and setting to an appropriate
amount (please see the advanced configuration section for more details), however, there
are drawbacks with doing this.
• Ideally PaperCut would be informed of the user selection prior to copying or scanning and
can accept/reject the job at this point. Current Toshiba API implementations prevent this
level of pre-approval.
• SDK version 3 supports the page costs of color, grayscale, small page size and large page size.
It does not support costs or discounts for duplex and individual pages sizes other than the 2
sizes of small and large. By default, the small paper size is set to ext-device.toshiba.limit-
reference.quota.small-paper-size which is US letter in the United States and A4 everywhere
else. The large paper size is set to ext-device.toshiba.limit-reference.quota.large-paper-size
which is Ledger in the United States and A3 everywhere else.
When the quota limit is exceeded a popup message on the device will alert the user to having run
out of quota.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 54 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
If the scanning is stopped midway through when scanning off the platen, then the Toshiba error
message is different to above, instead it says, “The quota has been reached. Only the previously
scanned documents will be processed”. Zero stop is not supported when scanning (PaperCut MF’s
Integrated Scanning and device’s scanning). If the scanning is denied from the outset, then the
standard message above will be shown.
• Undefined
• Admin
• Service
• Auditor
• Guest
If a PaperCut username matches an internal username (not case sensitive), login will fail and an error
message will be displayed.
The complete list of internal MFD usernames is available in TopAccess under “User Management >
User Accounts”.
• The copier’s built in admin password should be changed and always kept secure.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 55 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• The power and network cable should be securely connected. The system is designed to be
robust and record copier usage if the power is lost during copying, but it is possible to start
copying before the embedded application starts after restarting the copier.
• Apply IP filtering settings in the MFD to restrict unauthorised direct printing (for more
information please refer to online Help in TopAccess or the Administrator Guide)
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 56 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
NOTE: Leave the MFD idle without any user interaction for at least the duration of the selected
“Auto Clear” option, before deleting the device from PaperCut. If you do not, some of the PaperCut
settings might remain on the device and an error message might be displayed.
Theoretically, you could reverse all the steps that you followed during the setup process. You could
revert the 08 codes back to what they were and change all the TopAccess menu options back to
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 57 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
what they were. However, disabling the authentication would be the prime thing that is required.
Some other steps to be more complete could include:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 58 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
The Toshiba Embedded Web Browser (EWB) is an optional module licensed from Toshiba. It provides
a web-based interface for print release, to select accounts/cost-centers, and to associate unknown
card numbers from users. If your Toshiba MFD does not have the EWB module enabled, contact your
Toshiba dealer.
Ensure the EWB settings are correct
With “Toshiba v3+”, Papercut updates the EWB settings automatically on registration of a new
device. There are two EWB settings updated. If you cannot see the PaperCut login screen, review the
settings as follow:
1. In your web browser, log in to the MFD web interface (TopAccess) as the “Admin” user.
2. Select the “Administration” tab.
3. Navigate to the “Administration” -> “EWB” page.
4. Under the “Home Page Setting”, set the “Home Page” by changing “server-address” to the
address of your PaperCut server, and “device-id” to the device id as set up in PaperCut.
http://server-address:9191/device-web/toshiba/device-id/home
Alternatively, to use an encrypted HTTPS connection (advisable when using card-association)
enter: https://server-address:9192/device-web/toshiba/device-id/home
5. Under the “Login URL Setting in MDS Mode”, in “Login URL in MDS Mode”, change “server-
address” to the address of your PaperCut server, and “device-id” to the device id as set up in
PaperCut
http://server-address:9191/device-web/toshiba/device-id/login
Alternatively, to use an encrypted HTTPS connection (advisable when using card-association)
enter: https://server-address:9192/device-web/toshiba/device-id/login
NOTE: To use HTTPS, you must have an officially signed SSL certificate (e.g. from Verisign,
Thawte, etc) installed on the PaperCut Application Server and use the server’s DNS name.
Without this, the Toshiba embedded web browser displays a certificate warning message
before displaying the page. For more information, see Generating an SSL/HTTPS Key in the
PaperCut manual.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 59 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
4. The browser’s URL has the following pattern in the query parameters:
?service=direct/1/DeviceList/selectDevice&sp=l<device-id>
where <device-id> is the Id of the device.
Toshiba MDS V3 offers a new authentication mode called MDS. With MDS mode, an external
authentication server can control the authentication process.
When you register a new “Toshiba v3+” device in PaperCut, the device’s MDS mode is enabled.
This includes any dependency, such as, the Authentication Type, which is set to MFD Local
Authentication.
If you cannot see the PaperCut login screen, review the setting in TopAccess:
1. In your web browser, log in to the MFD web interface (TopAccess) as the “Admin” user.
2. Navigate to “Administration > Setup”.
3. Under “Device Information”, check that the “MDS Mode” setting is enabled
NOTE: If MDS mode is set to disabled, and you are unable to change it manually, click the question
mark next to it to check which of the dependencies you need to update first.
• In the PaperCut admin site, go to the “Devices” tab and select the device:
o Verify that the “Device hostname / IP” is correct.
o Verify that the appropriate “Device Functions” are enabled. i.e. To track faxes,
ensure “Track & control faxing” is enabled.
o Check the Device Status on this page (or in Status column of Device List) to ensure
no errors are occurring.
o Check that the Device’s administrator username and password are correct.
• Verify that the 08 service mode settings have been changed.
• Verify that ODCA has been enabled and the default port of 49629 was used.
• Verify the correct version of the firmware is running.
A user has overrun their quota during a copy job. Why didn’t it stop them earlier?
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 60 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
• A copy job tends to overrun its quota by at least 2 pages probably because there are at least
2 pages in the device that have not yet come out of the copier. This is a restriction of the
device.
• You have used more advanced costs than just color, grayscale, small paper size, or large
paper size, which are all that MDS V3 provides direct support for. For example, you have set
a duplex discount and by default PaperCut assumes all pages are duplex (according to ext-
device.toshiba.limit-reference.quota.duplex).
Firstly, ensure that you are using a compatible card reader (see Appendix A: Supported
Authentication Card Readers).
If you are using a compatible card reader the most likely cause is a configuration issue:
• Make sure the card reader is connected while the device is booting up. Try rebooting the
device.
• Check the 08 codes used to enable the card reader (e.g. 3500)
Use operating system command-line tools such as ipconfig or ifconfig to determine this.
I have thousands of accounts representing my clients. Will the system handle this?
Yes. We have designed the system to handle thousands of Shared Accounts. Users with many
accounts will also be presented with some “power options” to help them find accounts including
keywords based search.
This can be caused by incorrect network settings on the copier such as incorrect DNS servers, subnet
masks and similar. We recommend checking all network settings. If this fails to address the issue,
review the following:
1. Make sure you are running PaperCut 16.4 or above and the latest device firmware.
2. On the device in TopAccess, switch off all DNS servers and enter all network addresses as IP
numbers. Bad DNS server settings, or slow reverse DNS can slow down login times.
Card self-association is enabled but the user is still prompted for a PIN. If they enter their PIN it
doesn’t work. What is wrong?
If Card Authentication is requiring a PIN and card self-association is enabled, then the user must
enter a PIN of “0” when prompted for a PIN. If they enter any other PIN including their own PIN
associated with the PaperCut account, it will not work.
I have enabled Identity Number authentication in PaperCut but it doesn’t prompt me for the ID
number. Why not?
You might not have enabled PIN code authentication in TopAccess on the MFD. With the correct
firmware on the MFD, you must enable “PIN Code Authentication” in the “PIN Code Authentication
Setting” under the Security tab. This requires a firmware version that supports this feature. Please
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 61 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
check your device firmware is at or above the version listed in section 3.3 Supported Toshiba
Devices.
I have enabled Swipe Card requiring a PIN in PaperCut but it doesn’t prompt me for the PIN. Why
not?
You might not have enabled “Require PIN Code” in the “Card Authentication Setting” in the Security
tab in TopAccess. This requires the correct firmware on the MFD mentioned in section 3.3 Supported
Toshiba Devices.
Users are unable to cancel their print jobs at the MFD. How can I fix this?
This is explained in section “4.8 Disable MFD control of print jobs (mandatory)“
(Authenticate/Quota/Permission). Basically, to support the zero stop functionality, we have to force
network print jobs to be owned by “printope” instead of the real username. Therefore, by default
the MFD won’t let the authenticated user delete the print jobs which it believes are owned by
“printope”. To override this, an 08 code needs to be set (it is also listed in the 08 code checklist in
the appendix).
When a user chooses to copy using the Erasable Blue color option, why does the copy cost always
default to 1.0 per page?
Even after setting copy color job costs for the "Small Erasable Blue" and "Large Erasable Blue" on the
Admin web interface, the costs default to 1.00 on the device’s web admin. To override this, manually
set the copy color job costs on the device’s web admin (Counter > Quota Setting) and click Save.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 62 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
3501 1 or 2 or 3
NOTE: e-Bridge IDGATE in the table refers to Toshiba’s own brand of card readers.
For this card reader set 08 service mode 3500 setting to: 90001.
NOTE: The Elatec TWN3 might require special firmware to use on the Toshiba devices. This is
available from PaperCut. Download and firmware upgrade instructions can be found on the
PaperCut knowledge base at the link below:
http://www.papercut.com/kb/Main/ElatecFirmwareForToshibaMFD
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 63 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
code, one also needs to set the 3501 code to specify which track data to use as specified in the table
below.
When entering the track number (for example, track 2 has been used for the banking industry), you
will be shown boxes with the letters A to F. Please ignore this and just enter one of the digits 1 to 3
on the key pad. Then press OK. You will be asked to repeat this for confirmation and so just enter the
same digit again and press OK.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 64 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
The following card reader models below have been tested and are supported in generic keyboard
mode. Other models not in the table might be supported by calling a Toshiba technician to make the
necessary change (to register the new card reader’s Product ID (PID) and Vendor ID (VID)).
Elatec TWN4
TWN3
pcSwipe Enroll
RDR-8058AKU-PPCT
RDR-80581AKU
RDR-805H1AKU
RDR-805T1AKU
Magtek Dynamag
Cartadis TCM2MIFARE/HID
USB UART IC
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 65 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
1. Connecting a supported card reader to the device via the USB port (Note: On e-BRIDGE Next
devices this is hidden under a sticker on the top/front panel).
2. Enabling Swipe card as an Authentication method under the device’s configuration in
PaperCut’s web interface.
3. Ensure the card number, as read by the reader, is loaded into the Card Number field in the
PaperCut database (or consider using user self-association).
Swipe cards contain numbers used to identify users according to the card number configured in the
User Details screen under “Card/Identity” number. Some readers report information in addition to
the number encoded on the card, such as checksums. PaperCut can treat these cases in three ways:
• A typical case is the checksum being reported after the card number, separated by an equals
sign, such as in 5235092385=8. PaperCut can handle this case by default; it will extract
the number before the equal sign as the card number: 5235092385.
• For some cases, a “regular expression” that will filter the card number from the complete
string of characters reported by the card reader might be required. Documentation on
regular expressions can be found on the Internet, e.g. at .
o The regular expression must be fashioned so that the card number is returned as the
first match group.
o Usually one regular expression will be used for all the devices managed by PaperCut;
this must be entered in the “Config editor (advanced)” which you will find on the
Options tab under Actions. The key is called “ext-device.card-no-regex”.
o The global setting however can be overridden on a per-device basis: The key “ext-
device.card-no-regex” can also be found on the “ Advanced Config tab in the device
details screen. This setting will override the global setting unless the keyword
“GLOBAL” is specified.
o PaperCut developers will gladly assist in producing a regular expression when
supplied with a few sample outputs from your card reader. Contact your reseller or
Authorized Solution Center for help with regular expressions. You can find their
contact information in your PaperCut Admin interface on the About page.
o If you would like to write your own regular expressions, here are some examples:
▪ Use the first 10 characters (any character): (.{10})
▪ Use the first 19 digits: (\d{19})
▪ Extract the digits from between the two “=” characters in
“123453=292929=1221”: \d*=(\d*)=\d*
Note: Many card readers are configurable - the number format can be changed at the hardware
level via utility or configuration tools. PaperCut’s software-level converters are there to support
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 66 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
card readers that don’t offer this level of configuration, or where a global software-level
conversion is a better choice. For example, it might be quicker to do the conversion in PaperCut
rather than manually reprogram 100+ readers!
Like regex’s, the convertors can be defined on either a global (all devices) or on a per-device basis.
To set globally:
1. In the PaperCut Admin web interface, navigate to “Devices -> [select device] -> Advanced
Config”.
2. Search for “ext-device.card-no-converter”
3. Enter the name of the required converter (see table below); then click “Update”.
Standard Converters
Convertor Description
ascii-enc Unpack an ASCII encoded card number string. E.g. given the number
“3934364542443238”, the ASCII code “39” is converted to 9, “34” -
> 4, “45” -> E, with the entire number resulting in “946EBD28”.
It is possible to chain or pipeline converters by delimiting with a pipe (|). For example, ascii-
enc|hex2dec will first unpack the encoded ASCII number then convert it to a decimal.
Tip: Not sure which converter to use? Often trial and error is a good approach. After presenting a
card, the number will appear in an application logger message with conversions applied (assuming
the card is unknown to the system). Try different converters and inspect the resulting numbers in
the application log.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 67 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Tip: A Javascript script can also be included in the pipeline. For example
ascii-enc|hex2dec|javascript:custom/card.js
• If both a regular expression and a converter are defined, the regular expression is applied
first. This means a regular expression can be used to clean up the input (e.g. remove
checksum or delimiters) before passing to a converter.
• In some situations, a custom JavaScript implementation might not be enough. For example,
there might be a requirement to use a 3rd party system to decrypt the number. PaperCut
includes an advanced plugin architecture that the PaperCut Software development team
uses to implement these advanced converters. Contact your reseller or Authorized Solution
Center to discuss development options and costs. You can find their contact information in
your PaperCut Admin interface on the About page.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 68 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
4. Enter your “Username” and “Password”; then press “Log in”. If the association is successful,
the user is notified on the LCD screen.
5. Click “OK”.
The card is now associated with the user’s account. Swiping the card again allows them to login
using the card.
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 69 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
The PaperCut MF Print Release screen with all held print jobs:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 70 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
The PaperCut MF Print Release screen with details of one held print job:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 71 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 72 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
The PaperCut MF Account Confirmation screen without the option of account selection:
The PaperCut MF Account Confirmation screen with the option of account selection:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 73 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 74 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 75 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 76 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
3. The PaperCut MF Scan Complete (with the two buttons - Add another page, Send)
screen:
4. The PaperCut MF Scan Complete (with scan completed or failed status) screen:
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 77 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 78 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Appendix A:
Supported
Authentication
Card Readers
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 79 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 80 of 81
| Toshiba MDS V3 Embedded Manual 2018-07-18
Copyright © 2018 PaperCut Software International Pty. Ltd., All Rights Reserved. 81 of 81