On some Mac systems, PaperCut 13.3 and older may generate an error and fail when attempting to use db-tools as part of restoring a database, a required activity when migrating a Primary Server installation of PaperCut.

The applicable error message is:

  Error running db-tools, command: init-db.

  Can't connect to window server – not enough permissions.

This can be addressed by opening the db-tools file with a text editor such as vi, and adding the following parameter line after ${JAVA_CMD} \:

"-Djava.awt.headless=true" \

Your file will then resemble:

  export CLASSPATH
  ${JAVA_CMD} \
  "-Djava.io.tmpdir=${TMP_DIR}" \
  "-Dserver.home=${SERVER_HOME}" \
  "-Djava.awt.headless=true" \
  -Xmx256M \
  biz.papercut.pcng.persistence.tools.DBTools \
  "$@"

I am seeing the error shown below when trying to delete old logs. What can I do about it?

 Error occurred running db-tools, command: 
 delete-old-logs. GC overhead limit exceeded 

We have seen this error at a few busy sites. (Sites printing couple of thousands of pages every day) By default, db-tools application uses 256M of memory which can be increased by making the following changes.

1. Open db-tools file using a text editor.
2. Find the line Xmx256M
3. Try adding more amount by doubling it. E.g. Xmx512M
4. Save the file.
5. Test it if that works and change the memory parameter accordingly to your needs.