How do I use SSL with Microsoft SQL Server?

KB Home   |   How do I use SSL with Microsoft SQL Server?

By default PaperCut uses an internal embedded database called Apache Derby which was initially developed by IBM and sold as Cloudspace DB. PaperCut can also be run on external databases like Microsoft SQL Server.

Some PaperCut customers may wish to utilize a SSL connection to their Microsoft SQL server. When making the changes as described in the manual at the end of this document, you will need to make an additional change to support SSL connection.

Original

    #database.url=jdbc:jtds:sqlserver://localhost/papercut

Modified

    #database.url=jdbc:jtds:sqlserver://localhost/papercut;ssl=required

Additional steps for 14.2 onwards

With the release of 14.2 we updated the version of Java PaperCut uses, in this updated Java engine some SSL connection issues were discovered between the Java database driver and MS SQL Server. When using the ssl=required modification above, you may receive errors connecting to the database, in these circumstances we recommend the additional configuration steps:

  1. Create a text file in the directory: [app-path]\server\custom\ named service.conf
  2. Open the file in a text editor and add the following line: wrapper.java.additional.7=-Djsse.enableCBCProtection=false
  3. Save the text file.
  4. Restart the PaperCut Application Server service.
  5. Test the connection.

For more information using an external database, and instructions on how to “upsize” to an external database, see the manual here.

Other Microsoft SQL Server connection options

PaperCut utilizes the jTDS JDBC driver which has other connection options that may be applicable to your environment.

Categories: Databases

keywords: MSSQL, ms-sql, database server, error connecting to the SQLServer database,

Comments

Share your findings and experience with other PaperCut users. Feel free to add comments and suggestions about this Knowledge Base article. Please don't use this for support requests.

Article last modified on January 09, 2015, at 12:12 AM
Printable View   |   Article History   |   Edit Article