設定ファイル

confディレクトリの構成は次の通りです。

conf
|-- license-key
|-- copperd.properties
|-- logging.properties
|-- password.txt
|-- access.txt
`-- profiles
    |-- default.properties
    `-- fonts
        |-- fonts.xml
        |-- truetype
        |-- warrays
        |-- afms
        |-- cmaps
        `-- encodings

confディレクトリの直下には次の設定ファイルが収められています。

license-key
ライセンスキーファイルです。
copperd.properties
copperdの動作設定です。
logging.properties
ログの設定です。
password.txt
パスワードの設定です。編集にはcopperdコマンドを使ってください。
access.txt
アクセス制御設定です。

また、profilesディレクトリ内には次のファイルがあります。

default.properties
デフォルトの入出力プロパティです。
fonts/fonts.xml
使用するフォントの設定です。

copperdの動作設定(copperd.properties)

copperd.propertiesはcopperdサーバーの動作に関する設定です。 この設定の変更を反映するにはcopperdの再起動が必要です。

ファイルの形式は Javaのプロパティファイル です。各プロパティの説明は以下の通りです。

copperd.propertiesのプロパティ一覧
プロパティ 説明
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)

logging.propertiesはcopperdのログ設定ファイルです。 この設定の変更を反映するにはcopperdの再起動が必要です。 ログ設定ファイルは java.util.loggingのログプロパティファイル の形式で記述してください。

Copper PDFには日付でログをローテーションするログハンドラ (jp.cssj.logging.FileHandler) が用意されています。 ハンドラのプロパティは次のとおりです。

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)

access.txtはIPアドレスでアクセスできるクライアントを制限する設定です。 このファイルの変更は自動的に検出されるため、変更後にcopperdを再起動する必要はありません。 各行のルールを

[allow|deny] IPアドレス

という形式で記述します。 IPアドレスはIPv4, IPv6のどちらの形式も使用可能です。

allowは指定されたアドレスのアクセスを許可し、denyはアクセスを拒否するルールです。 クライアントからのアクセスがあった場合は、先頭から順に検索し、最初に一致したルールが適用されます。

IPアドレスを * にすると、全てのクライアントにルールを適用します。

profilesディレクトリ

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)

default.propertiesはデフォルトの入出力プロパティを設定するものです。 この設定の変更を反映するためにcopperdを再起動する必要はありません。

入出力プロパティはcopperコマンドの引数やcopper-webappの設定ウィンドウ、 プログラムインターフェースによって変更できますが、 default.propertiesに書いておくことにより、あらかじめ入出力プロパティを設定した状態にすることができます。

ファイルの形式は Javaのプロパティファイル です。 各プロパティは入出力プロパティの節で解説されていますが、 1つだけsystem.fontsという特別なプロパティがあります。 system.fontsは後で次に説明するフォント設定ファイルをdefault.propertiesファイルからの相対パスで指定したものです。

fontsディレクトリ

fontsディレクトリにはドキュメント中で使用することができるフォントの詳細情報が含まれます。 また、出荷時の設定ではfonts/truetypeディレクトリ内のフォントファイルを利用するようになっています。 使用したいフォントをfonts/truetypeディレクトリにコピー(あるいはシンボリックリンク)してください。 ディレクトリ名はtruetypeですが、Copper PDF 2.0.3からOpenType CFF/Type2(.otf)フォントがサポートされました。

フォント関連の設定方法の詳細は次の章で解説します。