confディレクトリの構成は次の通りです。
conf |-- license-key |-- copperd.properties |-- logging.properties |-- password.txt |-- access.txt `-- profiles |-- default.properties `-- fonts |-- fonts.xml |-- truetype |-- warrays |-- afms |-- cmaps `-- encodings
confディレクトリの直下には次の設定ファイルが収められています。
また、profilesディレクトリ内には次のファイルがあります。
copperd.propertiesはcCopper PDFサーバーの動作に関する設定です。 この設定の変更を反映するにはCopper PDFサーバーの再起動が必要です。
ファイルの形式は Javaのプロパティファイル です。各プロパティの説明は以下の通りです。
| プロパティ | 説明 |
|---|---|
| jp.cssj.cssjd.port | サービスポートです。 ドライバの接続先のポートです。 |
| jp.cssj.cssjd.control-command | 制御コマンドです。 |
| jp.cssj.cssjd.control-port | 制御用ポートです。 |
| jp.cssj.cssjd.timeout | 接続タイムアウト(秒数)です。 プログラムインターフェースとの間で指定された時間データがやりとりされなかった場合、接続を切断します。 |
| jp.cssj.cssjd.minThreads | 最小スレッド数です。 プログラムインターフェースの接続を待ち受けるために準備しておく最小限のスレッド数です。 高負荷が予想される状況では大きめの値を設定しておくと処理が効率化しますが、 使用するメモリは増大します。 |
| jp.cssj.cssjd.maxThreads | 最大スレッド数です。 copperdが同時に処理出来るプログラムインターフェースからの接続の最大数です。 高負荷が予想され、なおかつシステムのリソースに余裕がある場合は大きな値を設定するのが有効ですが、 リソースに余裕がない環境では、大きな値を設定することで逆に非効率になることがあります。 |
| jp.cssj.cssjd.backlog | 接続のバックログ数です。 未処理の接続がこの数を超えた場合、処理に空きが出来るまで以降の接続は拒否します。 |
logging.propertiesはCopper PDFサーバーのログ設定ファイルです。 この設定の変更を反映するにはCopper PDFサーバーの再起動が必要です。 ログ設定ファイルは java.util.loggingのログプロパティファイル の形式で記述してください。
# Logging levels by categories. jp.cssj.handlers = jp.cssj.logging.FileHandler, \ java.util.logging.ConsoleHandler jp.cssj.level = INFO # File java.util.logging.FileHandler.level = INFO java.util.logging.FileHandler.formatter = java.util.logging.SimpleFormatter java.util.logging.FileHandler.encoding = UTF-8 # Console java.util.logging.ConsoleHandler.level = OFF java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter
Copper PDFには日付でログをローテーションするログハンドラ (jp.cssj.logging.FileHandler) が用意されています。 ハンドラのプロパティは次のとおりです。
| 名前 | デフォルト | 説明 |
|---|---|---|
| directory | copperdの標準のlogsディレクトリ | ログの出力先ディレクトリ |
| prefix | copperd. | ログファイル名の先頭の文字列 |
| suffix | .log | ログファイル名の末尾の文字列 |
| level | ALL | ログレベル |
| filter | N/A | ログのフィルタ |
| formatter | java.util.logging.SimpleFormatter | ログのフォーマッタ |
| encoding | UTF-8 | ログファイルのキャラクタエンコーディング |
access.txtはIPアドレスでアクセス出来るクライアントを制限する設定です。 このファイルの変更は自動的に検出されるため、変更後にCopper PDFサーバーを再起動する必要はありません。 各行のルールを
[allow|deny] IPアドレス
という形式で記述します。 IPアドレスはIPv4, IPv6のどちらの形式も使用可能です。
allowは指定されたアドレスのアクセスを許可し、denyはアクセスを拒否するルールです。 クライアントからのアクセスがあった場合は、先頭から順に検索し、最初に一致したルールが適用されます。
IPアドレスを * にすると、全てのクライアントにルールを適用します。
allow 127.0.0.1 deny *
profilesディレクトリ内の設定は、Copper PDFの出力結果に関係するものです。 デフォルトの入出力プロパティやフォントの情報が含まれます。
Linux版のcopperdおよび、 Windows版の各種ツールはconfディレクトリ内のprofilesディレクトリの設定を使用しますが、 Linux版の copper copper-webapp は初回実行時に実行ユーザーのホームディレクトリに.copperという名前のディレクトリをつくり、 そこにprofilesディレクトリを作成します。 copper, copper-webappを使用する各ユーザーはホームディレクトリの設定を編集する必要があります。
copper-webappの設定ファイルは、初回実行時に /WEB-INF/client.propertiesから各ユーザーの.copper/webapp.proprtiesにコピーされます。 2.0.1
default.propertiesはデフォルトの入出力プロパティを設定するものです。 この設定の変更を反映するためにCopper PDFサーバーを再起動する必要はありません。
入出力プロパティはcopperコマンドの引数やcopper-webappの設定ウィンドウ、 プログラムインターフェースによって変更出来ますが、 default.propertiesに書いておくことにより、あらかじめ入出力プロパティを設定した状態にすることが出来ます。
ファイルの形式は Javaのプロパティファイル です。 各プロパティは入出力プロパティの節で解説されていますが、 １つだけsystem.fontsという特別なプロパティがあります。 system.fontsは後で次に説明するフォント設定ファイルをdefault.propertiesファイルからの相対パスで指定したものです。
フォント関連の設定です。詳細は次の章で解説します。