We have a fix planned for a future version of PaperCut NG/MF, but in the interim the script responsible for tracking/controlling printers can be replaced with a working version using the instructions found here.
Known Issues
Hitting a problem with your PaperCut implementation?
You might not be alone! This page lists all Known Issues across PaperCut products and includes information on possible workarounds or solutions.
We have a fix planned for a future version of PaperCut NG/MF, but in the interim the script responsible for tracking/controlling printers can be replaced with a working version using the instructions found here.
Solution:
This delay is actually the device default setting and can be adjusted. Change the below config key under Device > "Device Name" > Advanced Config from 5 (default) to 1 to reduce the delay between scans:
ext-device.hp-oxpd.timeout.complete-scan-job.secs
When using an External database for Card/User ID numbers, and using a modified driver type, the modified value may get overwritten when making other changes in the UI.
For example if you have followed the instructions on Configuring the external database lookup:
If you later hit Apply anywhere on Options > Advanced to save any other settings, it will show an error “Missing external user lookup settings. Please complete all fields”.
You’ll then have to select the database type again, to be able to save your other settings. However this will then overwrite the config key
user-lookup.db-driver
with the default net.sourceforge.jtds.jdbc.Driver
.
You’ll need to re-update the config key again with
com.microsoft.sqlserver.jdbc.SQLServerDriver
, to set this back to the correct driver.
We are looking to fix this issue in an upcoming release.
The behavior is best explained through an example, and this can be experienced without the need for any PaperCut products to be installed - this happens at the CUPS level with manufacturer drivers.
Example:
- Setup: Customer sets up library-grayscale and library-color print queues. The default settings include 'print in color' disabled for the library-grayscale printer, and 'print in color' enabled for the library-color printer.
- Test: Customer prints document 1 to library-grayscale. The document prints grayscale. Print to the library-color print queue, and ensure that color is enabled. The document prints (incorrectly) in grayscale. Print to the library-color print queue again, ensuring that color is enabled. The document prints (correctly) in color.
What appears to be happening is that CUPS retains the default setting used in the last print job - so in the example above the second job prints incorrectly in grayscale, because the previously printed job was grayscale. The third print job sent to the color queue prints correctly in color because the previous job was set to color.
We will update this Known Issue as and when we discover more information. In the meantime a suggested workaround is to promote black and white printing (PaperCut Pocket and Hive) or suggest that users print in grayscale through print scripting (PaperCut NG and MF). In this workaround users can print documents in color and then choose to convert selected documents to grayscale / black and white.
(e.g., '-10.0 instead of -10.0)
. This prevents some external systems from correctly importing the data.
Workarounds:
HTTP ERROR 500 javax.servlet.ServletException: javax.servlet.ServletException: Unable to resolve expression "mailto:'
when applying a perpetual license that has a negative number of Site Servers available in the Global Entitlements Service.HTTP ERROR 500 javax.servlet.ServletException: javax.servlet.ServletException: Unable to resolve expression "mailto:'
when applying a perpetual license that has a negative number of Site Servers available in the Global Entitlements Service.
- This does not impact licenses being applied where there is a positive number of Site Server entitlements available.
- This does not impact licenses being applied where there are any other types of entitlements which have been over-claimed (into the negative) - e.g. devices.
- This does not impact Application Servers where a license is already applied and has a negative number of available Site Server entitlements.
- This does not impact Application Servers where a license is already applied and has a negative number of available Site Server entitlements, and the App Server is restarted.
This will only happen in the extremely rare case where a license has a finite number of Site Servers in the entitlements (e.g. 2), AND that entitlement has been over-claimed (e.g. available Site Servers is -1) AND that license is then uploaded to an Application Server AND that Application server that the license is uploaded to has one or more site servers attached to it (listed under the 'Sites' tab).
The web interface will then produce the error above. The only option to restore service is to restore the Application Server database.
Note that this has been resolved in version 24.1.6.
Failed to decrypt claim response
in logs.Background entitlements sync failed. Reason: Failed to sync entitlements. Failed to decrypt claim response.
error in the logs, for Site Servers.
This error can be ignored since Site Servers do not need to sync with the Global Entitlements Service (GES). Only Application Servers need to sync with the GES.
We are looking to resolve this in an upcoming maintenance release.
PaperCut Admin UI > About > Registration
triggers a HTML error.
We’re actively working on having this resolved in the next maintenance release.
Error:
Unable to invoke method doRelease on web.components.ReleaseStationJobs$Enhance_49@22a83049[PrinterRelease/jobs]: Cannot find user admin
Workaround: Log into the Admin console as an account that's not the built in "Admin" account, with release privileges, and you can release jobs normally.
Note: Releasing jobs at a device is NOT impacted.
jr-fontxxxx.ttf
files can take up a large amount of space within /server/tmp/
.jr-fontxxxx.ttf
files can take up a large amount of space within /server/tmp/
.
These files are created if someone runs a PDF format report (e.g. any report within the Reports tab, where PDF is selected as the output format).
Workaround:
The files are indeed temporary, so can be safely deleted to save space. Some files may not be able to be deleted while the Application Server service is running, in which case to clear them entirely, during off-hours you'll need to stop the Application Server service, delete the temporary files, then start the Application Server service.
We are looking to fix this so that the temporary files are cleaned up properly, in a future release.
Note that this has now been resolved in PaperCut version 24.1.3.
Our developers are aware of the issue and it’s currently being scoped for resolution.
Note that this has now been resolved in PaperCut version 24.1.3.
We’re actively collaborating with the Xerox EIP team to find a resolution.
Workaround: If you’re using Altalink 80xx or Versalink 71xx devices, we recommend not upgrading to 24.1.2, or, if already upgraded, downgrading to PaperCut MF v24.1.1 until a fix is available.
Note that this has now been resolved in PaperCut version 24.1.3.
This issue occurs when multiple scans are performed in the same session (e.g., when selecting "scan more pages" at the device).
Note that this has been resolved in 2024-12-10-1226.
In Print Deploy, a shared secret is used for all customers utilising Single Sign-On (SSO) to enable user authentication through Microsoft Entra ID. The shared secret expired on November 24, 2024.
To find out if you’re using Entra ID, you can go to
Enable Printing > Print Deploy > Settings > Authentication methods
and if Microsoft is checked then you are using Entra ID.
To ensure uninterrupted authentication, we strongly recommend switching on auto updates
(Enable Printing>Setting>AutoUpdates)
to ensure you will receive the latest Print Deploy version 1.9.2768. It’s only the Print Deploy server that needs to be updated, not the Print Deploy Clients.
If you're not able to enable auto-update, you can manually update Print Deploy by following the steps here: Manually update the Print Deploy Server to the latest version
Organizations can also configure their own custom Entra ID application, allowing them to proactively manage their own secrets should they wish to do so, steps here: Use a custom Microsoft Entra ID application with Print Deploy
Note:The MF application server uses a different shared secret and is not affected.
When this occurs, the brand usage table in the About->Registration tab will indicate that the incorrect brand license is in use. This error is visual only and will not disrupt device or server licensing.
Workaround: To force SFP licenses to not use MFD entitlements, set the
subscriptions.sfp-entitlement-consumption.enabled config
key set to N
but ensure you have the appropriate SFP licenses.
Note that this has now been resolved in PaperCut version 24.1.3.
Unable to contact PaperCut Gateway Service
or Background entitlements sync failed
)Unable to contact PaperCut Gateway Service. Ensure your server is online and try again. If still failing, contact your Accredited Reseller for support.
Background entitlements sync failed. Reason: Request to PaperCut MF gateway service failed. Internal Server Error.
These are not critical errors and can mostly be safely ignored. For example if the hourly syncs are intermittently failing, and if you can see that the 'last synced' time under About > Registration > License Info (or Subscriptions) is showing a recent time stamp, then the errors can be safely ignored.
For peace of mind, you can perform a manual sync under About > Registration > License Info (or Subscriptions), then press the Sync button if required.
Note that despite some of these errors being downgraded from ERROR level to WARN level in 24.0.5 (under PO-2569), some sync errors may still appear as ERROR level.
We are aware that this issue with the sync intermittently failing is causing unnecessary alarm, and are working to address this - in the meantime, functionality, printing and licensing will not be impacted.
Update in version 24.1.1: Changes include changing the synchronization frequency within PaperCut NG/MF, to randomize Application Server syncs during the hour, preventing simultaneous server requests.
Konica Minolta devices log print jobs as copy jobs.
This happens in particular in conjunction with print release.
Fix:
Please ensure that print jobs go to the copier “unauthenticated”. See the section titled Enabling unauthenticated printing in the Konica Minolta Embedded Manual.
Note: Both the Print Driver settings and the Front Panel / LCD settings need to be changed.
This known issue refers to the User/Group sync source Unix Standard (PAM, nsswitch etc.).
Is your PAM (Pluggable Authentication Modules) setup configured to deny services by default? Some Linux/Unix distributions adopt more stringent defaults for unspecified management groups i.e. account, authentication, password and session.
Note: As with any security related modifications, make sure these authentication changes are right for you.
Fix:
Edit the
/etc/pam.d/papercut
PAM configuration file with appropriate permissions, and add the following lines:
auth required pam_unix.so
account required pam_unix.so
Please note: The module name (
pam_unix.so
) may be different for your Linux/Unix distribution.
Save the file. Changes should come into effect immediately.
Resolution:
Update impacted devices to use firmware version 121.xxx.034.28900 available from xerox.com. Be aware that there may be other issues with this firmware, including another PaperCut MF known issue CDSS-4678.
Currently, the system.network-address key, intended for internal communications between system components, is being used instead of the system.network-address.user-facing key, which is designed to present user-friendly URLs.
As a result, the email link may display the internal network address and port number of the wrong server (such as the Site Server if the MFD is connected to them), which is not intended for user access.
The PaperCut development team are aware of the issue and are investigating a fix.
Note that this has now been resolved in the 24.1.1 release.
You are using a license for a device your organization is not licensed for
when upgrading to version 24.0.4.You are using a license for a device your organization is not licensed for. Please contact your PaperCut Accredited Reseller for assistance
.
This relates to the new 'brand breakdown' table mentioned in the release notes: "Added a device brand breakdown table in the About > Registration page which will allow for better insight into which device brands are being used and licensed on the server. Note: After upgrading to 24.0.4, the license file will need to be uploaded again in order to display the license counts in the Brand breakdown table. [PO-2448]"
Workaround:
You will need to re-upload your license file, through About > Registration > Register. After re-uploading, the correct brand breakdown information should be shown, and the incorrect error message should disappear.
Customers utilizing Print Deploy to install Mobility Print queues may notice that these queues fail to install if they've implemented "Sign in with Microsoft" and affected end users have UPNs that contain uppercase characters within EntraID.
Symptoms of this issue are recorded in both the Print Deploy client and Mobility Print server logs.
Example from the Print Deploy Client log:
pc-print-deploy-client.exe: STDOUT|SUP "500 Internal Server Error" returned (attempts=0) {"src":"service.go:404"}
Example from the Mobility Print server log:
mobility-print.exe: STDOUT|ERROR Failed to validate credentials. [ credentialsType=Microsoft access token err=userPrincipalName from Graph API (TestUser@papercut.com) does not match the user (testuser@papercut.com) ] auth.go:204
Disclaimer:
The workaround below is only recommended for administrators familiar with PowerShell and Azure AD / EntraID. While the steps below have been tested, this is still considered unsupported in that any unintended side effects are the responsibility of the administrator who chooses to perform them.
The following steps will automate the conversion of UPNs stored in EntraID to lowercase via PowerShell.
Install the required Module and set the execution policy for the logged in user to run remote signed code (this can be reverted later):
Install-Module -Name Azure, Azure.Storage -Repository PSGallery -AllowClobber -Force
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Import the Module and connect to AzureAD using an administrator account (make sure to enter your Tenant ID after -tenantID
):
Import-Module -Name Azure
Connect-AzureAD -tenantID your-tenant-id-here
Test to ensure the authenticated user account is able to retrieve users:
Get-AzureADUser
This should return a list of users (example output):
ObjectId DisplayName UserPrincipalName UserType
-------- ----------- ----------------- --------
102df3af-95be-48d9-b4d7-dcf648113d1c Test User Test.User@testuser.onmicrosoft.com Member
Feel free to test the command on a single user:
Set-AzureADUser -ObjectId TestUser@test.com -UserPrincipalName testuser@test.com
Finally, the code below will convert all user UPNs to lowercase within your Azure tenant. This only changes the UserPrincipalName attribute to lowercase - no other modifications are made:
$arr = Get-AzureADuser
$output = ForEach ($user in $arr) {Set-AzureADuser -ObjectID $user.UserPrincipalName -UserPrincipalName $user.UserPrincipalName.ToLower()}
Workaround:
Background entitlements sync failed
error message seen in PaperCut Logs / Application LogBackground entitlements sync failed. Reason: Request to PaperCut MF gateway service failed. Internal Server Error.
) even after license registration has been successful.
This message is causing unnecessary alarm for PaperCut administrators and can be ignored if there have been subsequent successful syncs.
We are making a change in a future release to create this message as a Warning once the license has been registered.
In version 24.0.5, the error level for some of these errors have been reduced from ERROR to WARN. However, we are working on fixes to resolve this issue with the background sync more permanently in the future - see known issue PO-2745 for more information.
When attempting to set queues as optional when associating them with a Zone, the Optional checkbox at the bottom of the Print Queue list is unusable.
Print queues can still be set to Optional one by one using the three dot menu located on each print queue within a Zone.
Reported firmware versions: G00-RB, G00-RD, GC4-RD, G00-P8, GC4-RB
Workaround:
- Switching to Classic Interface view will show the missing icons.
- A device restart will temporarily resolve the issue for a limited time until the error occurs again.
- Downgrading to an older version of the firmware: G00-Q8
Customers experiencing this issue should reach out to their local Konica Minolta field engineer to help them resolve the issue as the workaround might look different for each customer.
Reported firmware versions: G00-RB, G00-RD, GC4-RD, G00-P8, GC4-RB
A firmware fix GC2-RE is now available for these devices:
- bizHub C3350i, C3351i, C4050i, C4051i
- ineo+ 3350i, 3351i, 4050i, 4051i
- d-Color MF3303, MF4003
Upgrading to the latest firmware fixes the issue. We have had a 100% success rate. The new firmware is under special firmware on the page of the device items.
For devices where firmware is not available, or customers still experiencing this issue after a firmware update should reach out to their Authorized Konica Minolta Partner as additional configuration changes may be required after a firmware upgrade.
Known Workarounds:
- A device restart will temporarily resolve the issue for a limited time until the error occurs again.
- Downgrading to an older version of the firmware: G00-Q8 seems to have fixed the issue for a customer.
PaperCut has now released Microsoft Windows Arm64 support for the majority of client components.
They are using Window's x64 emulation feature, Prism.
Please note: Arm64 is targeted at portable devices such as laptops, tablets, and we are prioritising support for these devices.
- PaperCut Global PostScript Printer Driver: The Windows Arm64 printer spooler requires architecture specific printer drivers. x64 printer drivers can not be used. Version 100.3.0.0 of the PaperCut Global PostScript Printer driver (included in PaperCut NG/MF 24.0.3 and Print Provider version 111.0.16.8220)
- PaperCut Pocket Edge Node installer
- PaperCut Hive Edge Node installer
- PaperCut Mobility Printer Installer Client (legacy)
- PaperCut NG/MF - Print Deploy - Mobility Print Import Wizard
- PaperCut NG/MF - manual installation of `providers\print\drivers\global\win`
- PaperCut TCP/IP Port: The Windows Arm64 printer spooler requires architecture specific printer port drivers. We are investigating this further and will be released later but is currently a low priority. This impacts Hardware Page Count Validation.
- PaperCut NG/MF - Server installations - Not supported in the near future: primary server, secondary server, site-server, direct-print-monitor installations
- PaperCut NG/MF - Print Deploy clients
- GhostTrap: GhostTrap is an open source product that PaperCut contributes to significantly. This product converts PDLs such as PostScript and PCL in to PDF. GhostTrap currently only installs to x64 systems. We are investigating supporting an enhancement to allow installation to Arm64 systems and allowing Prism emulation to handle running GhostTrap.
- PaperCut Pocket Edge Node installer
- PaperCut Hive Edge Node installer
- PaperCut Mobility Print server
- PaperCut NG/MF DocProc on prem service
- PaperCut NG/MF WebPrint service (server & sandbox)
- PaperCut NG/MF Print Deploy: This feature clones many different printer driver across multiple operating systems. Support for Arm64 printer drivers from manufacturers appears sparse at this time. We are adding support for Arm64 drivers at this time. Please note: If you clone a print queue with an Arm64 printer driver, it will likely overwrite an x64 driver on the server.
- PaperCut NG/MF Print Deploy Cloner: wmic.exe has been deprecated and causes an error when cloning. Resolved in - Cloner version v701, released in Print Deploy server version 1.8.2680. [PD-2066]
Products & features under testing
Products & features that are released:
Products & features under testing
Resolution:
Upgrade to PaperCut MF 24.0.4 or newer and use the Ricoh SmartSDK embedded version 3.2.7
There is an issue accessing Pay Station devices from the Admin UI. When selecting the device or when running the Pay Station report, you are taken to an error page with the following: "Required parameter userSourceType of component DeviceDetails/deviceAuthOptions is not bound." If the goal is to remove an unwanted pay station use the workaround below.
Please note that this has now been resolved in version 24.0.4.
Please note that this has now been resolved in version 24.0.4.
The root cause has been identified and we're working closely with Microsoft to implement a fix in a future release of Print Deploy.
Workaround:
Follow the guidance contained within our AntiVirus False Positive knowledge base article here.
client.conf.toml
file becoming corrupt.
Symptom:
The Print Deploy page, located on the Enable Printing tab within the NG/MF admin web interface will be blank.
Log snippet:
2024/07/19 02:07:51 pc-print-deploy-server.exe: STDOUT|ERROR: Print Deploy Server will now terminate. initialise config: failed to load config from file c:\Program Files\PaperCut MF\providers\print-deploy\win\data\config\client.conf.toml: toml: line 1: files cannot contain NULL bytes; probably using UTF-16; TOML files must be UTF-8 {"src":"main.go:61"}
Solution:
Delete the
client.conf.toml
file located here: [app-path]\PaperCut MF\providers\print-deploy\win\data\config
Then proceed to restart the PaperCut Print Deploy service.
With the Print Deploy client UI already displayed, selecting the taskbar (Windows) or menubar (macOS) Print Deploy client icon and choosing “View my printers” will open a tab in the default browser displaying the Print Deploy client UI.
Workaround: Restart the Print Deploy Client service or restart the affected machine(s)
This bug will be addressed in a forthcoming client update.
Workaround:
Configure ext-device.ricoh.scan.prompt.checkbox.checked Y
Roll back the Ricoh firmware to the previous version.
Ricoh is actively investigating this issue.
Issue
Customers have reported a null pointer exception in a number of HP devices after upgrading to 24.0.2. An error message pops up on the device with a dialog saying “please wait 15 minutes, contact admin."
Workaround
Delete the device and re-embed the software.
It should be noted that if the Application Server, or Application Server Service is restarted, this process will need to be repeated.
Workaround: Right click on the page and select “Reload”
Some customers do not allow their Application Servers to access the internet, so will experience licensing issues when upgrading to version 24.0.1 or later. See When upgrading to PaperCut MF v24.0 or later and the Application Server is offline.
We have plans to deliver support for offline activation for both Perpetual License customers and Subscriptions customers by November 2024. When released, customers will be required to request an offline activation from their reseller, providing both their license file/ activation code and server identification. If you'd like to be notified about this, contact us and quote "PO-2223", or keep an eye on the latest PaperCut MF release notes.
Workaround:
In the short term, for customers who upgrade to 24.0.2 or later we will increase the current offline grace period from 30 days to 120 days. This means customers can upgrade now and have 120 days to either activate online, or activate offline once that functionality becomes available. Remember also that even after this period expires, users and functionality is not impacted at all, only the administrator login will be restricted to certain pages.
If you believe that your Application Server should have access to the Global Entitlements Service, see General troubleshooting Global Entitlements Service (GES) connections for troubleshooting tips.
Workaround:
Restart the PaperCut Application Server service, and then click the Sync button in the PaperCut MF admin interface, under About > Registration > License Info.
Changes in licensing with version 24 means that Application Servers using the same CRN all share the same set of entitlements - see Global set of entitlements for more information. This means that if you build a new Application Server and restore your data from your original server, the Global Entitlements Server thinks this is a new additional Application Server, so you will only have access to the entitlements that your original server had not already claimed.
To work around this issue, you should ensure that you backup your server.uuid file from the old server where possible.
- On your active server, locate the
server.uuid
file from[App Server install directory]\server
, for example:C:\Program Files\PaperCut MF\server
. - Copy this file somewhere safe, to a different server or network location.
server.uuid
file back to the same location on the new server: [App Server install directory]\server
, for example: C:\Program Files\PaperCut MF\server
.
You should now be able to start up the server and the claimed entitlements should match up with what is in use currently.
If you are still seeing issues with activation or with claiming the entitlements (e.g. number of devices that you’re entitled to) then you will need to contact PaperCut tech support to ask them to release the original server's entitlements in the back-end.
install-license
does not work with PaperCut MF version 24.0.1.install-license
on version 24.0.1, the license may install correctly but buttons on the ‘Registration’ tab may be missing or broken.
We recommend not using the
install-license
command on 24.0.1 until this is resolved.
Customers are not impacted by this issue - customers viewing the subscription under About > Registration > Subscriptions will see their correct subscription information.
Note that this does not impact perpetual license customers (customers not running a Subscription).
Our recommendation is to not upgrade to version 24 if you are using HA features in your environment.
Please note that if you’re using High Availability using e.g. MS Failover Cluster Manager or VMWare vCenter High Availability, or if you’re using HA with Print Deploy only, then these solutions will continue to work as expected.
This issue has now been resolved in PaperCut NG/MF version 24.0.5.
We are investigating ways to minimise the negative performance effect of this security change. In the interim, you can utilise feature PO-540 and use the config key
user.card.pin.hash-encode=N
to control whether user PINs will be hashed encoded in the server.properties
file. After you make this change, you must save the server.properties
file and then restart the MF Application Server service to apply the change.
Please note that this has now been resolved in version 24.0.3.
To work around this limitation, per device configurations can be configured to disable high compression:
ext-device.kyocera-mita.scan.pdf.high-compression=N
ext-device.kyocera-mita.scan.use-file-default-settings=N
Alternatively, the device settings can be changed to not use High Compression PDF by default.
In an environment where Mobility Print queues have been deployed, and the Direct Print Monitor bundled with the Print Deploy Client is present, Application Server logs will be flooded with the following warning:
Printer 'PrinterName' on server 'pd-client' will not be monitored because it a remote HTTP printer.
Please re-install as a local printer or with a standard TCP printer
This is superfluous logging that can safely be ignored. We have a fix to prevent this logging in a future release of Print Deploy.
Workaround:If you aren't deploying direct print queues in your environment, you can prevent this by uninstalling the Direct Print Monitor component from client workstations. Additionally, to prevent this with future installations, you can skip the installation of the bundled Direct Print Monitor following the instructions here.
Fix is available in macOS client v1439 and Windows client v1778, which is available in Print Deploy server version 1.8.2614 .
Tips on getting this fix quicker:
Enable auto updates, follow Enable or disable auto-updates on the server. To trigger an auto-update immediately, restart the Print Deploy server service.
Once the server has been upgraded, Print Deploy clients will automatically update over a few days. To avoid waiting for clients to update automatically, you can:
- Download the latest Print Deploy client from the Print Deploy admin interface and deploy it with your MDM tool of choice or install it manually on clients.
-
For MacOS clients, if you can run terminal commands remotely, you can trigger an auto-update within 10 - 70 minutes by restarting the client.
Run sudo launchctl unload /Library/LaunchDaemons/pc-print-deploy-client.plist
And then sudo launchctl load /Library/LaunchDaemons/pc-print-deploy-client.plist - For Windows clients: Restart the PaperCut Print Deploy Client service from services.msc.
Issue:
In environments where the Direct Print Monitor bundled with the Print Deploy Client is present, non-Print Deploy printers that reside on a client device may be registered and monitored.
These registered printer objects will be listed in the "Printers" tab of the PaperCut NG/MF Admin web interface with the following syntax:
pd-client\PrinterName
Workaround:
If you aren't deploying direct print queues in your environment, you can prevent this by uninstalling the Direct Print Monitor component from client workstations. Additionally, to prevent this with future installations, you can skip the installation of the bundled Direct Print Monitor following the instructions here.
Update:
Any left over "pd-client" printers can be deleted individually in PaperCut on the Printers page, or deleted in bulk using the server command delete-printer pd-client “[All Printers]”
. For more information see Bulk deleting printers.
Expand this known issue for additional tips to deploy this fix.
Fix is available in Windows client v1781, which is available in Print Deploy server version 1.8.2616.
Tips on getting this fix quicker:
Enable auto updates, follow Enable or disable auto-updates on the server. To trigger an auto-update immediately, restart the Print Deploy server service.
Once the server has been upgraded, Print Deploy clients will automatically update over a few days. To avoid waiting for clients to update automatically, you can:
- Download the latest Print Deploy client from the Print Deploy admin interface and deploy it with your MDM tool of choice or install it manually on clients.
- For Windows clients: Restart the PaperCut Print Deploy Client service from services.msc. This will trigger an auto-update within 10-70 minutes.
Issue:
We have received reports that server shared printers are being unshared by Print Deploy. We are investigating a correlation between a printer's share setting on the reference machine used to clone printers, and that this then overrides the server's share setting of the printer.
Expand this known issue for additional tips to deploy this fix.
Fix is available in macOS client v1413 and Windows client v1745, which is available in Print Deploy server version 1.8.2588.
Tips on getting this fix quicker:
Enable auto updates, follow Enable or disable auto-updates on the server. To trigger an auto-update immediately, restart the Print Deploy server service.
Once the server has been upgraded, Print Deploy clients will automatically update over a few days. To avoid waiting for clients to update automatically, you can:
- Download the latest Print Deploy client from the Print Deploy admin interface and deploy it with your MDM tool of choice or install it manually on clients.
-
For MacOS clients, if you can run terminal commands remotely, you can trigger an auto-update within 10 - 70 minutes by restarting the client.
Run sudo launchctl unload /Library/LaunchDaemons/pc-print-deploy-client.plist
And then sudo launchctl load /Library/LaunchDaemons/pc-print-deploy-client.plist - For Windows clients: Restart the PaperCut Print Deploy Client service from services.msc.
Issue:
We have had multiple reports that after upgrading to the latest print deploy client, version 1.8.1744, the printers will show in the client simply as "loading....."
Cause:
We believe the issue with only show if the Print Deploy Client is being deployed with the "skipdpm=true"flag. Printers previously installed before the client updated will continue to work, but will show as "loading..." in the client UI.
Workaround:
At this time, if the printers are working as they were previously installed, then no action urgent action is required, as this is just a visual confusion. However if new queues do not deploy, then the immediate workaround is to deploy the client with the DPM being installed.
Fix:
Please note that this has now been resolved in PD Server version 1.8.2588.
Note: If you already had Universal Print installed before the upgrade, there is no impact - the connector will continue to work as normal.
Workaround:
Use Windows’ Services panel (services.msc) select PaperCut connector for Microsoft Universal Print then right click and select Restart . This will restart the service and MF will connect successfully to the Universal Print connector.
PaperCut requires an important security update
when trying to clone new queues.PaperCut requires an important security update before you can clone. To continue, download the latest PaperCut installer from https://www.papercut.com/products/upgrade
when trying to clone new queues.
To resolve this, you will need to upgrade PaperCut NG/MF to version 20.1.10, 21.2.14, 22.1.5 or 23.0.7 and later - as detailed on our PaperCut NG/MF Security Bulletin (March 2024).
(Also known as PD-1916, PD-1919)
IMPORTANT: Customers running PaperCut NG/MF version 20.0.2 or earlier will first need to upgrade to PaperCut NG/MF version 20.0.4 before upgrading to a more recent version. See Known Issue PD-1942 for more information.
If you’re running PaperCut NG/MF version 20.0.2 or earlier, check your version of Print Deploy by going to the PaperCut admin interface, then Enable Printing > Print Deploy then checking the Print Deploy version number at the bottom of the screen.
Workaround:
If you are running PaperCut NG/MF version 20.0.2 or earlier AND using Print Deploy version 1.3.1267 and earlier, you’ll need to:
- Upgrade to PaperCut NG/MF version 20.0.4
- Upgrade from 20.0.4 to the appropriate fix version listed on our upgrade page: https://www.papercut.com/products/upgrade
If you do accidentally upgrade straight from 20.0.2 or earlier to a later version, you’ll need to downgrade your PaperCut NG/MF install back to your original version as documented on our Downgrading PaperCut (to an older version) page. Then upgrade to version 20.0.4, then upgrade to a fixed version as detailed above.
Download links for 20.0.4:
PaperCut MF version 20.0.4 - Windows, macOS, Linux.
PaperCut NG version 20.0.4 - Windows, macOS, Linux.
We have had multiple reports that upgrading to 23.0.5 + can cause an "unknown error" when a restricted user attempts to start a scan. This has been observed on a wide range of Toshiba V3+ devices. If the user is then set to "unrestricted", then the scan will start without issue. Downgrading the MF server to 23.0.4 appears to rectify the issue. We have also had reports that toggling "Track & control scanning" may also change the behaviour. This does not appear to effect all installations.
Cause:
We have now determined that if the system locale for the MF application uses a currency that does not use a "." as the decimal separator, then you will see this error for restricted users. This will be rectified in an upcoming release after 23.0.7
Workaround:
Changing the system locale of the MF server to a currency that uses "." as its decimal separator, such as US, will temporarily resolve this issue. We have had reports that you can then set the individual locale override per Toshiba with the config key "ext-device.toshiba.locale-override" back to what it should be.
Update: This has now been fixed in version 23.0.8.
We have a fix planned for a future version of PaperCut NG/MF, but in the interim the script responsible for tracking/controlling printers can be replaced with a working version using the instructions found here.
Expand this known issue for additional tips to deploy this fix.
Also known as PD-1952
Fix is available in macOS client v1412, which is available in Print Deploy server version 1.8.2587.
Tips on getting this fix quicker:
Enable auto updates, follow Enable or disable auto-updates on the server. To trigger an auto-update immediately, restart the Print Deploy server service.
Once the server has been upgraded, Print Deploy clients will automatically update over a few days. To avoid waiting for clients to update automatically, you can:
- Download the latest MacOS Print Deploy client from the Print Deploy admin interface and deploy it with your MDM tool of choice or install it manually on clients.
-
If you can run terminal commands remotely, you can trigger an auto-update within 10 - 70 minutes by restarting the client.
Run sudo launchctl unload /Library/LaunchDaemons/pc-print-deploy-client.plist
And then sudo launchctl load /Library/LaunchDaemons/pc-print-deploy-client.plist
WORKAROUND:
You can manually apply the fix. Please refer Fix Print Tracking in Mac Sonoma 14.4 for more information.
ORIGINAL:
Due to a change (Apple ticket reference 123028502) introduced in macOS Sonoma 14.4, the Print Deploy Client fails to restart CUPS (Common Unix Printing System), preventing Print Deploy from installing new Direct Print queues. As a result, users won't be able to install new Direct Print queues. However, existing print queues installed on their Macs remain functional for printing.
Failed to complete job
when scanning.Failed to complete job
when scanning - only if using KM devices connected to a site server.
Workaround:
A workaround is to restart the Application Server service, and then the Site Server service on the site server, to re-establish webdav communication between the two.
free space: 0.0 MB
free space: 0.0 MB
.
Some customers have seen the correct free space reported after a machine restart, however others have seen the 0MB persist, even when there is plenty of space available. This issue does not appear limited to a particular operating system.
Please note that this has now been resolved in version 24.0.4.
We are aware of an issue that may prevent an application server from starting.
The issue is very dependent on environment, and has so far only been seen on some Linux servers.
An affected server will fail to start after clean installation or upgrade, and the server log will show error messages that include the phrase
Requested bean is currently in creation: Is there an unresolvable circular reference?
We are working to fix the issue and expect to include the resolution in the next maintenance release.
Update: this has now been resolved in version 23.0.7.
Integrated scan actions making use of the CLA integration will fail to complete as the job is unable to be uploaded to the cloud destination.
Symptoms:
Failed scan jobs will display the following error in the PaperCut Application server log:
Delivering scan images for scan job jobId@ failed with an error: CLA-Upload returned bad exit code, exitCode: 1. See more details in the server log.
Investigation Status:
Our Product Development team is aware of this issue and they're working to identify the root cause.
When entering the Mobility Print address manually, the admin interface displays a "No printers found for this server."
When scanning for Mobility Print servers, the admin interface doesn't display any Mobility Print servers.
Expand this known issue for additional tips to deploy the fix.
Fix is available in MacOS client v1403, which is available in Print Deploy server version 1.8.2568. This fix also automatically recovers a user's CUPS IPP backend if Print Deploy previously broke it.
Tips on getting this fix quicker:
Enable auto updates, follow Enable or disable auto-updates on the server. To trigger an auto-update immediately, restart the Print Deploy server service.
Once the server has been upgraded, Print Deploy clients will automatically update over a few days. To avoid waiting for clients to update automatically, you can:
- Download the latest MacOS Print Deploy client from the Print Deploy admin interface an deploy it with your MDM tool of choice or install it manually on clients.
-
If you can run terminal commands remotely, you can trigger an auto-update within 10 - 70 minutes by restarting the client.
Run sudo launchctl unload /Library/LaunchDaemons/pc-print-deploy-client.plist
And then sudo launchctl load /Library/LaunchDaemons/pc-print-deploy-client.plist
ORIGINAL:
We are working on a fix.
In the meantime, to restore the IPP backend manually, run this command on the client Mac:
sudo cp -p /System/Library/Templates/Data/usr/libexec/cups/backend/ipp /usr/libexec/cups/backend/ipp
Until we have a fix, IPP printing will continue to break when a Mobility Print or IPPS print queue is deployed.
Models reported (to date):
- Xerox Altalink 80xx series devices
- Versalink B405
- Versalink C405
- Versalink C7025
PaperCut has tested Xerox AltaLink 81xx series devices on the latest firmware and V3 browser and have not been able to replicate this issue on that series.
Additionally, it appears that only devices running 2nd Gen EIP Web Browser may be impacted by this issue.
Customers with Xerox devices are advised not to upgrade to PaperCut MF 23.0.5.
Please reach out to us via this link PaperCut Support Team and quote CDSS-3375 should you be experiencing this issue. Please do not forget to quote the model and firmware version of the device, too.
It is often possible to import older database export files into a more recent version of PaperCut, but sometimes changes to database structure or management mean that older imports cannot be supported.
v23.x contains changes that make it impossible to support DB imports from earlier versions of PaperCut.
In general it is best practice to only import databases that were exported from the same version of PaperCut as the target import server, but in the event that it is necessary to import an older database export into a v23.x or later PaperCut server, it can be done by setting up a clean version of PaperCut MF 22.1.4 or earlier, importing the database, and then upgrading the server to v23.0 or later.
If you do not have the Microsoft packages installed, you may see errors when GhostTrap is running, for example
Can't load GhostScript DLL, LoadLibrary error code 126
and Ghost Trap: Parent unable to load GS DLL
.
If you are experiencing this issue after installing/upgrading GhostTrap version 1.4.x, ensure that you have the C++ redistributable installed from e.g. https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist?view=msvc-170.
Note that this has now been resolved in GhostTrap version 1.4.10.03.1, which now optionally auto-installs the dependency or prompts for the installation. See GhostTrap release history for more information.
When running v23 & using the latest version of the User Client (required, see PO-1845), if the printer is set as "unauthenticated", then credentials popup box will not close.
Replication Testing:
Set a printer as unauthenticated
Run the latest user client and confirms it runs as the logged in user
Print to the unauthenticated printer
Credentials box pops up, enter credentials of a user
Observe user client update with correct balance and name in system tray
Popup box will not close and submit the job
Workaround:
At this time, there is no known workaround. Changing the printer to authenticated / Using Mobility Print will work.
Update 19th Dec, 2023:
This has been resolved with PaperCut MF/NG version 23.0.4:
- Backward-compatibility has been restored for Application Server version 23.0.4 with previous versions of the user client. The exception to this is if you upgraded your clients to the version included with 23.0.3, you'll need to upgrade them to the version included with 23.0.4.
- If you are upgrading from version 23.0.2 or earlier, you don't need to update the client version at the same time as the Application Server - the 23.0.4 Application Server remains backward compatible with previous user client versions.
Unable to successfully retrieve valid data from secure connection to server
when using older versions of the PaperCut Client for authentication, after upgrading the Application server to 23.0.3.
Please note that has only been seen when using the PaperCut user client for authentication (when a user has to enter their username and password into the PaperCut user client login). If you're only using the user client for the balance window, or for shared account selection, but not authentication, this will not be an issue. This also does not impact the user web interface login.
Workaround:
Upgrading the PaperCut Client to the latest version should resolve the issue, however we are adding this to the known issues page as an additional disclaimer for customers planning to upgrade so that they know that the PaperCut Client will need to be updated in tandem with the server.
Update 19th Dec, 2023:
This has been resolved with PaperCut MF/NG version 23.0.4:
- Backward-compatibility has been restored for Application Server version 23.0.4 with previous versions of the user client. The exception to this is if you upgraded your clients to the version included with 23.0.3, you'll need to upgrade them to the version included with 23.0.4.
- If you are upgrading from version 23.0.2 or earlier, you don't need to update the client version at the same time as the Application Server - the 23.0.4 Application Server remains backward compatible with previous user client versions.
Print deploy is failing to install the printer because pc-print-updater
is failing to run with a Access is denied
message.
You can confirm this is happening by reviewing the pc-print-deploy-client.log
and looking for this line in the logs:
updater.exe: STDERR|ERROR: Operation failed with error: rename update2023-09-04-1440 v2023-09-04-1440: Access is denied.
Workaround is available based on your configuration.
If you are using DPM:
Make sure all the PD client installations have DPM enabled during installation (that means, don't pass SKIP_DPM=true during installations)
If you don't need or use DPM installed with PD Client:
Set DPMUpgradesEnabled
to false in client.conf.toml
file in the Print Deploy server (C:\Program Files\PaperCut MF\providers\print-deploy\win\data\config)
Restart Print Deploy server service. This will stop sending DPM upgrade commands to client.
The Print Deploy team is aware of this issue and will release a fix soon
The Hardware Page Count feature does not work when using the Print Provider in the new HTTPS configuration released in NG/MF version 23.0.1.
Workaround:
If you require Hardware Page Count to be performed you must currently disable HTTPS in the Print Provider.
Investigation Status:
The issue is now fixed for Windows and Linux in PaperCut MF version 23.0.3. Work is in progress to fix this for MacOS too.
Note that this has now been resolved in PaperCut MF and NG version 23.0.3.
Once the Intune package has been created & uploaded to Intune - administrators should be able to specify what context it is added as (user/system)but this defaults to user, causing the install to fail.
Workaround Pre PaperCut Version 24.0.2:
To change this to system you need to edit the XML & follow the below steps before uploading the Intune file created in Step 1 in the installation guide:
Edit XML file
• Open the Intune package file in 7zip browse to \IntuneWinPackage\Metadata\Detection.xml
• Modify the MsiExecutionContext XML from User to System and save
You can now upload to Intune and you’ll see the install behaviour change from user to System. This process will need to be repeated if an updated client needs to be deployed.
A permanent fix is in 24.0.2, please upgrade PaperCut to resolve this issue.
As of 20.9.2023, this should now be resolved by a code change made in our Cloud Compression Engine. This does not require any action to the NG/MF server. Issue:
Integrated Scan PDF's with OCR (make searchable) and compression enabled are currently crashing in Adobe. Other PDF readers and web browsers are NOT crashing when opening these PDFs.
Cause:
At this time we believe this to be caused by the most recent Adobe Reader update (12th September), however investigation is ongoing. Adobe Release Notes
Workaround:
Set the PDF/A flag in the scan action will result in the PDF successfully opening in Adobe. Or, open the PDF in another supported program, such as Google Chrome or Microsoft Edge.
Solution:
At this time we are investigating the cause. If you would like updates, please keep an eye on this Known Issue, or log a ticket with PaperCut Support and quote "SC-1998", your PaperCut CRN and request to be added to updates to this JIRA.
Models reported:
C8130
C8155
C8170
Print Deploy Client v1.71670
21.2.13
22.1.3
Error: Scan job could not be completed. Please contact your administrator
.
Please note that this only impacts KM devices in the AccurioPrint 2100 series, and only impacts scan jobs done through the MF Integrated Scanning feature. Device initiated scan jobs are not impacted.
Resolved in 23.0.1
Users may find that when they attempt to select the file name of an Integrated Scanning job, the text field is unresponsive. This can make it difficult to make minor changes to the text field on the devices screen. So far confirmed effected devices are Altalink C8130, C8045 & C8145. This does not seem to be Firmware dependant. This only occurs when at the device physically, if performing the action via the remote panel, the issue will not be present.
Cause:
We believe this was introduced at some point during V22 of PaperCut MF. Confirmed effected is 22.0.9 onwards.
Request:
At this time we are tracking effected customers via CDSS-2455. If you are effected, we kindly ask that you log a support ticket with PaperCut Support quoting "CDSS-2455", as well as your CRN, model of device and MF version number. Thank you.
To resolve this, a PaperCut Application Service restart is required.
We are actively working on a fix for this issue.
Please note that this has now been resolved in the 23.0.0 release (released publicly as 23.0.1).
print-provider.log
file for:
ERROR: OpenPrinterA: printer_name=''\\pd-client\YOUR_DIRECT_PRINT_QUEUE_NAME - The printer name is invalid. (Error: 1801)
INFO : Redirect target print server omitted as target print server (pd-client) is as same as configuration key ServerName (pd-client)
Please log a ticket with the PaperCut Support Team if you would like to be proactively notified of the fix for this issue in an upcoming release of NG/MF & Print Deploy.
Please note that this has been fixed in PaperCut MF/NG version 22.1.4.
In iPrint environments, users may have the iPrint Client installed. When our solution redirects or converts a print job, iPrint will detect that the original version of the job has been cancelled, and by default the iPrint Client will notify the user of this cancellation. The job will proceed successfully, but users may be mislead by the errant notification into believing their job has been cancelled.
To avoid any such confusion, we recommend that organisations running the iPrint Client disable client notifications:
https://www.papercut.com/kb/Main/IPrintCanceledJobs
We believe that setting SSL to strong defaults in the "server.properties" should resolve this issue with TLS1.3. If you are experiencing this issue, please change the following settings, and restart the App service. The device should embed successfully:
server.ssl.protocols=auto
server.ssl.cipher-suites=auto
server.ssl.using-strong-defaults=Y
server.ssl.follow-client-cipher-order=Y
server.ssl.sni-host-check-enabled=N
Issue:
We have had some reports that new Canon MFDs are coming with the minimum TLS setting set to 1.2, and the maximum setting set to 1.3.
So far confirmed devices are as follows. Canon - imageRUNNER ADVANCE DX C3935i / C3930i / C3926i / C3922i. With these settings, embedding the Canon may fail, and simply display a blank white screen.
We are currently investigating potential solutions.
Workaround:
If you set the minimum TLS to 1.0, and maximum to 1.2, the device should embed successfully.
After upgrading to 22.1.2, you may find that Options > Notifications > SMTP Server Options > SMTP server is set to
Choose...
, as though you haven't set up an SMTP server.
IMPORTANT: please note that this issue does not actually impact the sending of emails - in the background the SMTP server settings will be retained.
If you do re-select the correct server type that you were using (e.g. Gmail or Custom etc) you may find that some of the fields are blank. Please ensure that you re-populate those fields before applying/saving any changes. Otherwise it will save the blank fields, and email notifications will stop working.
As an example, if you were using
Custom
before upgrading, then after the upgrade you will find the SMTP server set to Choose...
. If you then re-select Custom
from the drop down, you may find that the Host, Port and Encryption fields are blank. You'll need to re-populate those fields before saving (applying) the changes.
You can find previous settings through the config editor, in the following keys:
- notify.smtp.encryption-method
- notify.smtp.port
- notify.smtp.reject-untrusted-certificates
- notify.smtp.server
Please note that this has now been resolved in the PaperCut MF/NG 22.1.3 release.
The Windows Print Deploy Cloner may fail to properly clone if a Printer Port has a tab (\t) in the port name or host.
Example: 192.168.0.10 HP Universal Printing PCL 6
To work around this, please remove the tab (\t) from the name.
The Print Deploy team are aware of this issue and will look to fix this in a future release.
A change in 22.1.0 and later (related to the security hardening efforts) enforces a minimum 8 characters for all Internal User passwords.
Some customers (including customers using Nexudus integrations) have reported issues when using 22.1.0 or later because the integration attempts to create users with 4-character passwords. Creation of users then fails with the 8-character enforcement in place.
Workaround:
We recommend changing the Nexudus (or other user management integrations) configuration to use an 8-character minimum password length instead when using PaperCut MF/NG version 22.1.0 or later.
Please note that this has now been resolved in the PaperCut MF/NG 22.1.3 release: "For internal user accounts only, re-introduced honoring of config key min-password-length to allow admins to set minimum password length for users. Admin password length minimum is still 8 characters since 22.1.1."
The Windows Print Deploy Client may fail to update from a Windows Print Deploy Server.
You can confirm this is happening by reviewing the pc-print-deploy-client.log
and looking for this line in the logs:
2023/06/21 17:12:57 updater.exe: STDERR|ERROR: download checksum failed
The Print Deploy team is aware of this issue and will release a fix as soon as possible.
The onscreen error states "Could not execute batch: SQL insert...."
When the Site Server reconnects with the App server, the issue is immediately rectified.
Please note that this has now been resolved in the PaperCut MF 22.1.3 release.
These models of Xerox devices are working as per Xerox defined specifications. Customers using Versalink and Primelink modelswith PaperCut MF will need to ensure that whatever field they plan on using as their User ID should consist of no more than 32 characters.
If you want to contact Xerox about this issue directly, please reference: FER 17493.
We're actively investigating this.
Workaround:
We have discovered that this issue only happens when debug mode is enabled on the Application Server. As a temporary workaround while we investigate a full fix, we recommend switching off debug mode (in the PaperCut MF admin console > Options > Advanced > then ensure that "Enable debug mode" is unchecked.
Please note that this has now been resolved in version 24.0.4.
The new user web interface (with limited functionality) is not enabled by default. When using version 22.0.11 or later, the user is presented with a blank page after logging in.
Important: the original (default) user web interface is not impacted by this issue.
Please note that this has now been resolved in the 22.1.1 release.
The Print Deploy Clone on macOS may incorrectly clone an IPP Print Queue with missing data if the IPP endpoint (CUPS or PaperCut Mobility Print) is unavailable during cloning.
This will cause the printer to fail to install on a Print Deploy Client machine.
Workaround: Ensure the IPP endpoint is available during cloning.
You can find a similar log entry in the
pc-print-deploy-client.log of:Failed to install printer Print-Deploy-Mobility: printer connection type is not supported. valid values: [mobilityprint, directprint, serverprint] {"src":"pdservice.go:653"}
The Print Deploy will release a fix for this shortly.
WORKAROUND:
Please manually configure the correct Application Server address under Enable Printing -> Print Deploy -> Settings -> Direct Print options, which is resolvable from your client machine, remembering to Save the change towards the bottom of the page.
UPDATE May 15th 2023: This has been resolved in version 1.7.2336 of Print Deploy.
Please note that this has been resolved in PaperCut MF version 22.1.2
When a refund is made, the refund is credited to the personal default account instead of the personal account that was originally charged.
We're actively investigating this issue, so if you believe you've encountered it please reach out via our support portal and quote PO-1345.
Please note that this has now been resolved in PaperCut MF/NG version 22.1.3.
PaperCut versions prior to 20.1.7, 21.2.11 and 22.0.9 are vulnerable to a serious security exploit and should be patched immediately. All customers should update to the latest version of PaperCut as soon as possible.
Further information is available here.
The Print Deploy Client will display Navigation to webpage was cancelled or Can't reach this page. The PaperCut Print Deploy Client logs will show
Service stopped with exit code 1
and Restarting service (crash count: n)
along with ERR Failed to create env version file updater: no evn version contained
We're actively investigating this issue, so if you believe you've encountered it please reach out via our support portal and quote PD-1640.
UPDATE May 15th 2023: This has been resolved in version 1.7.2336 of Print Deploy.
These printers will appear in the Printers pane, in the following form:
pd-client\printerName
The client machines may then not be able to print to these local printers.
We're actively investigating this issue, so if you believe you've encountered it please reach out via our support portal and quote PD-1638.
UPDATE May 15th 2023: This has been resolved in version 1.7.2336 of Print Deploy.
We are investigating the issue and will update with details as we understand the issue in greater depth - including the exact circumstances where the client could crash.
Windows will report Application Error event 1000 in Windows Logs / Application.
A quick solution for a small number of workstations is to running the application in Windows 8 Compatibility Mode as we work to resolve this issue.
Alternatively, if account selection is the primary use of PC-Client, configuring the users to "Automatically charge to a single shared account" may also be an option.
One advanced solution if the PaperCut Client is starting from a share on the server is to run these commands to edit the registry on each workstation:
REG ADD "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers" /v "\\SERVER\PCClient\win\pc-client-local-cache.exe" /t REG_SZ /d WIN8RTM
REG ADD "HKLM\SOFTWARE\Microsoft\Windows NT\CurrentVersion\AppCompatFlags\Layers" /v "\\SERVER\PCClient\win\pc-client.exe" /t REG_SZ /d WIN8RTM
Be sure to update the path with the fully-qualified domain name of your server!
This could impact:
- pc-release.exe
- pc-release-manager.exe
- pc-release-secure.exe
- pc-pay-station.exe
- pc-client.exe
- pc-client-java.exe
- db-tools.exe
- server-command.exe
- create-ssl-keystore.exe
- sharp-configuration-tool.exe
- and others.
Please note that this has now been resolved in the 22.1.1 release.
PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
Workaround(s):
We have had reports toggling HTTPS to OFF for the device works without issue.
OR
Please use the 1.4.2 ROC Tool.
Solution:
We are currently working on a new version of the Tool to be released with an upcoming MF release.
Please note that this has now been resolved in PaperCut MF version 22.1.2
TypeError: Cannot read properties of undefined
(reading 'includes')
Workaround:Toshiba has introduced two new settings
Background Copy
and Background Scan
which is disabled by default. These settings need to be enabled in order to resolve the issue.- Log in to the MFP web interface (TopAccess) with your web browser as the “Admin” user.
- Select the Administration tab > select Setup tab
- Under Functions, set the
Background Copy
option toEnable
- Set
Background Scan
option toEnable
- Save the settings
We are looking into this issue and are currently looking to resolve this issue in v22.0.11.
Workaround:
Some customers encountering the issue have reported a temporary workaround by configuring these devices with the
Automatically release jobs upon login
setting under Devices > [select device] > Print Release (please see configuring secure print release in the manual for more info).
The other option you have is to downgrade your PaperCut MF Application server and devices back down to v22.0.7 in the interim but please be aware you will be vulnerable to the following security issues by not being on v22.0.9.
Please note: this has now been resolved in version 22.0.11.
The readme.txt file for batch-devices.csv is not up to date with the latest device name changes.
Please edit as follows when building a batch-devices.csv file for deploying Fuji devices:
The following lines need to be removed (lines 93-94):
FUJIFILM:
FujiFilm Business
The following lines need to be added:
FUJIFILM_V7:
Fujifilm BI AIP 7+
FUJIFILM_SFP:
Fujifilm BI AIP 7+ (Printer only)
Please note that this has been resolved in PaperCut MF version 22.0.10.
When connecting a Secondary Universal Print connector to the Primary App Server, the auth token for Universal Printer will not work if it begins with an "a". Capitalisation will make no difference.
For example - The auth token set to "PaperCut" will work, but "aPaperCut" will fail.
You will see the following in the Secondary Log -
Failed to subscribe to primary connector: 401 Unauthorized
The Primary UP logs will show -
ERR authorizationMiddleware.go:30 Unauthorized request
Workaround - Change the auth token to have anything other than an "a" as the first character.
Optional Printers in Print Deploy are some times not reinstalled when a user moves between zones.
The Print Deploy development team are aware of this issue and are working on a fix.
Workaround
This can be prevented from occurring again by unplugging and initializing the SD card storage, or by using an SD card with a larger storage capacity.
If the Recipients field of a Scheduled Report is empty and the Copy button is pressed, the report copy will not have all of the attributes visible.
When copying a Scheduled report, ensure that the Recipients field is not empty.
Log Data Privacy Setting
is set to Not to store
by default. When this is set to Not to store
, PaperCut MF is unable track user-level usage for all device job types (print, scan, fax, copy) since the username cannot be determined.Workaround: Set
Log Data Privacy Setting
to Store
- Log in to the MFP web interface (TopAccess) with your web browser as the “Admin” user.
- Select the Administration tab > select Setup tab
- Under Confidentiality Setting, set the
Log Data Privacy Setting
option toStore
- Save the settings.
This fix has brought about some minor changes on the Options > User/Group Sync page. The problem we will address in the 22.0.9 release, is when end users are allowed to self-register as internal users, IF the admin had set up the system to auto generate ID PINs, there was no way for the end user or admin to know what the PIN was, because the PIN is masked by `****` in their email as well as on the post-registration screen.
We've therefore implemented a fix to reveal the ID PINs that was auto-generated as clear text in the emails that are delivered to users. This brought about the necessity for email notifications. We've therefore added one constraint on the Options > User/Group Sync page that if all three are true:
1. Internal users are enabled.
2. User can self-register.
3. ID PINs are randomly generated by system as opposed to self-chosen.
... then both of these boxes must be ticked:
1. User must enter an email address.
2. Also send email confirmation to the user.
Should the first 3 conditions be met and either of the 2 boxes mentioned is not ticked, the page will not save, and will show an error. This is to ensure that when the 3 conditions are met, we can always notify the user of their ID PIN.
Please note that the method admins use to add internal users is not affected. Admins can continue to add internal users without providing an email address, because the admins have to input a PIN value while creating internal users. If they choose to, they can inform end users of their ID PINs in different ways, e.g. separate email or in-person verification process.
Due to this new constraint, we also changed the default value of "Also email confirmation to the user" box to be ticked, as "User must enter an email address" is already by default on. This does not affect the settings of old installs. The constraint will NOT apply to pre-existing configurations. It only applies when you try to change any settings on the Options > User/Group Sync page because that is when the validation processes run again.
For more information, see the kb: Options User Group Sync Change in 22.0.9.
IP-SUBNET filters are being detected as IP-RANGEs and including too many IP addresses.
Workaround: Print Deploy administrators can reliably use CIDR notation when using IP based filters.
More detail: Print Deploy supports multiple filters on Zones, restricting what printers are applied to a client. This includes IP based filters.
Print Deploy administrators may use IP-CIDR, IP-RANGE and IP-SUBNET filters.
Due to an issue in detecting the use of a SUBNET vs RANGE, a client may receive more printers than expected due to the SUBNET being detected as a RANGE.
Example: 10.0.0.0-255.255.255.0 includes all IPs from 10.0.0.0 to 255.255.254.255 and thus would incorrectly match 192.168.12.33.
(This issue is also known as PO-1134)
Please note that this has now been resolved in PaperCut version 22.0.9.
Sharp is currently working on getting a firmware released to fix this issue.
Workaround: It is recommended to register the card reader as this issue only occurs with unregistered card readers.
Authorize.net does not provide full support for Unicode characters in user names.
This can result in payments made via Authorize.net failing if the user's name includes unsupported Unicode characters. Unsupported characters include the 'é' character used in the French language.
UPDATE: The default for "ext-device.block-release-on-error.paper-out-using-trays" key will be changed to "no" in 22.0.9.
This configuration key was added in 22.0.8, and we have seen some confusion around how this key works & what it is for. Hopefully this Known Issue will clear things up.
Before you read this, please make sure you have read Step 3 in the Manual .
Reason for this additional config key:
Before this key, the global “noPaper” value was not honoured by a large number of OEMs. The addition of the new key enables the “noPaper” value to work on the vast majority of devices, regardless of OEM. The ongoing exceptions are Brother and Epson devices. During our testing these devices do not return the “noPaper” command we use with either key.
So with this key added, we now provide the same outcome to the “noPaper” value for most devices, creating a common outcome across all devices.
In fact, with this key, we now offer a wider range of variables for all OEMs, from only blocking release when all trays with a particular tray size are out (all_size), to blocking release when all trays are out of paper (all).
Default setting:
The decision was made to set the default key to “any”, so that it would match the original “noPaper” default setting. This setting blocks release when any of the trays is out of paper.
We understand that due to the increase in devices now supporting this configuration, that this level of tray detection may be leading to understandable confusion.
We currently have a tracking number for changing the default configuration to “no”, which would effectively disable this configuration key and require manually setting one of the other options explained in the manual. Please log a ticket with PaperCut Support and quote “PIE-219” if you wish to see us change this. Please let us know if you would prefer the default to be set to “all”, so that we only block release when all trays are out of paper. Update: Please see top of Known Issue.
Further notes:
This new configuration key is not retroactively added after upgrading to 22.0.8. However if no key is present in 22.0.8, we will assume the default value of “any”. Remember that “noPaper” still needs to be enabled for this to be honoured.
In the past, Xerox devices required an extra flag for the default key of “inputTrayEmpty”. If the new key is being used, this is no longer required as the “noPaper” command will be honoured. The manual will be updated to reflect this change (PIE-220)
“noPaper” MUST be set in “ext-device.block-release-on-error.snmp-error-list” for the new configuration key to be used in any capacity. This is the top level trigger for tray detection. Consider the new key an extension of the “noPaper” command.
Note that this key is now defaulted to "no" in 22.0.9
When installing PaperCut NG/MF 22.0.8 for the first time there is a possibility that the Print Deploy Server service does not start properly.
A coffee cup is shown instead.
Workaround: Restart the PaperCut Print Deploy Server service.
You can confirm you are experincing this specific issue by confirming these two entries in the PaperCut Print Deploy Server logs: pc-print-deploy.log
During startup: 2023/01/25 09:30:10 pc-print-deploy-server.exe: STDOUT|ERROR: failed to read C:\Program Files\PaperCut MF\server\data\internal-api-key.dat: open C:\Program Files\PaperCut MF\server\data\internal-api-key.dat: The system cannot find the file specified. {"src":"authmf.go:32"}
When viewing the Print Deploy Server admin interface: 2023/01/25 09:31:46 pc-print-deploy-server.exe: STDOUT|ERROR: AdminAPIAuth: error: authorization key provided for this request is invalid {"src":"verification.go:20"}
The Print Deploy team are aware of this and will update this KB article when there is a fix available.
Please note that this has now been resolved in PaperCut version 22.0.9.
Unexpected error communicating with the server java.io.IOException: An unexpected network error occurred
This doesn't appear to be specific to any MFD manufacturer and we have so far seen this on HP, Ricoh and Lexmark devices.
Initial investigations appear to point at the .mapdb files used on shared storage between the MF HA clustered nodes as the probable cause.
We have reports of errors with HP legacy FututreSmart copiers after upgrading to 22.0.8.
The copiers will fail to start, and show errors on the Device Details page of the PaperCut Admin UI.
We are investigating, but in the meantime advise customers with legacy FutureSmart copiers to remain on 22.0.7 or earlier.
Please note that this has now been resolved in PaperCut version 22.0.9.
Please note that this has now been resolved in PaperCut version 22.0.9.
expecting EOF, found ')'
.Since version 22.0.8, modifying child/sub accounts with batch import, server command, or API fails with error
expecting EOF, found ')'
.This only happens if you are importing/updating sub-accounts. If you're only importing/updating Parent accounts, this works successfully.
Another way the problem can manifest is if child/sub accounts are in use, and you attempt to set one of these accounts as a default shared account for a user, or configure a user to automatically charge to one of these accounts. If a user was already configured to automatically charge to a child/sub account, or had a child/sub account as their default account, prior to upgrading to 22.0.8, attempting to modify any attribute for that user will also result in this error.
If a user attempts to use Web Cashier to charge items to a child/sub account, the problem will also occur.
Workaround: for now, adding the child/sub-accounts manually through the user interface (Accounts > Actions > Create new account) is the only workaround for the import issue.
For the user details issue, there is no workaround besides not configuring the use of child/sub accounts.
For the Web Cashier issue, there is also no workaround.
Update 17th Jan 2023: there is now a hotfix available for this issue if needed. Please quote PO-1205 when contacting us to ask for it - thank you!
We'll also be looking to resolve this issue officially in an upcoming release.
Please note that this has now been resolved in PaperCut version 22.0.9.
This does not seem to effect any other form of login method - only swipe cards.
Workaround: In lieu of migrating to an alternative login method (E.g ID or username/password), the only known workaround is to downgrade the PaperCut MF server to the previous version.
Update 17th Jan 2023: A further workaround is to set the key
ext-device.konica-minolta.browser.enable-fast-login-flow
to N
which disables the faster login flow. As a result, the login time may be slightly increased, however the issue with the pre-authorization error message will disappear. Please see the 'PaperCut MF - Konica Minolta i-Option Embedded Manual' for more information about setting that key.
In the meantime we are working on a fix for the fast-login-flow option.
Please note that this has now been resolved in PaperCut version 22.0.9.
Print provider 10.3.33.172 was denied access to the application server as it is running a newer, incompatible, version 107.1.0.4602-1B73A92
which can safely be ignored.Print provider 10.3.33.172 was denied access to the application server as it is running a newer, incompatible, version 107.1.0.4602-1B73A92
.
In the 22.0.8 release we introduced a feature which allows newer versions of the Print Provider to communicate with older versions of the Application Server (ref PC-18655).
This means that you can for example be running a 20.x.x version of the Application Server, and run the Print Provider from 22.0.8 or later on your secondary servers. This will work fine as per the enhancement in the release note, however you may see this red-herring alert in your Application Server debug logs. This can be safely ignored (as long as the Print Provider is reporting jobs to the Application Server correctly and appears to be working ok).
In NG/MF version 22.0.8 we released a feature (PIE-40) which enables the Print Provider on CUPS servers to keep track of all currently held print jobs during a server reboot. This feature is not switched on by default.
Previously, the jobs being held during a server reboot would be 'lost' (they wouldn't be printed or tracked). Note that this impacted CUPS servers only (not Windows).
With version 22.0.8, this feature can be enabled by adding the job persistence config key
JobHoldPersistence=on
into the print-provider.conf file. From version 22.0.10 (under change PIE-294) this config key will be added to the print-provider.conf file, but will be set to OFF by default.We will be looking to switch this on by default in a future version - this change is tracked by PO-1199/PIE-295.
Enabling the feature
Manually add the following line to the print-provider.conf file and restart the Print Provider:
JobHoldPersistence=on
Important note: Version 22.0.8 contains an issue that in some cases could cause unreleased print jobs to be released when the server is restarted. This issue (tracked as PIE-226) has been fixed in the 22.0.9 release.
End users running macOS Ventura (beta at the time of writing) will be presented with a "Background Items Added" popup when the PaperCut NG/MF Print Deploy Client is installed to their machine.
This is an inbuilt feature of the new version of the macOS operating system. macOS Administrators can hide all messages of this type by using existing 3rd party MDM tools to manage com.apple.notificationsettings settings
.
PaperCut Mobility Print queues cloned, not imported, by Print Deploy are being deployed with the CUPS configuration of authinforequired username,password
in error.
PaperCut Mobility Print queues do not require the use of authinforequired
.
macOS users will be presented with an operating system level prompt to enter a username and password, preventing normal printing operations.
This has been resolved in 1.7.2234 (Dec 20 2022).
[app-path]\providers\web-print\[platform]\web-print.conf
Add the following line to the end of the file:
options.pdf=xpdf
Save the file and close/open the application, then confirm PDF job submissions work without issue. If you believe you've encountered this issue, please reach out through our support portal and quote reference PIE-208.
Please note that this has now been resolved in PaperCut version 22.0.9.
Please note that this will only impact print jobs which are being held (e.g. in a hold/release queue) at the time that the Print Provider Service (or the server) is restarted.
Workaround: When a PCL6 or PostScript driver for your printer is available, use that driver instead.
Please note: this has now been resolved in PaperCut version 22.0.8
Print Deploy Users with a username that end in a "mime type" (e.g. "john.ma") and use either a Domain/Directory joined machine or "Sign in with Google" may experience issues with the Print Deploy Client intermittently showing a "This is awkward." error message.
This is caused by an API call to the PaperCut NG/MF Application Server not returning expected data.
The Print Deploy team are aware of this issue and will release a fix, independent of a PaperCut NG/MF change, shortly
For example, if you configure a print queue with 'Enable hold/release queue' and then head into
Devices > [select device] > Summary > Print Release > Enable print release
. You will see the printer appear successfully under the 'Physical with Hold/Release' or 'Virtual with Hold/Release' sections of the list.
If you then go back and update the print queue to uncheck 'Enable hold/release queue' and then head into the same device setting, the printer should appear under the 'No Hold/Release' section. Instead it mistakenly appears under the original 'Physical with Hold/Release' or 'Virtual with Hold/Release' section.
This can be fixed by restarting the Application Server - however we believe this will only be seen if customers are making regular changes to the hold/release properties of a queue. This will not impact any of the hold/release functionality or find-me functionality.
Please note that this has now been resolved in PaperCut version 22.0.9.
In order to utilise the updated version with the correct addresses, please download the latest version, which can be found here https://www.papercut.com/kb/Main/SettingupthePaymentGateway#step-2-download-and-install-the-payment-gateway-module
If required you can follow the instructions for installing the payment gateway module here https://www.papercut.com/support/payment-gateway-guides/
When attempting to run the Print Deploy Cloner on macOS Ventura the following error will be displayed
"PaperCut Print Deploy Cloner.command" can't be opened because (null) is not allowed to open documents in Terminal.
Workaround 1: Mount the DMG and run the Cloner directly from Finder:
- Navigate to
/Volumes/PaperCut\ Print\ Deploy\ Cloner
- Right click on
PaperCut\ Print\ Deploy\ Cloner
and select "Show package contents" - Navigate to
Contents/MacOS/
- Double click
PaperCut\ Print\ Deploy\ Cloner.command
/Volumes/PaperCut\ Print\ Deploy\ Cloner/PaperCut\ Print\ Deploy\ Cloner.app/Contents/MacOS/PaperCut\ Print\ Deploy\ Cloner.command ; exit
The Print Deploy team are monitoring this issue and believe an update of macOS may fix this issue. We are also investigating changes to the macOS Print Deploy Cloner to support this change in macOS Ventura
ext-device.fujifilm.login.id-field.numeric
set to Y
, the regular device keyboard is displayed on screen instead of the expected numeric keypad
Please note: this has now been resolved in version 22.0.11.
This is not a Toshiba device or it was not registered successfully
.This is not a Toshiba device or it was not registered successfully
. This is due to a new REST endpoint service that has been added in the latest firmware, and causes the device registration to fail.
Workaround:
Disable the REST endpoint on the device. This will not have any side-effects on the functionality of the device.
- Log in to the MFP web interface (TopAccess) with your web browser as the “Admin” user.
- Select the Administration tab > select Setup tab > select ODCA section.
- Under REST, set the
Enable Port
option toDisable
- Save the settings.
We have also updated the Toshiba MDS V3 Embedded manual with this information (see section 2.4.16).
- The service works for a while and then stops
- Logs showing email fetching failures, sometimes the logs will explicitly say this is due to throttling, and usually after that, we will get a different type of exception
FolderClosedException
, causing the input stream reading process to fail; - Sometimes the failure point is at attempts to delete emails after fetching. Deletion is also part of the IMAP/POP3 functionality.
For more information, please see Recent Issues with IMAP or POP3 for Microsoft Exchange Mail Servers.
This is not a Fuji Xerox device
displayed on Fujifilm Business devices when upgrading to version 22.0.5 or laterThis is not a Fuji Xerox device or was not registered correctly.
This is due to the changes made for Fujifilm Business devices, documented in the 22.0.5 release notes.
IMPORTANT: Please read the Upgrading PaperCut MF to 22.0.5 with an existing Fujifilm Business device fleet article for more information.
Please note that further changes have been made in 22.0.7 which make this process easier. Please see details in the FujiFilm upgrade article above for more information.
This only happens with card authentication (username/password or ID number authentication are not impacted), and does not happen with all CR5 devices - some are not impacted at all, and others display this login issue.
We are actively working with Sharp Australia and Sharp Japan to resolve this issue with the highest priority.
Please note: This has now been resolved in PaperCut version 22.0.8.
WORKAROUND - Select an account on the PaperCut account selection screen before pressing the device home button
This new integration currently works with versions 21 and higher of PaperCut MF/NG, but attempting to use it with versions 19 and 20 will result in an error similar to the following:
Unable to invoke method formSubmit on ext.paymentgateway.pages.ExtnMonerisCheckout$Enhance_22@1f76794b[ExtnMonerisCheckout]: null
We have a hot-fix build available on request, please contact support and quote PO-1047.
We are working on a fix - in the meantime printing / tracking / copying / faxing / scanning should all continue to work without issues.
If you see this error and you are experiencing issues making configuration changes (e.g. adding Print Deploy zones) please reach out to the Customer Care team through support.papercut.com. Otherwise all other functionality should continue to work without issues.
Please note: This has now been resolved in the 22.0.6 release.
No data type for node: org.hibernate.hql.ast.tree.MethodNode
when trying to run the Executive Summary report (Reports > User > Executive Summary) or looking at Printer Statistics (Printers -> [select printer] -> Statistics). This looks to only be an issue if an external database (specifically SQL Server or Postgres confirmed so far) is in use.Other reports run successfully.
Update: This looks to impact customers using SQL Server and Postgres. MySQL and Derby (internal) databases do not appear to be impacted.
Please note: This has now been resolved in the 22.0.6 release.
Please note: This has now been resolved in the 22.0.6 release.
The Print Deploy team will be releasing a fix for this issue as soon as possible.
The previously cloned printers will fail to install on end user devices. Printers that are already installed will keep working.
Recovery steps:
If you have a recent backup after upgrading to v1.7.2177 or later and before you recloned, you can copy back the contents of the following directories.
~\providers\print-deploy\win\data\repository\drivers\[os]
~\providers\print-deploy\win\data\repository\capabilities\[os]
If your backups are from older versions of Print Deploy prior to v1.7.2177, then reach out to our support team at https://www.papercut.com/support/#papercut-mf and we’ll help you recover by reverting back to an older version.
Workaround:
Browse to ~\providers\print-deploy\win\data\repository\drivers\mac\ and if you see multiple subdirectories in there, copy the contents of each subdirectory to the latest one.
For example, if you have two subdirectories, 10.14-amd64, 12.5-amd6, then copy the files from 10.14-amd64 to 12.5-amd64.
Please contact Support if you believe you've been affected by this issue.
Note that this has now been resolved in our 22.0.5 release.
WORKAROUND - Currently downgrading the embedded to 3.0.2 will rectify the issue.
Please note that this has now been resolved in PaperCut version 22.0.9.
In the meantime, you can stay in PaperCut MF 22.0.2 or use this https://www.papercut.com/kb/Main/SharpCR5AtlasTitanwithMF#workaround-details
In PaperCut NG and MF 22.0.3, setting up a Google Cloud Directory user sync source will fail because the Google certificate import step fails with the following error:
The certificate failed to import. No changes were made.
Any Google Cloud Directory sync sources that were already set up using a PaperCut version prior to 22.0.3 will continue to work.
In order to resolve this issue, please follow the instructions below specific for your operating system.
Windows or Linux
Add the following line to the
wrapper.java.additional.8=-Dkeystore.pkcs12.legacy
After saving the file, restart the application server and confirm that you can now import the certificate.
MacOS
Add the following line to the
PC_CUSTOM_SERVER_ARG=-Dkeystore.pkcs12.legacy
After saving the file, restart the application server and confirm that you can now import the certificate.
SmartSDK
The current workaround is to utilize an older version of the SmartSDK application until this issue is resolved in an upcoming Maintenance Release.
Note that this has now been resolved in our 22.0.5 release.
print-and-device.script.enabled
key is set to N
by default. This means that scripting is disabled by default. This is expected behavior.
However, there should be a warning message that appears on the scripting page (e.g. under Devices > [select a device] > Scripting, or Printers > [select a printer] > Scripting), which tells the admin that scripting has been disabled, and links to instructions on how to enable scripting.
In version 22.0.0 and later this warning message is missing, so the scripting page just shows a blank page.
Workaround:
Enable scripting as described in the Enabling Print Scripting and Device Scripting KB.
Please note that this has now been resolved with our 22.0.3 release.
Please see the Sharp CR5 Atlas and Titan bulletin for more information, and workarounds.
Please note that this has now been resolved with our 22.0.2 release.
Clients:
Windows v1477
macOS v1181
Linux v492
The Print Deploy client is not correctly setting default printers based on the Zone configuration. Users may need to manually set their own default if required.
The checkbox can be found in Devices > Scan Actions > [select a scan action] > Details > Output settings > File type > PDF > Convert to PDF/A. If the scan action is using a document processing feature as detailed above, the checkbox will not impact the output file type.
We are hoping to fix this in a future maintenance release.
Workarounds: the only ways around this currently are:
- Use the device's native scanning function.
- Do not enable any of the document processing features for that scan action.
Side note: If you happen to be using the preview-release version 22.0.0, you'll find that the checkbox does actually work succesfully - and if you uncheck the Convert to PDF/A box you will receive a 'regular' PDF instead. This is not the case with 22.0.1 and 22.0.2, where the output will continue to be PDF/A in the circumstances above.
Update: This issue has been resolved in version 22.0.3 of PaperCut MF. After updating to version 22.0.3, existing scan actions from previous PaperCut MF versions that have any of document processing features enabled will now have the PDF/A box ticked. If the checkbox is subsequently unticked, the checkbox will now function as expected, and deliver the job as PDF instead of PDF/A.
Server: 1.6.2083
Windows Client: v1477
Server: 1.6.2096
Windows Client: v1484
Windows Print Deploy Clients that are left logged out (e.g. after a restart) will display an error page to end users saying "Can't reach this page".
This is caused by the computer being left at the login screen for too long and the Print Deploy Client stopping.
Please upgrade to Print Deploy server version 1.6.2096 and Print Deploy Client version v1484 to rectify this issue.
Users who have not authenticated to the PaperCut Print Deploy Client previously may not be shown a popup prompting for authentication.
Workaround: Users may still right click the Print Deploy Client in the taskbar / system tray and access their printers via "View My Printers" and follow the authentication prompts there.
The following TASKalfa devices are affected: 8002i, 7002i, 6002i, 5002i, 4002i, 3511i, 3011i, 8052i, 7052i, 6052ci, 5052ci, 4052ci, 3552ci, 3252ci, 2552ci, Ecosys MA5500
Note that this has been resolved in version 23.0.0, under CDSS-1865.
We have a hotfix Print Provider available to fix this issue, and this updated Print Provider will be included in a future public release.
Please note that this has now been resolved with our 22.0.3 release.
Windows v1429
macOS v1132
Linux v444
If the installation of a printer takes longer than expected, the Print Deploy Client may show to the user that the printer failed to install correctly even though the user can see the printer in their printer list when printing and printing works as expected.
The Print Deploy team will be releasing a fix for this issue as soon as possible.
Recent changes to Print Provider may cause print jobs with a number of copies (n) greater than 1 to be printed with n2 copies (number of copies multiplied by number of copies).
This behaviour was introduced in version 21.2.0 and only impacts the Print Provider when using Linux and macOS. The number of copies reported in PaperCut NG/MF will show the original number requested, but the actual number of copies printed will be n2.
Update: This has now been resolved in version 22.0.0 (available in the public release of 22.0.1).
When using Azure standard sync, the Card ID / Office / Department may not sync if you have selected 'import users from selected groups'.
We have identified an issue where the Card ID, Office and Department will not sync correctly (those fields will not be populated correctly in PaperCut MF/NG) if 'Import users from selected groups' is selected.
Workaround
Use the 'Import all users' option instead, which will then correctly populate the additional fields when the next sync happens (ensure that the config key user-source.update-user-details-card-id is set to Y).
Please note: this was incorrectly advertised that it was resolved in 22.0.8. This is not the case, but we are hoping to have this fixed in a future release.
Please note that this has now been resolved in PaperCut version 22.0.9.
We are working on a build to be released asap which will include log4j 2.17.1 and the fixes from 21.2.6.
In the meantime rolling back to 21.2.5 will restore the binaries for log4j 2.17.1, but without the fixes included in 21.2.6.
This has now been resolved in the 21.2.7 release, which contains the fixes from 21.2.6 and also log4j 2.17.1.
Workaround
Enable deskew, despeckle or any of the blank page Document Processing operations and PDF/A will apply to the scanned document.
Upcoming Fix
A change within an upcoming version of Doc Proc will properly listen to the PDF/A flag and apply it correctly.
This may happen if Federated Authentication is in use for that account - since PaperCut does not currently support Federated accounts for login with username/password where a browser is not in use. For example this may work when the user is logging into the User web interface through a browser, but may not work when the user is logging in with user/password authentication at a copier/device.
We have also seen some customers working around this in their environment using steps similar to these (external site): https://medium.com/@amanmcse/ropc-username-password-flow-fails-with-aadsts50126-invalid-username-or-password-for-federated-90c666b4808d
Please note that this has now been resolved in PaperCut NG and MF version 21.2.6.
Note: if you have applied the latest fix in 21.2.6 or later, and you're still experiencing this issue, you may be experiencing the specific case identified in PC-18730. We hope to have that additional issue resolved shortly.
This vulnerability requires the Apache Log4j component to be configured to listen for logging events on a socket. PaperCut Products do not use this feature of Log4j and as such the vulnerability CVE-2019-17571 does not affect PaperCut Products.
Please also note that this is unrelated to the much-publicised RCE vulnerability in log engine dependency Log4j (CVE-2021-44228) - which is documented in our other Known Issue for CVE-2021-44228.
PaperCut NG and MF have a dependency on the open source logging module log4j2.
A vulnerability has recently been discovered in log4j2 that may allow arbitrary code in logged strings to be executed. See here for details: https://www.lunasec.io/docs/blog/log4j-zero-day/. This vulnerability is sometimes called Log4Shell or LogJam, and defined in CVE-2021-44228.
Please note that only versions 21.0 and later are impacted. Versions 20 and earlier are NOT impacted by this.
Update 13th December
We have published a KB with more information about this Log4j vulnerability.
We are also hoping to have a maintenance release out shortly with a more permanent fix - however we highly recommend the configuration change above in the interim.
Update 14th December
The KB has been updated with a list of FAQs and confirmed impact on the User Client and Release Stations: PaperCut Log4j vulnerability information.
Update 15th December
A maintenance release version 21.2.3 is now publicly available which includes Apache log4j 2.16, and addresses CVE-2021–44228 and CVE-2021–45046
Update 21st December
A maintenance release version 21.2.4 is now publicly available which includes Apache log4j 2.17, and addresses CVE-2021–44228, CVE-2021–45046 and CVE-2021–45105
When enabling the "Sign in with Google" authentication option for Print Deploy an error can be seen in the Print Deploy server logs (pc-print-deploy.log) and authentication via Google will not work. 2021/11/12 17:52:44 pc-print-deploy-server.exe: STDOUT|ERROR: ServerErrorLog: http2: panic serving 10.0.0.51:51402: runtime error: invalid memory address or nil pointer dereference
Workaround: Restarting the PaperCut Print Deploy server service resolves this issue.
Ensure that your security policy within the MS tenancy does not enforce 2FA on the PaperCut app (note that this doesn’t mean that you have to disable 2FA globally). If you are applying policies or conditional access at the machine level, it’s the PaperCut App Server that you’ll need to exclude from 2FA enforcement - not the devices that the users are logging into.
If you do have 2FA/MFA enabled in a policy which includes your PaperCut Application server, then users may see Error AADSTS50076 or AADSTS50079 when trying to log in through the web interface, at the device or through the user client.
Workaround
We currently recommend disabling 2FA/MFA (only) for the PaperCut Application Server app (or the PaperCut app server device if you're applying conditional policies at the machine level). This means that for 'other' login scenarios, users will still need to enter their MFA codes.
See Step 7 of the Preparing to use UPN usernames with PaperCut when synching with the standard Azure AD sync method guide for more information.
Update in version 23.0.1 and later
There is additional support for MFA in version 23.0.1 and later - see Overview of synchronizing user and group details with Entra ID (Azure AD) for more information. While this Known Issue is now 'resolved' since this release, the errors listed may still occur if using unsupported functionality (e.g. logging into an MFD interface using username/password when MFA is enabled). See Deciding which sync option is right for you for more info on which options are supported with MFA.
Unexpected Apple Disk Image filename
Unexpected Apple Disk Image filename
.
Note that this was resolved in Print Deploy version 1.5.1947
- Are using the standard Azure AD sync.
- Have the config key
user-source.update-user-details-card-id
set toY
because you're synching the EmployeeID field from Azure into the Primary Card ID field in PaperCut. - Check the 'Auto generate random primary card ID number when blank' box under the Azure AD user/group sync options.
You'll notice that the checkbox gets unchecked when the page reloads. This is because in the background that checkbox is conflicting with the config key option to sync the field from Azure AD. You'll need to choose between either synching that primary field with Azure (keep the config key set to Y, but do not check the 'Auto generate random primary card ID number' checkbox), or not synching with Azure and instead using the auto-generated number (use the opposite settings).
One side effect of this is an edge case where you are synching your users for the first time. In this case if you perform the steps above and a brand new user is created in PaperCut, the user will initially have an auto-generated primary card ID number, even if they also have a valid EmployeeID in Azure. However at the next scheduled sync, because the checkbox to auto-generate the number will have been unchecked by the system, it will then correctly pull in the EmployeeID from Azure.
We're looking to get this resolved in a future release - but in the meantime as long as you don't set the conflicting values, it should behave as expected. It's also worth noting that the Secondary card number options are not impacted by this, since there is no curent option to sync the secondary card number with Azure AD.
Firmware Error [500.00] Profile "PaperCut Scan-to-Email" failed to stop before timeout.
Workaround
Increase the Lexmark device 'Screen Timeout'
Settings
=> Device
=> Screen Timeout
Our path is Settings
=> Device
=> Screen Timeout
Increase the Screen Timeout.
300
seconds is the maximum possible.Please note that this has been fixed in PaperCut MF/NG version 22.1.4.
Case 1: If all of the following are true:
- Using PaperCut version 21.1.2
- Account selection is enabled for the user(s)
- Document names are being hidden, specifically using the
HideDocumentNames=on
flag in the print-provider.conf file as documented on the Hide Document Names KB.
Then users may see jobs get 'stuck' in the target queue (the release queue) when trying to release their print job from a find-me / virtual queue. In the target print queue the job will show as 'paused'.
Case 2: If all of the following are true:
- Using PaperCut version 21.1.2
- Account selection is NOT enabled for the user(s)
- Document names are being hidden, specifically using the
HideDocumentNames=on
flag in the print-provider.conf file as documented on the Hide Document Names KB.
Then users will not see any impact to releasing their jobs, however jobs redirected from a find-me queue / virtual queue to the target queue will be incorrectly double-charged and incorrectly show two entries in the job log.
Workarounds:
- Downgrade PaperCut to version 21.1.1
- Where possible (if your requirements and environment allow), switch over to using the Windows Server method to hide document names as detailed on the Hide Document Names KB.
We have withdrawn version 21.1.2 while this issue is worked on, and we hope to have a 21.1.3 release in early November which will resolve this issue.
There are lots of sources of information on the internet surrounding Microsoft's latest changes, including Windows 10 KB5006670 update breaks network printing. Microsoft have also issued a Known Issue, however in our testing the impact appears to be a lot wider than only IPP printing.
Workarounds:
We have not been able to find any documentation or tips from other customers on an 'easy workaround' for this latest security update. Uninstalling the patch is obviously one non-recommended temporary solution here - but others include:
- Use an alternative method of network printing, e.g. using an LPD service and printing over LPR instead of using SMB. Find out more about that on our Using LPD with PaperCut article.
- Use PaperCut's Mobility Print solution to print from any device types, to shared Windows queues.
- Uninstall the October Windows Security updates.
Apologies that we don't have more information on this latest MS security update at this point, but we will post any more information as soon as we have it.
Update (22nd October):
We are working with Microsoft through a case on their Partner Portal on this issue and hoping for more news shortly.
(Please note that the workarounds above still apply in the meantime while we wait to hear any updates from Microsoft - at the moment we are relying on MS to resolve the issues with OS-level client > server printing. Our current recommendations for workarounds include using Mobility Print to bypass the issues introduced with these latest Microsoft security fixes).
Update (27th October):
Guidance from Microsoft to (specifically) help any customers seeing the 0x709 printer connection error, includes the requirement to open TCP/IP Ports needed by RPC, Remote Procedure Call. See Microsoft's article here.
Update (11 November):
We have reports that the specific TCP/IP Port for RPC which needs to be open is 135. Blocking port 135 results in error 0x6e4 when adding a connection to a shared printer.
Final update (22 November):
Microsoft has released optional update KB5007253 to resolve this issue.
Addresses a known issue that causes error codes 0x000006e4, 0x0000007c, or 0x00000709 when connecting to a remote printer that is shared on a Windows print server.
Further details can be found at
support.microsoft.com
#printnightmare
There is no longer an indication that libappindicator support will be removed from Debian based Linux distributions. Original issue:
The Debian 11 Linux distribution has deprecated libappindicator packages which includes libappindicator3-1, a package required for the Print Deploy Client to interact with users.
PaperCut will migrate to another library as soon as possible.
Customers have reported success in installing the .deb packages manually. Please consult with your IT support whether this is an appropriate action for your environment.
Please note that this has been resolved with version 21.2.5.
On the Toshiba V2 platform, the device performs a PIN comparison and it cannot do a comparison on an already encrypted string. Toshiba V3+ devices are unaffected.
Workaround:
Please contact the PaperCut Support Team prior to any upgrade to v20.1.0 to receive a hotfix build and upgrade instructions to help circumvent this issue if you use PIN authentication or still have Toshiba V2 devices actively in your environment. We would recommend to take a back-up of your MF database and PIN codes prior to your upgrade.
Please note that this has now been resolved in PaperCut NG and MF version 21.2.6.
Note that you will need to set the config key "user.card.pin.hash-encode" to "N" if you are using the PaperCut Toshiba V2 and use PINs for login, to prevent user PINs from being hash encoded.
Workaround
Within the same browser session, login to both the administrator portal and the web cashier portal and the username search functionality will work. (Workaround is only applicable if the web cashier user has PaperCut administrator privileges).
Please note that this has been resolved with version 21.2.5.
Windows Server 2019
Windows server 2016 (TBC)
We have discovered the September 14th 2021 Microsoft Windows Security Update
KB5005568
can break cross-server redirection in Windows Server 2019 and Windows Server 2012. This issue can affect the redirection of print jobs from one server to another. This issue can be identified by searching for entries within the Print Provider log(s) referencing
Error: 283
& Error: 317
The Print Provider logs are found within:
[app-path]\providers\print\[platform]\print-provider.log*
Sample log entries
ERROR: PrinterRedirect.cpp:311 - Failed to redirect job to printer (StartDocPrinter). JobId: 99, Datatype: RAW, Printer: \\ExampleServer-01\Printer01 - Error: 283 [****]
2021-09-17 12:00:00,633 ERROR: PrinterRedirect.cpp:515 - Failed to redirect job to printer \\ExampleServer-01\Printer01 - The system cannot find message text for message number 0x (Error: 317) [*****]
PaperCut is working with Microsoft to try and find a workaround for this ongoing issue.
We have had reports of customers resolving this issue by:
- Uninstalling the KB5005568 patch from the server (not recommended).
Further workaround:
An additional temporary workaround is listed below, which allows customers to install the security fix. As detailed on the Microsoft KB, one temporary alternative to get printing working again is (on the Windows Print Server) to:
- Add a new registry key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\RpcAuthnLevelPrivacyEnabled (type DWORD)
- Set the new key value to 0.
- Restart the Print Spooler service.
#printnightmare
We believe this is due to a protocol change which has been in Windows 10 since January but the recent updates now require that both client and server be able to use this new communication protocol method and error 0x0000011b is the result when there is a mismatch.
We have had reports of customers resolving this (and have tested ourselves with success) by:
- Uninstalling the patch from the server (not recommended).
- Ensuring that the patches are applied to the Server and the clients.
Other alternatives include using PaperCut's Mobility Print solution.
Further workaround:
An additional temporary workaround is listed below, which allows customers to install the security fix. As detailed on the Microsoft KB, one temporary alternative to get printing working again is (on the Windows Print Server) to:
- Add a new registry key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\RpcAuthnLevelPrivacyEnabled (type DWORD)
- Set the new key value to 0.
- Restart the Print Spooler service.
Note: these updates have also all been rolled up into the 'December' updates from Microsoft - so if you had previously not installed updates, and have now installed the December updates, you may see issues as a result of this.
Our most recent recommendations are:
- Use an alternative method of network printing, e.g. using an LPD service and printing over LPR instead of using SMB. Find out more about that on our Using LPD with PaperCut article.
- Use PaperCut's Mobility Print solution to print to shared Windows queues from any device types.
#printnightmare
It's useful to note for troubleshooting purposes that this will be an issue whether environments are using PaperCut or not.
In our testing (and as found by a handful of customers so far) we have found that if a Windows print queue is shared over the network, and macOS devices are printing via SMB connections, printing will break after installing the September security patches on the server.
Workarounds: The only workarounds that we are aware of currently are:
- Use an alternative method of network printing, e.g. using an LPD service and printing over LPR instead of using SMB. Find out more about that on our Using LPD with PaperCut article.
- Use PaperCut's Mobility Print solution to print to shared Windows queues from any device types.
The updates associated with this include: KB5005568 (Windows Server 2019), KB5005613 (Windows Server 2012 R2), KB5005627 (Windows Server 2012 R2), KB5005623 (Windows Server 2012), KB5005607 (Windows Server 2012), KB5005606 (Windows Server 2008), KB5005618 (Windows Server 2008), KB5005565 (Windows 10 2004, 20H2, and 21H1), KB5005566 (Windows 10 1909), KB5005615 (Windows 7 Windows Server 2008 R2)
Update Feb 2022
We have seen rumors that Apple have fixed this with the latest Monterey versions (detailed here - specifically "Resolves an issue that prevented authenticating to a Windows print server with increased RPC authentication level"). However our testing internally has shown that this doesn't have any impact, and as far as we can tell, printing between macOS and Windows over SMB is still broken. We have also tested using a suggestion being floated on discussion boards on the internet, which suggest adding ?encryption=no
to the connection string e.g. smb://printserver/print_queue?encryption=no will work. We have found that this does not resolve the issue either in our own testing.
We have also seen customers who have been successfully printing from macOS to Windows over SMB (despite having installed the security patches from last year) who are now suddently experiencing issues with the latest macOS Monterey releases.
Our recommendations remain at this point, to:
- Use an alternative method of network printing, e.g. using an LPD service and printing over LPR instead of using SMB. Find out more about that on our Using LPD with PaperCut article.
- Use PaperCut's Mobility Print solution to print to shared Windows queues from any device types.
Update October 2023
With macOS Sonoma now released (macOS 14), we are seeing further issues when printing macOS > Windows over SMB which can result in printers going into a Waiting state indefinitely. You might initially see them go into a Hold for Authentication state - if you click refresh and supply valid credentials, you will end up in the Waiting state. This is again something that happens with or without PaperCut involvement in the mix. There is a reddit thread where others have noticed this same behavior too.
Our recommendations remain at this point, to:
- Use an alternative method of network printing, e.g. using an LPD service and printing over LPR instead of using SMB. Find out more about that on our Using LPD with PaperCut article.
- Use PaperCut's Mobility Print solution to print to shared Windows queues from any device types.
Update March 2024
Early reports suggest Apple has fixed this behaviour in macOS Sonoma 14.4, and that printing via SMB from a macOS device to a Windows hosted print queue should now work.
#printnightmare
This has now been resolved in the 21.2.1 release.
The button is missing due to a bug in the processing of the EWB (Embedded Web Browser) version which has changed from a 3 component version number to a 4 component version number. This check was done in order to hide the button on older versions of the EWB which doesn't support this feature.
Workaround:
A workaround for this issue is to set an Advanced Device Configuration variable of ext-device.toshiba.show-job-status-button to the value of "ALWAYS" which will cause it to bypass the EWB version number check.
Workaround
In troubleshooting these issues with Toshiba, we've discovered that this is related to DNS lookups done when unlocking the device.
The workaround is to head into Top Access > SMTP Authentication, and either switch the authentication to 'Plain' instead of 'Auto' - or switch it off entirely if not required.
The PaperCut Print Deploy Cloner does not correctly copy defaults and capabilities of PaperCut Mobility Print queues when cloning.
Capabilities and Defaults are settings like monochrome vs colour/color, duplex vs simple and device configurations such as stapling, multiple input trays.
Expand for recommendations.
Do you trust this printer?
when trying to install a printer (either through non PaperCut-related methods, or through e.g. PaperCut Print Deploy).
When the user selects 'Install driver', any non-admin user will then be presented with a error message Connect to printer - Windows cannot connect to the printer
. This is due to the update documented on Microsoft's article - KB5005652 - Manage new Point and Print default driver installation behavior.
Workaround
We recommend using the workaround listed under the "Modify the default driver installation behavior using a registry key" section of this Microsoft article (set registry key RestrictDriverInstallationToAdministrators to 0) to allow non-admins to install printers as before.
However, with that advice, we also highly recommend Microsoft’s additional protections:
- Configure clients to only trust specific print servers and packages, as per the "Permit users to only connect to specific print servers that you trust" and "Permit users to only connect to specific Package Point and Print servers that you trust" sections of the Microsoft KB article.
- For any machines that are not sharing out printers, disable the Computer Configuration item "Allow Print Spooler to accept client connections" as detailed through controlling printing through Group Policy.
Note: If you’d prefer to get away from Windows > Windows printing connections entirely, an alternative here is to use OPTION 2 - Enable Point and Print without admin rights in our PrintNightmare guide.
#printnightmare
This is impacting 21.0.3 or later.
Altalink devices do not appear to be affected. Print release and other functions work successfully, however scanning and copying may fail.
Workarounds:
- Disabling scan and copy tracking has also reported to resolve the issue, however this comes with obvious consequences.
- Partners have also confirmed that setting the advanced key ext-device.xerox.enable-preauth to N will also resolve the issue - however again that will have consequences on zero-stop and potentially allow users to run into negative balance.
- Rolling back to 21.0.2 or earlier will also resolve the issue.
We now have a hot fix available for this - please contact us with your CRN and quote PO-448 as well as any additional details that you would normally include.
Important note:
This has now been released publicly in version 21.2.1 (and is also included in 21.2.3 and 21.2.4).
However, we have spotted one case where this may not be resolved - we are looking to make additional fixes (for e.g. the VersaLink B405) under PO-707.
Any previously created Scan to Fax actions will continue to work without any issues, and the Fax Server Settings will be retained. It is only new Scan to Fax actions that cannot be created.
We are aiming to resolve this in the next public release, and we do have a hot fix / manual workaround in the meantime if required. Please contact us and quote PC-18553. Thanks!
Sign-in failed: The device is not available to use. Please try again in a few minutes
.
We have been unable to recreate this with any of the devices in our lab, however there may be a pattern that the impacted devices are of a lower spec.
Please note that this has now been resolved in 21.1.2
Please note that our verification status as a developer with Google has not changed, however following the app rename, the old app will now show as unverified. We are working with Google to see if they can re-verify the 'old' app, which would remove the security checkup flag.
Importantly, please note that scans to Google Drive for those users who verified the app prior to 9th July will not be impacted - scans will continue to be delivered without any issues.
Users who have verified the Scans for PaperCut app since the 9th July will also not be impacted by this, and additionally will not see any Security Checkup flags.
Workaround: Users who wish to resolve the security checkup flag can safely use the 'revoke access' button next to the app in the Security Checkup section to remove the app from the list. The next time the user performs a Scan to Google Drive action, they will receive the 'Authorization' email which they will need to perform once to give the new app access to their Google Drive (as they did when they performed their first scan to Google Drive). By authorizing the 'new' version of the app, this will then appear in the list as a verified app, and will not be flagged for action. This is not a requirement however - any users still using the old version of the app will not be impacted at all.
An ERROR occurred testing settings:Write operations are not allowed in read-only mode (FlushMode.MANUAL): Turn your Session into FlushMode.COMMIT/AUTO or remove 'readOnly' marker from transaction definition.
This only happens when clicking the "Test Settings" button, and not during an actual sync.
It is HIGHLY RECOMMENDED that you restart the PaperCut Application Server service after receiving this error and do not then perform a test sync. In our testing we have found that the test sync is still attempting to complete in the background, taking up more resources, and could eventually bring down the Application Server due to lack of resources.
Please note that the 'real' sync (and scheduled syncs) will still work as intended.
Update: This has now been resolved in the 21.0.4 release.
Please note: This has now been resolved in version 21.1.1
This does not affect direct printing, or printing via a virtual printer with a model specific (or Universal OEM) driver. It can be a challenge to use a model specific (or Universal OEM) driver in mixed fleets though, due to driver compatibility between manufacturers.
The recognized workarounds for this are:
- Tick "Print in grayscale" option within Adobe DC
- Use a model specific (or Universal OEM) driver on the virtual printer - if there is a mixed fleet of printer manufacturers, it might also be necessary to use a PDL Transform to ensure that this solution works successfully.
Update Wednesday June 16th (AEST): Some customers have reported that restarting the Windows Print Spooler (and PaperCut Direct Print Monitor) on affected client machines has resolved this issue.
A root cause has yet to be found but if you're of the belief that you're having a similar issue you can try running through the following steps and submit a ticket to the Support Team. If you can record these troubleshooting steps with a screen recorder, it would be highly advantageous to us.
We need to know if the following troubleshooting steps work whilst the Print Deploy Client (Windows) is failing at the same time and from the same client.
- Click Start -> Run
- Type in in the server name, e.g.
\\printserver.company.lan\
in the exact format of the printer you're trying to install (save a screenshot of what is input in before clicking OK.) - If the previous step succeeds, double click the desired printer. (Save a screenshot of the printer having opened.)
- If the previous step succeeds, we need a copy of the
usercontextservice.log
andpc-print-deploy-client.log
files showing from that machine and a screenshot showing that the above three steps worked.
Two alternative troubleshooting commands:
- PowerShell:
Add-Printer -ConnectionName \\printServer\printerName
- cmd.exe:
rundll32 printui.dll,PrintUIEntry /in /n \\printServer\printerName
Workaround:
Ensure that you're running Print Deploy version 1.5.1805 (or above) and then:
- Add the line
Features=["powershell"]
to theclient.conf.toml
file on the Print Deploy server.-
For locations on PaperCut 23 and greater, this setting must be above the [PollingConfig] section of client.conf.toml.
- Restart the Print Deploy Server service.
Please note that this has now been resolved in Print Deploy version 1.5.1876.
In the app server debug logs, you will see a message similar to:
ERROR PrintJobAuthorizationController - Request rate '10/s'exceeded from: 127.0.0.1
Error displayed in the PaperCut Admin console is:
class java.time.LocalDateTime cannot be cast to class java.lang.String (java.time.LocalDateTime and java.lang.String are in module java.base of loader 'bootstrap')
This is believed to be the issue called out on the MySQL bug listing here: https://bugs.mysql.com/bug.php?id=102435
We are currently investigating, and working on getting a patch available to resolve this issue.
Workaround: for now, please roll back to MySQL versions 8.0.22 or below.
Update: This has now been resolved in the 21.0.4 release.
Print Deploy Client 1187
If a PaperCut Print Deploy server's Client Authentication method is set to AUTO or TRUST then PaperCut Mobility Print queues will fail to operate properly.
Depending on your client operating system, the behaviour exhibits differently:
- Microsoft Windows: the print queue fails to install
- macOS: queues install but any attempt to print results in the queue being deleted and re-installed
As a work around, Print Deploy Administrators can change the authentication method to PROMPT
A fix is being made ready.
Due to the presence of a "v" in the version field for the Print Deploy Client .deb package, the installation of the client may fail.
A new Print Deploy Client will be released shortly.
We have found an issue that caused frequent re-integrations of devices on Site Servers, when network connection to the main server is poor.
This has now been resolved in our 21.0.3 release.
If a Print Deploy user logs in via an alias (e.g. "bob" and their real username is "bobcitizen") and a Print Deploy administrator has configured a Zone to have a Group Based filter, user Bob will not meet that filter's requirements.
As a work around, Print Deploy user Bob will need to log in with their non aliased username.
We will update this Known Issue when this is resolved.
Users may notice that PaperCut Mobility Print queues that they elect to install via the Self Service functionality in PaperCut Print Deploy will fail to install.
This is confirmed by noting the following entry in the "pc-print-deploy-client.log"
Below is an example Windows PaperCut Print Deploy client logfile extract.
2021/03/15 18:06:05 pc-print-deploy-client.exe: STDOUT|ERR InstallPrinter: failed to install printer FOLLOW-ME with error: failed to install printer: unknown error: exit status 1. output: pc-printer-updater version 1.0.0.727-2f0cd118b2481cf114198311b563001c8b112b50
2021/03/15 18:06:05 pc-print-deploy-client.exe: STDOUT|please specify connection name for mobility queue
2021/03/15 18:06:05 pc-print-deploy-client.exe: STDOUT|Command installprn failed. Error: Input argument validation failed.
2021/03/15 18:06:05 pc-print-deploy-client.exe: STDOUT| {"src":"pdservice.go:406"}
As a work around, PaperCut Print Deploy administrators may change the printer to be no longer Optional and the printer will then be installed correctly.
The PaperCut Print Deploy team is working on a fix for this.
Note that this has now been resolved in 20.1.3
Installations that make use of the "Sign in with Google" authentication method for PaperCut Print Deploy and deploy PaperCut Mobility Print queues may fail to install.
This impacts installations using PaperCut Mobility Print server version 1.0.3103.
An updated PaperCut Mobility Print server has been released to address this issue.
Affected versions:
Print Deploy Server: 1.5.1598
Mobility Print Server: 1.0.3103
Resolved versions:
Print Deploy Server: 1.5.1598
Mobility Print Server: 1.0.3107
This may cause issues, especially in environments with load balancers or other network components that may mask the originating IP.
Symptoms may include:
- Users apparently unable to log in
- More client session threads needed than with previous versions.
- In extreme cases the server could exhaust the reservoir of threads reserved for client sessions and all client operations will stop functioning.
- This log line should be seen throughout the server.log file when the problem occurs: "ERROR BaseXMLRPCServlet:259 - Error occurred processing XMLRPC request for: client-xmlrpc. System overload: Maximum number of concurrent requests (15960) exceeded"
It is recommended that sites using desktop clients with PaperCut 20.0.2 or later always set client.use-ip-reported-by-client = Y
in order to avoid potential problems.
Reports are mainly coming from Chrome users who have reported other browsers (e.g. Firefox and Edge) working fine, but other browsers may be impacted too.
We're actively investigating.
If you have configured different costs for duplex grayscale pages vs duplex color pages there will be a cost discrepancy for those specific jobs (duplex print jobs with an odd number of pages where the last page is color).
If however you are charging the same for duplex grayscale pages and duplex color pages, costings will be correct.
NOTE: Page counting and cost analysis will not be impacted for any other jobs apart from the specific scenario above.
We have identified that the issue happens because the last page of an odd-numbered duplex job defaults to grayscale.We are currently investigating.
ext-device.hp_oxpd.permission.server-managed=N
. Setting the default sign in method back to 'PaperCut' will work temporarily, but the default sign in method for the device returns to 'Local Device' later. Devices which are managed by the server, using ext-device.hp_oxpd.permission.server-managed=Y
do not appear to be impacted by this issue.
Workaround:
We are working with HP on determining changes in the 4.11 firmware which may be causing this - in the meantime we recommend downgrading devices to 4.10 firmware or earlier.
Update:
This has now been resolved in the 20.1.3 release.
408ci series devices are the only models affected by this issue. The PaperCut application nor the Kyocera embedded application versions relevant as the issue can be reproduced on multiple versions.
The workaround is to update the Eval firmware of your Kyocera 408ci series devices to v.01.02.0012 (2020-12-15)
Specifically, this can occur when the Base DN, or your Google Cloud Identity domain name, does not match the User DN.
For example, for a Base DN of school.com, if a user has a User DN of the form student.school.com, PaperCut will no longer sync this user.
Similarly, for a Google Cloud Identity domain name of school.com, if a user is of the form student1@student.school.com, PaperCut will no longer sync this user.
If you believe you're encountering this issue, please contact PaperCut support and quote PC-17753, as a hot-fix build is available.
- Application Server - will not run on macOS 11 (fixed in 20.1.1)
- Site Server - will not run on macOS 11 (fixed in 20.1.1)
- Print provider/secondary server - will pause all queues on macOS 11 (workaround available, and fixed in 20.1.1)
- User client software - works ok (when the app is copied from e.g. a Windows, macOS 10.x or Linux server to a laptop or PC running macOS 11).
There are two further issues found on macOS 11 while running the 20.1.1 build that we hope to resolve with a 20.1.2 release:
- Web print (when using the Application Server as the Web Print Server) will not work with macOS 11.
- User authentication to the admin or user web pages will not work for a local system user (using PAM). The local 'admin' account and any other directory sources will work ok.
For more detailed information see Known issues with macOS 11 (Big Sur)
Note: These issues have been resolved with the 20.1.1 release.
ERROR LocalPageServlet - java.lang.StackOverflowError at java.util.Collections$UnmodifiableMap$UnmodifiableEntrySet$1.next(Collections.java)
There is currently a hot fix available for this issue, and we are hoping to have this resolved in the public 20.1.3 release.
Please note that this was successfully resolved in 20.1.3.
This is caused by printer drivers having files and data in non-standard locations, or by using hard-coded locations for files.
Work is underway to support these environments.
2020/10/27 16:13:24 pc-print-deploy-client.exe: STDOUT|CreateFile C:\Windows\TEMP\pd-driver-extracted[number]\pcglobal.inf: The system cannot find the file specified.
Please contact support and reference PD-882 for a work around.
A solution is forthcoming in the next embedded release.
The issue was introduced with the Integrated Scanning enhancement. If Integrated Scanning is not required, recommend downgrading to embedded version 2.10.0.
Copy jobs don’t stop after balance reaches $0. Balance goes into negative.
It has also been reported that Shared Accounts may not be charged correctly on some models (C7070 / C6570 / C5570 / C4570 / C3570 / C3070), but this has not yet been confirmed.
Affected models:
ApeosPort C7070 / C6570 / C5570 / C4570 / C3570 / C3070
ApeosPort 5570/4570
Update 13th October: We are working with Fuji Xerox to resolve these compatibility issues with the new devices.
Update 17th August 2023: this has been resolved in firmware versions 1.60.14 and later.
PE Release 72.204 / 72.216
When scanning from the glass, the incorrect rotation does not happen.
Fix is available - Please contact us if you need the updated Lexmark Embedded application.
Please request
papercut-les21-3.1.0.fls
and reference this known issue PC-17509
in your email.
Note that this will be resolved in the upcoming public release of 20.1.0, and LeSF App papercut-les21-3.1.0.fls
£$*&^%
special character, the error Cannot use this Character
is displayed within the password input text field on the Canon Gen3+ device screen.20.0.3
When users attempt to self-associate cards and their password contains a
£$*&^%
special character, the error Cannot use this Character
is displayed within the password input text field on the Canon Gen3+ device screen. This error stops the user from self-associating their card.
Note: This has now been resolved in a firmware update. Firmware Platform Version must include 3.13 or later.
Reports have included the inability to embed the device with PaperCut (installation appears to happen successfully, but the apps aren't installed), or the inability to scan with PaperCut.
Note that at this time this only appears to be impacting the new Altalink 81* series devices (e.g. B81* or C81* devices).
If you've come across other symptoms or if you've tried the below workarounds and it has / hasn't worked, either way, we'd love to hear from you - please send us a request, and mention PC-17688. Thank you!
Update 28-Sept: We are actively investigating these and working with Xerox for more information.
Update 2-Oct: So far we have had reports of B8145, B8170, C8155 all with issues embedding (the icons do not show up on the device) and C8155 (different customer reporting that embedding worked ok but integrated scanning did not work).
Update 6-Oct: Further investigations are ongoing with Xerox. They have suggested one additional workaround (for the icons-not-displaying issue) which we are exploring with them tomorrow (7th October): Enable all EIP Web Services options on the device web UI (Properties tab > General Setup > Extensible Service Setup > Extensible Service Registration > [Edit] > [Enable All] > [Save]).
Update 7-Oct: Successfully tested a B8145 and C8155 at the Xerox Lab.
Update 15-Oct: We are continuing investigations into reported issues with the 81* series devices, working with Xerox directly as well as with resellers. We have found that a large number of resellers are embedding these devices successfully (stepping through the Xerox manual exactly as written), without doing anything special - so our investigation is also looking at environmental and other variables involved in the installation process that could be causing issues for a small subset of environments.
Update 11-Nov: Checklist:
Most cases investigated so far have been resolved by:
- Making sure you're using PaperCut MF v 20.0.4 or later (which fixes an issue with scanning detailed in PC-17617).
- Make sure that the device time, and device timezone is set to the same time as the App Server time and timezone.
- Check that you're using the latest firmware (we've had reports of 111.009.000.27020 or later resolving issues).
Additional items to double check are:
- Check the Device Status in the PaperCut Device Settings page - If it there is an error message referencing “IP Lockout”, or a message referencing authentication failure, then:
- Make sure that the time and the timezone on the device matches the time and the timezone on the app server (and site server)
- Make sure that the device admin credentials have been entered into PaperCut correctly.
- If the message referenced “IP Lockout” then the device is currently blocking requests from PaperCut due to a prior authentication failure. You can try to clear the lockout - On the device, go to Apps -> Printing -> Printing Web Services -> Web Services IP lockout -> "Clear Lockout Button" - and try again, however there are reports that this does not always work, in which case you will need to wait for the lockout to expire, which it should do within 60 minutes.
- Check the Device Status in the PaperCut Device Settings page - If there’s an error message referring to ‘verify that Xerox Network Accounting is installed and enabled’ then manually enable this through the device admin.
- Reboot the device - it is possible that some configuration changes made during the registration process require a reboot before the change is actually complete. PaperCut should attempt to continue the registration following the reboot.
For customers specifically seeing ‘scanning failed’ issues with Integrated scanning. There are three things to check that we’ve seen so far:
- Enable all EIP Web Services options on the device web UI (Properties tab > General Setup > Extensible Service Setup > Extensible Service Registration > [Edit] > [Enable All] > [Save])
- On one customer device, “Allow Open Access to Job Information” on the device was Disabled, and it should be Enabled for scanning.
- There’s a ‘known scanning issue’ under PC-17617 - if you see a ‘scan failed’ message when using integrated scanning with PaperCut 20.0.3, this could be due to the Known Issue (fixed in 20.0.4 or workaround by enabling debug).
Update 26 May: Final update.
Successfully completed the Xerox self-validation process with PaperCut MF on 81* series devices. If you're experiencing issues similar to this, please confirm that you've checked all the items in the 'Checklist' section above.
We are investigating some scenarios where HP devices may be unable to contact the PaperCut server when the device is configured only to use DHE (Diffie Hellman) ciphers.
The message seen in this case will be related to SSLException: Could not generate DH keypair
and subsequently DH key size must be multiple of 64, and can only range from 512 to 8192 (inclusive)
Note that when the device is configured to use alternative ciphers this issue does not exist, and SSL comms with the PaperCut server work without issues.
Update 30th October: There is now a hot fix available which can workaround this issue (by using a different crypto provider within PaperCut if necessary). Please contact us to get hold of the hot fix!
Update 23rd December: The 20.1.2 release now includes a fix for this (by using a different crypto provider within PaperCut if necessary). Please contact us and refer to PC-17674 for more instructions about enabling the new crypto provider.
Aug 2020
You receive an error 'The parameter is incorrect'.
Note that this does not effect an existing local nul port configured prior to the Windows Update.
We are working with Microsoft to investigate. This looks to be related to KB4571703 (2012 R2), KB 4578013 (Win 8.1), KB4570334 (Win 10).
Workaround: Use the add-printerport PowerShell command to add the port to an updated system:
add-printerport -Name nul
Update 7th October 2020: In 20.0.4, PaperCut now auto-creates the nul port as part of the installation - saving customers from having to use the PowerShell workaround above.
Note that Microsoft also resolved this in a subsequent Windows patch in August.
Workaround: enable application server debug logging (Options -> Advanced -> Diagnostics -> Enable Debug Mode).
We hope to have this fixed in our upcoming 20.0.4 release.
Update: This has now been fixed in our publicly available 20.0.4 release.
1. Log out of the current OS session and log back in.
2. Restart the computer.
ClosedChannelException
error appear when using Integrated Scanning with Konica Minolta devices in certain circumstances.When performing scans using Integrated Scanning on a Konica Minolta device, we have had reports of a small number of customers seeing a ClosedChannelException
error appear.
We're actively investigating this and hope to have a hot fix available shortly.
Update: 7th August - we now have a hot fix available for anyone coming across this issue.
Update: 7th October - this has now been resolved in our 20.0.4 release.
We have found an issue in on-premise Document Processing that could, in some rare circumstances, lead to two users both being sent the scanned document belonging to one of them. It is very unlikely to happen, but it is possible.
This issue will be fixed in an update to on-premise Document Processing that will be released early the week beginning August 3rd 2020.
The problem cannot occur with our cloud-hosted Document Processing engine.
In the meantime, there are two different workarounds available for customers concerned about this issue:
- Switch the document processing to the PaperCut cloud hosted servers, or
- Reconfigure the on-premise Document Processing servers to only allow a single job to be processed at a time (the default setting for maximum concurrent jobs is 2).
Please note: This issue has now been resolved in Document Processing server V 1.1.9
There was an error in the script on this page
Error: Intl is not available.
Do you want scripts to continue running on this page?
KB4489881 can be removed if appropriate for your environment. Note: An update to Print Deploy will be published soon that fixes this issue.
If a PC MF upgrade is not feasible, this can be worked around by the following steps:
- Put the KM device on the older GG7-45 firmware.
- Enable the PC MF embedded app integration.
- Re-configure the SSL certificate.
- Enable the PC MF embedded app integration again.
- Set the following config key:
ext-device.konica-minolta.skipsetup=Y
The error looks like:
Failed to process print job: Could not obtain the lock for modifying account 'username' within 45 secs
.click for more information...
Failed to process print job: Could not obtain the lock for modifying account 'username' within 45 secs
messages in the logs.
Detail of the Investigation:
We have found that if an environment is using the PaperCut User Client, and an admin then leaves the Admin Console open on the 'Dashboard' tab for 3 mins or more, and the client connections happen in a certain order, then a database lock can occur.
Workaround:
If you have installed 20.0 and are experiencing this issue, you will have to restart the Application Server to clear the lock. Once you have done this, make sure that the admins know not to let the Dashboard page timeout (3 mins by default) - or temporarily revoke access under Options -> Admin Rights -> then revoke the 'Access Dashboard' right.
This should stop the lock from happening.
Update 29 June 09:00 AEST:
Current investigations are centered around a potential lock which can be triggered by admins staying on the 'Dashboard' page of the Admin Interface and letting it time out (along with other requirements too). If a customer is running the PaperCut user client (for popups like shared account selection or print notifications) and sits on the Dashboard in the admin interface, and the client connections happen in a certain order, this can trigger this issue.
Once this issue is triggered, the remedy is to restart the Application Server.
Update 29 June 14:00 AEST:
We now have a hot fix available which should resolve this issue. We are also hoping to get this fix into a publicly available 20.0.2 release shortly. Please contact us if you need this hot fix - please also include 'request for hot fix PC-17485' in your email, along with your CRN and other details/debug logs/messages showing the symptoms your seeing.
Update 1 July 14:00 AEST:
We are now working on getting this fix included in a publicly available 20.0.2 release - hopefully available next week.
Update 7 July 14:00 AEST:
This issue has now been resolved in the publicly available release of 20.0.2.
You should be able to create a deployed device and a staged device with the same Hostname/IP. However, this is not possible for Kyocera at the moment.
You can create a staged Kyocera device if there is already a deployed device with the same hostname/IP in the PaperCut MF server.
You can not create them in reverse order though. So if there is a staged Kyocera, you can not create a deployed device for the same hostname/IP using the create multiple devices feature.
The workaround is to deploy the embedded software software using the manual installation method. (Contact your authorized partner for assistance). The same way they were created before this feature existed.
You should be able to create a deployed device and a staged device with the same Hostname/IP. However, this is not possible for Sharp at the moment.
You can create a staged Sharp device if there is already a deployed device with the same hostname/IP in the PaperCut MF server.
You can not create them in reverse order though. So if there is a staged Sharp, you can not create a deployed device for the same hostname/IP using the create multiple devices feature.
The work around is to create the deployed device the old fashioned way. The same way they were created before this feature existed.
An error caused by two groups with the same name synced. PaperCut expects group names to be unique but in the derby database the unique key can have sensitive values. This can happen when there are multiple sync sources with the same group names in both. For Example: one sync source is on prem active directory and the secondary source is Gsuite each contain the same group name, this will cause a conflict.
HTML Error Shown:
Unable to invoke method formSubmit on
web.pages.GroupAddRemove$Enhance_59@7316309[GroupAddRemove]: Expected
only one result, but got 2 List:
Workaround:
Only add the one group from the one source needed or rename the group until the bug is resolved.
This has been resolved in OPS for PaperCut v 2.1.11.
Note that this has now been resolved with the 20.0.3 release.
Please note that this has been fixed as of version 19.2.0 of PaperCut MF.
To work around this issue, either downgrade the firmware to versions prior to 2019.09.24 or please make sure WSD and Enhanced WSD scanning are both turned on, also that TLS1.2 is enabled.
Currently no workaround is available however a has been released with embedded version 3.0.3 (19.2.3)
Please note that this has now been resolved in version 19.2.4.
SmartSDK
Upgrading to MF v19.2.3 and upgrading the Ricoh SmartSDK to V2.4.4 resolves the issue. If you are not in a position to upgrade, we do have a workaround; please log a ticket over here referencing the known issues to receive a hotfix embedded build.
At this point the permissions can be set to whatever you require.
We have noticed though that the permissions on this folder are reset again every time the installer is run (E.g. during an upgrade), and this can potentially leave the web-print-hot-folder exposed on the network - so we are investigating not resetting these permissions during an upgrade.
You can workaround this issue in the meantime by manually adjusting the security permissions on this folder after an upgrade is performed.
This looks to be related to the method used to report the time-stamp of the email by the email server. So far this has been reported on Exchange and Office 365.
Note that this has now been resolved in 19.2.3
auto
, however you may have changed this to trust
or prompt
.Updating the config key followed by restarting the Print Deploy service will fix this issue. More info can be found here.
Updating Print Deploy on macOS also resets values within the pc-print-deploy.conf file back to default values. You may have changed this content to configure Print Deploy auto updates.
This issue affects all current Print Deploy users.
- User sends a print job to a hold/release queue.
- Print Administrator makes a change to the print queues on that print server, e.g. removing a print queue, adding a print queue or renaming a print queue - or the ~4am Print Provider daily maintenance refresh happens. (Note that making property changes like driver defaults is not included in this list - only major changes like add printer / remove printer / rename printer).
- User then releases the job.
Note: if there are no changes being made by the print server administrator, and if jobs aren’t happening around the 4am maintenance window, then this issue will not be seen. If the scenario above was experienced, the behavior seen would be:
*The user walks up to a release station and releases the job. It would look as though the job didn’t successfully release to the printer, and the job would not actually print.
*If the user then went back to the release station and released the job again (it could be displayed again), the job would successfully release, but the user would then be charged twice for the job.
*The likelihood of this happening is even less if a find-me queue is in use, and the job is redirected to a different target queue on release.
This has now been resolved in 19.2.1.
This error is difficult to reproduce and only happens in unreliable network environments where connections are terminated improperly.
This issues has been resolved in PaperCut NG/MF 19.2 GA and Print Deploy version 1.1.904, otherwise Restarting the PaperCut Application Server will resolve this issue temporarily.
Example partial error message:
HTTP ERROR 500
Problem accessing /print-deploy/admin/. Reason:
Server Error
Caused by:
java.net.SocketTimeoutException: timeout
Print Provider “printsrv01|192.0.0.1”: Print job “Document-1.pdf” printed by “user1” is offline and has been temporarily hidden from the Print Release screen.
Through our analysis we have determined that the Print Provider may stop when documents are printed using Windows 10 store apps to a shared print queue on a Windows Print Server with Print Archiving enabled on the same print queue. Workarounds to this include disabling Print Archiving on the relevant print queues, correcting the use of XPS2GDI print jobs to the PaperCut Print Server or have Windows 10 devices print through Mobility Print.
This issue seems to only affect PaperCut 19.1.5.
Please note that this has now been fixed in 19.2.1.
One workaround is to clear it by either:
- Reapply your license file to your server (on the About page in the Admin Interface), or
- Restart the PaperCut Application Server service on your server
Please note that this has now been resolved in 19.2.4.
The issue does not appear to effect other applications - for example, printing from Adobe Reader does not present this problem.
Please note that this has now been resolved in version 21.1.2.
spar:
101.002.009. 00300
1333899v2
(April 5, 2019)
This issue has been seen on firmware 101.002.009.00300 but apparently worked fine on previous 100 firmware. Xerox Support have reproduced the issue and have released a new patch for Altalink, Software Patch 1333899v2, on April 5, 2019.
This is more likely to affect customers running PaperCut MF 19.0.5 and newer.
It’s possible to prevent this from happening by deploying a different PaperCut client by following the links below. Install the User Client on Windows
Alternately you may be able to resolve the issue by manually replacing the following files inside the Client installation directory.
Steps:
- Download the latest Microsoft Visual C++ Redistributable
- On the affected client computer, browse to the PaperCut MF Client folder
- Replace msvcp140.dll and vcruntime140.dll with those downloaded from the Microsoft Visual C++ Redistributable
- Run the Client
- Please note that this has now been resolved in the 19.2.1 release.
Due to libraries updated with the 19.1 release, customers at those locations are reporting that the uploads to the cloud are now more reliable.
This has now been resolved in 19.1.1 (but 19.1.2 is highly recommended).
investigating
Workarounds are available in
If you are using the PaperCut LPD Service you can workaround this issue by:
- Make sure that you’re using the latest LPD Service version, by running the installer in
[app-path]\providers\lpd\win\pc-lpd-installer.exe
- Edit the LPD Service config file:
[app-path]\PaperCut LPD Service\pc-lpd.config
- Add the line
RemoveHostAddress = true
(and save the config file) - Restart the LPD Service
If you’re using the Microsoft LPD Service - or if you still want the IP address to show in the username at the OS level for other reasons (other integrations or workflows), there is also an alternative workaround:
- Log into the PaperCut admin interface
- Go to the Options tab
- Go to the Config Editor (Advanced) action
- Search for the
system.normalize-network-username-regex
config key - Enter a value of
^([^\s]+)
and then click ‘update’
This will mean that the username in the print queue is untouched - however when PaperCut receives the job for tracking, it strips out the IP address at the App Server level.
Update: Please note that this has now been resolved in the 19.1.2 release.
However since 19.0, that customization now impacts the input field text - for example if you’re running 19.0.1 and you have customized the release station to use grey text, you’ll find that the input box (e.g. username and password) text will also be grey.
Update: This has now been fixed in the 19.1.3 release. Init.
update
19.1.1
Make sure your vend-money-url setting ends with
/transactions/onecard/vendmoney/process
and balance-inquiry-url setting ends with /transactions/onecard/inquiry/process
. For example:
touchnet-onecard.vend-money-url=https://www.test.com/api/transactions/onecard/vendmoney/process
touchnet-onecard.balance-inquiry-url=https://www.test.com/api/transactions/onecard/inquiry/process
Then restart your PaperCut MF/NG server.
Update: this has now been clarified within the config files included with the latest version of the payment gateway.
- No i-Option compatible web browser enabled
- Three user authentication methods enabled (i.e. Username and password, Identity number, and Swipe card)
A fix is planned for inclusion in a shortly forthcoming release of PaperCut MF, but the problem can also be worked around by heading to the Advanced Config subtab of the Device Details page for an afflicted device and updating the value of the following configuration key to
Y
:ext-device.konica-minolta.login.prioritise-card = Y
Update: this has now been resolved in the 19.1.3 update.
track2Data
then you will experience balance and transaction failures on those accounts.Note that this has now been resolved in 19.1.1
This behaviour stems from a difference between the previous SQL database driver (used in V18 and earlier) and the current driver (used in V19 onwards)
We’ve corrected this in an upcoming version of PaperCut, however there is a simple workaround that can be implemented in conjunction with a PaperCut server restart.
To implement the workaround please add the following to the end of your existing SQL connection statement
;socketTimeout=600000
This has now also been resolved in 19.1.1.
Whilst the initial implementation of Device Scripting enables a broad array of possible inputs and actions with which to solve problems and meet unique requirements, the sheer multitude of supported devices and methods through which PaperCut MF integrates with them incurs a small number of limitations. This article provides information around these limitations, and will be updated to reflect any changes concerning them down the line.
The hook deviceLoginHook
does not support guest/anonymous access on some devices
When included in a Device Script, deviceLoginHook will be called at the point a user attempts to login to the applicable device, giving the opportunity to take actions such as denying their login, denying them access to colour copying based on criteria such as custom quotas, or filtering the Shared Accounts they can employ in the current login session. Whilst calling this hook is supported on all devices, testing has shown that the guest access authentication method may not trigger it on certain models. This appears to be due to slight variations in the specific authentication workflow for guest access on these devices, and which families of devices are likely to be impacted is accordingly unpredictable.
A warning concerning this will be displayed when using deviceLoginHook in a Device Script applied to a device that has guest access enabled. To test if this hook is compatible with guest access on your devices, the following snippet could be inserted into a Device Script:
function deviceLoginHook(inputs, actions) {
actions.log.info("Phew, looks like guest access is supported =)");
}
Once this Device Script is applied, walk up to the device and hit the Guest button to login, taking note of the time. Return to the PaperCut MF Admin web interface and check the Application Log subtab of the Logs tab. If you see an entry at the noted time of login which contains the text “Phew, looks like guest access is supported =)”, the device supports the hook in conjunction with guest access. If no matching entry can be found, please reach out to us via the Device Scripting Percolator page with the following details:
- Make and model of the device
- Version of firmware installed
… so that we can keep track of any unsupported models, and potentially determine ways to address this in future. Be sure to remove the Device Script snippet when you’re finished testing, too!
Note that anonymous access, an authentication method closely related to guest access, will similarly not be able to trigger this hook for any unsupported devices.
Whilst the initial implementation of Device Scripting enables a broad array of possible inputs and actions with which to solve problems and meet unique requirements, the sheer multitude of supported devices and methods through which PaperCut MF integrates with them incurs a small number of limitations. This article provides information around these limitations, and will be updated to reflect any changes concerning them down the line.
The hook deviceJobLogHook
is not supported on some device types
Commonly, devices integrated with PaperCut MF will keep track of the copies, scans, and faxes a user performs whilst logged in, and then return this data to the PaperCut MF Application Server once the user logs out. The Application Server then uses the charging configuration applied to a device to calculate how much to deduct from the relevant Shared Account or Personal Account balance, as well as enter job records into the Job Log.
The deviceJobLogHook portion of a Device Script is called during that post-processing of job data by the Application Server, allowing for granular charging adjustments, updates to custom quotas, or the insertion of comments into the Job Log. However, various device types deliver job data to the Application Server in differing ways, with these differentiations dependent on how each platform behaves in tandem with our software integration. The resulting workflow of some device types is incompatible with the present implementation of this hook.
In these cases, an applied Device Script will not trigger the deviceJobLogHook, rendering that section of the script inapplicable for the device types listed below:
- Brother
- Fuji Xerox (Legacy AIP only - ApeosPortV+ devices are supported)
- OKI Open Platform
- Toshiba
If you apply a Device Script containing deviceJobLogHook to a device of one of these types, a warning message will be displayed as above.
Toshiba V3
Evidence of this happening can also be seen in the Application Server Debug logs with the line of: “Forcing logout after scanning for deviceId:”.
A hot fix is available for this (based on 19.0.7) - and we have also now resolved this in 19.1.1
We suspect the new call to the Session API that was added in version 19.0.5 may have triggered an issue with the Xerox firmware just on Versalink. Reports back from the customer seem to confirm this theory.
Xerox has advised us of the relevant issue: CQGbl01318341.
The SPAR release xx.45.61 PL5-Rw for the entire Versalink family was released on June 29, 2019 to address this issue but we have yet to confirm the fix.
For Versalink models without the SPAR fix release, the Session API can be turned off in version 19.1 by setting ext-device.xerox.use-session-api to N.
Turning off the Session API will mean that for scenarios where a user changes multiple accounts in a session and/or uses Job Limits with a job where the user will log out before the job on the MFP has finished being analysed, the job may not be tracked correctly or may not enforce that an account was selected (if that selection option was enabled).
Please note that this has been resolved in 19.1.0
Function Printers
OXP Printer Only
workaround
with Firmware
update pending
from HP.
For other cases unresolved by the 4.7.1 firmware, we are continuing our investigations with HP Engineering.
Update: 19.1.1 is now live, and this version has further workarounds to reduce the likelihood of these errors from occurring. HP are also hoping to release a firmware update in the future to resolve the underlying issues around these errors.
As per the release notes: ‘Added an improved workaround to reduce the chances of 49.DE.xx error codes displaying on HP OXP devices’
Typically, the FQDN specified by the certificate does not match the server name used when establishing the connection between the device and the server.
This is correctable by recreating the SSL certificate with one that includes the correct name.
As a workaround, you can disable SNI host checking by setting the following configuration key in the
server.properties
file on the Application Server, and then restarting the PaperCut Application Server service:server.ssl.sni-host-check-enabled=N
This is only recommended as a stopgap measure until you’re able to recreate your certificate as noted above.
All
This does not impact Hardware Validation / Hardware Page checking.
Update: There is a hot fix available for this if needed. Please contact us if needed!
Update: This has now been resolved in MF version 19.0.6.
client.config.show-balance
to ‘N’ (on the server side) or using the config properties hide-balance=Y
config option, or using the —hide-balance
command line option when starting the client.This has been fixed in 19.0.3.
In some cases with shared workstations (multi-user switching), users may see the error ‘Unable to create the local cache in ‘C:\Cache’.
We’re hoping to resolve this in the next release.
Update: there is now a hot fix available for this - please contact us if you need this!
Update: this has now been resolved in the public 19.0.4 release.
Note that this will not impact the sync behavior on upgrade unless someone uses the UI to update either the ‘primary number’ or ‘secondary number’ source configuration.
This has been resolved in 19.0.3.
For users experiencing this, the behavior of client-local-install.exe will be that installation will work fine, however then when running the User Client, it won’t run at all - no error.
The workaround currently is to either not upgrade using the client-local-install.exe (old versions of the client work perfectly ok with later versions of the App Server), or uninstall the client from the local workstation, prior to using the client-local-install.exe to install the updated client.
This has now been resolved in 19.2.2
This has been fixed in 19.0.3.
A workaround is to head into the config editor, and set
system.scan.cloud.api-url
to https://scan.cloud.papercut.com
.If you’re wondering what Scan to Cloud is - check out Scan to Cloud Storage.
HyPAS embedded
v2.4.2
Workaround this display issue by selecting the refresh icon in the upper right of the screen to refresh the page.
Update: This has now been resolved in MF 19.0.6 / embedded v2.4.2.
4.6.4
All
Full resolved
in 19.0.7
- In firmware 4.6.3 and below - pages were counted as grayscale pages by the device counters.
- In firmware 4.6.4 and above - pages are counted as color pages by the device counters.
- Color detection in PaperCut - with 4.6.3 and below, PaperCut would correctly count the pages as grayscale pages - and the device counter would match. Now with the 4.6.4 firmware, the device will register color pages, but PaperCut will still log and charge for grayscale pages.
- When using grayscale conversion in scripts or filters & conversions, the job will be logged as grayscale in PaperCut logs, but will be logged as color in the device counters.
- Black only (uses only black toner)
- CMYK Grayscale (uses mixed color toner to produce fine grayscale)
Update: this has now been partially resolved in the public 19.0.4 release.
As per the release notes: HP Universal print driver (PCL, PostScript) or HP model-specific driver: Documents printed with a color selection of “High Quality CMYK Grayscale” are now counted as color jobs instead of grayscale. This change aligns with HP’s change in firmware version 4.6.4 and above where these jobs are now counted as color in device meter counts. This behaviour can be reversed by setting CompositeIsGrayscale in the print-provider.conf file to “True”.
A number of customers have confirmed that this has fixed the discrepancies that they were seeing.
Further Update: we have found some circumstances where the PJL headers
GRAYSCALE=COMPOSITE
and PLANESINUSE=1
are present in the spool file - in this case we may incorrectly detect the job as grayscale, whereas the device will report the job as color. If you are running 19.0.4 or above, and you’re finding that some color jobs are incorrectly logged as grayscale in PaperCut, this is probably the issue that you’re seeing. Final Update: the additional circumstances mentioned above have now been resolved in the 19.0.7 release.
This has been fixed in 19.0.3.
Please note that if you’re not using OCR, then you’ll not see this issue happening.
Jedi
(Futuresmart
’Legacy’)
Please note that this does not impact the more recent Futuresmart platforms.
This will only impact those jobs that were printed prior to the upgrade.
If you find yourself in this situation, the workarounds available are:
Clear your hold/release queues
We strongly advise to do the version 19 upgrade out of hours, and to ensure that Hold/Release Queues are cleared down pre-upgrade where possible.
If possible, clear out your hold/release queues - so that the pre-upgrade jobs are removed, and don’t cause confusion for users. Unfortunately this does have the obvious side-effect that users will have to re-print their jobs if they still need them.
Remove the job-status data from the Application Server
This issue has come about due to changes and improvements in the ability to select accounts to charge jobs to, at release time. See Assigning accounts at the MFD if you’re interested in this feature. To handle this, the status information about jobs being held has been changed.
One way to get around this is to:
- Shut down the App Server
- Remove the following files from
[app-path]/server/data/internal/state/systemstate/
held-jobs.curr.ser
user-client-data.curr.ser - Start the PaperCut Application Server service
- Jobs that were printed by users who have their account selection set to ‘Automatically Charge to Personal Account’ or ‘Automatically Charge to a Single Shared Account’, will then be available for release for those users. This is the good news.
- The bad news is that jobs that were printed by users who have their account selection set to e.g. ‘Show Standard Account Selection’ (i.e. the user has to select which account to use) will need to re-select the account required. If your users have the ability to assign accounts at the MFD, then they can do this - otherwise they will have to return to their computer, make sure that the PaperCut User Client is running, and re-select the required account.
- User is restricted
- User has a balance of 0 or less
- Account selection set to be able to select a Shared Account
- When a shared account is selected, option to ‘Charge personal account (and allocate to shared account for reporting)’ is selected
Please note that this only happens with the exact configuration above. For any other combinations, Zero Stop will work as expected, and deny the user from performing any copy jobs. Additionally this only happens with devices that are EIP 1.5 or below. EIP 2.0 or above are unaffected.
Update: this has now been resolved in 19.0.3.
10.13.4
SmartSDK
As a workaround please do not use the auto reset timer, instead use the panel sleep timer (user will be logged out on panel sleep). This timer is set in minutes, with the minimum being 1 minute.
Please note that this has now been resolved in 19.2.1.
Update: This has now been resolved in the 18.3.8 release.
Update: This has now been resolved in 19.0.0
Please note that this has now been resolved in our 19.2.0 release.
limitations
In any of the following environments where a user is able to release held print jobs originally printed by another user, this user is also able to change the settings of such jobs:
- In the 'External Device Settings' section of the Device Details page, the only enabled Access methods setting is 'Allow guest/anonymous access'.
- In the 'Print Release' section of the Device Details page, the 'Users have permission to:' dropdown menu is set to release any print jobs (charged to their account).
Print setting changes made prior to an Application Server outage are not applied if these print jobs are released during the outage
Print setting changes made prior to an Application Server outage are applied only if the jobs are also released prior to the outage or after the outage. However, these changes are not applied if they are released during the outage.
Initial attributes of print jobs
While users can change held print jobs from color to grayscale and from 1-sided to 2-sided, they cannot do the reverse (from grayscale to color and from 2-sided to 1-sided).
Unidentifiable account displayed at the device
If a job has been printed from a terminal using an unauthenticated user account, then the device displays the account of the terminal from which the user has printed the job, instead of the actual account of the printing user. However, upon release, this job is successfully charged to the user’s own account.
Maximum number of copies is 9999
When changing the number of copies of a print job, the maximum number that the UI allows is 9999.
Changing charging model while modifying a print job is not supported
If the 'Charging' cost model is changed via a print queue’s 'Printer Details' page in the Admin web interface whilst a print job held in that queue is simultaneously being modified on a device, unpredictable charging of that print job may occur. We recommend only changing the job cost model at a time when print jobs are unlikely to be modified.
Print setting changes made on multiple jobs are applied only on release
'Force grayscale' and/or 'Force 2-sided' on multiple held print jobs are applied only if the jobs are released after making the change.
Selection of Force grayscale and Force 2-sided checkboxes may be ignored
Selecting the Force grayscale or Force 2-sided checkboxes is ignored in the following situations:
- If multiple jobs are modified at once, and the jobs aren’t released after making the change and before logging out of the device, these changes will be forgotten.
- If there are multiple print jobs with a mix of PDLs that both support and don’t support changing settings, the checkboxes are still available for all print jobs. However, selecting either checkbox for a print job with an unsupported PDL will have no effect.
Selecting a Shared Account at the device - submitting a print job with no account selected
From PaperCut V19, you are able to submit a print job without selecting an account and this will allow you to select one on the copier’s screen. This new feature reduces the need of running the PaperCut user client on workstations.
With PaperCut V18, you are only able to CHANGE the account associated to a print job, after you have selected an account previously (you cannot submit a print job without an account being selected).
[app-path]\server\data\archive
; one for the original print job, and one for the modified print job, which leads to drive space wastage.
Only one print job is recorded in the Job Log, showing the print settings at the time the document was released.
- In CWIS, go to “Properties → Security → Authentication Configuration” and set “Login Type” to “No Login Required”. Click “Apply” then “Reboot”. When the MFD has restarted, you can delete the device from PaperCut.
(documentation
change only)
This information has been added to the PaperCut MF Kyocera Embedded Manual, as an additional step during installation. It is possible this behaviour may also be changed in future releases of firmware for the affected models, but our current recommendation is to format all optional hard disks before deploying the Kyocera embedded solution.
Futuresmart
from HP
(4.7.1)
This item is restricted. Try to use another account, or contact the system administrator or the person who set up this product
This happens when the device is configured to show the ‘locked’ native device icons (e.g. Print Release, Scan, Copy).
- Press one of the locked icons
- The login screen appears
- Don’t log in, but instead press the ‘home’ icon top left
- The above status message appears
Update: This issue has now been resolved with the Firmware update 4.7.1 from HP.
An error has occurred while processing your request, please check the logs
Jan 23
2019
2019
Early indications are that something has changed on the Google Cloud side of things, which means that when the PaperCut App Server is asking to publish a printer it gets a reply from Google with a malformed URL. This results in the printer failing to publish.
Update: Google reached out to us on the 26th Jan to confirm that they’ve fixed the malformed URL response. There are no updates needed on the PaperCut side. Testing has confirmed that publishing printers now works as expected.
MDS
This has now been fixed in the 19.0.3 release.
Server-Command.exe
/Payment Gateway interfacesServer-Command.exe
(often used by our Payment Gateways via our Web Services API), the executable will not shut down until after the command has gotten its result. It will instead hang for roughly 5 seconds before finally shutting down.While this can be annoying for System Administrator that are using the command line, since they cannot enter another command within those 5 seconds, the main problem comes from external devices that use the server-command to function, as it can slow them down a lot (e.g. getting a users balance suddenly takes 5 more seconds).
PaperCut end-users can see this as a perceived network delay when authenticating at a Payment Gateway Cash Loader for instance.
Update: This has now been resolved with version 18.3.7
Jedi
(Futuresmart
’Legacy’)
If you already have the Jedi app installed on a device, and you upgrade the device to the 4.7.1 firmware, you’ll not be impacted.
PaperCut is working with HP to re-sign the app and will be available in an up-coming release of PaperCut.
To tell if you’d be impacted by this:
- Take a look in your PaperCut Admin console, under the ‘Devices’ tab, and check the ‘Type’ column:
- If you’re running HP (FutureSmart) or HP FutureSmart (legacy) you will be impacted if you try to install the app on a device, or re-install the app on a current device running the 4.7.1 firmware - since you’re running the older legacy Jedi app.
- If you see HP FutureSmart 4+, HP FutureSmart 4+ (Printer Only), HP OXP or HP OXP (Printer Only), you’re using the newer OXP platform, and will not be impacted.
Jan 31
2019
Action required
You may receive an email from them containing the below information:
Authorize.Net is phasing out the MD5 based transHash element in favor of the SHA-512 based transHashSHA2. The setting in the Merchant Interface which controls the MD5 Hash option will be removed by the end of January 2019, and the transHash element will stop returning values from March 14,2019 according to their support site above.
Their support article with more information is over on the Authorize.net Support Site
PaperCut will support the new SHA-512 signature with the updated Payment Gateway module. This build is for new SHA2 key hashing changes for Authorize.Net Payment gateway. Though this build will support both SHA2 and existing MD5 keys, we highly recommend that you obtain the new ‘Signature Key’ from the Authorize.Net Merchant Interface, as Authorize.Net will stop processing MD5 hash key by March 14,2019 according to their support site above.
Please ensure that you switch to the new SHA-512 signature prior to this date
I currently use the Authorize.net gateway. What do I need to do?
Upgrade the PaperCut Payment Gateway Module:
- Head over to the Payment Gateway Install page, and download the latest Payment Gateway installer for your OS.
- Install the new Payment Gateway module on your PaperCut App Server (as documented in the link above).
- Log into the Merchant Interface at https://account.authorize.net.
- Click Account from the main toolbar.
- Click Settings in the main left-side menu.
- Click API Credentials & Keys.
- Select New Signature Key*
- Click Submit to continue.
- Request and enter PIN for verification.
- Your new Signature Key is displayed. This Signature key will be string of random 128 character.
Finally, configure your Signature key in PaperCut:
- Stop the PaperCut Application Server Service. Follow the steps here on how to do this.
- Open the payment gateway config file ‘ext-payment-gateway-authorize-net.properties’ (located in
[install-path]/server/lib-ext/
). - Add the line ‘authorize-net.sha2-hash-value=‘ and include the signature key from Authorize.net after the = sign.
- Important: Make sure that you delete the line with ‘authorize-net.md5-hash-value’ - you can’t have both hash value lines in the config file at the same time.
- Start the PaperCut Application Server Service.
I ran into an issue - what do I check?
- When adding funds, in the PaperCut interface I get an error:
Unable to resolve expression ‘fingerprintHash’ for ext.paymentgateway.pages.AuthorizeNetRedirect$Enhance
.
- When adding funds, after entering payment information, in the Authorize.net interface I get an error:
An error occurred while trying to report this transaction to the merchant. An email has been sent to the merchant informing them of the error. The following is the result of the attempt to charge your credit card: This transaction has been approved. It is advisable for you to contact the merchant to verify that you will receive the product or service
.
MDS
Firmware fixed
11/Oct/2018
[Release version] L6.13.F
Weiss2H: T373HD0W1121F
Weiss2L: T370HD0W1121F
Reuss: T410HD0W1121F
Shasta: T380HD0W1121F
Shastina: T385HD0W1121F
Weiss2H: T373HD0W1121
Weiss2L: T370HD0W1121
Reuss: T410HD0W1121
Shasta: T380HD0W1121
Shastina: T385HD0W1121
This is more likely to affect customers running PaperCut MF 18.1.4 and newer, because in that version we changed the default behavior for Mac and Linux clients so that printers will automatically be imported.
It’s possible to prevent this from happening by disabling the printer auto-import feature.
Steps:
- On the affected macOS computer, browse to the PaperCut application folder and run the executable Control Printer Monitoring.command.
- Enter the Mac’s admin password in the Terminal window when prompted.
- Type “yes” and press the enter key to disable the auto-import feature. This will prevent the print queues from being duplicated accidentally.
- Run the Control Printer Monitoring.command file again.
- Follow the prompts to disable the print queues you don’t want monitored, and enable monitoring for the printers you do want tracked.
- Lastly, open System Preferences and choose Printer & Scanners. Select any duplicated printers and click the minus sign to remove them.
Update: This has now been resolved in 19.0.0.
in firmware
4.7
HP has informed us that they have fixed this error in the 4.7 firmware.
We have had the following information from HP on this:
If the issue persists, please answer the below questions for further investigating.
- Do you observe this behavior on other device models? Or is it observed only on certain devices?
- Please provide us the complete steps to reproduce this issue if possible
- Please provide the JDP logs. You can open EWS page and navigate through Troubleshooting → Diagnostic Data → Click “Start” button → Choose “Create zipped debug information file” → Check “Clean up debug information” → Click “Export” button
Futuresmart
This is linked to MAC-5381 above, so the workaround is to disable the new login flow:
Note: You’ll need to do this for each HP device:
- In the PaperCut MF Admin web interface, select Devices → [select device] → Advanced Config.
- Search for
ext-device.hp-oxpd.fast-swipe-login-flow
. - Change the value from
Y
toN
. - Click ‘Update’ to save the change.
Note that his has now been resolved in 18.3.4.
Futuresmart
If you’re on 18.3.3, you can workaround the issue by doing the following:
Note: You’ll need to do this for each HP device:
- In the PaperCut MF Admin web interface, select Devices → [select device] → Advanced Config.
- Search for
ext-device.hp-oxpd.fast-swipe-login-flow
. - Change the value from
Y
toN
. - Click ‘Update’ to save the change.
Please note that in 18.3.4, the default behavior is that the new fast-swipe-login is not enabled. In order to enable the new faster swipe-to-login flow, set the advanced config key
ext-device.hp-oxpd.fast-swipe-login-flow
to ‘Y’ for each device.
MDS
This has now been resolved in 18.3.6.
eConnect
This has now been resolved in 18.3.6.
This has been fixed in 18.3.5
Futuresmart
There is a hot-fix available for testing - and this has now also been resolved in the 19.1.1 release.
Futuresmart
This can previously be resolved by unplugging and replugging the card reader. Obviously this isn’t great, so this will be resolved in the next release.
Note that we have seen that in normal operation the device (and firmware boot up sequence etc) can take anywhere from 30 seconds to 2 minutes to recognize the card reader. We’ve also seen behavior where the card reader beeps as though it’s ready to read swipes, but the firmware is still initializing in the background.
PRO
HP firmware
x.1921E.00
Logging in with username/password, or typing in the card ID are not impacted.
Update: HP have confirmed that they have resolved this issue in HP firmware version x.1921E.00 or later (the ‘x’ will changed depending on the device model).
4.6.x
Futuresmart
firmware
In certain circumstances this could also result in a user self-associating with the spurious card ID, which will then result in that user appearing to login/logout repeatedly.
Initial investigations point to a status code being received by the device, and the device interpreting that as a card swipe.
Update May 2019:
HP has confirmed that the ‘Ghost Authentication Issues’ have now been fixed in Radio 2.04 firmware on X3D03A. Additionally, the device firmware has to be 4.7.1.3 or later.
HP has asked customers experiencing this to contact their HP reseller to apply the new Radio firmware and any new device firmware updates needed.
firmware from
HP (4.7.0.1)
We have also found during our testing that factory reseting the device and re-loading the latest firmware can help stop this issue from happening.
Update: HP has advised that they have fixed this in 4.7.1 firmware, however this is not yet publicly available. HP has advised that anyone seeing this error should chat with their local HP contacts and ask for early access to the 4.7.1 firmware.
Further Update: HP has advised that they have fixed this in 4.7.0.1 firmware, which is now publicly available (Feb 6, 2019).
This firmware will resolve the 49.DE.05 errors for all devices except for those below:
- HP PageWide Enterprise Color MFP 780/785
- HP PageWide Color 774/779
- HP PageWide Managed Color MFP E77650/60
- HP PageWide Managed Color MFP P77940/50/60
- HP PageWide Managed Color MFP P77440
- HP LaserJet Managed MFP E82540/50/60
- HP Color LaserJet Managed MFP E87640/50/60
Fixed in 18.3.2.
Please leave the hardware checks feature enabled but edit the print-provider.conf file following the steps below.
- On the PaperCut server, browse to [Application-Directory]\Providers\print\win\.
- Open the file print-provider.conf with a text editing program.
- Add the line
IsPrintingBasedOnPortMonitor=off
to the file and save. - Open Services.msc, find the service “PaperCut Print Provider” and choose Restart for the new configuration to take effect.
Update: This has now been resolved in 18.3.7
Fixed in 18.3.3
- PaperCut embedded application will disappear from the device’s screen
- Authentication via card swipe fails to work
- Integrated Scanning may fail to launch.
- Errors may also be seen in the PaperCut admin console such as “The server sent HTTP status code 500: Internal Server Error” or “java.io.IOException: Invalid Http response”.
Changes were also introduced in PaperCut MF version 18.3.5 to improve the user experience when the issue occurred. The following is only applicable to organizations that cannot upgrade to Firmware GG7-Wx and above. A new behavior can now be enabled so that the PaperCut embedded application will instead display the following error message when this state occurs:
- “The device is currently experiencing an internal error. Please contact your system administrator.”
ext-device.konica-minolta.internal-error-handling.enabled
: Set toY
to prevent users from accessing the device when the firmware error is encountered (and the device is in an unpredictable state).ext-device.konica-minolta.internal-error-handling.message
: This can be used to customise the message displayed to the user at the device when in this situation. For example ‘Please contact local IT admin on xxx xxx xxxx’.
Futuresmart
Futuresmart
This has now been fixed in 18.3.2
For your IPN verification postbacks (the Notificatin URL configured on the PayPal account site), if you are currently using HTTP you’ll need to make this adjustment to use HTTPS. There is more information about this from PayPal here: https://www.paypal.com/sg/webapps/mpp/ipn-verification-https
In order to keep your PayPal Gateway working with PaperCut, you’ll need to:
- Log into your PayPal Manager Interface / Merchant Account Site:
- For PayPal Payflow: head into
Service Settings → Hosted Checkout Pages → Set Up → Silent Post URL
- For PayPal Website Payments: head into
My Account → Profile → Instant Payment Notification → Preferences → IPN Settings → Notification URL
For example, you would see something like https://papercut.myorg.edu/rpc/gateway/paypal-wps , where papercut.myorg.edu is the external hostname of your PaperCut server. If you’re using PaperCut’s default HTTPS port 9192, then you would see the port in the IPN URL like the following: https://papercut.myorg.edu:9192/rpc/gateway/paypal-wps
Reported in
WC 36xx,
WC 79xx,
WC 72xx
and WC 78xx.
EIP 1.5+
upgrade
Please contact support for more information.
Reported in
WC 5955
EIP 1.5+
Please contact support for more information.
If you can’t upgrade to 18.2.5 right now, you can do the workaround we cover below:
Please leave the hardware checks feature enabled but edit the print-provider.conf file following the steps below.
- On the PaperCut server, browse to [Application-Directory]\Providers\print\win\.
- Open the file print-provider.conf with a text editing program.
- Add the line
IsPrintingBasedOnPortMonitor=off
to the file and save. - Open Services.msc, find the service “PaperCut Print Provider” and choose Restart for the new configuration to take effect.
Organizations have found dropping back to SQL Server 2012 generally solves the problem, however, we also have instructions to use Microsoft’s own SQL driver which claims to be much faster than our current Java driver.
To add the MS driver into PaperCut (prior to PaperCut 19.0) please follow these instructions.
- Download the latest version of Microsoft’s JDBC driver for SQL Server (
sqljdbc_7.0.0.0_enu.exe
) from this link: https://www.microsoft.com/en-us/download/confirmation.aspx?id=57175 - Run
sqljdbc_7.0.0.0_enu.exe
to extract the files. - Copy the file
mssql-jdbc-7.0.0.jre8.jar
from the location the files were extracted to, to<PaperCut MF or NG install directory>\server\lib-ext\
- Comment out your current SQL entries (these will form your backup plan)
- Copy the following entries into the server.properties file and modify to point to your SQL server:
database.type=SQLServer
database.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
database.url=jdbc:sqlserver://<serverName>:<portNumber>;databaseName=<databasename>;socketTimeout=600000
database.username=<user name>
database.password=<password>
If the connection requires additional properties (not expected, based on what we know), they can be found here: https://docs.microsoft.com/en-us/sql/connect/jdbc/setting-the-connection-properties?view=sql-server-2017
Update: This has now been resolved in 19.0.0. If you’re using the old built-in database driver, you’ll now see a warning in the Application Log advising to upgrade to the Microsoft driver. If you’re on PaperCut 19.0.0 or later then you can rest easy. The updated MS DB drivers are bundled in the PaperCut build, so you don’t have to download any extra drivers. However, there are two changes in the database connection settings, in the server.properties file that you’ll need to make:
- database.driver (update to the driver being used)
- database.url (update to the format of the connection string)
database.type=SQLServer
database.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver
database.url=jdbc:sqlserver://localhost:1433;databaseName=papercut;socketTimeout=600000
database.username=
database.password=
A security-related change in PaperCut MF 17.4.2 to address a potential access issue on Sharp devices, potentially allowing free printing, has also closed a print method that allowed users with Sharp User Authentication set in their print driver to release a job printed to a PaperCut MF managed queue.
We understand that there are users that could still have User Authentication configured for their Sharp print drivers, and hence this may cause disruption to their printing.
To easily resolve this issue, please ensure on each user’s system that the Sharp driver User Authentication settings are disabled by deselecting the User Authentication checkbox under the Job Handling section of the Sharp driver’s Properties.

This is also covered in the FAQ & Troubleshooting section of the PaperCut MF Sharp Embedded Manual.
On large sites this may present a challenge if considerable numbers of users have this configured as a legacy setting. Fortunately, there are a few avenues to a solution:
Firstly change the setting on the driver shared from the server if needed.
To change users drivers you can:
- Guide users to manually change the settings on their driver.
- Use Group Policy to remove the printer and re-add it.
- Use a login script to remove the printer and re-add it during the logon process.
Should the above methods prove unacceptable in the short term, we have provided a method by which an administrator can choose to relax the security enhancement by adding a device-specific advanced configuration key:
ext-device.sharp_osa.workaround.mac-3763=Y
Please contact your reseller for assistance in adding this key to your PaperCut MF server.
Note: Fixed in 18.2.6
Resolved in 18.2.4
”Access Device” button (random occurrence).
MDS
Please contact support for more information.
WC 59xx,
WC 66xx,
AltaLink B80xx,
& AltaLink C80xx
EIP 1.5+
upgrade
Please contact support if you continue to see issues after upgrading to the latest firmware.
PaperCut will provide a maintenance release to address this issue if it is detected.
A fix for the following payment solutions was provided in PaperCut NG and MF 18.2.2
- Apex 5000
- Microcoin
- SEM-ACS 9500Ss
- Boscop Coin Op
The Mobile web client registers its session with a machine name of
web_client
, as a machine name is not readily available for browser sessions. This means that the machine name from a print job cannot be successfully used to find a matching Mobile web client session, leaving us to rely upon the IP address and username.However, under certain circumstances the IP address of the print job and the Mobile web client will not match. For example, if a desktop machine is connected to two networks, and the print job is associated with one IP and the Mobile web client another, this will leave only the username to match on. Some Mobility Print jobs may be similarly impacted in select network environments.
By default, we will not match a User Client session to a print job on the basis of the username alone. Under the rare circumstances outlined above, this means that the Account Selection Popup will not be issued to the user, and the print job will not be able to progress.
This behaviour can be circumvented by changing a particular config key via the Advanced Config Editor, allowing print jobs to be matched to User Client sessions based solely on the username. HOWEVER, making this change can have unexpected impacts for some deployments, so it is best to confer with your primary support contact beforehand, as well as thoroughly testing the adjustment afterwards. For PaperCut MF, you can identify your primary support contact via the Support section of the About tab in the Admin web interface. For PaperCut NG, feel free to raise a ticket via https://support.papercut.com to discuss further.
Reported on
WC 5875,
WC 5955,
WC 7220,
WC 78xx
and AltaLink B8075.
EIP 1.5+
We suspect that the fix to support “Switch Mode Devices” going to the device’s native screen has caused this problem on a number of Xerox models. This issue has been resolved in 18.2.1.
Please contact support for more information.
Futuresmart
and 18.3.4
(see more info)
Note: You’ll need to do this for each HP device:
- In the PaperCut MF Admin web interface, select Devices → [select device] → Advanced Config.
- Search for
ext-device.hp-oxpd.fast-swipe-login-flow
. - Change the value from
DEFAULT
toY
. - Click ‘Update’ to save the change.
MDS
As a workaround in order to restart the ODCA server, one needs to disable and enable the ODCA service. This can be done in TopAccess by going to:
- Administration→Setup→General Setting→MDS mode, disabling and hitting Save
- Administration→Setup→ODCA→Enable Port, disabling and hitting Save
- Administration→Setup→ODCA→Enable Port, enabling and hitting Save
- Administration→Setup→General Setting→MDS mode, enabling and hitting Save (though this last step should happen automatically by PaperCut re-enabling MDS).
The workaround for this issue will be to manually navigate back to the PaperCut MF Admin web interface.
Note that this has now been fixed in 18.2.3
- Delete all files in [app-path]\PaperCut MF\server\tmp directory
- Move all mapdb files in [app-path]\PaperCut MF\server\data\internal to a different directory.
- Restart the PaperCut Application Server service.
Note that version 18.3.6 includes a fix for the issue preventing the need for the steps above.
Uncertain
JBA/XSA
SPAR release
December 2017
Xerox is aware of the issue and is working on fixes. Engineering releases are currently available for WC 3655, WC 59xx and WC 78xx, with Engineering releases for the other models expected in a week. A SPAR release for all the models is expected to be released in mid December 2017.
Update
(053.240)
Update: this has now been resolved in the latest firmware from Lexmark (May 2019). Note that this firmware is currently only available through your local Lexmark contact (quote firmware level CXTMH.053.240 or greater). We’re hoping that this latest update will be made public soon!
The following languages are affected:
Catalan, Czech, Danish, German, Spanish, Finnish, French, Croatian, Hungarian, Italian, Hebrew, Japanese, Korean, Dutch, Norwegian, Portuguese-Portugal, Polish, Russian, Slovenian, Serbian, Turkish, Chinese (China, Hong Kong, Taiwan).
This has been fixed in PaperCut NG/MF 18.1.2.
Reported in
WC 58xx,
WC 78xx,
WC 59xx
and WC 79xx.
EIP 1.5+
upgrade.
Please contact support for more information.
PaperCut 18.1.3 will address this issue. In the meantime, there is a hot fix build available. Please reach out to us via support.papercut.com for assistance.
Note: Fixed in the documentation with 18.3.2
Reach out to us via support.papercut.com and we’ll update this known issue page once we have more information.
Futuresmart
Workarounds:
1. Admins can set ext-device.hp-oxpd.restricted.multiple-txns to Y, to allow multiple transactions. The drawback of this is that some users could go into negative balance if they copy a subsequent job that puts their balance negative. Please see section 5.13 of the HP OXP Embedded Manual for more information.
2. Set all users to unrestricted within PaperCut. This will allow all users to process multiple copy jobs in quick succession.
NullPointerException
on newly setup devices. MDS
TopAccess
via the menus: Administration → EWB) then an error of “Error occurred of type: NullPointerException
” will be generated. This bug can be worked around by entering anything into the EWB Home and Login URLs and these URLS will then be overridden correctly by PaperCut in a few minutes. Alternatively, a hotfix installer for this issue can be provided by PaperCut support.This issue will be fixed in 18.0.5.
(Build 42955)
A hotfix build is available from support.papercut.com, and this same fix will be formally available in the impending PaperCut MF 18.0.3.
PaperCut version
v 2.1.4
This has been resolved in OPS for Papercut – version 2.1.4. Please contact your Epson supplier for more information.
This has been fixed in 18.0.5, or this error condition can be avoided by increasing the timeout config key ‘print-provider.offline-if-no-contact-seconds’ to 31536000.
More information can be found here.
The workaround for this issue is to regenerate the certificate using keytool, with a ‘Not Valid After’ date that is before January 19 2038.
This issue has been fixed in v18.0.4.
with first
generation
browsers.
EIP 1.5+
This has been fixed in v18.0.5, or the workaround for this issue is controlled by setting the config key ‘release-station.released-job-processing-timeout-secs’ to 680.
devices
EIP 1.5+
Update. Workaround
Available in v2.5.0
17.4
Customers are encouraged to contact Lexmark and inquire whether an internal firmware build is available to address this issue.
Starting with PaperCut embedded client v2.5.0, admins can hide the logout icon by setting the following device config key:
ext-device.lexmark.logout.display-icon=N
Users will be able to click on their username (displayed at the top-rightmost corner of the display) to logout. This method properly logs the user out, even on the affected firmware version listed above.
This was officially updated in PaperCut 17.4.0
If you are experiencing issues with incorrect paper size when printing from Apple’s Pages, Keynote, and Numbers v3.3, can you please contact support via http://support.papercut.com
If you are experiencing issues with incorrect paper size when printing from Apple’s Pages, Keynote, and Numbers v3.3, can you please contact support via http://support.papercut.com
Nov 2017
available
(Build 41733)
NG 17.3.2
(Build 41734)
(Build 41947)
NG 17.3.4
(Build 41948)
(Build 41733)
NG 17.3.2
(Build 41734)
(Build 41828)
NG 17.3.3
(Build 41829)
Some devices when upgrading firmware to:
2H7_2F00.016.003
are having an issue when logging in, they see a white screen. Downgrading the device firmware will resolve this issue.PaperCut are working with Kyocera to resolve the problem.
(since July 2017)
newest firmware
The ‘RFIDeas 241 Client Mode’ interface itself is responsible for this delay, and as such PaperCut cannot provide any improvements for it. RFIDeas have mentioned that they are aware of this delay and are working on bringing out an improved firmware.
(Build 41500)
NG 17.2.4
(Build 41501)
Build 41828)
NG 17.3.3
(Build 41829)
that have
integrated
scanning
capabilities.
EIP 1.5+
Please contact your Xerox support to find out if your Xerox device is capable of running EIP version 4.0. Otherwise please contact support for more information.
MDS
This issue was fixed in 17.3.3.
MDS
and v17.2.1
PaperCut have identified the cause of this message. A combination of firmware 1050 and v17.2.1 resolved the issue.
A fix for this issue is expected to be released in PaperCut MF 17.2
MDS
On the device screen the user will see the following message: Javax.xml.ws.soap.OAPFaultException. The subscription is not known
PaperCut have worked with Toshiba to understand the change in protocol and to update our app to work with it. A fix for this issue was included in PaperCut MF 17.2.1
MDS
A fix for this issue was included in PaperCut MF 17.1.2.
Please note: we now have a hot fix available if you are experiencing this issue. Please contact your PaperCut Partner (or PaperCut Support) if you’d like this hot fix. We are hoping to include this fix into an upcoming public release too.
v 2.1.7
(Build 40576)
NG 17.1.2
(Build 40577)
(Build 40576)
NG 17.1.2
(Build 40577)
(Build 40647)
The problem arises from the implementation of the zero stop feature. In order to prevent users bypassing zero stop on newer devices by changing paper size, PaperCut must provide a full list of paper sizes supported by the device in an API call. Prior to the 17.0.2 release, this functionality needed to be specifically enabled by a config key, “ext-device.konica-minolta.additional-media-info”, and this key needed to be set for every new KM device installed. With release 17.0.2, the config key was removed to make this the default behavior.
However, an unintended consequence of this change is that some older devices no longer work, as the particular API call is not supported. A hotfix that resolves the problem, by reverting to the original behavior on older devices, was available from PaperCut Support. This hotfix was then rolled into PaperCut MF 17.2.0.
The certificate used to sign the par expired on the weekend (15th April, 2017). We have a new PAR file available now which is available from PaperCut v17.1.
It will affect all versions of PaperCut but only customers doing new installations or updating the PAR file will see this issue. Existing installations are not affected.
You can obtain the new PAR file by using PaperCut v17.1 or newer.
SmartSDK
Workaround is to set the devices only to go into power saving mode, and not fully sleep. Since PaperCut 17.4, by default the workaround is enforced by the PaperCut app.
SmartSDK
Known limitation.
v 2.1.8
JBA/XSA
ERROR ExtDeviceStateManagerImpl:844 - Error occurred on device: device\library. Error occurred of type: NullPointerException. No further information.
This will be fixed in PaperCut MF 17.0 and a hotfix build based from 16.4 (Build 39158) can be obtained from support.
SmartSDK
EIP 1.5+
Current status as of April 19th 2017:
Problem: SNMP login prompt configuration no longer works - Fixed
Problem: Secure Access needs to be automatically set - Fixed
Problem: JobLimits works differently to expected - Fixed
Problem: Setting user permissions - Fixed
Problem: Setting Access Configuration via SNMP fails - Fixed
Regression testing - complete
Resolved in 17.0.7
15.3 (Build 34230)
Without the card reader attached and PaperCut installed the device performs normally.
A fix for this bug was included in PaperCut MF 16.0 (Build 34949).
EIP 1.5+
Unfortunately, the early access release of version 16.4 omitted this fix but the final 16.4 release includes the fix.
16.0 Build 34949
to
16.1 Build 35753
This is a known issue that is expected to be fixed in future release v2.3.1 (currently in final development stages).
As a workaround, affected customers may install the previous version of the embedded application (v32000), available from our support team.
versions up to
(incl.)
16.1 Build 35753
This is a known issue that is expected to be addressed in future release v2.3.1 (currently in final development stages).
versions up to
(incl.)
16.1 Build 35753
16.0 Build 34949
to
16.1 Build 35753
16.0 Build 34949
to
16.1 Build 35753
This is a known issue that will be fixed in v2.3.0.
As a workaround, affected customers may install the previous version of the embedded application (v32000), available from our support team.
SmartSDK
This issue affects the SmartSDK application.
Workarounds to this problem are:
- Enter the fax number before pressing the “Start” button (without pressing the “Speaker” button).
- Select a fax number from the address book and press the “Start” button.
We have had an official statement from Sharp Japan, that this behavior is “by design”. However due to customer demand they are reconsidering this behavior for future firmware/devices.
New installations of the v1.1.0+ embedded application by default use HTTPS port 9192 to communicate with the PaperCut server. PaperCut versions earlier than 16.0 are not capable of communicating with devices on this port. Change the device ‘HTTPS/binary’ port to 9193 when connecting to PaperCut versions earlier than 16.0.
SmartSDK
Known limitation.
This issue affects the SmartSDK application.
Not possible to fix this issue given that we receive fax detection events right at the end of the process.
SmartSDK
This issue affects the SmartSDK application.
SDK/J
New installations of recent embedded application versions by default use HTTPS port 9192 to communicate with the PaperCut server. PaperCut versions earlier than 16.0 are not capable of communicating with devices on this port. Change the device’s server port to 9193 when connecting to PaperCut versions earlier than 16.0.
HyPAS embedded v34678
HyPAS embedded
v2.0.1
15.3 (Build 34230)
login: error=9, message=fail DeviceLock
The likelihood of this happening has been further reduced in version 16.0
15.3 (Build 34230)
(Build 35678)
Please contact PaperCut support for details regarding an available workaround. We will update this page with further information when more details are available.
(Build 34420)
Error: setApplicationDetails: error=3, message=Duplicate Control
The temporary workaround is to uncheck the ‘Enable self-association’ feature under Devices → [select device] → External Device Settings → Swipe Card → Enable self-association with existing user accounts.
A fix for this bug was included in PaperCut MF 15.3 (Build 34420).
EIP 1.5+
Workaround:-
If you are experiencing this issue then please follow the instructions in section 2 of Trouble Shooting Xerox SSL.
Resolved in 15.2 (Build 33701)
Brother
mono and
color devices
DCP-L5500DN, DCP-L5502DN, DCP-L5600DN, DCP-L5602DN, DCP-L5650DN, DCP-L5652DN, DCP-L6600DW, MFC-8530DN, MFC-8535DN, MFC-8540DN, MFC-L5700DN, MFC-L5700DW, MFC-L5702DW, MFC-L5750DW, MFC-L5755DW, MFC-L5800DW, MFC-L5802DW, MFC-L5850DW, MFC-L5900DW, MFC-L5902DW, MFC-L6700DW, MFC-L6702DW, MFC-L6750DW, MFC-L6800DW, MFC-L6900DW, MFC-L6902DW, ADS-2800W, ADS-3600W, MFC-J5330DW, MFC-J5335DW, MFC-J5730DW, MFC-J5830DW, MFC-J5930DW, MFC-J6530DW, MFC-J6535DW, MFC-J6730DW, MFC-J6930DW, MFC-J6935DW, MFC-J2330DW, MFC-J2730DW, MFC-J3530DW, MFC-J3930DW, MFC-J6580CDW, MFC-J6980CDW, MFC-J6995CDW, DCP-L8410CDW, MFC-L8610CDW, MFC-L8690CDW, MFC-L8900CDW and MFC-L9570CDW. Please contact your Brother reseller for updated firmware.
X945e
Update (P125)
- The LCD screen flickers repeatedly showing the PaperCut login screen logo.
- When ever any of the function buttons are pressed (e.g. “Copy”, “Fax”, etc) the LCD screen display “busy, please wait”.
- The LCD screens displays “busy, please wait” when the PaperCut application starts.
These problems do not occur on most X945e devices. PaperCut has been certified to work on the X945e devices and also is known to work correctly on many customer sites. So it appears that there are differences between some X945e devices that trigger these problems.
By working closely with Lexmark this issue has been resolved through a firmware upgrade for the X945e device. The firmware version that fixes this problem is version P125. We can provide you this firmware upon request.
You will also require an updated version of the PaperCut embedded application. You can also request from us through support. This update will be included in the next release of PaperCut.
072.xxx.xxx.xxxxx
JBA/XSA
072.0×0.134.32800
A fix for this bug was included in PaperCut MF 15.3 (Build 34420).
HyPAS embedded v34034
HyPAS embedded
v1.9.3
A small number of customers who are using API 2.x devices have reported this issue when exiting maintenance mode.
We are investigating the root cause of this issue.
For API 2.x devices, upgrading to PaperCut HyPAS embedded v1.9.2 has solved the issue for some customers. Other customers still experience it, but the MFD seems to successfully launch the PaperCut HyPAS application after a few seconds.
For API 1.x devices, a suggested workaround is to install PaperCut HyPAS embedded v32152.
We will post more info as it becomes available.
Resolve in 15.2 (Build 33701)
Brother
mono and
color devices
SDK2
A fix for this bug was included in PaperCut MF 15.3 (Build 34078).
EIP 1.5+
We have an interim build that fixes this issue based on PaperCut 15.1 (Build 33336) that may be requested from support. Alternatively, the fix will be incorporated into the PaperCut 15.2 release.
Update
We worked closely with affected customers and Lexmark to collect diagnostic information and determine the cause of the problem. Lexmark identified a device firmware bug that was causing the problem, and have released a firmware upgrade for all affected devices.
The firmware upgrade was released in November 2010. Please contact Lexmark to get access to the upgraded firmware.
Some more information is available here.
HyPAS embedded v34034
HyPAS embedded
v1.9.2
- The MFD might become unresponsive
- The MFD might display an internal error code (F245 / F248 / F345)
- Scanning might fail mid-way
- The generated scanned file would be corrupted
Kyocera has released new firmware versions to address the above mentioned unresponsive / internal error code messages. Customers are encouraged to upgrade any affected devices to the latest available firmware versions.
PaperCut has released a new HyPAS embedded application (v1.9.2) which addresses these issues. Please contact our support team to obtain this version.
This issue can be remedied by applying an update. Contact support for a hot fix.
SDK2
A PaperCut fix for this bug is included the 15.2 bug fix release. A script for removing the duplicate entries from PaperCut’s job log database is available for Derby databases running on Windows - please contact support to obtain this or for scripts that need to be run on any other database platforms.
X464de
investigating
Lexmark has acknowledged this to be an issue.
No firmware updates or other relief has been announced for this issue.
If this happens, the normal login screen will not be shown and the PaperCut Kyocera embedded application will need to be reinstalled by an authorised Kyocera service representative.
This can only happen if the copier loses power or is rebooted during the configuration change. In testing, this is approximately a 15 second window on average.
An updated
pc-kyocera.pkg
has been made available in PaperCut MF (build 34230).
This issue can be remedied by applying an update. Contact support for a hot fix.
Adelaide devices
App v1.3.0
MS610de
C792de
C748de
CS510de
MS810de
MX510de
investigating
Lexmark have confirmed this is an issue in their firmware and have provided a test firmware to one of our affected customers. As of June 2014, these firmwares have not been made public by Lexmark. If you are seeing this issue on your site, please contact Lexmark customer support and request the update firmware for your device.
Affected devices are reported to include at least the following:
- MS610de
- C792de
- C748de
- CS510de
- MS810de
- MX510de
- March 2013 - Issue has been reported to OKI
- July 2015 - Not reproduced or reported since original case. Assumed fixed by firmware and closed. Please inform PaperCut support if you see this issue.
HP
, it will cause the following error:java.lang.IllegalArgumentException: Invalid token
- Login to the MFD’s administration UI, click on “Security”, scroll down to “Embedded Web Server Options” and un-check “Enable Cross-site Request Forgery (CSRF) prevention”.
- Configure the PaperCut Application Server details.
- Re-enable CSRF prevention by undoing the first step.
Update
to 18.0.3
Futuresmart
This has been resolved in MF 18.0.4.
Futuresmart
firmware 3.7.3
Error: The server sent HTTP status code 400: BadRequest
HTTP transport error: javax.net.ssl.SSL HandshakeException: server certificate change is restricted during renegotiation
We have narrowed this issue down to an issue with interoperability between PaperCut and the HP Fleet Release Bundle Version Designation: 3.7 (firmware version 3.7) which was released in early January 2016 and may be seen on any FutureSmart devices. The devices PaperCut have seen with this error so far are below:
- HP FutureSmart X585
- HP FutureSmart M527
- HP FutureSmart M575
- HP FutureSmart M577
- HP FutureSmart M680
- HP FutureSmart M830
- HP FutureSmart M4555
- HP FutureSmart cM4540
- HP LaserJet M525dn
A fix for this bug was included in FutureSmart firmware interim 3.7.3. To obtain a link to the firmware contact your local HP ATS (Advanced Technical Support).
Futuresmart
(Build 34420)
A fix for this bug was included in PaperCut MF 15.3 (Build 34420).
(Build 32334)
Futuresmart
update
- HP X585 - firmware 2304070_439651 and 2304061_439464
- HP M630 - firmware 2304070_439645
- HP M725 - firmware 2304070_439661
- HP M775 - firmware 2304070_439663
- HP M830 - firmware 2304070_439651
- HP M880 - firmware 2304070_439653
PaperCut has been advised that there is newer firmware being released for all devices affected as of the 15th of April 2015. If there is firmware newer than the 18th of February 2015, then please upgrade to this firmware. If there is no newer firmware, then the workaround is to downgrade firmware on the device.
If you find the same behavior on different models of HP, please email support@papercut.com with your HP model and firmware versions, and we will add it to the list.
(Build 30615)
Resolved in 14.3.30615
SDK/J
SDK2
It has been reported on Toshiba eS3540C with firmware T140HD0W3301, that when PaperCut goes to retrieve the job log from the device it will cause an error:
ERROR ToshibaV2ExtDevice:248 - SOAP error: Internal server error
which will prevent PaperCut from tracking any jobs.Toshiba Japan are aware of the issue and the solution is to upgrade the Toshiba MFD to the latest version of the firmware. For example, on the Toshiba eS3540C a recent working firmware version is T140HD0W4003(L4.635).
In PaperCut MF 14.2 (Build 28232) we added support for better handling of the retrieval failure of the firmware number so that job tracking is unaffected.
Available
As it turns out, these are symptoms of the workstation’s remote renderer not communicating correctly with the iPrint Appliance. To confirm this, launch the spool file directory on the iPrint Appliance and check whether job submission generates only a PDF file without its spool file counterpart. If the spool file is missing, please re-install the remote render software on the affected workstation. A customer report confirmed that re-installing the remote renderer restored full communication to the iPrint Appliance and correctly generated the job’s corresponding PDF and spool files.
The fix has been released publicly in version 14.3 (Build 29819).
SDK2
DEBUG ToshibaSoapOutbound:114 - Establishing Toshiba SOAP connection to: 10.12.4.225, user: admin
ERROR ToshibaV2ExtDevice:238 - Connection error: HTTP transport error: java.net.ConnectException: Connection refused: connect
This is likely due to the Toshiba’s ODCA server not responding.
Please contact Toshiba for a firmware patch to rectify the problem.
This has been seen on firmware 2001 and fixed on firmware 2001G.
Upgrade
Upgrading to the latest firmware on the Toshiba has rectified the problem.
SDK2
update
This affects all versions of iPrint up to and including OES 6.3 SP3.
Novell are aware of the issue and have raised an internal bug (#700160).
As of 2nd December 2011, Novell have notified us they have a fix in testing for this problem. If you would like access to this fix, please contact Novell Support and reference the bug #700160.
This fix is expected to be included in upcoming Novell iPrint releases.
904, 6240 and 5150
Available
A reported solution is to remove the “pairing” between the OSA device and the card reader as follows
- Login on the device with the admin credentials
- Disable PaperCut in the Application settings / External Application settings / External Accounting Application settings
- Choose ‘User Control’ and ‘Card Reader Device Registration’.
- Delete the pairing information
- Reboot the copier and enable PaperCut in the Application settings / External Application settings / External Accounting Application settings.
We would be interested in reports of success or failure using this approach. Please let us know: support@papercut.com
(14.2 and earlier)
PaperCut MF 14.2.2 contains a workaround for this situation.
SDK2
SDK2
This is fixed in PaperCut 13.4.
Available
In order to workaround this issue and not require having guest enabled, please request a special Print Data Converter file from PaperCut support.
Please follow the guidelines in the Toshiba SDKv2 manual for installing this Print Data Converter.
This PDC file is considered experimental and is not provided in the installation as we are awaiting approval from Toshiba Japan.
papercut
is added to the autoload command.To run PaperCut with a debug version of iPrint, PaperCut needs to be recompiled with special debug flags against the matching debug version. If you’re working with the Novell support team to diagnose an issue and PaperCut needs to be enabled during this diagnostic, please contact our support team. We’ll look into the possibility of supplying a matching compatible debug version of PaperCut.
Available
Read more about it here.
(14.2 and earlier)
PaperCut MF 14.2.2 contains a workaround for this situation.
Available
"%&'<>[]
or spaces
then the authentication at the Toshiba’s panel will fail. We have narrowed down that this behavior occurs when the “Create User Information Automatically” option is turned on in the Security settings of the Toshiba. However, PaperCut needs this setting turned on for its functionality to work. Toshiba Japan are aware of the issue and plan to improve their password character support in a future update of their firmware.Until the problem is resolved, we recommend avoiding these characters in passwords. Other punctuation characters still work. Toshiba has provided a table which lists valid and invalid password characters:

A custom build of PaperCut is available to correct this issue. Workarounds include ensuring the device is contactable when deleting it, or not deleting the device. This issue will be fixed in the next release.
This problem occurs because Quota limits need to be set up after login (or account selection). If there is a short delay in setting up the quota limits, and the user starts a copy process before this operation completes, they may experience this message (a race-condition). When the user retries to copy, usually the message does not re-appear. PaperCut has recently made a number of code changes to reduce the likelihood of this occurring. PaperCut is also working with Toshiba to see if some device-level changes are possible to further mitigate the issue.
Update (1-Nov-2012): With the release of PaperCut 12.5 we’ve made a number of improvements to reduce the likelihood of this occurring. We recommend you upgrade if you are running Toshiba SDK2 devices, particularly if you have 50+ Toshiba devices connected.
(Build 25901)
JBA/XSA
(Build 26241)
3300
SDK2
Update
Toshiba have confirmed this is a firmware issue and it will be resolved in an upcoming firmware update.
Available
The recommended mitigation strategy at the current time is to:
- Exclude your Sharp devices from any regular security scanning system.
- Consider firewalling off your Sharp devices at a nearby switch so only print servers can access (hence avoiding exposure to other network traffic).
This issue has been reported to Sharp and will likely require a firmware-level update. PaperCut Software would like to thank the IT team at the University of Washington for their assistance in tracking down the cause of this issue.
Update (2015–03–03): This issue was initially reported in 2012. PaperCut has not been made aware of this issue continued existence in the last 12–18 months on the most recent updated firmware.
(Build 28232)
pre-v3000
SDK2
Update v3000+
For this reason we recommend checking the settings and testing to assure that the integration works after installing firmware upgrades.
From:
exit_on_error /etc/init.d/papercutcups start
To:
exit_on_error /etc/init.d/papercut-event-monitor start
(This service was renamed as it now does more than just CUPS management - it also does server connection monitoring for the new event resend feature.)
SDK/J
The administrator username/password must be entered in the “config.properties” file during installation on the device. If the application is already installed you can modify the “config.properties” file and re-upload the application.
iPrint build
- Jobs do not print after enabling PaperCut on the printer
- Errors may appear in the iPrint logs (ipsmd.log)
- Contact Novell support and ask for the latest iprint update compatible with PaperCut. It’s filed under TID 7005723. Ensure the update is suitable for OES2 SP2 and your architecture. (the version should be novell-iprint-server-6.2.20100414–0.4 or later)
v3300
When this occurs the device status in PaperCut will list an error similar to the following:
java.net.ConnectException: Connection refused
Adelaide devices
App v1.2.2
java.security.InvalidAlgorithmParameterException: the trustAnchors parameter must be non-empty [maintenance thread]
This issue can occur with Harare and Adelaide device families. The workaround is to change the device configuration to use port 9193 for PaperCut communications.
This issue has been resolved in embedded application version 1.2.2.
The symptoms of this issue are that the device will report the following error (both in the device status in the admin UI and in the server.log):
One or more of the permission names are invalid
iPrint build
Symptoms:
- Errors may appear in PaperCut’s print-provider.log - Unable to cancel job error number: 1349320716 (0×506D0012)
- Errors may appear in the iPrint logs (ipsmd.log)
- The
papercut
accounting autoload command may be listed as a<defunct>
process (this is because the parent process has died and left us in a zombie/orphaned state as explained here).
- Contact Novell support and ask for the latest iprint update compatible with PaperCut. It’s filed under TID 7004872
and MX511N
Upgrade
A warning dialog appears on the copier LCD when, for example, a copier panel is open. If the panel is left open for long enough then the user is logged out of the copier and the PaperCut card login screen appears under the warning dialog. On some Sharp models the PaperCut card login cannot be activated after this, even after the warning dialog disappears.
This appears to be a problem with the LCD window managers on some Sharp models and has been seen in the Sharp MX2610N and MX511N series.
A workaround is
- Enable username/password login as well as card login.
Update (2012–04–02): This is fixed in the following Sharp firmware updates
- MX2610/3110/3610N: 06.00.A1.j0
- MX4110/4111/4112/5110/5111/5112N: 06.00.R1.h0
- All Sharp firmware releases from this date onward will have this fix.
- C3350
- C3850
- C4750
We are working with Konica Minolta to resolve this issue. The issue has been escalated with Konica Minolta Japan.
As a temporary workaround enable auto job release on login.
Contact support for a build to remedy this situation.
EIP 1.5+
Upgrade
ERROR
ToshibaV2ExtDevice:207
- Encountered error: null
iPrint build
Symptoms:
- Jobs are identified in PaperCut under the wrong username.
- See Novell TID 7005753.
v3000
Apparently, that although the value for address 10 is displayed with the intended value, it is actually stored as blank. To correct the problem, one needs to change the address to the wrong value, save it, and then go back and set the correct value and re-save it. The value needs to be different in order for the change to be saved. This problem should be fixed in firmware updates after v3000.
Note that Toshiba SDK2 devices in PaperCut do not use SNMP traps and so this is issue is not relevant for them.
and 315
SDK2
Available
The solution is to run an older version of the firmware, such as 309 or 304. NOTE: If the device firmware is downgraded then the Toshiba technician must reinitialise the “Network Settings”. It has also been reported that v313 appears to be fine.
Chai
- Check you have a supported model. There is a complete list of supported models in the manual. Confusion often arises out of similar model names starting with and without the letter “M”. E.g. there is a model M4345 and another called just 4345 without the initial “M”. PaperCut only supports models starting with the letter “M”.
- Possible error message:
Package pc-hp.jar fails to load. Reason: java.lang.NoClassDefFoundError:
hp/laserjet/io/usbhost/USBDevice
- Possible error message:
- Perform an INITIALIZE DISK procedure. This is documented with the “Configuration Guide” manual as part of the official HP documentation for your device. This manual may only be available to HP service technicians. If you need assistance with the INITIALIZE DISK procedure please contact support.
- Possible error message:
Reason: com.hp.chai.soe.chaipackage.ChaiPackageException: Required package not available:
urn:com:hp:asa:auth:manager:authmanager
- Possible error message:
- Check you have the latest firmware on your device.
EIP 1.5+
Specifically, the Build Job and Sample Job buttons on the Job Assembly tab are disabled. In release 14.0, we have added a config parameter, ext-device.xerox.enable-preauth, which can be set to “N” to stop the job limit pre-authorization from happening and thus allowing Job Assembly. Also, the account charging has been fixed to work without job limits.
- Logon scripts that utilize the NWUSERNAME variable no longer work properly.
- PaperCut’s User Client is reporting the wrong username.
- Use the following command to set the variable:
SET NWUSERNAME = “%CN”
Existing installations are not affected.
It seems to be specific to certain models with certain firmware versions.
The message on the screen is:
Unable to unlock device for use, please try again.
The server log may contain the following message from the device:
error: 21 - Login Error
WC 58xx, WC 72xx
& CQ 93xx
EIP 1.5+
(Build 26241)
Some of the symptoms include:
- Delay before the user can log in (while a “cancel” button is shown)
- No response from printer when user’s card is swiped to login or logout (using various types of cards and card readers; Mifare, HID, etc)
- No response from Panel when Alternate Login button is selected for user to login
- No response from Panel when a network or Authentication Server failure has occurred
Types of evidence gathering include:
- Movie file that shows the issue
- Clone file of the printer with all boxes checked when creating the clone file
- Printer configuration sheet
Devices
App v1.2.1
This issue can occur with the application versions 1.1.1 and 1.2.0, particularly on Guildford series (40xx) devices. Please upgrade your PaperCut embedded application to the latest available version.
JBA/XSA
JBA/XSA
15.005.21.000
Xerox were made aware of the issue and has it has been addressed in firmware version: “15.005.21.000”.
We recommend customers upgrade their MFPs to device firmware version “15.005.21.000” (you may need to request this from Xerox).
Please log a ticket (http://support.papercut.com) if you continue to see issues after upgrade to the above firmware.
20.104.04.007
JBA/XSA
20.105.24.000
The symptoms of this problem are errors in the PaperCut device status and logs in one of the forms:
- “Missing CR” - (this is the most common error)
- “Unexpected end of file”
- “The Xerox device is not clearing/purging downloaded jobs.”
PaperCut is working with Xerox US support and affected customers to understand and resolve this issue.
Xerox have confirmed this issue and have raised an internal ticket to get this issue resolved. Xerox have now provided a SPAR firmware release to address this issue. Please upgrade the MFP to SPAR version v20.105.24.000 to resolve this issue. NOTE: Some customers report that you must also perform a “memory clear” from the device service menu after the firmware upgrade (seek the assistance of a Xerox technician).
If problems continue after this SPAR update is installed please report this to support.
Djemila Series
Greater Series
Update
SDK/J
This is an intermittent problem that can occur occasionally on some MFDs. When the problem occurs the only solution is to restart the MFD.
C654e
Available
Started (with errors)
Error: changeAuthenticationSetting: error=9, message=Fatal
If you see this error during setup, the advice from Konica Minolta is to contact your KM dealer to check that the following setting is configured:
SW Switch setting number 43:
Set to Bit Assignment 00000011 / Hex Assignment 03
Please note that this setting change is performed within the tech rep mode interface and may require the KM dealer to do this.
SDK/J
Ricoh has released an SDK update (10.18) and a firmware update (LCDC OpePanel 1.22) to address this.
EIP 1.5+
(Build 25126)
(Build 25126)
- This has been officially resolved version 13.5 (Build 25126)
v21124
Futuresmart
v19437
Futuresmart
v19902
Upgrade
On some newer devices with card reader enabled, the above welcome message by PaperCut get overwritten by “Place the IC Card on the Authentication Device”.
Please upgrade the firmware and enable “Function Level 7” on the device to resolve the problem. Please contact support if you need help with “Function Level 7”.
Issue History:
- 3rd March 2015 - Konica provides instructions to enable “Function Level 7” which will resolve this problem.
- 20th January 2014 - Konica has indicated they have plan to aim to release firmware fixes in February.
- 1st October 2013 - Konica is preparing a firmware update to resolve this issue. No ETA given yet.
- 09th September 2013 - Issue raised with Konica.
If you are seeing this issue we recommend making the following change:
- In the PaperCut admin interface, navigate to the Advanced Config tab of the device in question.
- Find the setting
hp.soap.inbound.use-ssl
. - Change the value to
N
and press Update.
The above config change may still need to be made if you have upgraded from a version prior to PaperCut 13.0.
& 23186)
EIP 1.5+
(Build 23214)
This problem is resolved in Release 13.3 Build 23214.
C36 & C42
Upgrade
setAccountMapConfiguration - Account Map Setting more than MAX support
We have analyzed these cases and determined that the issue is within the MFP firmware.
We worked with Konica Minolta to determine that this is an issue with the “OpenAPI 4.0” level firmware for these devices. The issue has been escalated with Konica Minolta Japan.
Konica Minolta have now released firmware to resolve this issue. Please contact Konica Minolta for updated firmware. The new firmware version for the C35 is A121-30G0-1604-AA (but this may vary by region and device).
Please contact Konica-Minolta for an updated firmware.
ArrayIndex...
appears in device status and prevents some functionality. 48.A1.01
error discussed below.
(Builds 23137 and 23186)
JBA/XSA
(Build 23214)
This problem is resolved in Release 13.3 Build 23214.
This worked correctly with previous versions of the scanner driver version.
PaperCut MF 13.4 contains a workaround for the situation — please refer to the manual under section 4.5, “Host-based authentication”.
Futuresmart
C364 & C224
Upgrade
Upgrade
- User logs into the PaperCut App on the device
- User releases jobs
- User logs out
- A second user attempts to login; after a significant delay “Cannot connect to server” will be displayed
Investigation by the involved reseller has determined that this issue can be resolved by deploying the latest “special” firmware from Konica Minolta to the affected C451 devices.
48.A1.01
error appears on device, device functions disabled. Futuresmart
- Rebooting the device.
- Resetting the device to factory default settings.
48.A1.01
error appears on device, device functions disabled. Futuresmart
The fix is included in the 14.1 release.
2H7_2F00.009.020 2010.04.15
Upgrading to the latest firmware will resolve this issue.
v2.xx.07.07
This security issue needs to be resolved at the firmware level and Samsung have confirmed a fix will be made available in the next firmware update.
If PaperCut is going to be installed in a security conscious environment, we do not recommend using these devices until a fix is provided.
Samsung have advised PaperCut Software that new firmware has been issued which resolves the problem described above, for the devices SCX-6546 NX and SCX-6555 NX. The firmware is v2.xx.07.07 or above.
This has been confirmed by Samsung as a bug in the firmware of the A4 device range. They are working on a solution and we will update this notice as Samsung inform us of progress on this issue.
&
(ampersand) character on Kyocera A4 devices. &
(ampersand) character.
We have found the problem which is a result of a firmware regression for this device. We have produced a workaround which will be made available in the PaperCut 12.2 release. Customers can contact support@papercut.com to receive an early update before the official release.
SDK/J
SDK/J
PaperCut developers have logged a Support request with Apple, for further clarification. We will continue to keep this known issue updated, and hope we can provide an Apple ID soon.
If your auto-update was disabled prior to 1.0.3741 no action is needed.
If you need to disable an auto update in 1.0.3741. You can work around it as follows:
- Open pc-mobility-print.conf file in PaperCut Mobility Print directory using a text editor
- In BOTH "ScheduledTasks" and "StartupTasks" sections, replace the links "https://mobility-print.papercut.com/client-version/v1/check-update/pc" with "https://mobility-print.NON-EXISTING-SERVER-999888777.com/client-version/v1/check-update/pc" (this internet address will fail to resolve every time the updater tries to check for updates).
- Save pc-mobility-print.conf file
- Restart Mobility Print server
Error:
Failed to connect to Mobility Print server. The installation will be terminated.
Workaround: Have the user removed the quote [ " ] character from their password, or change it to be the last character in the password field.
When printing specific documents, such as checks, print job scaling is approximately incorrect up to 3/16" / 4.7625mm.
For affected customers one workaround is to create a file "C:\Program Files (x86)\PaperCut Mobility Print\pc-spool-job.conf.user".
- Using a text editor, create the following file on the Mobility Print server: C:\Program Files (x86)\PaperCut Mobility Print\pc-spool-job.conf.user
- Open the configuration file and paste the following two lines into it to set the parameter "FitToPage" to "NO_FITTING":
- Save the file and restart the Mobility Print service.
[general] FitToPage='NO_FITTING'
If you're affected by this, please reach out to us directly at support.papercut.com.
We're investigating reports of jobs submitted from macOS clients resulting in the incorrect amount of copies being printed. This only applies to macOS and/or Linux systems as the issue looks to be specific to CUPS.
Thus far, we're only seeing this issue crop up on Mobility Print queues, that reside on the client device, configured with the "Generic PostScript Printer" PPD.
One workaround is to add EnableTransforms=off
to the end of the print-provider.conf
file located here on the server:
[app path]\providers\print\win
Once that's been done, you'll need to restart the Print Provider service. If any issues arise, we would recommend reverting that change.
Additionally, changing the PPD that the Mobility Print queues on the client are using prevents the issue. The easiest means of updating said PPDs is via Print Deploy.
Workaround:
Follow the guidance contained within our AntiVirus False Positive knowledge base article here.
Similar to blank output from photo app issue which was resolved in iOS 17.4.
1. Sometimes, some pages don't print. For example, when printing a 4 pages pdf file with a range for pages between 2 and 3 with 2in1, only page 3 is printed.
2. And sometimes any jobs don't print.
This was similar to MOB-2978 [Known Issue]
We have submitted the feedback to Apple about this known issue.
Cause:
Windows Defender's attack surface reduction rule, specifically "Block executable files from running unless they meet a prevalence, age, or trusted list criterion," is blocking certain Mobility Print binaries. The new code signing certificate is suspected to trigger this rule.
Symptoms:
The path detected was C:\Program Files (x86)\PaperCut Mobility Print\v2024-04-09-1113\mobility-print.exe but any binary in the v* folder structure could potentially be flagged.
Workaround:
Microsoft has documentation on how to create certificate indicators for Windows Defender: https://learn.microsoft.com/en-us/defender-endpoint/indicator-certificates?view=o365-worldwide#create-an-indicator-for-certificates-from-the-settings-page
The workaround is to disable Guest Printing and use a standalone Mobility Print server instead. Please contact the support team for details.
We have reported this to Apple developers and are awaiting a fix.
This has been confirmed as resolved in Apple's release of iOS 17.4.
We are currently investigating reports of printer discovery not working when using the DNS Discovery option, and using iOS 17 devices. mDNS and Known Host discovery methods continue to work successfully, and iOS 16 devices are still able to find printers advertised through DNS discovery.
Update 27th October, 2023
We have performed internal testing with the developer beta release of Apple iOS v17.2, and have observed that the devices now display Mobility Print printers published with DNS discovery mode. We expect this issue to be fully addressed once Apple publicly releases iOS 17.2.
Update 6th October, 2023
We have successfully recreated this on our iOS 17 devices, and compared the traffic behavior with iOS 16. We've confirmed that this issue is a result of a change Apple introduced in iOS 17 and that it is not something we can fix on our end. We've captured network traces and have sent this along with diagnostic info over to Apple for investigation.
While Apple investigates, consider another Mobility Print discovery method such as mDNS or Known Host if that will work in your environment. See configuring Mobility Print with Known Host (preferred) or configuring Mobility Print with mDNS.
Update 13th December, 2023
Apple released iOS 17.2 publicly yesterday, and our internal testing (and customer feedback) has confirmed that this resolves this issue.
Printing works successfully from an iOS 17 device through Mobility Print, however we have noticed that the job doesn't count towards the total 'Apple iOS' print jobs count - shown on the Mobility Print admin interface.
Please note that the print job does print successfully and does get tracked by PaperCut MF/NG (if used) in the expected way. Jobs from other iOS versions will still count successfully too.
We'll be looking to fix this in an upcoming version of Mobility Print.
We have found that the original credentials used for the first print are re-used, and it doesn't ask for credentials again.
We are looking to fix this in a future release of Mobility Print.
This results in a decoding issue with the printer capabilities TOML file and the affected queue is removed by the Mobility server.
Workaround: Removing the offending carriage return (or additional line of text) from the Comments field under printer properties will result in the affected queue reappearing in the Published printers list (you may need to refresh the Mobility admin page).
This may be the result of recent security policy changes in Google Workspace and steps should taken to confirm that the Mobility Chrome app has the required access controls to perform Oauth authentication for Google SSO.
Note that this process will require you to enter the following OAuth client ID for the Chrome app:
On the old Chrome extension, please use this ID:
480151528597-fqu9qacleoocel7v7csivja9qehg1llg.apps.googleusercontent.com
On the new Chrome extension, please use this ID:
89073488612-m55irqf3sqr6pmpnh5fimconmef04j97.apps.googleusercontent.com
1) From the Google Workspace Homepage, you need to navigate to: Security--->Access and Data Control--->API Controls
2) Click Manage Third-Party App Access
3) Click Add App and select Oauth App Name or Client ID
4) Paste the above Client ID in the text field and search
5) Select Papercut Mobility Print from the search results and click the check box next to it, then click Select
6) Choose the necessary OUs you want to configure access for and click Continue
7) Choose Trusted access to Google Data parameters, then select Continue
8) Review changes and click Finish
Note that this was fixed in Chrome App version 1.3.5
Firewall rule updates also required (see details)
Google Cloud IoT Core is scheduled to retire on 16 August 2023. We’ll be updating Mobility Print to v1.0.3552 in mid-July with a replacement for Cloud IoT Core so that users can continue to print remotely.
Please ensure that you are running Mobility Print version 1.0.3552 or later (once it is released) to continue using Mobility Print Cloud Print after this date - and ensure that if you have strict firewall rules in place, that these rules are updated for the new cloud notification replacement service.
See the Mobility Print - Cloud Print Update article for more information, and for the firewall rule updates required.
Please reach out to PaperCut support if you are experiencing this problem and quote MOB-2747. Please also include an example of the issue.
Two solutions reported by customers are:
Here is a list of all the executables in use that should be excluded in Cylance:
C:\Program Files\PaperCut NG or MF\server\bin\win\pc-server.exe
C:\Program Files\PaperCut NG or MF\providers\print\win\pc-print.exe
C:\Program Files (x86)\PaperCut Mobility Print\pc-mobility-print.exe
C:\Program Files (x86)\PaperCut Mobility Print\pc-updater.exe
We recommend restarting the Mobility Print server after these exceptions have been applied.
When selecting a printer from the printer options within iOS, the first time you select the printer, the paper size selection tab is missing. If you submit a print and then repeat the steps, the second time, the options is then available.
This could be an IPP issue where the "Get Printer Attributes" call doesn't get the data that is expected by iOS. This problem has been reproduced in iOS versions 16.1.1, 16.1.3 and 16.4.1. This could affect other iOS versions too.
We are investigating this issue. A workaround is available in Mobility Print 1.0.3631.
Workaround:
- Install Mobility Print in Known Host mode.
- Use /setup link on an Android device logged in with a managed account.
- Press Install or Update - this redirects the user to the Play Store.
- Download app - you won't be able to discover printers because the referral didn't pass the Known Host URL.
- Return to the /setup link again and press Install or Update again.
- You will be able to discover printers now.
We're looking to resolve this issue in an upcoming Mobility Print Android App release.
Workaround:
- Navigate to the Mobile Print Directory on the server and look for the latest version folder v2022-09-13-2238.
- In the latest folder, rename the pc-raw-spool-job to pc-raw-spool-job_OLD.
- Navigate back to the second to latest folder and copy out the same pc-raw-spool-job, then paste it into the latest folder.
- Restart the mobility print service, then resubmit a print.
Please note that this has now been resolved in Mobility Print version 1.0.3496.
You may see the error
mobility-print.exe: STDERR|runtime: out of memory: cannot allocate
in the Mobility Print logs.
Fix: Please update to Mobility Print Server version 1.0.3512.
Workaround: You are able to utilise up to 20 Mobility Servers in an environment, we would recommend implementing additional Mobility Servers and, if feasible, load balance them within your environment.
If you're using DNS-SD as your Mobility Print discovery method, please refer to the configure multiple print servers with windows DNS documentation.
It is advised to stay on Chrome 101 while this issue is investigated and further updates can be provided. Note: We have found in our internal testing that Chrome 103 (beta) appears to resolve this and works successfully.
There is also a Chromium bug report that we are tracking here with comments from other people's findings as the case develops.
Update 23 June: This issue is fixed in v103 and v104. The next M102 refresh will also contain this fix, and is scheduled for release in mid-July. A detailed description of the reported Chromium bug is provided below:
"This (issue) can happen if users have all printer types represented in their recent printers + system default printer, as such printers are pre-loaded at startup to populate the dropdown. Note the system default printer is a local/native printer. This bug previously did not manifest because users did not have an extension, privet, and cloud printer all in their recent destinations. However, with the removal of privet and cloud printer types, this bug could be triggered by simply having a recent extension printer + having a system default native printer."
When using Mobility Print Cloud Print, users are not able to send jobs from Windows/Mac clients. Mobility Cloud Print jobs are failing due to an incompatibility issue as a result of authentication tokens issued by Previous version of Mobility Server to the clients is not being recognised by the current Mobility Print server release 1.0.3436
WORKAROUND
In the meantime, we have a workaround available. You will need to reset the authorization token on the client system, copy the current auth.toml out of the folder below.
On Windows:
%USERPROFILE%\AppData\Local\PaperCutMobilityPrintClient\auth.tomlOn Mac:
/Users/userX/Library/Application Support/PaperCutMobilityPrintClient/auth.toml
Reboot the machine or restart the PaperCut Mobility Print Client service.
Submit a new print job to the Mobility Cloud printer. This would result in showing the authentication page. Please enter the valid user and password information. This should fix the the issue for you.
Please note: This will only impact BYOD Known-Host setups with Android 12 devices. Managed known host will not be impacted. Additionally, if the known host is already saved on the device, it will continue to work without any issues.
We'll be updating the app to use verified app links in the next version which will resolve this.
Workaround:
- On the Android 12 device, open Settings > App Defaults > Mobility Print
- Under 'Supported web addresses' add 'www.papercut.com' (or if it's already added, just make sure that the switch is set to 'Allow' next to 'www.papercut.com').
- Save the changes, and then re-visit the organization-specific Known Host setup URL for Android.
We're looking to resolve this issue in an upcoming Mobility Print Android App release.
Workarounds:
- Switch off the Private Relay feature while printing through Mobility Print.
- Use the Known Host method for print discovery instead.
This incident has been resolved.
Our understanding is that GCP incident 1xkAB1KmLrh5g3v9ZEZ7 caused temporary downtime with print job submission via Mobility Cloud Print.
What we know so far is that this can happen when:
The Mobility Print server is hosted on macOS. As far as we know, Mobility Print servers running on Windows have not encountered a similar problem.
It so far only happens when the printer is of certain Sharp models.
It only happens when the Find Me queue on the server has the Generic Postscript Driver.
The issue is caused by some minor incompatibility between the CUPS filters and the Generic Postscript Driver.
The Solution:
We recommend that when a Mobility Print server is running on a Mac, and that the printers are Sharp models, Sharp printer drivers are installed on the Find Me or Virtual queue to ensure correct parsing of media sizes.
We have had a number of customers reporting that users may not be able to discover printers when using Mobility Print with Chromebooks using Chrome version 91+.
We have been unable to recreate this internally, however investigations are continuing.
Potential workaround:
Some eagle-eyed customers using Managed Chromebooks have discovered that Google have switched off "Privet" as part of the Google Cloud Print decommissioning.
- A number of customers have found that re-enabling this has restored the ability to discover printers. The setting is available through "User & Browser Settings" > "Printing" then change
Deprecated privet printing
toEnable deprecated privet printing
. Our investigations have shown that Mobility Print does not rely on Privet - so we're focusing on other effects that Privet could be having on printers being discovered using this method. - Another customer has discovered that while the above setting alone did not work, setting the following did work, within Devices > Chrome > Settings > User and Browser Settings > Printing > Print preview default, and change from
Define the default print
toUse default print behavior
.
We've discovered that this appears to be a known issue with QuickBooks and printers with long printer names.
In this case, shortening the name of the printer published by the Mobility Print server resolves the issue:
- Rename the printer on the Mobility Print server to something less than 25 characters.
- (If you're using Mobility Print with PaperCut NG or MF, you'll need to rename the print queue at the OS level and rename the printer in PaperCut as detailed in the Rename a printer section of the manual).
- Once renamed, unpublish and republish the printer, then re-add the printer to the workstation.
Reports from customers online using QuickBooks with printers of any kind with long printer names have mentioned that they have also needed to delete the file QBPRINT.QBP in the QuickBooks ProgramData directory to clear the old long printer name. QuickBooks will recreate this file. There are also some guides that mention to make sure that the printer being used by QuickBooks does not have the word 'on' in the name.
Workaround:
Navigate to the required webpage.
Tap the aA icon in the address bar.
Choose Request Mobile Website.
This has now been resolved in the Android app version 1.2.3.
error printsys job with ID 123456 does not exist
error may show in the logs.When this occurs, users may not be able to discover the printers, or may not be able to print (the exact symptom and error will vary depending on how Mobility Print is set up and what device the end-user has), however in all cases with this issue the web interface of the Mobility Print server will be inaccessible.
When looking at the Mobility Print server logs, we see the error error printsys job with ID 123456 does not exist
moments before the logging stops.
This issue is still under investigation and we do not yet have a workaround. If you encounter behavior like this please submit a support ticket so that you can be notified as soon as we have an update. You will be asked to provide the logs from your Mobility Print server so we can confirm it is the same issue.
Update 17th March: We have pushed out a Mobility Print Server fix with version 1.0.3112 (all platforms) which we believe should resolve the issue with the Mobility Print Server (and the admin interface) becoming unresponsive. However, the error printsys job with ID 123456 does not exist
error may still happen, and will impact the print job mentioned in the error.
We are still investigating this issue.
We are working on creating a new version of the Android app with a fix for this issue.
This has now been resolved with the Android 1.2.2 app release.
Workaround: Disable authentication per job for each affected printer within Mobility Print.
Note that this has now been resolved in the auto-update of 1.0.3108.
WORKAROUND
Use a browser other than Chrome or manually edit the URL to http://[SITE-SERVER]:9163/client-setup/macos.html.
This has now been resolved in 1.0.3067
Workaround
Remove any special characters (such as forward slash, back slash or commas) from the printer queue location field.
Reinstall the cloud printers via the Mobility Cloud link.
Note: This will only happen if the user is logged into their Android device with a managed account (e.g. a work account or school account managed by an organization).
Note that this was related to issue PC-17580 - which has now been resolved for all cases apart from the case where someone is logged into their Android device with a managed account of some kind.
Workaround: Click the 'install' or 'update' link a second time, and the printers should then be discovered successfully.
Note that this has now been resolved - apart from one scenario where the issue can still happen if you're logged into the Android device with a managed account. See PC-17725 for more information.
Users may report this as no printers being displayed in the list when selecting File > Print.
This issue has been resolved via an update to the PaperCut Mobility Print Chrome App. The updated version is v1.0.246. This should be automatically updated on all ChromeOS clients.
For example, if you set the printer properties on the print server to Black and White, on the client device adding the printer it will be set as colour by default.
We have an open feature request to be able to have more control over the print queue defaults.
Workaround:
In a managed environment, there are two ways you can enforce these printing preferences:
- Use Print Deploy to roll out the Mobility Print print queues to Windows and Mac clients.
- Configure PaperCut NG/MF to force the preferences. You can do this using Print Scripting or via the Filters & Restrictions page.
We have raised this issue with Apple Support.
Mobility needs LPR in order to print on Linux.
Adding to the confusion, the version of LPR you get by running
sudo apt install lpr
doesn't support options (-o
) in the command string, so it also prevents a successful implementation.
In the Mobility logs, you will see something like this:
2018/08/03 16:27:48 mobility-print: STDOUT|==================================================
2018/08/03 16:27:48 mobility-print: STDOUT|stderr=Failed to print, error The command returned with error, usage: lpr [cdfghlmnpqrstv] [#num] [-1234 font] [-C class] [-i [numcols]]
2018/08/03 16:27:48 mobility-print: STDOUT| [-J job] [-Pprinter] [-T title] [-U user] [-wnum] [name ...]
2018/08/03 16:27:48 mobility-print: STDOUT|: exit status 1
2018/08/03 16:27:48 mobility-print: STDOUT|
2018/08/03 16:27:48 mobility-print: STDOUT|==================================================
2018/08/03 16:27:48 mobility-print: STDOUT| {"src":"spooler.go:161"}
The fix is to install the CUPS BSD commands package, which includes a version of LPR that supports options:
sudo apt install cups-bsd
We have had reports that checkboxes on interactive PDFs will be distorted or missing.
This is now fixed in Mobility Print version 1.0.2417.
One of the options to workaround this is to remove the space from the password. Another option that we have found out is that you could use quotes around the space for the password to work. For example: Pass” “word
This is now fixed in Mobility Print version 1.0.2417.
Good news is that we fixed this in Mobility Print server version 1.0.2137 and the Chromebook client has been updated so the “Sign in with Google” button will continue to function.
Customers who have disabled auto update on their Mobility Print servers will have to manually upgrade their server to version 1.0.2137 as soon as possible and no later than March 6th 2019. This is also documented in the Mobility Print Release History.
How to Identify the issue: Check within the Windows Event Viewer logs under PrintService on the Windows workstation for error messages regarding EventID: 511, Task Category: Initializing a print provider, General Information: The print spooler failed to load print provider inetpp.dll.INACTIVE. This can occur because of system instability or a lack of system resources.
Findings and workaround: iPrint / Novell client changes the value of the registry key for the HTTP Print Service
(HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Control\Print\Providers\Internet Print Provider)
and sets the DLL name to inetpp.dll.INACTIVE. When changed to inetpp.dll the issue is resolved.PaperCut are currently looking into adding a flag to check when this registry key isn’t correct and show an unsuccessful message on install and then be inserted into the Mobility Client Logs as an error. We will attempt to look into a longer term fix.
(MOB-1747)
This is due to these sizes not being standard Windows paper sizes. A0 and A1 are in-fact given to us by the driver, but set as custom paper sizes.
Mobility Server
1.0.2841
The issue normally occurs when using the macOS generic PostScript Driver but can affect other drivers.
With v1.0.2304, it is now possible to configure the iOSAutoRotate option to resolve the issue:
- Install a macOS Mobility Print Server ≥ 1.0.2304.
- Edit the
pc-mobility-print.conf
file. - Add
features=iOSAutoRotate&rdquo
in the Args array within the Services section. - Restart the Mobility Print service.
- Send the landscape document via iOS onto a Mobility Print queue.
Why is this not enabled by default?
There is a process used to detect the page dimensions of the document - which we then use to infer the orientation. Unfortunately, this process requires reading the whole document into memory. This can be problematic if there are multiple big jobs from iOS clients being sent to the server.
Confirmed resolution for this has been to Install a package called iptables-services on the Mobility Linux box by doing the following;
- yum install iptables-services
- launch DNSTASKS scripts (/opt/papercut/pc-mobility-print/dnstasks)
- service iptables save (saving iptables rules)
- chkconfig iptables on (enable iptables after reboot)
There is a workaround available for now until we get this released. Please reach out to us via support.papercut.com. This issue involves a fix within Mobility Print and PaperCut NG/MF. This will be fixed in v18.1.3 which hasn’t been released yet, we’ll keep this page to date soon as it’s available.
v. 67.0.3396.0
A workaround is to install the Chrome app into your Chrome browser and print using the printers discovered via this app instead of the windows print queues.
This has now been fixed in Chrome version 67.0.3396.0 (currently available in Google ‘Canary’ - waiting for Google to release in the ‘Production’ updates to Chrome). See this Chromium bug report for details.
Mobility Print 1.0.1757
This occurs when the default color preference is set on the print driver, then print jobs sent through Mobility Print will print as the driver’s color default regardless of what the users select. This occurs with the Konica Minolta C364Series PCL driver, Konica Minolta C368Series PCL driver, Konica Minolta C287Series, Fuji Xerox AP VI C4471 PCL driver and the Kyocera KX driver. Check out the Mobility Print release history page to see the fix versions for each of these print drivers: https://www.papercut.com/products/ng/mobility-print/manual/release-history/
If you encounter this issue with any print drivers, there are a set of files from Mobility Print that we’ll need to troubleshoot this. Follow the steps here to collect for us and then reach out via PaperCut support with the files.
There is a workaround:
1. Press the CMD+P buttons or click “File” > “Print” to open the print dialog box
2. In the print dialog box, click the drop-down menu in the bottom left-hand corner and select “Open PDF in Preview”
3. The document will open in Preview
a. Press print in the lower right-hand corner
b. Check the “B & W” box
c. Print the document
4. Release the document on a print release station
If you encounter this issue, please contact PaperCut support.
To fix this issue, there is a print driver setting to change. Check out the following knowledge base article for the steps to resolve.
Fixed in Mobility Print v1.0.840.
The behavior is best explained through an example, and this can be experienced without the need for any PaperCut products to be installed - this happens at the CUPS level with manufacturer drivers.
Example:
- Setup: Customer sets up library-grayscale and library-color print queues. The default settings include 'print in color' disabled for the library-grayscale printer, and 'print in color' enabled for the library-color printer.
- Test: Customer prints document 1 to library-grayscale. The document prints grayscale. Print to the library-color print queue, and ensure that color is enabled. The document prints (incorrectly) in grayscale. Print to the library-color print queue again, ensuring that color is enabled. The document prints (correctly) in color.
What appears to be happening is that CUPS retains the default setting used in the last print job - so in the example above the second job prints incorrectly in grayscale, because the previously printed job was grayscale. The third print job sent to the color queue prints correctly in color because the previous job was set to color.
We will update this Known Issue as and when we discover more information. In the meantime a suggested workaround is to promote black and white printing (PaperCut Pocket and Hive) or suggest that users print in grayscale through print scripting (PaperCut NG and MF). In this workaround users can print documents in color and then choose to convert selected documents to grayscale / black and white.
We have had a number of reports of print jobs that have previously been marked as "Printed", are changing to a "Cancelled" state days later.
Resolution:
At this time the issue is still being investigated by the development team. We believe the "Cancelled" may come at the customers set "Job Expiry" time, from after the job was marked as "Printed". However the issue has only been seen for a few customers so far.
Workaround:
This is primarily a logging time sync error. As the job was marked as "Printed", it will show up in reporting correctly, however in the admin UI it will show as "Cancelled".
Customers who have onboarded to PaperCut Hive or Pocket from July 2024 onwards will not see scan and copy data in the "Usage over time" trends chart in the admin UI. This is displayed at the top of the home page for the admin UI.
Resolution:
The team are working on a fix, there is no available workaround at this time.
When checking the Activity Log in the admin console, you will see - The "serviced-office-billing-basic-v1" addon failed to perform "printjobs".Error: fatal_error"
Downloading reporting's manually is functioning correctly.
The Development team is actively investigating the api and this known issue will be updated when we have more information.
Issue:
Unable to log in to PaperCut Hive or Pocket with the following error(s):
"Different account type - To continue, log in with an account and login method you've used before. Learn more about different account types"
Reason for issue:
The Google Identity Platform does not support account linking in some scenarios. The known scenarios so far are:
- If you previously signed up with "Continue with Microsoft", and used the "Personal account" setting, you cannot now use the "Work or school account" option. You MUST continue to use the "Personal account" setting.
- Another example is - If you previously signed up with the "Email & password" option, you cannot now link the account via a Microsoft 0Auth connection.
- If you signed up as an administrator with a Microsoft "personal account", then are invited as a user and sign up with "work or school account". This will fail as the email for the administrator account is linked to the "personal account".
Workaround:
If you wish to login via a different method, you must remove both admin and user for the required email address. Once re-invited you will be able to sign-up with your chosen method.
Description: Users are experiencing access denied errors, particularly with the pc-pdl-analyser.exe binary and other binaries. Installation of PaperCut is being blocked for some customers.
Symptoms:
- Users are experiencing access denied errors, particularly with the pc-pdl-analyser.exe binary and other binaries.
- Installation of PaperCut is being blocked for some customers.
Cause:
Windows Defender's attack surface reduction rule, specifically "Block executable files from running unless they meet a prevalence, age, or trusted list criterion," is blocking certain PaperCut binaries. The new code signing certificate is suspected to trigger this rule.
Workaround:
Add an exclusion policy based on the binary code signing certificate (which can be extracted from any of the blocked binaries) or add a policy to the edge node folder.
Status:
- PaperCut has been in contact with Microsoft to add exceptions for our PaperCut certificate, however, the recommendation from Microsoft:
- Is for PaperCut customers to submit a .cab log file to PaperCut which will be forwarded to Microsoft.
- There are reports that there are less issues with Windows Defender where it has been automatically allowing our binaries over time.
An error occurred printing this document
.An error occurred printing this document
.
This happens when printing from the iOS device itself. Printing from a laptop or desktop continues to work successfully. Releasing the job (printed from a non-iOS17 device or from a laptop/desktop) works successfully in the app.
We've tested an Edge Node fix which we hope will be released publicly within a few days, to resolve this issue.
Please note that this has now been resolved with Edge Node version 2023-09-19-0811.
We have recieved multiple reports of the iOS application crashing to home screen as soon as it has been opened.
We have so far confirmed the devices effected have been running iOS version 16.5.1(c) or newer.
This is not effecting all devices running these versions.
Workaround
So far, almost all cases of this issue have been resolved by performing a hard restart of the device, and then re-installing the Mobile Application.
If re-installing has not fixed the issue on your device, please may you log a ticket at support.papercut.com by selecting "SUBMIT A TICKET" at the top of the page. Please provide the exact version of iOS that your device is running, and quote "CCEM-2246".
Fix
Development have begun investigating the cause of the crashes, and we are working on a fixed version of the App.
Update (19th Sept 2023):
App version 1.7.0 was released last night which disables the PaperCut Pocket/Hive app notifications as part of troubleshooting this issue.
Update (2nd Oct 2023):
App version 1.8.0 was released today which re-enables the PaperCut Pocket/Hive app notifications. However we don't expect this to alter the crashing-behavior at this point. Investigations are still continuing.
The otool requirement was removed from the queue cloner in July 2023
The cloner tool requires a working version of the otool library on MacOS.
The logs will identify this issue with a message such as:
Failed to clone: error while cloning print queues: collect drivers: failed to collect printer driver
To resolve, run:
xcode-select --install
in the Terminal (on the Mac where the manufacturer driver was installed and configured).
If the above does not resolve the issue, run:
xcode-select --reset
in the Terminal (on the Mac where the manufacturer driver was installed and configured).
These modern Huawei phones only have access to the “AppGallery”, which is a separate App Store not currently supported by PaperCut.
Therefore, at this time you will be unable to use our Mobile App on these devices.
We are currently tracking affected customers for this under "PFR-649". If you are affected by this limitation, please open a ticket with Support quoting this tracking identifier, "PFR-649".
We have found a potential bug in the most recent edge node version where the edge node service is unable to create a thumbnail for a print job. We are in the early stages of investigation.
This appears to be effecting both Windows & Mac. Through early testing we have determined that with Windows this appears to only effect the PaperCut Printer when the driver is NOT the PaperCut Global PS Driver. With Mac it appears to effect all drivers. This is subject to change as more investigation is required.
You can determine if this is the issue by searching for the Job ID in the Edge Node logs, and looking for the following line:
Windows:
2023/03/30 09:34:14 pc-printjob-spooler.exe: STDOUT|ERROR: failed to generate thumbnail from "data\\job-spooler\\print-jobs\\Mg4VYKmQ1k\\CryIX4ShrwQSiUjC-20230330083414-c-job.data.pdf" for job "CryIX4ShrwQSiUjC-20230330083414-c-job" err Unsupported file format application/binary {"src":"joblifecyclehooks.go:128"}
Mac:
2023/03/30 14:29:46 pc-printjob-spooler: STDOUT|ERROR: failed to generate thumbnail from "data/job-spooler/print-jobs/GRxCxPTKIT/6wwgXvQP2G5sk1I2-20230330132945-c-job.data.pdf" for job "6wwgXvQP2G5sk1I2-20230330132945-c-job" err pdf2image execution error: exitStatus=1 err=exit status 1
This issue has been raised with Development and will be investigated ASAP.
When printing via PaperCut Pocket or Hive on Macs via Queue with some drivers, the number of copies can become squared (4 copies will become 16 and so on).
Workaround currently is to switch to IPP printing.
We are actively working on a fix for this issue.
PaperCut will have installed and be working correctly in these cases. The error is a false-alarm.
Resolution is to use newer versions of Windows or Windows Server, or disregard the message.
Windows 8 is already end-of life (please see our System Requirements page for the currently supported platforms), and Server 2012 R2 will be officially ending support from Microsoft later this year.
If you are running into an issue where jobs are showing as zero pages in the Job Log, or are stuck showing as analyzing on the mobile app, you may be running into an issue with the latest edge node version (2023-01-12-2301).
You can confirm this by opening the job trace in the admin UI, and looking for the following error under the first edge node in the logs
failed submit job report for job "xxxxxxxxxxxxxxxx-c-job" err message queue is terminated, cannot enqueue event.
Temp Workaround: The edge node in the job trace displaying this error needs to be restarted. The message queue is unable to clear itself. Once this edge node is restarted, it will start to publish its job analysis correctly to the Cloud.
Solution: We will be releasing a new edge node build as soon as possible to fix the issue permanently.
We have released a new edge node update - 2023-01-16-1453. As an admin, you can use the "Update Now" on the Edge Mesh page of the Admin UI to force an edge node to update. Edge nodes will automatically update over the next 24 hours (16.1.23 15:53 GMT).
Please note that another edge node has gone out that has a number of extra fixes for this error. 2023-01-17-1050
NTAG215
NFC sticker/tags on Huawei devices.Huawei devices do not have access to the Google Play Store, and therefore do not support the PaperCut Pocket & Hive phone app
PaperCut Android release app fails to write to
NTAG215 NFC
sticker/tags on Huawei devices.
Workaround
Our native release app writes the NFC URL displayed on the
Details
tab when you select a printer.
Copy the
NFC URL
and write it to the tag using the NFC Tools Android Application downloadable from the Google Play store.
We have opened a support case with Huawei to ask them to address the issue with their underlying library project NFC writing service.
Quick Scan Icons are also not displaying on:
Sharp embedded
in beta
(OSA 5.1+ and n2.0 browser required)Ricoh embedded
in beta
(Smart SDK 2.12 or above required)An investigation into the cause of this issue is ongoing.
MIUI Global 12
com.google.android.printservice.recommendation
service fails to recommend printers when attempting to print from applications such as Gallery & File Manager.This issue affects printer recommendations of all types and is not inclusive to the PaperCut Printer.
Workaround:This only impacts printing from the Gallery and File Manager applications. Printing from Gmail / Chrome / Google Drive etc all work ok. Furthermore, with these particular applications if you scroll past the initial 'share to' feature and scroll along the bottom options until you find the 'Print' option, this method of printing continues to work (and finds the printers successfully) as normal:

In the meantime, we have opened a support case with Xiaomi to address the issue with their
com.google.android.printservice.recommendation
printer recommendation service.
This issue is limited to Ricoh printers only, and only a subset of those (however we don't have a firm list of those impacted). It will also only happen if the printing method in use is IPP.
By default, we use the “local queue delivery” method, so this will only impact customers who don't have a local queue set up or have manually changed the delivery method to IPP.
WORKAROUND:
Create a print queue which can access the device, and change the priority order in Hive to preference queues over IPP (head into Manage > Printers > [select the printer] > Advanced > Print Delivery > Custom > Primary Delivery Method > [select Local queue delivery]).
The behavior is best explained through an example, and this can be experienced without the need for any PaperCut products to be installed - this happens at the CUPS level with manufacturer drivers.
Example:
- Setup: Customer sets up library-grayscale and library-color print queues. The default settings include 'print in color' disabled for the library-grayscale printer, and 'print in color' enabled for the library-color printer.
- Test: Customer prints document 1 to library-grayscale. The document prints grayscale. Print to the library-color print queue, and ensure that color is enabled. The document prints (incorrectly) in grayscale. Print to the library-color print queue again, ensuring that color is enabled. The document prints (correctly) in color.
What appears to be happening is that CUPS retains the default setting used in the last print job - so in the example above the second job prints incorrectly in grayscale, because the previously printed job was grayscale. The third print job sent to the color queue prints correctly in color because the previous job was set to color.
We will update this Known Issue as and when we discover more information. In the meantime a suggested workaround is to promote black and white printing (PaperCut Pocket and Hive) or suggest that users print in grayscale through print scripting (PaperCut NG and MF). In this workaround users can print documents in color and then choose to convert selected documents to grayscale / black and white.
We have had a number of reports of print jobs that have previously been marked as "Printed", are changing to a "Cancelled" state days later.
Resolution:
At this time the issue is still being investigated by the development team. We believe the "Cancelled" may come at the customers set "Job Expiry" time, from after the job was marked as "Printed". However the issue has only been seen for a few customers so far.
Workaround:
This is primarily a logging time sync error. As the job was marked as "Printed", it will show up in reporting correctly, however in the admin UI it will show as "Cancelled".
Customers who have onboarded to PaperCut Hive or Pocket from July 2024 onwards will not see scan and copy data in the "Usage over time" trends chart in the admin UI. This is displayed at the top of the home page for the admin UI.
Resolution:
The team are working on a fix, there is no available workaround at this time.
When checking the Activity Log in the admin console, you will see - The "serviced-office-billing-basic-v1" addon failed to perform "printjobs".Error: fatal_error"
Downloading reporting's manually is functioning correctly.
The Development team is actively investigating the api and this known issue will be updated when we have more information.
Issue:
Unable to log in to PaperCut Hive or Pocket with the following error(s):
"Different account type - To continue, log in with an account and login method you've used before. Learn more about different account types"
Reason for issue:
The Google Identity Platform does not support account linking in some scenarios. The known scenarios so far are:
- If you previously signed up with "Continue with Microsoft", and used the "Personal account" setting, you cannot now use the "Work or school account" option. You MUST continue to use the "Personal account" setting.
- Another example is - If you previously signed up with the "Email & password" option, you cannot now link the account via a Microsoft 0Auth connection.
- If you signed up as an administrator with a Microsoft "personal account", then are invited as a user and sign up with "work or school account". This will fail as the email for the administrator account is linked to the "personal account".
Workaround:
If you wish to login via a different method, you must remove both admin and user for the required email address. Once re-invited you will be able to sign-up with your chosen method.
RESOLVED 11/11/24
Description: When an admin creates and then deletes a print delivery profile in the admin console, all printer information, including printer stats, disappears for all printers.
Symptoms:
- Missing printer stats for previously configured printers.
- Inability to view printer supplies information.
- Missing printer make and model details.
Cause:
Deleting a print delivery profile currently causes all associated printer data to be removed from the admin console. This impacts printer-related stats and configuration details.
Workaround:
Update: If you are experiencing missing information from your printers, go to the "Newly Discovered" tab in the Printers page, and add these as new printers then you can "merge" the printers. This will allow printing to continue.
Status:
- We are actively working to restore data for affected printers.
- A critical fix to prevent data loss from profile deletions is in progress, and the “Delete” button has been temporarily removed from the admin console.
Upon selecting "Quick Scan" or "Device Functions > PaperCut" , the app gets stuck on the "Connecting to server..." message for an extended period, often resulting in errors like "Failed to retrieve the scan action" or "Oops! Something went wrong. Try again.” This issue only occurs after a cardswipe and is caused by extended javascript functions failing to execute in certain Chromium browser versions.
How to tell if the issue is related to CDSS-4434:
1. Chromium Browser version is 1.1
1. This issue is seen with devices with Chromium Browser 1.1
To check the device’s browser version: Login to the device > Press “Web Browser” > Press “Menu” > Help.
The browser information is displayed.
2. Restart the device, perform a card login. Click on “Device Functions” . Launch PaperCut Hive from the Device Functions screen. There will be a very significant delay launching the PaperCut Hive app using these steps. You will notice "Connecting to Server" for a minute or so, and then the screen goes back to the login screen or back to the Hive screen with the "Oops! Something went wrong" message.
Workaround: If your browser is Chromium 1.1. and the you are able to verify that the application doesn’t launch via Device Functions, it is most likely your issue is related to CDSS-4434.
A workaround is available, please reach out to use by tagging CDSS-4434, mentioning you need the config key workaround enabled for your organisation.
Symptoms:
The Toner Forecast is including ignored printers in the toner usage forecast, leading to overestimation. As a result, it suggests ordering more toner than suggested.
Cause:
Ignored printers are not being properly removed from the system's inventory, causing them to be included in the toner usage calculations.
Workaround:
When calculating your toner forecast for a make and model, be mindful to exclude the name of the printer you have ignored in the Printers page.
Status:
Pending a system update to automatically recognize and exclude ignored printers from the toner usage forecast.
Description: Users are experiencing access denied errors, particularly with the pc-pdl-analyser.exe binary and other binaries. Installation of PaperCut is being blocked for some customers.
Symptoms:
- Users are experiencing access denied errors, particularly with the pc-pdl-analyser.exe binary and other binaries.
- Installation of PaperCut is being blocked for some customers.
Cause:
Windows Defender's attack surface reduction rule, specifically "Block executable files from running unless they meet a prevalence, age, or trusted list criterion," is blocking certain PaperCut binaries. The new code signing certificate is suspected to trigger this rule.
Workaround:
Add an exclusion policy based on the binary code signing certificate (which can be extracted from any of the blocked binaries) or add a policy to the edge node folder.
Status:
- PaperCut has been in contact with Microsoft to add exceptions for our PaperCut certificate, however, the recommendation from Microsoft:
- Is for PaperCut customers to submit a .cab log file to PaperCut which will be forwarded to Microsoft.
- There are reports that there are less issues with Windows Defender where it has been automatically allowing our binaries over time.
Description: In certain scenarios, users on Mac OS 14.4 and above may experience a delay in the initiation of direct print tracking immediately after installation or following the addition of a new print queue. Print jobs may take 30-60 minutes to commence being tracked.
Symptoms:
- Direct print tracking does not start immediately after the Pocket/Hive installation or the installation of a new print queue on Mac OS 14.4 and above.
- Print jobs may not be tracked for the initial 30-60 minutes post-installation.
Cause:
The delay in direct print tracking is primarily from a recent MacOS 14.4 change.
Workaround:
While a comprehensive solution is under development, users encountering this issue on Mac OS 14.4 and above can implement the following workaround:
- Manually restart the CUPS service after the installation to expedite the cache flushing and
printers.conf
reloading process.
Status:
The development team is actively investigating and working to identify a permanent solution for the delayed direct print tracking on Mac OS 14.4 and above. Regular updates will be provided as progress is made towards resolving this issue. Users on Mac OS 14.4 and above are encouraged to stay informed about the status of this known issue.
Issue Description:
Users may encounter disruptions in iOS printing functionality within the PaperCut environment due to the expiration of certificates for iOS profiles. This issue may result in various symptoms, impacting the seamless printing experience for affected users.
Symptoms:
- Print Jobs Not Displayed: Users may observe that print jobs sent to the PaperCut Printer from their iPhone do not appear on the mobile app or the MFD (Multi-Functional Device) screen during document release.
- Missing PaperCut Printer: The PaperCut Printer may not be visible on the iPhone as a selectable printer option due to the expiration of certificates.
- Warning Messages: Users may receive warning messages indicating that the certificate associated with the iOS profile has expired.
Indications of an Expired iOS Profile:
Navigate to Settings -> General -> VPN & Device Management, and press PaperCut Printer Setup to check the certificate expiry.
Solution to fix printing for iOS iPhones
To resolve this issue, follow the steps below:
Removing the old profile to install a new profile
- Navigate to Settings on your iPhone.
- Go to General.
- Select VPN & Device Management.
- Under Configuration Profile, locate "PaperCut Printer Setup" (refer to the provided screenshot).
- Tap on "PaperCut Printer Setup" and then choose "Remove profile."
After removing the old profile, you can add the new profile by doing the following:
Steps for a New Profile
- Open your PaperCut Pocket/Hive mobile app.
- Click the banner presented or navigate to the top-right-hand avatar.
- Look for the “Print from this Phone? Install Profile” option.
- Follow the prompts to reinstall the new profile.
Description: In certain scenarios, users may encounter issues with the deployment of queues and drivers on Windows 11 devices. This issue manifests as a failure to deploy queues and drivers to specific Windows 11 devices.
Symptoms:
- Queues and drivers may not be deployed to some Windows 11 devices as intended.
- Some users may receive the printers, whilst some may not.
- Deployment failures might be sporadic, impacting specific devices while others remain unaffected.
- An additional symptom includes the "failed to get host OS info..." error appearing in the edge node logs.
Cause: This known issue is primarily attributed to the deprecation of a Microsoft tool, which serves as the root cause for the observed problems.
Workaround: While a solution is under development, users encountering this issue can manually install queues and drivers on affected devices and point the port to http://localhost:9265/printers/papercutpocket to resolve the "failed to get host OS info..." error in the edge node logs.
Status: This issue is recognized by the development team, and active efforts are being made to identify and address the underlying cause.
This is the same as with another of our products, Mobility Print, as seen in this Known Issue
At this time the change lies with Apple, though we are investigating if we are able to resolve ourselves.
Symantec made changes to their product in January 2024 which resolved the issue.
We have received multiple reports of some Hive user invite emails being marked as spam. We have so far confirmed that only User Invite Emails sent in the US region is impacted. This is not affecting Emails in the EU, UK, and AU regions. The issue is mitigated with a temporary solution though some User Invite emails may still be marked as spam. We have identified that Message Labs (Symantec) have blocked the Hive User Invite emails and have contacted them to review. Investigations are ongoing and we will update here as soon as we know more
An error occurred printing this document
.An error occurred printing this document
.
This happens when printing from the iOS device itself. Printing from a laptop or desktop continues to work successfully. Releasing the job (printed from a non-iOS17 device or from a laptop/desktop) works successfully in the app.
We've tested an Edge Node fix which we hope will be released publicly within a few days, to resolve this issue.
Please note that this has now been resolved with Edge Node version 2023-09-19-0811.
If you are performing a Quick Scan action and the email destination has an apostrophe in the email, you will be unable to start the scan as the email will not be seen as valid.
Effected Devices:
All devices running the latest bEST certified embedded for KM on the US data center (Version 2.0.2 or earlier) are effected by this. Devices on the AU data center running an updated embedded (3.0.3) are NOT effected.
Fix Time frame:
At this time we are aiming to have the embedded bEST certified for the US data center in November 2023. As new data center's are added, they will come with the updated embedded version.
We have recieved multiple reports of the iOS application crashing to home screen as soon as it has been opened.
We have so far confirmed the devices effected have been running iOS version 16.5.1(c) or newer.
This is not effecting all devices running these versions.
Workaround
So far, almost all cases of this issue have been resolved by performing a hard restart of the device, and then re-installing the Mobile Application.
If re-installing has not fixed the issue on your device, please may you log a ticket at support.papercut.com by selecting "SUBMIT A TICKET" at the top of the page. Please provide the exact version of iOS that your device is running, and quote "CCEM-2246".
Fix
Development have begun investigating the cause of the crashes, and we are working on a fixed version of the App.
Update (19th Sept 2023):
App version 1.7.0 was released last night which disables the PaperCut Pocket/Hive app notifications as part of troubleshooting this issue.
Update (2nd Oct 2023):
App version 1.8.0 was released today which re-enables the PaperCut Pocket/Hive app notifications. However we don't expect this to alter the crashing-behavior at this point. Investigations are still continuing.
9100 RAW printing is now available for all PaperCut Pocket/Hive Customers. This is a new delivery method, that uses the printer's 9100 port instead of IPP. This has proven to increase reliability, and Kyocera KX Driver settings will provide consistent output.
If you are deploying a Kyocera KX Driver via the "Queues & Drivers" tab within Pocket & Hive, you may find inconsistent results with the following:
The duplex setting not being honoured.
Finishing options not being applied correctly.
After investigation we have found this to be an incompatibility between Kyocera drivers and our IPP delivery method.
Our investigation is still ongoing, however the initial findings are that any fixes we apply have a good chance of causing issues with other printer manufacturer's drivers, therefore we have created a short term and medium term workaround:
Short Term - If you require advanced features from the Kyocera driver, then set the delivery method of your Kyocera printer to "Local Queue Delivery " and make sure you have reliable release queues setup, preferably hosted on a Super Node.
Medium Term - Coming later in 2023 is direct printing via port 9100 in Pocket & Hive, which will be an additional third delivery method alongside the existing options of Local Queue Delivery & IPP. This will leverage the power of the manufacturer driver deployed via the "Queues & Drivers" tab to release a print job via port 9100 directly to the printer.
A fix is now underway
Known Issue: Print Job Misdirection due to Shared IP Address
Description:
When multiple printers on a network share the same IP address, a known issue arises where print jobs may be unintentionally released to the wrong printer. This occurs due to the inability of the network to distinguish between the printers with identical IP addresses. Consequently, users may experience instances where their printouts end up in the wrong physical printer, leading to confusion, privacy concerns, and potential delays in retrieving important documents.
Impact:
The impact of this known issue can vary depending on the environment and usage scenario. In an office setting, it can disrupt workflow efficiency as confidential documents may be printed and left unattended at unintended printers, leading to potential data breaches or unauthorized access. In shared printer environments, such as libraries or educational institutions, printouts can end up in the hands of the wrong individuals, compromising data privacy and confidentiality.
Workaround:
To mitigate this issue, it is crucial to ensure that each printer connected to the network has a unique IP address. This can be achieved by assigning individual IP addresses manually through the printer's settings or by using a DHCP server that dynamically assigns IP addresses to devices. By implementing distinct IP addresses for each printer, the network can accurately route print jobs to their intended destinations, reducing the risk of misdirect
As of 2024, we now automatically send the user a new email invite and notify them to check their inbox.
Known Issue: Inability to Relink Mobile App Due to Expired Invitation Email
Description for administrators:
When users are prompted to relink their mobile app, they may encounter a problem where their invitation email has expired, preventing them from successfully completing the relinking process. As a result, users are unable to establish a connection between their email and mobile phone.
Workaround for users:
To resolve this issue, users can follow the steps below:
- Contact the administrator or responsible party to request a new invitation email.
- Once the new invitation email is received, carefully read its content and follow the provided instructions.
- Proceed with relinking your email to your mobile phone by following the prompts outlined in the new invitation email.
- Ensure that all necessary steps are completed to relink the mobile app.
By obtaining a fresh invitation email, users will be able to relink their mobile app without any issues.
The otool requirement was removed from the queue cloner in July 2023
The cloner tool requires a working version of the otool library on MacOS.
The logs will identify this issue with a message such as:
Failed to clone: error while cloning print queues: collect drivers: failed to collect printer driver
To resolve, run:
xcode-select --install
in the Terminal (on the Mac where the manufacturer driver was installed and configured).
If the above does not resolve the issue, run:
xcode-select --reset
in the Terminal (on the Mac where the manufacturer driver was installed and configured).
These modern Huawei phones only have access to the “AppGallery”, which is a separate App Store not currently supported by PaperCut.
Therefore, at this time you will be unable to use our Mobile App on these devices.
We are currently tracking affected customers for this under "PFR-649". If you are affected by this limitation, please open a ticket with Support quoting this tracking identifier, "PFR-649".
We have received no reports of this re-occurring since March 2023.
In some cases a colour document may end up being reported in the Pocket/Hive Job Log as B&W even when it was submitted and printed in colour. This issue is being investigated.
This was resolved with changes in the cloud for most OEMs. Ricoh was resolved in version 1.10
If a user has a synced email address which contains capital letters, or you try and use an email address containing capital letters, the user will be unable to scan to email. They will receive an 'Oops' error message stating: "“Scan job cannot be started. Oops, wrong format in To. Enter a valid email address.”
We have found a potential bug in the most recent edge node version where the edge node service is unable to create a thumbnail for a print job. We are in the early stages of investigation.
This appears to be effecting both Windows & Mac. Through early testing we have determined that with Windows this appears to only effect the PaperCut Printer when the driver is NOT the PaperCut Global PS Driver. With Mac it appears to effect all drivers. This is subject to change as more investigation is required.
You can determine if this is the issue by searching for the Job ID in the Edge Node logs, and looking for the following line:
Windows:
2023/03/30 09:34:14 pc-printjob-spooler.exe: STDOUT|ERROR: failed to generate thumbnail from "data\\job-spooler\\print-jobs\\Mg4VYKmQ1k\\CryIX4ShrwQSiUjC-20230330083414-c-job.data.pdf" for job "CryIX4ShrwQSiUjC-20230330083414-c-job" err Unsupported file format application/binary {"src":"joblifecyclehooks.go:128"}
Mac:
2023/03/30 14:29:46 pc-printjob-spooler: STDOUT|ERROR: failed to generate thumbnail from "data/job-spooler/print-jobs/GRxCxPTKIT/6wwgXvQP2G5sk1I2-20230330132945-c-job.data.pdf" for job "6wwgXvQP2G5sk1I2-20230330132945-c-job" err pdf2image execution error: exitStatus=1 err=exit status 1
This issue has been raised with Development and will be investigated ASAP.
This was previously thought to be resolved with the 1.1.8 version of the embedded. However we have found this not to be the case. The Development Team has now found the cause of this issue and are in the process of updating the embedded version.
Please note that this has been resolved in PaperCut MF version 22.0.10.
The warning message reads as follows:
"WARNING: VAULT_PROJECT_ID value was not provided, fallback to PROJECT_ID unknown - PROJECT_ID env var not set."
This is an erroneous message that can be safely ignored.
When printing via PaperCut Pocket or Hive on Macs via Queue with some drivers, the number of copies can become squared (4 copies will become 16 and so on).
Workaround currently is to switch to IPP printing.
We are actively working on a fix for this issue.
Error connecting app: Unable to link additional users because it has been frozen pending review
.Error connecting app: Unable to link additional users because it has been frozen pending review
.
- Existing Dropbox-linked Hive users will not be impacted.
- PaperCut MF users will not be impacted as this is only impacting the Hive application.
Workaround:
Users can scan files to their email using “Scan to Email” and forward it to their dropbox account where possible. If users have other cloud destinations such Google Drive or MS OneDrive, they can scan to those too.
This has now been resolved as of 24th Feb, 2023 (AEDT).
PaperCut will have installed and be working correctly in these cases. The error is a false-alarm.
Resolution is to use newer versions of Windows or Windows Server, or disregard the message.
Windows 8 is already end-of life (please see our System Requirements page for the currently supported platforms), and Server 2012 R2 will be officially ending support from Microsoft later this year.
If you are running into an issue where jobs are showing as zero pages in the Job Log, or are stuck showing as analyzing on the mobile app, you may be running into an issue with the latest edge node version (2023-01-12-2301).
You can confirm this by opening the job trace in the admin UI, and looking for the following error under the first edge node in the logs
failed submit job report for job "xxxxxxxxxxxxxxxx-c-job" err message queue is terminated, cannot enqueue event.
Temp Workaround: The edge node in the job trace displaying this error needs to be restarted. The message queue is unable to clear itself. Once this edge node is restarted, it will start to publish its job analysis correctly to the Cloud.
Solution: We will be releasing a new edge node build as soon as possible to fix the issue permanently.
We have released a new edge node update - 2023-01-16-1453. As an admin, you can use the "Update Now" on the Edge Mesh page of the Admin UI to force an edge node to update. Edge nodes will automatically update over the next 24 hours (16.1.23 15:53 GMT).
Please note that another edge node has gone out that has a number of extra fixes for this error. 2023-01-17-1050
Cause: We have found recently that a Level 2 CIS Microsoft Intune Policy is automatically enabling a Registry Key change that will break printing with the PaperCut Printer.
This Reg Key can be checked as follows:
Navigate to HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Microsoft\Windows NT\Printers\
Look for the key DisableHTTPPrinting. If the value of this key is set to 1, the Print Spooler will block any IPP printing.
You can also see evidence of this Intune Policy in the Windows Event Viewer PrintService admin logs, look out for the following error event:
The document Print Document, owned by XXX, failed to print on printer PaperCut Printer. Try to print the document again, or restart the print spooler.
Data type: RAW. Size of the spool file in bytes: 19138. Number of bytes printed: 0. Total number of pages in the document: 1. Number of pages printed: 0. Client computer: \\XXXXX. Win32 error code returned by the print processor: 1260. This program is blocked by group policy. For more information, contact your system administrator.
The good news is this change can be easily reverted by browsing to the following policy in Intune:
System > Internet Communication Management > Internet Communication Settings
Turn off printing over HTTP - Disabled
Oops! There's a problem - failed to send the scanned document
when sending scans using Quick Scan on the HP E78330 device (and other HP CE devices).5.6
Oops! There's a problem - failed to send the scanned document
when sending scans using Quick Scan on the HP E78330 device (and other HP CE devices). In the job log this may be recorded as processing → failed
. We have been investigating this issue with HP, and it looks like it could be related to some kind of timeout.
Update: This is now resolved in HP firmware 5.6 (2506116_037316) across all impacted devices.
If you provide a Primary and a Secondary Delivery Method, with Primary set as Local Queue Delivery, and Secondary as IPP, then on save, the order will not be honoured, and the IPP method will become the Primary Method.
We are currently investigating the root cause of this and working on a fix to remedy the situation. In the meantime, if you specifically require Queue delivery for a printer, and do not wish for IPP to be a delivery method at all, then set the Primary method to Local Queue Delivery and the Secondary Delivery Method to None.
We are unable to replicate this issue anymore. We believe Adobe have resolved this.
We have found a bug when trying to change the print job properties of the PaperCut Global PostScript driver in Adobe Acrobat. When you select Print > Properties > Advanced and then change the print job to an A3 page format, you may experience one or two notifications from Adobe when hitting print:
"The document could not be printed."
"An error occurred when printing the document."
Despite the error, you will still see the print job successfully printed to PaperCut Hive and the print will be visible in the PaperCut Hive Job Log with the correct A3 properties. When releasing the print job you may notice that the print job does not honour the properties that were set, for example, the page size of A3 would release in A4 instead.
When printing the same print job with the same A3 properties for the second time, you will not see the two errors in Adobe Acrobat and the print job will correctly honour the properties set at the point of print and release.
Whilst we investigate this issue there are a number of workarounds you can implement to mitigate this issue:
- Use a native OEM driver instead: https://www.papercut.com/kb/PaperCutPocketHive/ChangingDrivers
- Use an alternative PDF viewing application, like Edge or Google Chrome
- Alternatively use “Page Setup” in the bottom left of the Adobe Print Window, instead of Properties > Paper/Quality > Advanced when specifying your paper sizes.
One workaround is to temporarily change the ‘Primary Delivery Method’ (under Manage > Printers > [select printer] > Advanced > Print Delivery Method) to ‘Local Queue Delivery’ for any printers impacted. However we recommend reviewing the longer term fix below instead.
Update 28th Oct, 2022:
We have found some examples where the delay has been attributed to the device's Primary DNS Server not being able to successfully resolve
printerapp.papercut.com
. For example if the device is configured with a primary DNS which isn't able to successfully resolve that name for some reason, it will attempt to re-resolve 27 times, before falling back to the secondary DNS server configured on the device.
In cases where that has happened, setting the device DNS value to a public DNS like Google (8.8.8.8) or OpenDNS (208.67.222.123) has eradicated the delay.
Ensuring that your primary DNS can resolve
printerapp.papercut.com
is the key requirement to avoid any device-delays. The DNS settings can be found through the device admin interface > System Settings > Network Settings> DNS Settings > Primary Server.
Update 21st Nov, 2022:
To remove the delays involved with IPP printing on Sharp devices, Sharp have recommended disabling IPP authentication and checking the device's DNS set up:
Disable IPP Authentication:
- Log in to the Sharp device admin interface.
- Navigate to System Settings > Authentication Settings > Default Settings. On some models this setting may be under User Control -> Default Settings.
- Uncheck Enable IPP Authentication Except for Printer Driver.
- Restart the device.
Check the device DNS entries
Make sure the deviceʼs Primary DNS Server can successfully resolve
printerapp.papercut.com
. For example, if the device is configured with a primary DNS which isnʼt able to successfully resolve that name, it will attempt to re-resolve the name 27 times, before falling back to the secondary DNS server configured on the device.
In cases where that has happened, setting the device DNS value to a public DNS like Google (8.8.8.8) or OpenDNS (208.67.222.123) has eradicated the delay.
Ensuring that your primary DNS can resolve
printerapp.papercut.com
is the key requirement to avoid any device-delays. The DNS settings can be found through the device admin interface, under System Settings > Network Settings> DNS Settings >Primary Server.
When Print In Order is turned on for an organization (since 28th March 2023 this is now enabled by default), the desired behavior is when multiple documents are released at once, these documents will print in the order they exist in the print list.
Issue
This behavior may not occur if the print jobs are accepted and sent to the printer from multiple edge nodes. The jobs may end up being printed out of order in these cases.
Workaround
If Print In Order is required for a particular printer, then go to the advanced section of that printer’s detail page and
- Set the Primary Delivery Method to Local Queue Delivery
- Use Driver can be left on Auto
- Set Handled by to Super nodes only.
- Set Secondary Delivery Method to None
Then ensure you have just one Super Node which has a queue that can print to this printer. This will ensure that all jobs that are printed on this printer will print in the order they are sent. This Super Node must be reliable and have a reliable network connection to PaperCut and the printer, or you will experience a higher rate of failures to print due to removing PaperCut's ability to fall back to alternate delivery routes.
This process must be done against any printer you wish printing in order to work for.
Update (28th March 2023): This has been resolved with updates to PaperCut Pocket & Hive's job release process which now enables all jobs released in batches to honour the order they were released in.
This was resolved in the cloud in May 2022.
We have a small number of reports of past successfully released and previously deleted print jobs being incorrectly displayed on Hive device embedded release interface(s) since the incident reported on our status page on Monday 21st March. These jobs cannot be deleted or released.
This issue is occurring across a number of different manufacturers - Konica Minolta, Toshiba, HP reported so far.
The issue can occur even after installing the embedded application afresh on a new device. These print jobs do not show up on the
mobile release app
and can also be absent from the PaperCut Hive Job Log
Our development team are currently investigating this ongoing issue.
If your organisation is facing this problem, please log a ticket via our support email
support@papercut.com
and provide your organization ID and any print job information you have available such as the Print JobID, print job name & submitted date.
NTAG215
NFC sticker/tags on Huawei devices.Huawei devices do not have access to the Google Play Store, and therefore do not support the PaperCut Pocket & Hive phone app
PaperCut Android release app fails to write to
NTAG215 NFC
sticker/tags on Huawei devices.
Workaround
Our native release app writes the NFC URL displayed on the
Details
tab when you select a printer.
Copy the
NFC URL
and write it to the tag using the NFC Tools Android Application downloadable from the Google Play store.
We have opened a support case with Huawei to ask them to address the issue with their underlying library project NFC writing service.
Swipe card authentication fails on HP OXP devices after self-registering a new swipe card.
It appears the issue happens across multiple Swipe Card models and HP firmware versions (4.11.2.1 and 5.3.0.1).
These issues have been re-created internally and have now been escalated to our development team for further investigation.
B&W prompt
feature or Auto B&W
feature within the Reduce Waste
section are enabled.When the Promote B&W feature
Reduce Waste > Promote Black & White
or Auto B&W with the 'notify' feature is enabled Reduce Waste > Auto Black & White > Automatically convert color to Black & White > Notify
color pages cannot be released because the B&W prompt or Auto B&W prompt flashes up briefly but does not allow the user to select Print Selected
PaperCut has produced a fix for this issue.
The fix is awaiting Konica Minolta BEST Certification prior to official release. A hotfix build is underway. Please contact
support@papercut.com
for more information on this.Temporary Workaround
Workaround #1 - Contact support - We have a non-certified KM application available.
OR
Workaround #2 - Disable the Promote B&W feature
Reduce Waste > Promote Black & White
& the Auto B&W feature with the 'notify' option Reduce Waste > Auto Black & White > Automatically convert color to Black & White > Notify
if your PaperCut Hive environment includes devices embedded with the Konica Minolta Full Embedded App. Color print jobs can then be released.Quick Scan Icons are also not displaying on:
Sharp embedded
in beta
(OSA 5.1+ and n2.0 browser required)Ricoh embedded
in beta
(Smart SDK 2.12 or above required)An investigation into the cause of this issue is ongoing.
Our current advice is to roll back the device to a previous version of firmware.
This has now been resolved.
MIUI Global 12
com.google.android.printservice.recommendation
service fails to recommend printers when attempting to print from applications such as Gallery & File Manager.This issue affects printer recommendations of all types and is not inclusive to the PaperCut Printer.
Workaround:This only impacts printing from the Gallery and File Manager applications. Printing from Gmail / Chrome / Google Drive etc all work ok. Furthermore, with these particular applications if you scroll past the initial 'share to' feature and scroll along the bottom options until you find the 'Print' option, this method of printing continues to work (and finds the printers successfully) as normal:

In the meantime, we have opened a support case with Xiaomi to address the issue with their
com.google.android.printservice.recommendation
printer recommendation service.
This issue is limited to Ricoh printers only, and only a subset of those (however we don't have a firm list of those impacted). It will also only happen if the printing method in use is IPP.
By default, we use the “local queue delivery” method, so this will only impact customers who don't have a local queue set up or have manually changed the delivery method to IPP.
WORKAROUND:
Create a print queue which can access the device, and change the priority order in Hive to preference queues over IPP (head into Manage > Printers > [select the printer] > Advanced > Print Delivery > Custom > Primary Delivery Method > [select Local queue delivery]).