手順1:JDBCデータソース名の確認
配信管理サーバでは、Interstage Application ServerのJDBCデータソースの機能を利用しています。手順3で、データソース名として「LWLDSTDS」を設定します。同じサーバの他のシステムでInterstage Application ServerのJDBCデータソースを利用しており、すでにデータソース名「LWLDSTDS」を利用しているかを確認します。
JDBCデータソース名を確認する方法は以下のとおりです。
Webブラウザで、以下に示すURLを指定し、Interstage管理コンソールのログイン画面を表示します。
https://hostname:port/IsAdmin
List Worksサーバ(配信管理サーバがインストールされているサーバ)のホスト名を指定します。
Interstage管理コンソールのポート番号を指定します。デフォルトは12000です。
注意
SSL暗号化通信を使用しない設定を行った場合は、「https」の部分を「http」に置き換えて指定してください。
管理者権限を持つユーザIDとパスワードを指定し、【ログイン】ボタンをクリックします。
→Interstage管理コンソールの画面が表示されます。
【Interstage管理コンソール】-【Interstage Application Server】-【システム】-【リソース】-【JDBC】をクリックします。
→右の画面にJDBCデータソースの一覧が表示されます。
一覧に「LWLDSTDS」がないことを確認します。
「LWLDSTDS」が存在する場合は、手順3で、印刷配信の動作環境定義ファイルの「db.datasourcename」キーに別の値を設定してください。
配信フォルダの帳票を格納するフォルダを、List Worksサーバのローカルドライブに作成します。
フォルダを作成する場所は、帳票を格納するのに必要なディスク容量を考慮し、フォルダのパスが100バイト以内になるようにします。
必要なディスク容量については、“1.6.4 配信フォルダのディスク容量”を参照してください。 |
フォルダには、以下のアクセス権を設定してください。設定されていない場合、配信フォルダの作成や帳票登録ができない可能性があります。
また、フォルダへの不当なアクセスを防止する目的で、以下のアクセス権の設定を除いて、必要以上にアクセスができるような設定はしないようにすることを推奨します。
List Worksサービス、サービス「LW Transfer Service」、サービス「TransactionDirector」に設定されているログオンアカウントのユーザに対し、フルコントロールのアクセス権を設定します。
通常、ログオンアカウントはシステムアカウントが設定されています。ログオンアカウントにシステムアカウントが設定されている場合は、SYSTEMに対しフルコントロールのアクセス権を設定します。
配信管理サーバの環境設定用のコマンドおよび運用用のコマンドを実行する管理者権限を持つユーザに対し、フルコントロールのアクセス権を設定します。
List Creator互換印刷機能を利用する場合は、帳票出力アプリケーションの実行ユーザに対し、フルコントロールのアクセス権を設定します。
注意
配信フォルダの帳票を格納するフォルダ配下には、ファイルやフォルダを格納しないでください。
参考
ここで作成したフォルダは、手順3で印刷配信の動作環境定義ファイルの「folder.rootpath」キーに指定します。
印刷配信の動作環境定義ファイル(lwmctr.conf)を編集します。動作環境定義ファイルの雛形は、以下の場所に格納されています。
List Worksのインストール先フォルダ\Distribute\manager\conf
印刷配信の動作環境定義ファイルの編集規約とキーの説明を以下に示します。
1行1項目で指定してください。
キーと値の指定は、「キー=値」の形式で指定してください。
設定値の後に、続けて全角の空白文字や半角の空白文字を入力しないで改行してください。
コメントを記述する場合は、行頭に「#」を記述してください。
行は削除しないでください。
追加した行の最後は、必ず改行してください。
シフトJISコードで記述してください。
キー名を変更しないでください。キー名を誤って指定した場合、設定は無効となります。
同一のキー名が重複して指定された場合は、後で指定した値が有効となります。
印刷配信の動作環境定義ファイルの以下のキーを設定します。
注意
キーに指定する内容が以下の場合は、手順4でコマンドを実行したときに、エラーとなります。
必須の項目を省略した場合
指定できる数値以外の値を指定した場合
指定できる文字列長を超えた値を指定した場合
使用できない文字種を指定した場合
キー名 | キーの設定内容(設定値) | 必須 | 雛形における設定値 |
---|---|---|---|
配信データベースの作成時に指定したRDBシステム名を8バイト以内の半角英数字で指定します。 通常は設定値を変更する必要はありません。 | ○ | LWLDSTDB | |
データベースサーバのIPアドレスまたはホスト名を15バイト以内の半角文字で指定します。配信データベースと配信管理サーバが同じ筐体にある場合、「localhost」または「127.0.0.1」を指定します。 | ○ | localhost | |
配信データベースの作成時に指定したポート番号を指定します。 配信データベースと配信管理サーバが異なる筐体にある場合に指定する必要があります。 | ○(注1) | 2056 | |
配信データベースに接続するための資源名(データソース名)を27バイト以内の半角英数字で指定します。 通常は設定値を変更する必要はありません。 手順1で同じデータソース名を利用していることが確認された場合に、別のデータソース名を指定します。 | ○ | LWLDSTDS | |
配信データベースに接続するユーザIDを18バイト以内の半角英数字で指定します。データベースサーバの管理者権限を持つユーザIDを指定します。 注意 セキュリティの面から、パスワードがあるユーザIDを指定することを推奨します。 | ○ | - | |
db.useridで指定したユーザのパスワードを14バイト以内の半角文字で指定します。 | ○ | - | |
JDBCアーカイブファイル(fjsymjdbc2.jar)を255バイト以内の絶対パスで指定します。 以下のパスを指定します。 Symfoware Server クライアント機能のインストール先フォルダ\JDBC\fjjdbc\lib\fjsymjdbc2.jar | ○ | C:\SFW\SFWCLNT\JDBC\fjjdbc\lib\fjsymjdbc2.jar | |
帳票印刷配信機能を使用するユーザの認証方法を指定します。
| ○ | 0 | |
帳票印刷配信機能を使用するユーザの認証先を指定します。 certificate.modeで0(オペレーティングシステムによる認証)を指定した場合は必須項目です。
| ○(注2) | 1 | |
認証先のドメイン名を15バイト以内の半角文字で指定します。 certificate.modeに0(オペレーティングシステムによる認証)を指定して、certificate.typeに3(他のドメイン)を指定した場合は必須項目です。 | ○(注3) | ||
List Worksサーバのホスト名またはIPアドレスを255バイト以内の半角文字(注4)で指定します。配信出力サーバから配信管理サーバに通信するときに利用します。配信管理サーバと配信出力サーバが別筐体の場合は、「localhost」または「127.0.0.1」を指定しないでください。 | ○ | - | |
配信出力サーバを運用するサーバのWebサーバに設定しているポート番号を1~65535の範囲で指定します。すでに「80」を使用している場合は、別の値に変更します。帳票の印刷時に利用します。 配信出力サーバの環境設定で設定するWebサーバのポート番号は、本項目と合わせてください。 | ○ | 80 | |
List WorksサーバのWebサーバに設定しているポート番号を1~65535の範囲で指定します。すでに「80」を使用している場合は、別の値に変更します。印刷管理で配信出力サーバとの通信に利用します。 | ○ | 80 | |
“3.4 ネットワークの設定”でservicesファイルに指定した、サービス「LW Transfer Service」が使用するポート番号を1~65535の範囲で指定します。配信出力サーバとの通信に利用します。 | ○ | 9564 | |
帳票登録時に、作成ユーザIDが指定されなかった場合に、帳票に設定する作成ユーザIDを64バイト以内の半角文字(注4)で指定します。 | ○ | Administrator | |
手順2で作成した、配信フォルダの帳票を格納するフォルダのパスを、100バイト以内の絶対パスで指定します。(注5) | ○ | C:\ListWORKS\Distribute\manager\managefolder |
注1:配信データベースと配信管理サーバが同じ筐体にある場合は、指定しても無効になります。
注2:certificate.modeで5(ユーザ作成ライブラリによる認証)を指定した場合は省略できます。
注3:certificate.typeで1(このコンピュータ)または2(このコンピュータが所属するドメイン)を指定した場合は省略できます。
注4:指定できる半角記号は、以下のとおりです。
指定項目 | 空白 | ! | " | # | $ | % | & | ' | ( | ) | * | + | , | - | ` | . |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
server.hostname | ○ | ○ | ||||||||||||||
default.userid | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ | ○ |
指定項目 | / | : | ; | < | = | > | ? | @ | [ | \ | ] | ^ | _ | { | | | } | ~ |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
server.hostname | |||||||||||||||||
default.userid | ○ | ○ | ○ | ○ | ○ | ○ |
○:指定できる文字
注5:配信管理サーバの環境設定後や運用中に、「folder.rootpath」キーの値を変更する場合は、サービスの停止などの操作が必要です。
「folder.rootpath」キーの値を変更する場合の手順については、“8.1 配信フォルダの帳票を格納するフォルダの変更”を参照してください。 |
注意
配信管理サーバで指定するユーザの認証方法および認証先は、リスト管理サーバと同じ方法を指定してください。
印刷配信の動作環境定義ファイルの記述例を以下に示します。
#データベースの設定 db.systemname=LWLDSTDB db.hostname=localhost db.port=2056 db.datasourcename=LWLDSTDS db.userid=Administrator db.password=ListWorks classpath.jdbc=C:\SFW\SFWCLNT\JDBC\fjjdbc\lib\fjsymjdbc2.jar #認証 certificate.mode=0 certificate.type=1 #certificate.domainname=ドメイン名 #配信管理サーバホスト名 server.hostname=SYS1 #ポート番号 delivery.writer.web.port=80 delivery.manager.web.port=80 delivery.manager.filetrans.port=9564 #帳票作成ユーザ default.userid=Administrator #格納場所 folder.rootpath=C:\ListWORKS\Distribute\manager\managefolder
印刷配信の動作環境定義ファイルに指定した値を有効にするため、lwdstmgrenvコマンドを実行します。
lwdstmgrenvコマンドについては、“14.1.3 lwdstmgrenvコマンド”を参照してください。 |
注意
印刷配信の動作環境定義ファイルには、配信データベースに接続するためのユーザIDやパスワードが記述されています。配信データベースへの不当なアクセスを防止する目的で、印刷配信の環境設定後、印刷配信の動作環境定義ファイルをList Worksサーバ上から削除し、別の場所で大切に管理することを推奨します。
lwdstmgrenvコマンドの実行後は、必ず配信データベースの接続確認を行ってください。
手順5:配信データベースの接続確認
配信管理サーバと配信データベースの接続確認をします。
配信管理サーバと配信データベースの接続確認をする方法を以下に示します。
Webブラウザで以下に示すURLを指定し、Interstage管理コンソールを起動します。管理者権限を持ったアカウントでログインします。
https://hostname:port/IsAdmin
List Worksサーバ(配信管理サーバがインストールされているサーバ)のホスト名を指定します。
Interstage管理コンソールのポート番号を指定します。デフォルトは12000です。
注意
SSL暗号化通信を使用しない設定を行った場合は、「https」の部分を「http」に置き換えて指定してください。
→Interstage管理コンソールの画面が表示されます。
【Interstage管理コンソール】-【Interstage Application Server】-【システム】-【環境設定】をクリックします。
クラスパスを指定します。
【クラスパス】エディットボックスに、JDBCアーカイブファイル(fjsymjdbc2.jar)の絶対パスを追加します
Symfoware Server クライアント機能のインストール先フォルダ\JDBC\fjjdbc\lib\fjsymjdbc2.jar
例) C:\SFW\SFWCLNT\JDBC\fjjdbc\lib\fjsymjdbc2.jar
参考
配信データベースの接続確認後、追加したクラスパスを削除しても運用上問題ありません。
【Interstage管理コンソール】-【Interstage Application Server】-【システム】-【リソース】-【JDBC】をクリックします。
→右の画面にJDBCデータソースの一覧が表示されます。
一覧からデータソース名「LWLDSTDS」をクリックして、環境設定画面を表示します。
注意
印刷配信の環境設定の「db.datasourcename」キーで「LWLDSTDS」以外を指定している場合は、指定したデータソース名をクリックしてください。印刷配信の環境設定はlwdstmgrenvコマンドで確認してください。
環境設定画面の【DB接続テスト】ボタンをクリックし、配信データベースの接続確認をします。
接続確認に成功した場合は、以下の内容のメッセージが表示されます。
IS: 情報: is40303: JDBCデータソース接続テストに成功しました(定義名=LWLDSTDS)
接続確認に失敗した場合は、以下の内容のメッセージが表示されます。メッセージに表示されるエラー情報を参考にして、“手順3:印刷配信の動作環境定義ファイルの編集”から再度行ってください。
IS: エラー: is40304: JDBCデータソース接続テストに失敗しました(定義名=LWLDSTDS, エラー情報=[SymfoWARE ODBC Driver][SymfoWARE Server] JYP1011E 利用者の認証ができません.)