PaperCut Ver.25 の重要なポイント

PaperCut MF/Plusを使用している機能によっては、
PaperCutの以前のバージョンからVer.25.xにアップグレードした後、
一部の機能が正常に動作しなくなる可能性があります。

アップグレードを行う前に、この記事を確認して、影響を受ける可能性がある箇所を確認してください。

Ver.25.xの変更点

重要

PaperCut MF/Plus ver.25.x以降では、使用している機能やプラットフォームによって複数の重大な変更があります。
この記事で説明する機能やコンポーネントを使用しているかを確認してください。
使用している場合、必要な手順を確認してください。
この記事に記載する内容を実施しない場合、印刷機能、ペイメント機能、その他の機能に影響が出る可能性があります。

ジョブ・チケット取得を使用している場合

ジョブ・チケットのサーバのバージョンが1.0.3127以降であるかを確認してください。

● ジョブ・チケット取得機能のバージョンが1.0.3127以降で、
　 PaperCut MF/Plusのバージョンが24.x 以前のバージョンと互換性があり、
　 またPaperCut MF/Plusのバージョン25.x以降とも互換性があります。

● PaperCut MF/Plusのバージョンが25.x以降を使用する場合、
　 ジョブ・チケット取得のバージョン1.0.3127 以降のみと互換性があります。

古いバージョンのジョブ・チケット取得を使用している場合

古いバージョン(Ver.1.0.3126以前)のジョブ・チケット取得を使用している場合、
PaperCut Ver.25.xにアップグレードする前に、ジョブ・チケットのサーバをアップデートする必要があります。
ジョブ・チケットを先にアップデートしない場合、Ver.25.xをインストールした後、起動に失敗します。
最新のジョブ・チケット取得のインストーラの入手に関しては販売店までご連絡ください。

手動での回避方法

すでにPaperCut Ver.25.xにアップグレード済みでジョブ・チケット取得をアップグレードしていない場合で、
ジョブ・チケット取得は起動しない場合、手動で回避方法を実施することにより利用可能です。

1． PaperCut と ジョブ・チケット取得のサービスを停止してください。

2． テキスト・エディタから設定ファイル「pc-job-ticketing.conf」を開いてください。(<app-path>\/job-ticketing/app/vxxx/pc-job-ticketing.conf)

3． 以下の例のように、Args 行の後に次の行を追加してください。

　　"--add-opens=java.base/java.lang=ALL-UNNAMED",

　　【注記】 最後にカンマを付けることを忘れないでください！

4． PaperCut と ジョブ・チケット取得のサービスを再起動してください。

Payment Gateway を使用している場合

(もしくは、Payment Gatewayモジュールがインストールされている場合 – たとえ現在使用中ではなくても)

アプリケーション・サーバをPaperCut MF/Plus Ver.25.xにアップグレードした後、
すぐにPayment Gatewayモジュールをアップグレードする必要があります。
新しいPayment Gatewayは、古いアプリケーション・サーバのバージョンと下位互換性がありません。

● PaperCut MF/Plus Ver.25は、Ver.25のPayment Gatewayモジュール・プラグインのみと互換性があります。

● Payment Gatewayモジュール Ver.25は、PaperCut MF/Plus Ver.25以降とのみ互換性があります。

アプリケーション・サーバをVer.25以降にアップグレードする時、インストールに次のエラーメッセージが表示されます:
“Update of your Payment Gateway module is required”

[OK] をクリックし、次に表示されるメッセージで、インストールを継続するかどうかを確認してください。

 

● [Yes] をクリックすると、インストールが再開されます。
　 サーバは互換性のないプラグインを無視し、エラーメッセージをserver.logに記録した後、起動を完了します。
　 ・ その後、Payment機能を正常に利用し続けるためには、
　 　 Payment Gatewayモジュールをアップグレードする必要があります。

● [No] をクリックすると、インストールが中断されます。

アプリケーション・サーバがPaperCut MF/Plus Ver.24またはそれ以前のバージョンの場合、
Payment GatewayのVer.25をインストールすると、次のエラーメッセージが表示されます。

 

[OK]をクリックし、インストールを中断してください。

macOSまたはLinuxの場合、インストール中にエラーメッセージは表示されません。
アップグレード後にアプリケーション・サーバは正常に起動しますが、
Payment Gatewayは動作しません。Server.logとアプリケーション・ログにエラーメッセージが記録されます。

Payment Gatewayモジュールの最新バージョンの入手方法

弊社までお問合せください。

古いデータベース・バージョンを使用している場合

PaperCutアプリケーション・サーバはPaperCut MF/Plus ver.25.x以降にアップグレードした後、軌道に失敗する可能性があります。
PaperCut社における検証中に、一部のEnd of Life(EOL)データベース・バージョンがPaperCut Ver.25のアップグレード時に
インストールに失敗することが判明しました。
これらの仕様はPaperCut MF/Plusのシステム要件ページに記載している最低要件未満です。

● PostgreSQL Ver.12以前
　 ・ 具体的には、PostgreSQL 9.4および12では、次のエラーが発生することが確認されています

　 　 　PSQLException syntax error

● MySQL Ver.7.0以前

● Oracle 18.4.0以前

● Microsoft SQL Server 2014以前

これらの非対応のデータベース・バージョンを使用している場合、
PaperCut MF/Plus Ver.25以降にアップグレードする前に、対応しているバージョンにアップグレードすることをお勧めします。
上記に特に指定していない限り、これらの古いバージョンにおいて特定のエラーは確認されていません。
しかし、問題が発生した場合、サポート対象のデータベースのバージョンにアップグレードすることをお願いする場合があります。

その他のVer.25の変更

下記に記載するのは役立つ情報です。なお、互換性を損なう変更は含まれません。

Ver.24.0.0 より古いバージョンからアップグレードする場合

例えば、Ver.23.1.2から25.0.1にアップグレードする場合、Ver.25の重要な変更点に加えて、
Ver.24で実施されている重要な変更点も確認することを推奨します。

外部データベースを使用している場合

PaperCut MF/plus 25のアップグレードまたは新規インストールを行う場合、
データベース・ドライバの取り扱い方法に新しいアプローチが導入されました。

● ドライバ検出

　 PaperCut社は、古いバージョンのMicrosoft SQL Serverデータベース・ドライバを使用している場合に警告を表示するようになりました。
　 PaperCut管理画面にアクセスした時にポップアップ通知が表示され、アップデート方法について記載したKBの記事(英語)へのリンクが表示されます。
　 詳細は、下記記事を参照してください。

　　【Microsoft SQL JDBC ドライバのアップグレード方法】　https://cosy500-papercut-2.blogspot.com/2025/05/microsoft-sql-jdbc.html

● PaperCut管理者画面にデータベースのバージョンを表示

　 PaperCut管理者画面の<PaperCutについて>セクションの「システム情報」エリアに使用しているデータベースのバージョンが表示されるようになりました。

　 ・ データベースのバージョン

　 ・ データベースドライバのバージョン

● データベース・ドライバは上書きされない

PaperCut MF/Plus Ver.25.以降、
アップグレード毎にファイルシステム内で更新されたデータベース・ドライバを手動で移動する必要がなくなりました。
例えば、MS SQL とより新しいドライバを使用している場合、
Microsoft SQL JDBCドライバ(データベース・ドライバ) のアップグレード後に、
下記ページの「3． JDBCドライバとauth dllのアップグレード」を毎回実施する必要がなくなりました。

【Microsoft SQL JDBC ドライバのアップグレード方法】 https://cosy500-papercut-2.blogspot.com/2025/05/microsoft-sql-jdbc.html

Ver.25の新規インストールの場合

PaperCut MF/plus 25の新規インストールを行う場合、推奨するデータベース・ドライバと認証DLLが次のフォルダ内に格納されます

　<app-path>/server/repository/database-drivers

　 ・ MS SQL driver: mssql-jdbc-12.10.0.jre8.jar へアップグレード

　 ・ PostgreSQL driver: postgresql-42.7.5.jar へアップグレード

　 ・ Windows Authentication DLL: auth/x64/mssql-jdbc_auth-12.x.x.x64.dll へアップグレード

古いバージョンからアップグレードする場合

PaperCut MF/Plusの古いバージョンからVer.25以降へアップグレードする場合

● システムは、既存の「server/lib」フォルダから現在インストールされているドライバをスキャン

● 最大3つの既存のドライバが新しいロケーションへ移動される: <app-path>/server/lib-ext/

● 認証DLLは元のロケーション(/lib-64, /x86) に保持される

これらの変更により、特別な対応は不要です。(アプリケーション・サーバはアップグレード後も正常に動作します)
しかし、使用しているデータベース・プラットフォームに応じて、次の記事を確認することを推奨します。

● 【Microsoft SQL JDBC ドライバのアップグレード方法】 https://cosy500-papercut-2.blogspot.com/2025/05/microsoft-sql-jdbc.html

● 別紙「外部データベース設定ガイド」の「4-2 Microsoft SQL Server の設定」

● 別紙「外部データベース設定ガイド」の「4-4 PostgreSQLの設定 」

● 別紙「外部データベース設定ガイド」の「4-5 Oracleの設定(Oracle Express Editionを含む)」

● 別紙「外部データベース設定ガイド」の「4-6 AzureSQLの設定」

外部カード参照を使用している場合

外部データベースをカード参照に使用している場合に、
PaperCut MF/Plus Ver.25以降にアップグレードする時、設定を再確認することを推奨します。
PaperCut管理画面の<オプション>-<拡張> の
「外部ユーザ参照」エリアの「カード番号参照のため外部データベースを使用」を有効化している場合、
「データベース・タイプ」と「データベース接続URL」が正しく設定されているかを確認してください。

古いモデルの複合機/プリンタを使用している場合

古いデバイスはEnd of Life(EOL) の終盤に差し掛かっています。
一部のモデルはPaperCut MF Ver.25の新しい機能や技術と互換性がない可能性があります。
PaperCut社のテストラボや製造元のテストラボには、対象のデバイスが古すぎて入手ができないため、
テストを実施することができないことがあります。
下記に記載するデバイスがある場合、アップグレード前にテスト環境を構築し、互換性を検証することをお勧めします。
動作しない場合、古いバージョン（Ver.24以前）を使用し続けることを検討してください。

対象となるデバイス:

● Fuji Xerox (EIP)

● HP Chai

● HP OSA

● Toshiba Eraser

● Toshiba eConnect

● Xerox Network Accounting

● OKi

● Sindoh

FAQ

Q： Ver.25の大幅な変更に伴い、ダウングレードが必要になった場合の手順を教えてください。

A： Ver.25の大幅な変更に伴い、ダウングレードを行う必要がある場合は正しい手順に従うことが必要です。
　　まず最初に、PaperCut アプリケーション・サーバの完全なバックアップとファイルシステムのバックアップ、
　　またはVMのスナップショットを取得する必要があります。
　　Ver.25に新規インストール/上書きインストールした後、古いPaperCut アプリケーション・サーバを上書きインストールしないでください！
　　これはサポートしておらず、問題を引き起こす可能性があります。Ver.25のアップグレード前にバックアップを取ることを強くお勧めします。
　　問題が発生した場合、Ver.25をアンインストールしてから、次に古いバージョンのPaperCutをインストールし、
　　アップグレード前に作成したバックアップを復元してください。

Q： PaperCut管理画面の
　 <PaperCutについて> タブの[アップデート情報を確認] ボタンを使用しても、Ver.25が一覧に表示されません。

A： Ver.25は正式リリース日から7~10日かけて段階的にリリースしています。
　　[アップデート情報を確認] をクリックすると、直接製品内で利用可能かどうかを確認することができます。

Q： 新しいガベージ・コレクタとは何ですか？それは何をするのでしょうか?

A： PaperCut MF/Plusのアプリケーション・サーバ Ver.25に搭載された新しいガベージ・コレクタは、
　　従来のParallel GCに代わってZGC(Zガベージ・コレクタ)を導入しています。
　　ZGCは超低遅延を目的として設計されており、低遅延アプリケーションに最適です。
　　大規模なデータセットに対応可能で、完全な並列収集を実行し、最小限のチューニングですぐに優れたパフォーマンスを発揮します。
　　このアップグレードは、特に応答性とスケーラビリティが求められるシステムにおいて、大幅なパフォーマンスの向上をもたらします。

Q： サイト・サーバは、アプリケーション・サーバと同時にアップグレードする必要がありますか？

A： はい、アプリケーション・サーバをアップグレードする時に、必ずサイト・サーバもアップグレードしてください。
　　アプリケーション・サーバとサイト・サーバのバージョンが一致しない場合、サイト・サーバはオフライン・モードのままとなり、機能の一部が制限されます。

Q： JDBCドライバは自動的に更新されますか？それともアップグレード時にデータベース接続文字列の変更が自動的に行われますか？

A： データベース・ドライバは自動的に変更されず、データベース接続文字列も自動的に変更されません。
　　データベース・ドライバのバージョンまたはデータベース接続文字列を変更する場合、下記サイトおよびドキュメントを参照してください。

　　● 【Microsoft SQL JDBC ドライバのアップグレード方法】 https://cosy500-papercut-2.blogspot.com/2025/05/microsoft-sql-jdbc.html

　　● 別紙「外部データベース設定ガイド」の「4-2 Microsoft SQL Server の設定」

　　● 別紙「外部データベース設定ガイド」の「4-4 PostgreSQLの設定 」

　　● 別紙「外部データベース設定ガイド」の「4-5 Oracleの設定(Oracle Express Editionを含む)」

　　● 別紙「外部データベース設定ガイド」の「4-6 AzureSQLの設定」

Q： PaperCut MF/Plusと互換性のあるデータベースのバージョンを教えてください。

A： 

　　● PostgreSQL: versions 13, 14, 15, 16, 17

　　● Microsoft SQL Server: versions 2016, 2017, 2019, 2022

　　● MySQL: version 8

　　● Oracle: version 19.3

-------------------------

https://www.papercut.com/kb/Main/important-points-to-know-about-papercut-ng-mf-version-25/