<!--DOCTYPE chapter PUBLIC "-//OASIS//DTD DocBook V4.1//EN"-->
<chapter id="vine-cups">
		<title>CUPSによる印刷環境の設定方法と使用方法</title>
	<!--chapterinfo>
		<authorgroup>
			<author>
				<firstname>Yasumichi</firstname>
				<surname>Akahoshi</surname>
				<affiliation>
					<address>
						<email>yasumichi@vinelinux.org</email>
					</address>
				</affiliation>
			</author>
			<editor>
			  	<fistname>Takuya</firstname>
				<surname>Kobayashi</surname>
			</editor>
		</authorgroup>
		<abstract><para>
				この文書には，Vine Linux で印刷環境を設定する方法が書いてあります。
		</para></abstract>
	</chapterinfo-->

	<sect1 id="vine-cups-1">
		<title>はじめに</title>
		<para>
			Vine Linux 3.0から、LPRngに代わってCUPS(the Common Unix Printing System)が標準の印刷システムとして採用されています。
		</para>
		<para>
			CUPSには、LPRngと比べ以下の利点があります。
		</para>
		<itemizedlist>
			<listitem><para>IPP（次世代のネットワーク印刷プロトコル）のサポート</para></listitem>
			<listitem><para>ネットワークプリンタの自動検出</para></listitem>
			<listitem><para>Webインターフェイス設定ツール</para></listitem>
			<listitem><para>PPDプリンタ記述ファイルのサポート</para></listitem>
			<listitem><para>フィルタのインタフェースがモジュール化されており、様々なファイル形式をサポートする単一のプリンタドライバをわずかな努力で開発可能</para></listitem>
		</itemizedlist>
		<para>なお、このドキュメントはVine Linux 4.xをフルインストールした環境を基準に記述されています。カスタムインストールを選択された場合は、以下のパッケージがインストールされていることを前提としています。</para>
		<itemizedlist>
			<listitem><para>cups-libs</para></listitem>
			<listitem><para>cups</para></listitem>
			<listitem><para>libgnomecups</para></listitem>
			<listitem><para>gnome-cups-manager</para></listitem>
			<listitem><para>eplaser-cups</para></listitem>
			<listitem><para>foomatic</para></listitem>
			<listitem><para>foomatic-ppd-gimp-print-ijs</para></listitem>
			<listitem><para>foomatic-ppd</para></listitem>
		</itemizedlist>
		<para>2.6からのアップグレードインストール等の場合、標準の印刷システムはLPRngのままであることに御注意ください。</para>
	</sect1>

	<sect1 id="vine-cups-2">
		<title>プリンタの設定</title>
		<important>
			<title>Vine Linux 5.2 から CUPS の Web インターフェースを利用するための下準備が必要になりました</title>
			<para><ulink url="http://vinelinux.org/errata/5x/20100714-4.html">セキュリティホール</ulink>の修正のため、Vine Linux 5.2から、インストール時のデフォルトの状態では、CUPS の Web インターフェースを利用することができなくなりました。</para>
			<para><ulink url="http://vinelinux.org/vlmagazine/">Vine Linux Magazine</ulink> の <ulink url="http://vinelinux.org/vlmagazine/20101224.html">EPSON EP-803A の印刷設定 for Vine Linux 5.2（Web IF編）</ulink> にて、Web インターフェースを利用できるようにするための方法やプリンタの設定例について紹介されていますのでそちらを参照してください。</para> 
		</important>
		<para>ToDo: 設定ファイルの記述法などに変更</para>
		<!--para>
			プリンタを設定するには、w3m等のWebブラウザから<ulink url="http://localhost:631/">http://localhost:631/</ulink>へアクセスしてください。次のようなページが表示されますので、上のバーの ESP 管理 クラス ヘルプ ジョブ プリンタ ソフトウェア の プリンタ、もしくは、プリンタ管理 からプリンタを追加してください。この際、ユーザ名とパスワードを尋ねられますのでユーザ名にroot、パスワードにrootのパスワードを入力してください。
		</para>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-1.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS 管理インタフェース</phrase>
			</textobject>
		</mediaobject>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-2.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS プリンタ管理</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="input_name_place_description">
			<title>名前、場所、説明の入力</title>
			<para>
				最初にプリンタの名前、場所、説明を入力します。この内、名前は必須項目です。名前には後でコマンドラインから利用しやすい様に半角英数字をお使いください。例えば、プリンタの型番やlp0,lp1,...などの様に入力すると良いでしょう。場所や説明はユーザがプリンタを識別しやすい様に入力します。企業や学校など、同機種のプリンタが存在する環境では営業部などの様にプリンタの置き場所を入力しておくと良いでしょう。
			</para>
		</sect2>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-3.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS プリンタ追加</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="select_device">
			<title>デバイスの選択</title>
			<para>接続形態を選択します。例えば、直接コンピュータのパラレルポートに接続している場合は、『Parallel Port #1』を選択します。</para>
		</sect2>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-4.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS デバイスの設定</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="set_device_URI">
			<title>デバイスURLの入力</title>
			<para>
				ネットワーク接続の場合のみデバイスURLの入力を求められます。例を参考に入力してください。例えば、TCP/IP接続で192.168.0.5 を割り当てられ、9100番のポートを利用するプリンタの場合、socket://192.168.0.5:9100の様に入力します。
			</para>
		</sect2>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-5.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS デバイスの URI</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="select_maker_name">
			<title>メーカ名の選択</title>
			<para>一覧から、お使いのプリンタのメーカを選択して、次へ進みます。</para>
		</sect2>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-6.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS メーカ名の選択</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="select_model_name">
			<title>モデル名の選択</title>
			<para>
				一覧からプリンタの型番を選択して次へ進んでください。『プリンタ &lt;名前&gt; の追加に成功しました.』の様に表示されたら、&lt;名前&gt; をクリックしてください。設定済みのプリンタの一覧が表示されます。
			</para>
		</sect2>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-7.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS プリンタモデル名の選択</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="print_testpage">
			<title>テストページの印刷</title>
			<para>
				以上の設定がうまくいっているかを確認するためにテストページを印刷します。追加したプリンタの欄の『テストページ』と書かれたボタンをクリックしてください。もし、全く印刷できなかったら、『プリンタ変更』をクリックして設定をもう一度、見直してください。もし、用紙サイズの不一致などで印刷できなかった場合は、『印刷設定』をクリックして用紙サイズ等を見直してください。
			</para>
		</sect2>
		<mediaobject>
			<imageobject>
				<imagedata fileref="images/cups-8.png" />
			</imageobject>
			<textobject>
				<phrase>CUPS テストページ印刷</phrase>
			</textobject>
		</mediaobject>
		<sect2 id="hint">
			<title>ヒント</title>
			<para>
				Webブラウザから設定する方法以外にもGNOMEのCUPS印刷マネージャ等を利用する方法があります。CUPS印刷マネージャを利用するには、 GNOMEメニューの<guimenu>デスクトップ</guimenu>→<guimenuitem>システム管理</guimenuitem>→<guimenuitem>CUPS 印刷マネージャ</guimenuitem>を実行するか、コマンドライン等からgnome-cups-managerを実行してください。この際、rootのパスワードを尋ねられますので入力してください。CUPS印刷マネージャが起動できたら、新しいプリンタというアイコンをダブルクリックして必要事項を入力してください。詳細は、CUPS印刷マネージャのヘルプを参照してください。
			</para>
		</sect2-->
	</sect1>
	<sect1 id="vine-cups-3">
		<title>コマンドラインからの印刷方法</title>
		<para>CUPSでは、テキストファイル、PostScript、画像といった様々な種類のファイルを直接、コマンドラインから印刷することができます。</para>
		<para>コマンドラインからファイルを印刷するには、<command>lp</command>または<command>lpr</command>コマンドを使用します。以下の様に特にオプションを指定しない場合は、デフォルトプリンタが使用されます。</para>
		<screen>$ <command>lp <filename>ファイル名</filename></command></screen>
		<para>また、オプションの使用によりプリンタを選択することができます。<command>lp</command>コマンドを使用する場合は、次の様に<option>-d</option>を使用します。</para>
		<screen>$ <command>lp <option>-d プリンタ名</option> <filename>ファイル名</filename></command></screen>
		<para><command>lpr</command>コマンドを使用する場合は、次の様に<option>-P</option>を使用します。</para>
		<screen>$ <command>lpr <option>-P プリンタ名</option> <filename>ファイル名</filename></command></screen>
		<para>なお、利用可能なプリンタ名を一覧表示するには、以下のコマンドを実行します。この際、<option>-d</option>を付加するとデフォルトプリンタ名も表示されます。</para>
		<screen>$ lpstat -p</screen>
	</sect1>
	<sect1 id="vine-cups-4">
		<title>トラブルシューティング</title>
		<qandaset>
		  	<qandaentry>
				<question><para>印刷できないが、何が起きているのかわからない。</para></question>
				<answer>
					<para>CUPS のログは /var/log/cups 以下に出力されます。<filename>/var/log/cups/error_log</filename> や <filename>/var/log/cups/access_log</filename> などがあります。ファイル名の最後に .数字 の付いてないものが最新のファイルです。</para>
					<para>通常のテキストファイルですので、ページャやエディタを使って読んでどんなメッセージが出力されているか、またそれがどんな意味なのかを調べてください。参照 <xref linkend="less" /></para>
					<para>ログファイルを見てもわからない場合には、さらに詳細なログを出力するように設定を変更し、再度印刷してログを確認してください。</para>
				</answer>
			</qandaentry>
		  	<qandaentry>
				<question><para>詳細なログを得るには？</para></question>
				<answer>
					<para>CUPS の設定ファイル /etc/cups/cupsd.conf の 154〜166行くらいのところに、LogLevel の設定の部分があります。</para>
					<para>LogLevel info となっていたら、さらに詳細な Log を出力するために、エディタを使って  LogLevel debug 等に書き換えてください。</para>

					<para>/etc/cups/cupsd.conf を書き換えた後で、設定を有効にするために CUPSサーバ を再起動してください。</para>
					
					<para>/etc/cups/cupsd.conf の書き換えと CUPSサーバ の再起動には root 権限が必要です。</para>

					<example id="cupsd.conf">
					  	<title>/etc/cups/cupsd.conf の書き換え</title>
						<screen>#
# LogLevel: controls the number of messages logged to the ErrorLog
# file and can be one of the following:
#
#     debug2    Log everything.
#     debug     Log almost everything.
#     info      Log all requests and state changes.
#     warn      Log errors and warnings.
#     error     Log only errors.
#     none      Log nothing.
#

<emphasis>#</emphasis>LogLevel info
<emphasis>LogLevel debug</emphasis>

</screen>
						<para>行頭に # をつけることでその行を無効にできます。</para>
						<para>LogLevel info と書かれている行に # をつけて無効にして、その次の行に新しい設定 LogLevel debug と書くと、変更前は LogLevel info だったということを残しておけます。</para>
					</example>

					<para>書き換えたら root権限で次のコマンドを実行して CUPSサーバ を再起動します。
					<screen># /etc/init.d/cups restart</screen></para>

					<para>再起動後に、再度印刷を実行し、どんなログが出力されているか確認してください。</para>
				</answer>
			</qandaentry>
			<qandaentry>
				<question><para>ブラウザからhttp://localhost:631/にアクセスすると接続を拒否されます。</para></question>
				<answer>
					<para>まず、CUPSサーバが起動しているかを次のようにGNOME端末等で確認してください。
<screen>$ /etc/init.d/cups status
cupsdは停止しています</screen>
						の様に表示されれば、CUPSサーバが起動していないのが原因です。root権限で次のコマンドを実行してCUPSサーバを起動してください。</para>
					<screen># /etc/init.d/cups start</screen>
					<para>ここで以下の様に表示されれば、CUPSサーバが起動していますので再度アクセスしてみて下さい。</para>
					<screen>cupsを起動中:                                              [  OK  ]</screen>
				</answer>
			</qandaentry>
			<qandaentry>
				<question><para>私が使っているプリンタ用のドライバが用意されていません。</para></question>
				<answer>
					<para>
						もし、お使いのプリンタ用のドライバが見つからなかったら、他のプリンタ向けのドライバが用意されていないかapt-getを利用して『foomatic』などをキーワードに検索してみてください。該当しそうなパッケージがあればインストールしてみると良いかもしれません。
					</para>
					<para>ドキュメント就筆時点では、<xref linkend="packages" />の様なパッケージが存在しています。</para>
					<para>なお、インストール後はCUPSサーバを再起動してください。</para>
					<para>該当するパッケージがないならば、お使いのプリンタのlinuxでの対応状況を調べておくと良いでしょう。『linux &lt;プリンタの型番&gt;』をキーワードに検索エンジンを利用してみてください。</para>
					<para>もし、CUPSでは使用できないが従来のLPRngで使用できるプリンタであればLPRng(Plusに収録)をお使い下さい。LPRngを使用する場合のプリンタの設定方法については、<ulink url="vine-lprng.html">LPRngによる印刷環境の設定方法と使用方法</ulink>を御覧ください。</para>
					<table id="packages">
						<title>Plusにあるパッケージ</title>
						<tgroup cols="2">
							<tbody>
								<row>
									<entry>foomatic-ppd-hpijs</entry>
									<entry>ヒューレットパッカード社のインクジェットプリンタ用</entry>
								</row>
								<row>
									<entry>foomatic-ppd-omni</entry>
									<entry>Omni社のプリンタ用</entry>
								</row>
							</tbody>
						</tgroup>
					</table>
					<example id="install-foomatic-hpijs">
						<title>foomatic-hpijsをインストールする場合の例</title>
<screen># apt-get install foomatic-hpijs
# /etc/init.d/cups restart</screen>
					</example>
				</answer>
			</qandaentry>
			<qandaentry>
				<question><para>2.x からのアップグレード環境でCUPSを利用するには?</para></question>
				<answer>
					<para>アップグレード時には、CUPSが利用できる状態になっていません。CUPSを利用できるようにするためには、以下の手順をroot権限で実行して下さい。</para>
<screen># /sbin/update-alternatives --auto print
# apt-get --reinstall install cups</screen>
				</answer>
			</qandaentry>
		</qandaset>
	</sect1>
	<sect1 id="vine-cups-5">
		<title>参考文献</title>
		<itemizedlist>
			<listitem><para><ulink url="http://localhost:631/help/">CUPS ヘルプページ</ulink></para></listitem>
			<listitem><para><xref linkend="using-rpm" /></para></listitem>
		</itemizedlist>
	</sect1>
</chapter>

<!--
vi:syntax=docbkxml
-->
