とってもかんたん！サーブレット＆JSP体験プログラミングトラブルシューティングのページ

【トラブルシューティング】

もし，「環境変数の領域が足りません」というエラーメッセージがMS-DOSプロンプトに表示されてTomcatがうまく起動できないときは，以下の作業を行ってください．
Tomcatをインストールしたディレクトリ（フォルダ）の中のbinというディレクトリ（書籍の設定では，C:\Jakarta-tomcat-3.2.3\bin）の中に「startup.bat」というファイルがあります．Tomcatの起動はこのファイルを利用して行っています．

①エクスプローラなどで，このbinディレクトリの内容を表示させ，startup.batのアイコンを右クリックして，「プロパティ」を選択してください．

②ダイアログが表示されますので，「メモリ」タブをクリックして「環境変数の初期サイズ」を「2048」など大きめの値に設定し直してください（デフォルトでは「自動」になっています）．

③同じbinフォルダにある「shutdown.bat」（Tomcatを終了するためのファイル）に対しても同様の操作を行ってください．

また，上記の操作を行ってもまだ，「環境変数の領域が足りません」というエラーメッセージが表示される場合は，startup.batの方ではなく，MS-DOSプロンプトそのものの環境変数を，自動→2048に変更してみてください(変更のしかたは同じです．「MS-DOSプロンプト」のアイコンを右クリックして「プロパティ」を選択してください)．

■その2：CLASSPATHがうまく設定できない（Windows98，Windows95の場合）

Tomcatを起動するときに，MS-DOSプロンプトに

　Unable to set CLASSPATH dynamically.
　Note: To set the CLASSPATH dynamically on Win9x systems
　only DOS 8.3 names may be used in TOMCAT_HOME!

というメッセージが出力されてTomcatが起動できなかった場合には，以下の作業を行ってみてください．
このメッセージは「Win9xのシステムではCLASSPATHを動的に設定することはできないので，TOMCAT_HOMEを8文字以内.3文字の形式で設定してほしい!」といっています．　
MS-DOSプロンプトを起動して，Tomcatをインストールしたディレクトリの下のbinディレクトリにcdコマンドで移動したあと，環境変数TOMCAT_HOMEを手動で設定してから起動してみてください．設定する値はTomcatがインストールされているディレクトリです．　
ただし，このときTOMCAT_HOMEに設定する値には少し気をつける必要があります．それは，必ずコマンドプロンプトの左側に表示されているのと同じ形式でディレクトリ名称を設定しなくてはならないということです．　
たとえば，コマンドプロンプトでTomcatをインストールしたディレクトリに移動して

　C:\> cd jakarta-tomcat-3.2.3\bin
　C:\JAKART~1\BIN> startup.bat

のようにTomcatを起動させようとしてうまくいかなかった場合は，次のように環境変数TOMCAT_HOMEを設定してから，startup.batを実行してTomcatを起動してみてください．このとき，TOMCAT_HOMEの値をコマンドプロンプトに表示されているのと同じ「C:\JAKART~1」のようなディレクトリ名称で表し，あえて8文字以内で設定することが重要です．

　C:\> cd jakarta-tomcat-3.2.3\bin
　C:\JAKART~1\BIN> set TOMCAT_HOME=C:\JAKART~1 　　
　　　注：実際にはTomcatをインストールしたディレクトリの名称を8文字以内で

　C:\JAKART~1\BIN> startup.bat

もう少し詳しく…

冒頭のようなメッセージを出力するプログラムは，startup.batから起動される「tomcat.bat」というファイルにあります．tomcat.batの内容は，実際には次のようになっています．なお，TOMCAT_HOMEの設定は，ここに引用した部分より前の部分でカレントディレクトリから類推して設定されるようになっています．そのため，Tomcatをインストールしたディレクトリに移動してからTomcatを起動すれば，TOMCAT_HOMEを明示的に設定していなくても起動できるようになっているのです．

>>>>>> 以下，Tomcat 3.2.3のtomcat.batより引用
:dynClasspath
set _LIBJARS=
for %%i in (%TOMCAT_HOME%\lib\*.*) do call %TOMCAT_HOME%\bin\cpappend.bat %%i
if not "%_LIBJARS%" == "" goto gotLibJars
echo Unable to set CLASSPATH dynamically.
if "%OS%" == "Windows_NT" goto staticClasspath
echo Note: To set the CLASSPATH dynamically on Win9x systems
echo       only DOS 8.3 names may be used in TOMCAT_HOME!
goto staticClasspath
<<<<<< 以上，Tomcat 3.2.3のtomcat.batより引用

　そして，ここから数行あとに

>>>>>> 以下，Tomcat 3.2.3のtomcat.batより引用
:staticClasspath
echo Setting your CLASSPATH statically.
if exist "%TOMCAT_HOME%\lib\ant.jar" set CP=%CP%;%TOMCAT_HOME%\lib\ant.jar
if exist "%TOMCAT_HOME%\lib\jasper.jar" set CP=%CP%;%TOMCAT_HOME%\lib\jasper.jar
if exist "%TOMCAT_HOME%\lib\jaxp.jar" set CP=%CP%;%TOMCAT_HOME%\lib\jaxp.jar
if exist "%TOMCAT_HOME%\lib\parser.jar" set CP=%CP%;%TOMCAT_HOME%\lib\parser.jar
if exist "%TOMCAT_HOME%\lib\servlet.jar" set CP=%CP%;%TOMCAT_HOME%\lib\servlet.jar
if exist "%TOMCAT_HOME%\lib\webserver.jar" set CP=%CP%;%TOMCAT_HOME%\lib\webserver.jar
<<<<<< 以上，Tomcat 3.2.3のtomcat.batより引用

　というように，TOMCAT_HOMEの値を元に*.jarをCLASSPATHに追加しています．

■その3：ポート番号の変更について（Windows／Linux共通）

ApacheやTomcat以外のWebサーバソフトをすでに使っている場合，ポートが競合するなどして，あとからインストールしたApacheやTomcatがうまく起動できないことがあります．
その場合には，ApacheやTomcatが使うポートの番号を変更するという方法があります．変更のしかたは次のとおりです．

Apacheのポート番号の変更方法
Apacheの設定ファイルは，本書p.048（Windows）またはp.049（Linux）の③で述べたように，Apacheをインストールしたディレクトリ（フォルダ）の下のconfディレクトリにある「httpd.conf」というファイルです．
このhttpd.confファイルのなかに
　　Port 80
という記述があります．これがポートの番号を設定している部分です．デフォルトでは80番になっています．
この80という番号を，8000などほかのソフトウェアが使用していない番号に変更してApacheを再起動します．
きちんとポート番号が変更されたかどうか確認するには，Webブラウザで
　　http://localhost:8000/
というURLでアクセスして（ただし，赤字の部分は実際に変更したポート番号），本書p.038の図18（Windows）またはp.041の図9（Linux）にあるApacheの起動画面が表示されればO.K.です．
Tomcatのポート番号の変更方法
Tomcatの設定ファイルは，Tomcatをインストールしたディレクトリ（フォルダ）の下のconfディレクトリにある「server.xml」というファイルです．
このserver.xmlファイルの中で，Tomcatがデフォルトで使用するポート番号「8080」を検索してください．見つかったら，この8080という番号を，7000などほかのソフトウェアが使用していない番号に変更してTomcatを再起動します．
きちんとポート番号が変更されたかどうか確認するには，Webブラウザで
　　http://localhost:7000/
というURLでアクセスして（ただし，赤字の部分は実際に変更したポート番号），本書p.044の図20（Windows）またはp.045の図11（Linux）にあるTomcatの起動画面が表示されればO.K.です．

ただし，TomcatではApacheなど別のWebサーバと通信するために8007番というポートも使用します．こちらも同様にして変更できます．

■その4：TOMECAT_HOMEの設定について（Windows／Linux共通）

環境変数TOMCAT_HOMEについては，本書ではとくにこれを設定していません．本書p.044（Windows）またはp.043（Linux）にあるように，Tomcatがインストールされているディレクトリ（フォルダ）の下のbinというディレクトリに移動してから，Tomcatを起動する手順になっています．こうしておくと，Tomcatが起動するときにカレントディレクトリから類推してTOMCAT_HOMEの値が自動的に設定されるようになっています．