セットアップ

この章ではCopper PDFのセットアップ(インストール)方法について説明します。

Java実行環境 のインストール

Copper PDFをインストールするためには、Java実行環境(JREまたはJDK)が必要です。 Java実行環境は、各OSベンダが配布しているものをインストールするか、 http://www.java.com/download/ で配布されているものをインストールしてください。

必要なJava実行環境はバージョン1.4.2以降の国際化対応Java実行環境です。 JDK(開発環境およびサーバー用Java VMを含むもの)を推奨します。

Copper PDF の配布パッケージ

Copper PDF本体は、以下のパッケージが配布されています。 利用する環境に合ったパッケージをダウンロードしてください。 (2.x.xの部分はCopper PDFのバージョンにより異なります)

copper-pdf-2_x_x.zip
ZIPアーカイブ
copper-pdf-2.x.x-x.noarch.rpm
RPMパッケージ
copper-pdf_2.x.x_all.deb
Debianパッケージ
copper-pdf-2.x.x.tar.gz
tar.gzアーカイブ

Windows 2000/XP/Vista

http://copper-pdf.com/download/ で配布されているZIPアーカイブ copper-pdf-2_x_x.zip をダウンロードしてください。

copper-pdf-2_x_x.zipを展開し、CopperPDFディレクトリを適当な場所に配置してください。 アンイストールはCopperPDFディレクトリを削除するだけです

CopperPDFディレクトリまでのファイルパスに半角英数字以外の文字(かな、漢字など)が含まれている場合は、 次に説明するサービスの起動ができません。 Cドライブ直下、あるいはC:\Program Filesなど、 半角英数字の文字だけで構成されるファイルパスに格納してください。

サービスのインストール(Windows 2000 / Windows XP)

Windows版にはCopper PDFサーバーをサービスとしてインストールするためのスクリプトが用意されています。 スクリプトのインストール方法は、Administrator権限を持つユーザーでInstallService.batを実行するだけです。 サービスを削除する場合はRemoveService.batを実行してください。

Windows Vistaでサービスをインストールする場合

アクセサリの「コマンドプロンプト」を管理者で実行し、 Copper PDFのディレクトリに移動してからInstallService.batを実行してください。 サービスを削除する場合も同様にRemoveService.batを実行してください。

C:\>cd [Copper PDFのインストールディレクトリ]
C:\[Copper PDFのインストールディレクトリ]>.\InstallService.bat

サービスの動作状態の確認

サービスの動作状態を確認するには、copperd.exeの-statusオプションを利用することができます。

C:\>cd [Copper PDFのインストールディレクトリ]
C:\[Copper PDFのインストールディレクトリ]>copperd.exe -status
* Status Report *
[Summary]
Uptime:0 days 0 h 0 min 3 s
AccessCount:0

[Threads]
Total:10
Busy:0
Free:10
Max:50

[Memory]
Total:127.06MB
Using:3.96MB
Free:123.1MB
Max:1016.13MB

Red Hat Enterprise Linux(RHEL)

RHEL向けにはRPMパッケージを配布しています。

RHELでは、Java実行環境としてjava-(バージョン)-sun が必要です。 Red Hat NetworksのSupplementaryチャンネルからyumでインストールするか、 Supplement CDに収録されているものをインストールしてください。 java-(バージョン)-gcj-compatでは動作しません。 alternatives --config javaコマンドでjava-(バージョン)-sunに切り替えてください。

copper-pdf-2.x.x-0.noarch.rpmをrpmコマンドでインストールしてください。 アンインストールの方法は通常のRPMパッケージの場合と同じです。

# sudo rpm -ivh copper-pdf-2.0.0-0.noarch.rpm
# sudo rpm -e copper-pdf

Copper PDFサーバーの起動・停止

RHELではchkconfigおよびserviceコマンドでCopper PDFサーバーを管理できます。 Copper PDFサーバーのサービス名はcopperdです。 インストール直後は、Copper PDFサーバーの自動起動は無効化されています。

# sudo service copperd start
# sudo copperd -status
# sudo service copperd stop
# sudo service copperd restart
# sudo chkconfig copperd on
# sudo chkconfig copperd off

Debian

Debian向けにはdebパッケージを配布しています。

Debianでは、Java実行環境としてsun-java5-jdk [non-free]が必要です。 kaffe または java-gcj-compatでは動作しません。 sun-java5-jdkをインストールし、 update-alternatives --config javaコマンドでjavaコマンドを /usr/lib/jvm/java-1.5.0-sun/jre/bin/javaに切り替えてください。

他の方法でインストールしたJava実行環境を使う場合は、 /etc/profileファイル等で、JAVA_HOME環境変数にJavaのインストールディレクトリのパスを設定してください。

copper-pdf_2.x.x_all.debをdpkgコマンドでインストールしてください。 アンインストールの方法は通常のdebパッケージの場合と同じです。

# sudo dpkg -i copper-pdf_2.0.0_all.deb
# sudo dpkg -r copper-pdf

Copper PDFサーバーの起動・停止

DebianではCopper PDFのサービスは/etc/init.d/copperdとして配置されます。 インストール直後は、Copper PDFサーバーの自動起動は無効化された状態です。 サービスの管理方法は以下の通り、通常のDebianの手法に従います。

# sudo /etc/init.d/copperd start
# sudo copperd -status
# sudo /etc/init.d/copperd stop
# sudo /etc/init.d/copperd restart
# sudo update-rc.d /etc/init.d/copperd defaults
# sudo update-rc.d /etc/init.d/copperd remove

その他のOS

Javaを実行可能なOS全般のために、tar.gzアーカイブのパッケージを配布しています。

copper-pdf-2.x.x.tar.gzを適当なディレクトリに展開してください。

ディレクトリ構成

アーカイブ内のディレクトリ構成

ZIPまたはtar.gzアーカイブを展開すると、copper-pdf-2_x_xというディレクトリができます。 各ツールの実行ファイルは、このディレクトリの直下にあります。 その他のディレクトリ構成は次の通りです。

copper-pdf-2_x_x
|-- conf		設定ディレクトリ
|   `-- profiles	プロファイル
|       `-- fonts	フォント設定
|-- docs		ドキュメント
|-- extras		アイコン、各プラットフォーム向けのファイル等
|-- legal		付属ライブラリのライセンス文書
|-- jetty		サーブレットコンテナ(copper-webapp用)
|-- lib			ライブラリ
|-- logs		ログディレクトリ
`-- webapp		copper-webapp

RPMまたはDebianパッケージの構成

RPMまたはDebianパッケージでインストールした場合は、 Copper PDFの各コマンドラインツールは/usr/binと/usr/sbinに配置されます。

また、他のディレクトリの配置場所は次のとおりです。

RPM/Debianのディレクトリ構成
ディレクトリ 配置場所
lib /usr/share/copper-pdf/lib
docs /usr/share/doc/copper-pdf
conf /var/lib/copper-pdf/conf (/etc/copper-pdfにシンボリックリンク)
jetty /var/lib/copper-pdf/jetty
webapp /var/lib/copper-pdf/webapp
logs /var/log/copper-pdf (/var/lib/copper-pdf/logsにシンボリックリンク)

/etc/init.d/copperdはcopperユーザーで実行されます。 ファイルの読み書きが行われる /usr/share/copper-pdf/conf/profiles, /var/log/copper-pdf の各ディレクトリはcopperユーザーの所有となります。

ライセンスキーファイルの配置

Copper PDFを使用するためには、ライセンスキー・ファイル(license-key)をconfディレクトリに配置する必要があります。 ライセンスキーはhttp://copper-pdf.com/buy/で購入してください。 また、機能・期限に制限のある試用ライセンスキーを無料で発行しています。