ApacheとJBOSSの連携 - その2 - Apache/JBossの設定

前回、「ApacheとJBOSSの連携 - その１ mod_jk.so の入手方法」でmod_jk.soの準備ができたら、ApacheとJBossのセットアップです。

前提条件：

• ApacheはD:\app\Apache2.2にインストール済み (Versionは2.2.22)
• JBOSSはD:\app\jboss-5.1.0.GA-jdk6\jboss-5.1.0.GAにインストール済み (Versionは5.1.0GA-jdk6)
• Apache, JBOSSは同じマシン上にインストールされている(Windows 2008)
• ApacheとJBOSSはTomcat Connector (mod_jk.so)で連携
• Apacheと連携させるWeb Application はJBossの管理アプリケーションであるweb-console, admin-console, jmx-console とする

目的：

ユーザーがWeb Application Serverに8080ポートでアクセスしている状態（いわゆる直アクセス）であるところを、Front End HTTPサーバーとしてApacheを立ててWell known Portである80番ポートでアクセスできるようにしてあげる。

図で表すと、こういう状態を

このようにします。

手順：

Apache側のセットアップ 

セットアップの概要はこんな感じ

1. conf/httpd.confを修正

ファイルの最下行に、次のInclude Statement 1行を追加

Include conf/mod_jk.conf

*Apacheに「mod_jkを使うよ、詳しくはconf/mod_jk.confを見てね」と言っている

2. conf/mod_jk.confを作成

メモ帳を開き、次の6行をコピペして、mod_jk.confファイルとして保存、confフォルダの下に置く

LoadModule jk_module modules/mod_jk.so
JkWorkersFile conf/workers.properties
JkLogFile logs/mod_jk.log
JkMount /admin-console/* node1
JkMount /jmx-console/* node1
JkMount /web-console/* node1

ステップ1の[Include]の設定で、Apacheはこのファイルを見に来る。

まず、ここではApacheにロードしてもらいたいmod_jk.soモジュールの場所を伝え[LoadModule]、mod_jk.soモジュールに関するログを出力するファイルの場所を指定している[JkLogFile]。

ユーザーからのHTTPリクエストのURLに/admin-console/、/jmx-console/、/web-console/が入っている場合にnode1 (worker) にリクエストを転送するよう指示している[JkMount]。Apacheはリクエストをnode1に転送すれば良いことは理解できたがnode1は何処か? 転送先情報はまだ知らない。

node1の転送先情報は、[JkWorkersFile] で指定されたconf/workers.propertiesで定義されているので、次にconf/workers.propertiesのファイルを見に行く。

3. conf/workers.propertiesを作成

メモ帳を開き、次の5行をコピペして、workers.propertiesとして保存、confフォルダの下に置く

worker.list=node1
worker.node1.port=8009
worker.node1.host=server1
worker.node1.type=ajp13

ステップ2の[JkWorkersFile]の設定で、Apacheは転送先情報を知るためこのファイルを見に来る。

workers.propertiesファイルでは、node1という名前のWorkerはここで定義されていて[worker.list]、node1のHost名（またはIP）、ポート番号とタイプが定義されている[worker.node1.port], [worker.node1.host], [worker.node1.type]。

4. mod_jk.soをApacheサイトからDownloadしてmodulesフォルダに置く

mod_jk.soのDownload方法は前回の ApacheとJBOSSの連携 - その１ mod_jk.so の入手方法 を参照。

JBOSS側のセットアップ

JBOSS起動用バッチ(run.bat) にbオプションでJBOSSがListenするアドレスを指定（ホスト名もしくはIP）しておく。　（今回は、run.bat -b 0.0.0.0 と設定している、0.0.0.0は、server1上のすべてのNetwork Interface (NIC) のアドレスでJBossはリスエストを受け付けるようになる）

オプション付きでJBossを起動する方法として、過去紹介したように起動用バッチを準備したり、下の例のようにrun.batのショートカットを作成して、プロパティで-bオプションをつけてやる方法がある。

Apache/JBOSSを起動と動作確認

以上の設定が終わったら、Apache/JBOSSを起動する。　下記URLがちゃんと表示されたら設定完了（server1の部分は実際のサーバーホスト名に変更してください）。

http://server1/admin-console/
http://server1/jmx-console/
http://server1/web-console/

最後に：

今回はHTTP（Apache）とWeb Application Server（JBoss）が同じマシンにある場合の設定方法を紹介したが、下図のようにserver1, server2と別々のマシンに別れている場合は、workers.propertiesのnode1.hostを変えてやれば良い。

ApacheとJBOSSの連携 - その1 - mod_jk.so の入手方法

今回は、ApacheとJBOSSの連携 その１ として、手始めに（そして、ちょっと丁寧に）
mod_jk.so の入手方法をまとめてみる。

前提条件

• ApacheはD:\app\Apache2.2にインストール済み (Versionは2.2.22)
• JBOSSはD:\app\jboss-5.1.0.GA-jdk6\jboss-5.1.0.GAにインストール済み (Versionは5.1.0GA-jdk6)
• Apache, JBOSSは同じマシン上にインストールされている(Windows 2008)
• ApacheとJBOSSはTomcat Connector (mod_jk.so)で連携

mod_jk.so の入手方法

　1. Apache - nearby FTP mirror siteにアクセス
　　　http://www.apache.org/ のDownloadリンクからアクセス
　　　またはURL ( http://www.apache.org/dyn/closer.cgi) から直接アクセス

　2. 最寄りのミラーサイトのリストから、いずかのサイトにアクセス

　3. ミラーサイトにアクセスできたら下記の順でディレクトリを辿る
　　　tomcat --> tomcat-connectors --> jk --> binaries --> windows

　4. 最新版のtomcat-connectorsから使用する環境に対応したものをDownloadする
　　しかし、通常下のように7つのバージョンがあり、どのバージョンが選ぶべきかは
　　ファイル名の意味を理解する必要がある

　　　(a) tomcat-connectors-1.2.37-windows-i386-httpd-2.0.x.zip
　　　(b) tomcat-connectors-1.2.37-windows-i386-httpd-2.2.x.zip
　　　(c) tomcat-connectors-1.2.37-windows-i386-httpd-2.4.x.zip
　　　(d) tomcat-connectors-1.2.37-windows-i386-iis.zip
　　　(e) tomcat-connectors-1.2.37-windows-i386-iplanet.zip
　　　(f) tomcat-connectors-1.2.37-windows-x86_64-httpd-2.4.x.zip
　　　(g) tomcat-connectors-1.2.37-windows-x86_64-iis.zip

　　　この場合:

• 1.2.37はtomcat-connectorsのバージョン（大抵、最新の方が良い）
• i386は32-bit Windows OSで、x86_64は64-bit Windows OS用 (XP, 7, 2003, 2008などは不問)
• httpdはApache、iisはIIS、iplanetはNetscapeとの連携用であることを意味している
• httpdはさらにApacheのバージョン毎 (2.0.x, 2.2.xと2.4.x) にBinaryが提供されている

　　　以上を踏まえると今回は「Windows 32-bit版のApache2.2.22」を使うので

　　　  (b) tomcat-connectors-1.2.37-windows-i386-httpd-2.2.x.zip

　　　をDownloadするのが正解となる。


　5. tomcat-connectorsがDownloadできたらUnzipして、mod_jk.soをゲット。
　　ApacheのModulesディレクトリに置いて準備完了


次回（ApacheとJBOSSの連携 - その2 - Apache/JBossの設定）に続く。。。

org.w3c.dom.Document の XML parse で Exception あるある

Double-Byteの文字が入っているXMLファイルをParseする際に良くある失敗

Invalid byte 1 of 1-byte UTF-8 sequence.


XMLにDouble-Byteが入っているなら、対応するEncodingを指定してあげましょう
上の例であれば、読み込み対象のXMLファイルのEncodingがUTF-8になっているはずなのでこれをShift-JISに変えます。

<?xml version="1.0" encoding="UTF-8"?> 
 -->
<?xml version="1.0" encoding="Shift-JIS"?>

そもそもDouble-Byteが入っているのにEncodingがUTF-8であるXMLファイルは、それ自体XMLファイルとしてFormatが成立していない訳なんですが、自分の場合は、強引にXMLファイルを作成するケースが多いので、なんども同じ過ちを繰り返してしまう。。。

あるよね～ （え？ないですか？）

Oracle Enterprise Manager (OracleDBConsole) がアクセスできない！？

背景：

ある日、突然 EM (Oracle Enterprise Manager) のWeb Consoleが使えなくなった

Internet Explorer ではこのページは表示できません

Windows Service "OracleDBConsole" は開始になってるし、%ORACLE_HOME%\sysman\log\emdb.nohupなどを確認しても問題なく動いているし。。。
でも、 https://hostname:1158/emにアクセスしようとすると、やっぱり

Internet Explorer ではこのページは表示できません

なんで？

やったこと： 

いちおうセオリーに則って。。。

1．Windows ServiceからEM ("OracleDBConsole") の再起動 --> 復旧せず

2．EMの再生成 --> 復旧せず

• 　emca -deconfig dbcontrol db -repos drop

• 　emca -config dbcontrol db -repos create

create 途中で、「'job_queue_processes' must be greater than or equal to 1.」と怒られたので、alter system set job_queue_processes=1 scope=both; でjob_queue_processesを1にしてみる、そういえばこの前この値を変更したわぁ、きっとこれが原因に違いないと思ったが、結局 create後も現象は復旧せず

3． そもそもEM自体は問題なく動いてたわけだし、1. 2.ともに解決策になるわけもないことを確認する。「Internet Explorer ではこのページは表示できません」という現象を考察し直す。　サーバーサイドエラー（500系）ではないので、ブラウザ側の設定の問題かも知れないと思う（今更ですが。。。）

4. 試しにFireFoxでアクセスしてみる -->動いた！（ていうか、そもそも動いてたー！）

5. そういえばIEを8に上げていたんだった

6．IE設定の問題かと思うけど、FireFoxを使うからいいや、ということで、とりあえずおしまい。ここまでで 3時間を無駄にした

まとめ：

IEだとページがロードできなかったので、FireFoxを使うことにした。
IEのSSLやTLSあたりの設定が原因かと思うが、今回は特定はできず。
追って確認する、します。 

原因解明：

原因が解明、Windows更新プログラムだったかー

暫定回避策を更新しました

@setlocal EnableDelayedExpansionの使い方

@setlocal EnableDelayedExpansionの使い方について

はじめに：

EnableDelayedExpansionは遅延環境変数を使用可能にするオプションです。
この設定が欲しくなるケースは恐らくその多くの場合、「For loop内で、loopが1巡する毎に異なる値を環境変数に設定したい時」だと思います。

以下説明は、「setlocal /?」と「cmd /?」のヘルプからの引用＋自分なりに解釈した、環境変数と遅延環境変数の違いです（たぶん合ってる、間違っていたらすみません。。。）

• 環境変数は区切り文字として % を使います　（例：%var%）
• 遅延環境変数は区切り文字として ! を使います　（例：!var!）
• 環境変数はforループ中に値を変更することができません。forループが完了してからループ中最後に代入された値が入ります(途中で代入された値は無視されます)。　同様にLoopに入る前にすでに環境変数に値が入っている場合はLoop中は常にその値が維持されます、そしてLoopが完了した時点でLoop中最後に代入された値が反映されます。
• 遅延環境変数はforループ中にsetで値を代入することができます。（<-- これが、いいですねー）

と、いきなり言われても結局どう使えるの？
ということで、遅延環境変数の使用例です

使用例：

ある複数行のテキストファイルがあり、For分で一行ずつ環境変数に読み込んでEchoでその環境変数を標準出力する。

手順：

1. C:\temp\forというフォルダを作成
2. EnableDE.bat(*1)をC:\temp\forに作成
3. readFile.txt(*2)というファイルを準備(内容はなんでもいいんです)
4. CMDを開いてC:\temp\forに移動(cdする)
5. EnableDE.batを実行

5の実行結果、下のような結果が出てくれば成功です（!count!には行番号、!readline!は各行の文字列になります）

C:\Temp\for>EnableDE.bat
Line:1 This is a sample file to be read
Line:2 by "for" statement in test.bat.
Line:3 Each line to be set as a value
Line:4 of the environment varialble,
Line:5 "!readline!" and shown
Line:6 by echo !readline!.
Line:7 This requires
Line:8 "@setlocal EnableDelayedExpansion"
Line:9 enables setting each line to
Line:10 !readline! variable
Line:11 *EVEN* that's set sometime in "for" loop
Line:12 As default, otherwise, setting
Line:13 several values in a "for" loop
Line:14 wasn't allowed.



(*1)EnableDE.bat
=========================================
@echo off
@setlocal EnableDelayedExpansion
set count=
for /f "delims=" %%s in (C:\temp\for\readFile.txt) do (
 set /a COUNT+=1
 set readline=%%s
 echo Line^:!count! !readline!
)


(*2)readFile.txt
=========================================
 This is a sample file to be read
 by "for" statement in test.bat.

 Each line to be set as a value
 of the environment varialble,
 "^!readline^!" and shown
 by echo ^!readline^!.

 This requires
 "@setlocal EnableDelayedExpansion"
 enables setting each line to
 ^!readline^! variable
 *EVEN* that's set sometime in "for" loop
 As default, otherwise, setting
 several values in a "for" loop
 wasn't allowed.

ちなみに：

一方で、環境変数を使った場合はForループ内で値は変更されないことが分かります
気になる方は、DisabledDE.batをC:\temp\forで実行してみください

(*3)DisabledDE.bat
=========================================
 @echo off
set count=
for /f "delims=" %%s in (C:\temp\for\readFile.txt) do (
 set /a COUNT+=1
 set readline=%%s
 echo Line^:%count% %readline%
)

FOR 変数参照の置換(%~) の可能性を探る旅

ファイルの取扱いで痒いところに手が届かないイメージのあるDOSですが、for /? のHelpを見ると、それなりに使えるオプションが揃っています。
今回は、FOR 変数参照の置換(%~) の可能性を探る旅と称して、「DOS for文のツアー」を準備してみました。

旅準備：

test用のフォルダとファイルを準備します。　手作りでもいいですが、せっかくなので下の8行をコピーしてDOS窓にペーストして実行してみます。

if not exist C:\temp\for (mkdir C:\temp\for) fsutil file createnew C:\temp\for\0kb.txt 0 fsutil file createnew C:\temp\for\1kb.txt 1024 fsutil file createnew C:\temp\for\10kb.txt 1024 if not exist C:\temp\for\sub (mkdir C:\temp\for\sub) fsutil file createnew C:\temp\for\sub\0kb.txt 0 fsutil file createnew C:\temp\for\sub\5kb.txt 5120 fsutil file createnew C:\temp\for\sub\50kb.txt 51200

DOS窓からtreeで表示すると下記のような構成のフォルダになります

> tree /F /A C:\temp\for C:\TEMP\FOR |   0kb.txt |   10kb.txt |   1kb.txt | \---sub         0kb.txt         50kb.txt         5kb.txt

test用のフォルダの準備ができたら、そのDOSをそのまま使っても結構なのでecho offします(for文の標準出力がうっとうしいので)

echo off

そして以下のfor文を実行してみましょう

for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %I)

こんな結果が出たら旅の準備は完了です

C:\temp\for\0kb.txt C:\temp\for\10kb.txt C:\temp\for\1kb.txt C:\temp\for\sub C:\temp\for\sub\0kb.txt C:\temp\for\sub\50kb.txt C:\temp\for\sub\5kb.txt

いざ旅へ！：

さて、ここから旅の始まりです。「FOR 変数参照の置換オプション」を試してみましょう
はてさて、それぞれどんな結果になるでしょうか？

for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %~fI) for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %~sI) for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %~aI) for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %~tI) for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %~zI) for /F "delims=" %I in ('dir /S /B "C:\temp\for"') do (echo %~ftzaI)

更なる旅へ！：

さて（うまく結果が出たとして）、今回の「DOS for文ツアー」はここで終わりです
これまでを通して「FOR 変数参照の置換オプション」というツールを手に入れられたのではないでしょうか?　(ついでにfsutilやtreeなどにも触れました。)
 個人的には ~z のファイルのサイズを返すオプションが目玉だと思います。空ファイル(0kb)を判別する必要がある時などに重宝します。

そして、ここからが旅の本番です、行く先々で待ち受けているであろう「DOS故の痒いところ」は、もしかすると「FOR 変数参照の置換オプション」で、意外と簡単に乗り越えられるかもしれませんね

※今回の例ではFOR変数に I を使用しています、またコマンドラインで実行しているので 変数I に付ける % は一個です、.batで実行するような時は %%I としてください。　またFOR変数は I である必要はありません、aを使いたかったら%aでいいですし、その場合は %~za という感じで使ってください


最後に「FOR 変数参照の置換オプション」をリストしておきます。for /? からの抜粋です。

===========================================================     %~I         - すべての引用句 (") を削除して、%I を展開します。     %~fI        - %I を完全修飾パス名に展開します。     %~dI        - %I をドライブ文字だけに展開します。     %~pI        - %I をパス名だけに展開します。     %~nI        - %I をファイル名だけに展開します。     %~xI        - %I をファイル拡張子だけに展開します。     %~sI        - 展開されたパスは短い名前だけを含みます。     %~aI        - %I をファイルの属性に展開します。     %~tI        k- %I ファイルの日付/時刻に展開します。     %~zI        - %I ファイルのサイズに展開します。     %~$PATH:I   - PATH 環境変数に指定されているディレクトリを                    検索し、最初に見つかった完全修飾名に %I を                    展開します。                    環境変数名が定義されていない場合、または検索                    してもファイルが見つからなかった場合は、この                    修飾子を指定すると空の文字列に展開されます。 修飾子を組み合わせて、複合結果を得ることもできます:     %~dpI       - %I をドライブ文字とパスだけに展開します。     %~nxI       - %I をファイル名と拡張子だけに展開します。     %~fsI       - %I を完全なパスと短い名前だけに展開します。     %~dp$PATH:I - PATH 環境変数に指定されているディレクトリを                    検索して %I を探し、最初に見つかったファイル                    のドライブ文字とパスだけに展開します。     %~ftzaI     - %I を DIR コマンドの出力行のように展開します。 ===========================================================

Scripting.FileSystemObject.Drive Object - Sample

Scripting.FileSystemObject.Driveの使用例

scanDrives.vbs：
　VBスクリプト。　Scripting.FileSystemObjectオブジェクトを作成してDrivesと
　EnumNetworkDrivesを使用して、マイコンピュータがマウントしている各ドライブをスキャンして
　各ドライブの情報をCSV形式で出力する

使い方：
　下のscanDrives.vbsをテキストエディタにコピペして、scanDrives.vbsで保存して実行。
　次の例は、C:\scanDrives.vbsに保存した場合の使用方法。

c:\>cscript /nologo c:\scanDrives.vbs

 Letter,Type,Total[Byte],Used[Byte],Available[Byte],Usage[%],Path
 C,Local HDD Drive,52428795904,48322715648,4106080256,7.83%,-
 D,Local HDD Drive,246629265408,151006982144,95622283264,38.77%,-
 E,Local HDD Drive,20971515904,10150678528,10820837376,51.60%,-
 F is not ready.
 Z,Network Drive,-,-,-,-,\\fileserver01\Shared\
 Y,Network Drive,-,-,-,-,\\fileserver02\NASShare
 Z,Network Drive,-,-,-,-,\\remoteservr01\c$

scanDrives.vbs
==================================================================================

'--------------------------------------------------------
' Scripting.FileSystemObject.Drive Object
'--------------------------------------------------------
' Property       | 機能
'----------------|---------------------------------------
' AvailableSpace | 利用可能な空きスペースの大きさを取得する
' DriveLetter    | ドライブ名（「C」など）を取得する
' DriveType      | ドライブの種類を取得する (0は不明なドライブ、1はリムーバブル・ディス
'                | ク、2はハードディスク、3はネットワーク・ドライブ、4はCD-ROM、5はRAM
'                | ディスクを表す。)
' FileSystem     | ドライブのファイルシステムを取得する
' FreeSpace      | ディスクの空きスペースの大きさを取得する
' IsReady        | ドライブが準備できているかどうかを取得する
' Path           | コロン付きのドライブ名を取得する
' RootFolder     | ルートフォルダを表すFolderオブジェクトを取得する
' SerialNumber   | ディスクのシリアルナンバーを取得する
' ShareName      | ネットワーク・ドライブの共有名を取得する
' TotalSize      | ディスクの総容量を取得する
' VolumeName     | ドライブのボリューム名を取得する
'---------------------------------------------------------

Set fso1 = CreateObject("Scripting.FileSystemObject")
Set drives = fso1.Drives
Set fso2 = CreateObject ("WScript.Network")
Set networkdrives = fso2.EnumNetworkDrives

WScript.Echo "Letter" & "," & "Type" & "," & "Total[Byte]" & "," & "Used[Byte]" & "," & "Available[Byte]" & "," & "Usage[%]" & "," & "Path"

For Each drive in drives
   letter = drive.DriveLetter
   if(drive.isReady) Then
   Select Case drive.DriveType
      Case "1"
         diskusage = FormatPercent (drive.AvailableSpace/drive.TotalSize)
         WScript.Echo letter & "," & "Removable HDD Drive" & "," & drive.TotalSize & "," & drive.TotalSize - drive.AvailableSpace & "," & drive.AvailableSpace & "," & diskusage & "," & "-"
         WScript.Echo letter
         diskusage = ""
      Case "2"
         diskusage = FormatPercent (drive.AvailableSpace/drive.TotalSize)
         WScript.Echo letter & "," & "Local HDD Drive" & "," & drive.TotalSize & "," & drive.TotalSize - drive.AvailableSpace & "," & drive.AvailableSpace & "," & diskusage & "," & "-"
         diskusage = ""
      Case "3"
         path = ""
         For i = 0 to networkdrives.Count - 1 Step 2
            if networkdrives.Item(i) = letter & ":" Then
               path = networkdrives.Item(i + 1)
            End if
         Next
         WScript.Echo letter & "," & "Network Drive" & "," & "-" & "," & "-" & "," & "-" & "," & "-" & "," & path
      Case "4"
         WScript.Echo letter & "," & "Disc Drive" & "," & "-" & "," & "-" & "," & "-" & "," & "-" & "," & "-"
      Case Else
         WScript.Echo letter & "," & "Unknown Drive Type" & "," & "-" & "," & "-" & "," & "-" & "," & "-" & "," & path
   End Select
   Else
         WScript.Echo letter & " is not ready."
   End if
Next

==================================================================================