Web Interface V6.0 for AH FormatterDockerイメージ

タグ

Dockerイメージには、メジャーおよびポイントリリース番号と改訂番号とビルド番号が付いています。『Formatter』 の改訂版リリースは、すべて同じメジャー番号およびポイントリリース番号でタグ付けされていますが、改訂番号およびビルド番号が異なります。また、すべてのイメージは、latest バージョンとしてタグ付けされています。改訂版リリースごとに、Docker Hub に latest、メジャーおよびポイントリリース番号でタグ付けされている Dockerイメージは最新のイメージへ入れ替えられます。次の表は、『Formatter V7.4』でリリースごとに付けられるタグの例を示しています。

ラベル

『Formatter』 の Dockerイメージのバージョン情報は docker inspect を使って取得できます。

$ docker inspect --format='{{.Config.Labels.about}}' antennahouse/xdsserver:7
AHFCmd : Antenna House Formatter V7.4 R1 Linux : 7.4.1.63121 (2023-12-20T11:05+09)

『Web Interface』サーバプログラムの場合も同様です。

$ docker inspect --format='{{.Config.Labels.xdsserverabout}}' antennahouse/xdsserver:7
xds version: 6.0MR11 (409) 2024-01-05 14:31 JST

Web Interface サーバプログラム

『Web Interface』サーバプログラムは、暗号化されていない接続または SSL を使用して保護されている接続のいずれかの受け入れが開始されると、構築されます。SSL パラメータは、Docker のコマンドラインまたはオプションファイルを使用して設定できます。

Dockerコンテナを開始

$ docker run -d --rm -p 9999:9999 --name=xdsserver antennahouse/xdsserver:7

コマンドラインで SSL パラメータを指定

OS によっては、キーストアパスワードを含むコマンドラインが、同じマシン上で実行されている他のプロセスで表示される場合があることに注意してください。

Bash：

$ docker run -d --rm -v `pwd`/keystore.jks:/xds/server/keystore.jks:ro \
     antennahouse/xdsserver:7 \
     -java-prop javax.net.ssl.keyStore keystore.jks \
     -java-prop javax.net.ssl.keyStorePassword 123456 -ssl \
     -p 9999:9999 --name=xdsserver antennahouse/xdsserver:7

コマンドプロンプト：

> java docker run -d --rm -v %cd%\keystore.jks:/xds/server/keystore.jks:ro ^
     antennahouse/xdsserver:7 ^
     -java-prop javax.net.ssl.keyStore keystore.jks ^
     -java-prop javax.net.ssl.keyStorePassword 123456 -ssl ^
     -p 9999:9999 --name=xdsserver antennahouse/xdsserver:7

Power Shell：

> docker run -d --rm -v $PWD/keystore.jks:/xds/server/keystore.jks:ro `
     antennahouse/xdsserver:7 `
     -java-prop javax.net.ssl.keyStore keystore.jks `
     -java-prop javax.net.ssl.keyStorePassword 123456 -ssl `
     -p 9999:9999 --name=xdsserver antennahouse/xdsserver:7

オプションファイルで SSL パラメータを指定

キーストアのパスワードがオプションファイルに格納されている場合、キーストアのパスワードはホストマシン上で実行されている他のプロセスからは見えません。ただし、プロセスに適切な権限が与えられていれば、オプション XML ファイルを読み取れる場合があります。

Bash：

$ docker run -d --rm -v `pwd`/keystore.jks:/xds/server/keystore.jks:ro \
     -v `pwd`/xds-ssl-options.xml:/xds/server/xds-options.xml:ro \
     --name=xdsserver antennahouse/xdsserver:7

コマンドプロンプト：

> docker run -d --rm -v %cd%\keystore.jks:/xds/server/keystore.jks:ro ^
     -v %cd%\xds-ssl-options.xml:/xds/server/xds-options.xml:ro ^
     --name=xdsserver antennahouse/xdsserver:7

Power Shell：

> docker run -d --rm -v $PWD/keystore.jks:/xds/server/keystore.jks:ro `
     -v $PWD/xds-ssl-options.xml:/xds/server/xds-options.xml:ro `
     --name=xdsserver antennahouse/xdsserver:7

SSL パラメータは、xds-ssl-options.xml ファイルで指定します。

<commandLine>
  <value>-java-prop</value>
  <value>javax.net.ssl.keyStore</value>
  <value>keystore.jks</value>
  <value>-java-prop</value>
  <value>javax.net.ssl.keyStorePassword</value>
  <value>123456</value>
  <value>-ssl</value>
</commandLine>

Dockerコンテナにメディアファイルをマウント

file: プロトコルを使用した、あるいは絶対パスを含むメディア参照は、『Web Interface』サーバプログラムのコンテナのパスとして扱われます。ホストマシン上のメディアファイルは、Dockerコンテナ内のそれらの位置にマウントできます。複数のメディアファイルまたは個々のメディアファイルを含むディレクトリは、『Formatter』 がドキュメントを組版するときに参照されるようにコンテナにマウントできます。コマンドプロンプト構文を使用した以下の例ではイメージを含むディレクトリをマウントしています。

> docker run -d --rm -v %cd%\img:/img:ro ^
   --name=xdsserver antennahouse/xdsserver:7

Dockerコンテナが実行中であることを確認

$ docker container ls
CONTAINER ID        IMAGE                       COMMAND                   CREATED             STATUS                    PORTS                              NAMES
c70ac7e48402        antennahouse/xdsserver:7    "java -jar xds-serve…"   15 minutes ago      Up 15 minutes (healthy)   0.0.0.0:9999->9999/tcp             xdsserver

コンテナ ID は、コンテナが実行されるたびに異なることに注意してください。

Dockerコンテナを停止

$ docker container stop xdsserver

Dockerコンテナに割り当てられた名前がない場合は、docker container ls が出力したコンテナ ID を使用します。次に例を示します。

$ docker container stop c70ac7e48402

Web Interface クライアントプログラム

Web Interface for 『Formatter』 のクライアントプログラムは、どのユーザでも実行できます。

プログラムを開始

$ java -jar xds-client.jar -d in/hello-world.fo -o hello-world.pdf

代替ホストまたはポート

『Web Interface』サーバプログラムは、別のマシンでホストさせることができます。また、デフォルト以外のポートを介して接続を受け入れることもできます。

$ java -jar xds-client.jar -d in/hello-world.fo -o hello-world.pdf \
    -xds-host localhost -xds-port 9999

Java システムプロパティで SSL を指定

キーストアの場所とパスワードを指定する Java システムプロパティは、java コマンドラインで -jar xds-client.jar パラメータの前に指定できます。

Bash：

$ java -Djavax.net.ssl.trustStore=`pwd`/keystore.jks \
     -Djavax.net.ssl.trustStorePassword=123456 \
     -jar xds-client.jar -xds-ssl -d in/hello-world.fo -o hello-world.pdf

コマンドプロンプト：

> java -Djavax.net.ssl.trustStore=%cd%\keystore.jks ^
     -Djavax.net.ssl.trustStorePassword=123456 ^
     -jar xds-client.jar -xds-ssl -d in/hello-world.fo -o hello-world.pdf

Power Shell：

> java -Djavax.net.ssl.trustStore=$PWD/keystore.jks `
     -Djavax.net.ssl.trustStorePassword=123456 `
     -jar xds-client.jar -xds-ssl -d in/hello-world.fo -o hello-world.pdf

-xds-java-prop で SSL パラメータを指定

また、『Web Interface』クライアントプログラムの -xds-java-prop パラメータを使用して、キーストアの場所とパスワードを Java システムプロパティに指定することができます。

Bash：

$ java -jar xds-client.jar -xds-ssl \
     -xds-java-prop javax.net.ssl.trustStore `pwd`/keystore.jks \
     -xds-java-prop javax.net.ssl.trustStorePassword 123456 \
     -d in/hello-world.fo -o hello-world.pdf

コマンドプロンプト：

> java -jar xds-client.jar -xds-ssl ^
     -xds-java-prop javax.net.ssl.trustStore %cd%\keystore.jks ^
     -xds-java-prop javax.net.ssl.trustStorePassword 123456 ^
     -d in/hello-world.fo -o hello-world.pdf

Power Shell：

> java -jar xds-client.jar -xds-ssl `
     -xds-java-prop javax.net.ssl.trustStore $PWD/keystore.jks `
     -xds-java-prop javax.net.ssl.trustStorePassword 123456 `
     -d in/hello-world.fo -o hello-world.pdf

オプションファイルで SSL パラメータを指定

XDS_CLIENT_CONFIG 環境変数がオプションファイルの絶対位置に設定されている場合、『Web Interface』 クライアントプログラムは、ファイルで指定されているデフォルトのコマンドラインオプションも使用します。クライアントプログラムのオプションファイルの形式は、サーバープログラムのオプションファイルの形式と同じです。キーストアの場所とパスワードを Java システムプロパティで指定するための -xds-java-prop パラメータは、オプションファイルに含めることができます。

<commandLine>
  <value>-xds-ssl</value>
  <value>-xds-java-prop</value>
  <value>javax.net.ssl.trustStore</value>
  <value>keystore.jks</value>
  <value>-xds-java-prop</value>
  <value>javax.net.ssl.trustStorePassword</value>
  <value>123456</value>
</commandLine>

Bash：

$ export XDS_CLIENT_CONFIG=`pwd`/client-option.xml
$ java -jar xds-client.jar -d in/hello-world.fo -o hello-world.pdf

コマンドプロンプト：

> XDS_CLIENT_CONFIG=%cwd%/client-option.xml
> java -jar xds-client.jar -d in/hello-world.fo -o hello-world.pdf

Power Shell：

> $env:XDS_CLIENT_CONFIG=$PWD/client-option.xml
> java -jar xds-client.jar -d in/hello-world.fo -o hello-world.pdf

フォルダ監視サービス

フォルダ監視サービスプログラムは、どのユーザでも実行できます。

プログラムを開始

$ java -jar xds-folder-monitor.jar monitoring monitoring/output

代替ホストまたはポート

『Web Interface』サーバプログラムは、別のマシンでホストさせることができます。また、デフォルト以外のポートを介して接続を受け入れることもできます。別のホストまたは別のポートを使用するには、対応する 『Web Interface』クライアントプログラムのオプションを、デフォルトのコマンドファイル、または対象となるファイルの各 zip アーカイブに含まれている command.txt ファイルに指定する必要があります。たとえば command-host-port.txt ファイルの内容が次のような場合です。

ARGS = -xds-host localhost -xds-port 9999

$ java -jar xds-folder-monitor.jar  \
    -default-command-file command-host-port.txt \
    monitoring monitoring/output

Java システムプロパティで SSL を指定

キーストアの場所とパスワードを指定する Java システムのプロパティは、java コマンドラインの -jar xds-folder-monitor.jar パラメータの前に指定できます。『Web Interface』 クライアントプログラムの SSL を有効にする -xds-ssl パラメータは、コマンドファイルの ARGS パラメータに含める必要があります。たとえば command-xds-ssl.txt が次のような場合です。

ARGS = -xds-ssl

Bash：

$ java -Djavax.net.ssl.trustStore=`pwd`/keystore.jks \
     -Djavax.net.ssl.trustStorePassword=123456 \
     -jar xds-folter-monitor.jar \
     -default-command-file command-xds-ssl.txt \
     monitoring monitoring/output

コマンドプロンプト：

> java -Djavax.net.ssl.trustStore=%cd%\keystore.jks ^
     -Djavax.net.ssl.trustStorePassword=123456 ^
     -jar xds-folder-monitor.jar ^
     -default-command-file command-xds-ssl.txt ^
     monitoring monitoring/output

Power Shell：

> java -Djavax.net.ssl.trustStore=$PWD/keystore.jks `
     -Djavax.net.ssl.trustStorePassword=123456 `
     -jar xds-folder-monitor.jar `
     -default-command-file command-xds-ssl.txt `
     monitoring monitoring/output

-java-prop で SSL パラメータを指定

また、フォルダ監視サービスの -java-prop パラメータを使用して、キーストアの場所とパスワードを Java システムプロパティに指定することができます。-xds-ssl もコマンドファイルの ARGS パラメータに含める必要があります。

Bash：

$ java -jar xds-folder-monitor.jar \
     -java-prop javax.net.ssl.trustStore `pwd`/keystore.jks \
     -java-prop javax.net.ssl.trustStorePassword 123456 \
     -default-command-file command-xds-ssl.txt \
     monitoring monitoring/output

コマンドプロンプト：

> java -jar xds-folder-monitor.jar ^
     -java-prop javax.net.ssl.trustStore %cd%\keystore.jks ^
     -java-prop javax.net.ssl.trustStorePassword 123456 ^
     -default-command-file command-xds-ssl.txt ^
     monitoring monitoring/output

Power Shell：

> java -jar xds-folder-monitor.jar `
     -java-prop javax.net.ssl.trustStore $PWD/keystore.jks `
     -java-prop javax.net.ssl.trustStorePassword 123456 `
     -default-command-file command-xds-ssl.txt `
     monitoring monitoring/output

コマンドファイルですべての SSL パラメータを指定

フォルダ監視サービスのコマンドライン -java-prop パラメータの代わりに、対応する -xds-java-prop パラメータをコマンドファイルで使用できます。たとえば command-xds-ssl-java-prop.txt が次のような場合です。

ARGS = -xds-ssl
ARGS = -xds-java-prop javax.net.ssl.trustStore C:/path/to/keystore.jks
ARGS = -xds-java-prop javax.net.ssl.trustStorePassword 123456

Bash：

$ java -jar xds-folder-monitor.jar \
     -default-command-file command-xds-ssl-java-prop.txt \
     monitoring monitoring/output

コマンドプロンプト：

> java -jar xds-folder-monitor.jar ^
     -default-command-file command-xds-ssl-java-prop.txt ^
     monitoring monitoring/output

Power Shell：

> java -jar xds-folder-monitor.jar `
     -default-command-file command-xds-ssl-java-prop.txt `
     monitoring monitoring/output