IM-PDFAutoConverter for Accel Platform セットアップガイド 第20版 2023-10-01

6.1. PDF変換サーバ での作業

PDF変換サーバ での作業内容を説明します。

6.1.1. Apache Tomcat のセットアップ

Apache Tomcat の構築手順を示します。

Apache Tomcat は PDF変換サーバ に構築します。

6.1.1.1. Javaランタイムのインストール

  1. PDF変換サーバ に管理者権限(Administrator)のあるユーザでログインしてください。

    PDF変換サーバ で使用する JDK は、 intra-mart Accel Platform で使用する JDK とバージョンを合わせてください。

  2. Javaランタイムをダウンロードします。Javaランタイムのインストーラは、オラクル社のサイトからダウンロードできます。

    http://java.com/ja/download/ (2020年8月 現在)

  3. ダウンロードしたインストーラから、インストールを行います。インストールに関する詳細は、オラクル社のサイトを参照してください。

  4. インストール完了後に、コマンドラインに以下を入力しリターンキーを押します。

    > java -version
    
  5. コマンドラインにJavaのバージョン情報が表示されたら、インストールは成功です。

6.1.1.2. Apache Tomcat のインストール

  1. PDF変換サーバ に管理者権限(Administrator)のあるユーザでログインしてください。

  2. Apache Tomcat のインストーラをダウンロードします。

    http://tomcat.apache.org/ (2020年8月 現在)

  3. ダウンロードしたインストーラから、インストールを行います。

    インストールに関する詳細は、該当ドキュメントを参照してください。

  4. 各サーバの環境に合わせて、 Apache Tomcat を適宜 設定してください。

  5. Apache Tomcat のポート番号は Resinサーバ のポート番号と衝突しないようにしてください。

    Apache Tomcat のポート番号は %CATALINA_HOME%/conf/server.xml にて設定できます。

6.1.2. PDFコンバータXP のインストール

  1. PDF変換サーバ に管理者権限(Administrator)のあるユーザでログインしてください。
  2. PDFコンバータXP インストール・ガイド 」 の 「PDFコンバータXP のインストール」 に沿って、インストールしてください。
  3. OSを再起動してください。

注意

UACの監視下にあるディレクトリにインストールした場合、ディレクトリの読み書きにおいて制限を受ける可能性があります。

そのため、 PDFコンバータXP のインストール先に、Program Files等UACの監視下にあるディレクトリは避けてください。

インストール先の例は、次の通りです。

C:\tool\PDFconverter\

6.1.3. PDFオートコンバータEX のインストール

  1. PDF変換サーバ に管理者権限(Administrator)のあるユーザでログインしてください。
  2. PDFオートコンバータEX インストール・ガイド 」 の 「PDFオートコンバータEX のインストール」 に沿って、インストールしてください。
  3. OSを再起動してください。

注意

UACの監視下にあるディレクトリにインストールした場合、ディレクトリの読み書きにおいて制限を受ける可能性があります。

そのため、 PDFオートコンバータEX のインストール先に、Program Files等UACの監視下にあるディレクトリは避けてください。

インストール先の例は、次の通りです。

C:\tool\AutoConverterEX\

注意

異なるバージョンの、 PDFオートコンバータEX がインストールされている環境では、インストール前に以下のフォルダを削除してください。

C:/YSS_Settings/Auto Converter EX

上記フォルダは隠しフォルダとなっているため、フォルダ名を直接入力し削除ください。

6.1.4. 環境設定

6.1.4.1. PDFオートコンバータEX の環境設定

  1. PDFオートコンバータEX インストール・ガイド 」 の以下の章の設定をしてください。
    • 「【重要】WindowsServer xxxxx における必須の設定」
    • 「共通で設定したほうが良い事項(推奨)」
    • 「アプリごとの変換に必要な設定(必須)」

6.1.4.2. 環境変数の設定

  1. PDF変換サーバ に管理者権限(Administrator)のあるユーザでログインしてください。

  2. 以下の環境変数を設定します。

    環境変数は、 Apache Tomcat の起動ユーザから参照できるよう設定してください。

    IM-PDFCoordinator を同じサーバにインストールしている場合は、

    環境変数の順番が PDFメイクアップ、PDFオートコンバータEX となるよう注意してください。

    順番を間違えますと動作しません。

    環境変数は、通常であればシステム環境変数に設定いただければ問題ありません。

    環境変数名 設定内容
    PATH % PDFオートコンバータEX のインストールフォルダ%/bin
  3. 以下を設定してください。

    Apache Tomcat の共通libフォルダ(%CATALINA_HOME%/libが一般的)に、<autoex.jar> ファイルを配置します。

    <autoex.jar> ファイルは、libフォルダにあります。

    場所 ファイル名
    %CATALINA_HOME%/lib autoex.jar
  4. コマンドプロンプトを起動し、以下のコマンドを実行してください。

    > yexset
    
  5. 以下の画面が表示されれば環境変数の設定は完了です。

    ../../../_images/index_pdfserver_1.png

コラム

環境変数設定後は、必ず Resin をプロセスごと再起動してください。

6.1.4.3. warファイルのデプロイ

  1. serverフォルダを開き、<autoexsoap.war> ファイルを、 Apache Tomcat のWEBアプリケーション配置ディレクトリにコピーします。

    通常は %CATALINA_HOME%/webapps です。

  2. autoexsoap.war ファイルを、<axis2.war> にリネームします。

注意

warファイルのデプロイには、WEBアプリケーションサーバ( Apache Tomcat 等)が停止している必要があります。

6.1.4.4. 設定ファイルの編集

  1. axis2.xml ファイルを環境に合わせて修正してください。

    ファイル 場所
    axis2.xml %CATALINA_HOME%/webapps/axis2/WEB-INF/conf

    attachmentDIR は、クライアントからアップロードされるファイルの一時保存先です。必ず指定する必要があります。

    <axisconfig name="AxisJava2.0">
       ~~~~~~~~省略~~~~~~~~~
       <!--Uncomment if you want to enable file caching for attachments -->
       <parameter name="cacheAttachments">true</parameter>
       <!-- 添付ファイル(クライアントからアップロードされるファイル)の一時保存先です。必ず指定してください -->
       <parameter name="attachmentDIR">C:\tmp</parameter>
       <parameter name="sizeThreshold">4000</parameter>
       ~~~~~~~~省略~~~~~~~~~
    </axisconfig>
    
  2. 修正後にサーバを再起動してください。

  3. 以上で作業は完了です。

6.1.4.5. Apache Tomcat の起動

  1. Apache Tomcat を起動してください。 Apache Tomcat はWindowsにログインし手動起動をお願いいたします。

注意

環境設定は、 Apache Tomcat の起動ユーザで行ってください。

環境設定を行ったユーザと、 Apache Tomcat の起動ユーザが異なる場合、正常に動作しません。