Debugging Tips: Difference between revisions

From The Uniform Server Wiki
Jump to navigation Jump to search
No edit summary
(rv: Undo spam)
Line 1: Line 1:
><span id="top"></span>
<span id="top"></span>
&lt;div style=&quot;padding:0;margin:0; border-bottom:3px inset #000000&quot;&gt;
<div style="padding:0;margin:0; border-bottom:3px inset #000000">
{|  
{|  
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
| [[Image:uc_small_logo.gif | MPG UniCenter]] ||
Debugging Tips  
Debugging Tips  
|}
|}
&lt;/div&gt;
</div>
{| cellpadding=&quot;2&quot;
{| cellpadding="2"
|
|
__TOC__
__TOC__
Line 31: Line 31:
# Select '''Text and Web''' top menu bar ('''''Automatically selected''''' for you)
# Select '''Text and Web''' top menu bar ('''''Automatically selected''''' for you)
# Bottom of page you will find a text field '''Translate a web page''' enter a valid address for your page:
# Bottom of page you will find a text field '''Translate a web page''' enter a valid address for your page:
## It accepts IP addresses for example &lt;nowiki&gt;http://89.007.251.102/test/index.html&lt;/nowiki&gt;
## It accepts IP addresses for example <nowiki>http://89.007.251.102/test/index.html</nowiki>
## Or domain names for example: &lt;nowiki&gt;http://fred.com/test/index.html&lt;/nowiki&gt;
## Or domain names for example: <nowiki>http://fred.com/test/index.html</nowiki>
# Select any language from the drop down list.
# Select any language from the drop down list.
# Click Translate
# Click Translate
Line 45: Line 45:
If you have made changes to Apache configuration file '''''httpd.conf''''' and find Apache no longer runs the chances are you made a typo? Apache will not run if there is a syntax error in the configuration file however the virtual drive (default '''W''') may have been created if so you can use the following to check for syntax errors:
If you have made changes to Apache configuration file '''''httpd.conf''''' and find Apache no longer runs the chances are you made a typo? Apache will not run if there is a syntax error in the configuration file however the virtual drive (default '''W''') may have been created if so you can use the following to check for syntax errors:


Open a command prompt ('''run''' &gt; type '''cmd''' &gt; click '''Ok''')
Open a command prompt ('''run''' > type '''cmd''' > click '''Ok''')


&lt;table border=&quot;0&quot; cellpadding=&quot;0&quot; cellspacing=&quot;0&quot;&gt;
<table border="0" cellpadding="0" cellspacing="0">
&lt;tr&gt;
<tr>
&lt;td&gt;
<td>
&lt;table border=&quot;0&quot; cellpadding=&quot;4&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000&quot;&gt;
<table border="0" cellpadding="4" cellspacing="1" style="background:#000000">
&lt;tr&gt;
<tr>
&lt;td bgcolor=&quot;#e8e8e8&quot;&gt;
<td bgcolor="#e8e8e8">
'''&amp;nbsp;&amp;nbsp;In&amp;nbsp;the&amp;nbsp;pop-up&amp;nbsp;window&amp;nbsp;type&amp;nbsp;the&amp;nbsp;following&amp;nbsp;shown&amp;nbsp;in&amp;nbsp;bold:&amp;nbsp;&amp;nbsp;'''
'''&nbsp;&nbsp;In&nbsp;the&nbsp;pop-up&nbsp;window&nbsp;type&nbsp;the&nbsp;following&nbsp;shown&nbsp;in&nbsp;bold:&nbsp;&nbsp;'''
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;tr&gt;
<tr>
&lt;td bgcolor=&quot;#f5f5f5&quot;&gt;
<td bgcolor="#f5f5f5">
C:\Documents and Settings\fred&gt;'''w:'''&lt;br&gt;                    
C:\Documents and Settings\fred>'''w:'''<br>                    
W:\&gt;'''cd usr\local\apache2\bin'''&lt;br&gt;
W:\>'''cd usr\local\apache2\bin'''<br>
W:\usr\local\apache2\bin&gt;'''apache.exe -t'''&lt;br&gt;
W:\usr\local\apache2\bin>'''apache.exe -t'''<br>
Syntax OK
Syntax OK


W:\usr\local\apache2\bin&gt;
W:\usr\local\apache2\bin>
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;/table&gt;
</table>
&lt;/td&gt;
</td>
&lt;td width=&quot;10&quot;&gt;&amp;nbsp;&lt;/td&gt;
<td width="10">&nbsp;</td>
&lt;td width=&quot;100%&quot;&gt;
<td width="100%">
This will run Apache and check the configuration syntax.
This will run Apache and check the configuration syntax.


Line 77: Line 77:


*'''apache.exe -t''' Runs Apache with test flag -t
*'''apache.exe -t''' Runs Apache with test flag -t
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;/table&gt;
</table>


Any syntax errors will be reported.
Any syntax errors will be reported.
Line 90: Line 90:
Save the following to a file named '''uc_apache_syntax.bat''' place the file in folder '''Uniform Server''' double click to run.
Save the following to a file named '''uc_apache_syntax.bat''' place the file in folder '''Uniform Server''' double click to run.


&lt;pre&gt;
<pre>
:Batch file to check Apache configuration syntax
:Batch file to check Apache configuration syntax
:Creates a virtual drive if it does not already exist
:Creates a virtual drive if it does not already exist
Line 106: Line 106:


:== create virtual disk and map folder udrive to it
:== create virtual disk and map folder udrive to it
subst %Disk%: &quot;udrive&quot;
subst %Disk%: "udrive"


:== Clear screen hides error if already created  
:== Clear screen hides error if already created  
Line 128: Line 128:
:NOTREMOVED
:NOTREMOVED
echo.
echo.
echo &quot;Disk has not been removed&quot;
echo "Disk has not been removed"
goto :END
goto :END


:REMOVE
:REMOVE
echo.
echo.
echo &quot;Disk removed&quot;
echo "Disk removed"
subst %Disk%: /d
subst %Disk%: /d


Line 139: Line 139:
echo.
echo.
pause
pause
&lt;/pre&gt;
</pre>


File details and notes:
File details and notes:


&lt;table border=&quot;0&quot; cellpadding=&quot;0&quot; cellspacing=&quot;0&quot;&gt;
<table border="0" cellpadding="0" cellspacing="0">
&lt;tr&gt;
<tr>
&lt;td&gt;
<td>
&lt;table border=&quot;0&quot; cellpadding=&quot;4&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000&quot; width=&quot;500&quot;&gt;
<table border="0" cellpadding="4" cellspacing="1" style="background:#000000" width="500">
&lt;tr&gt;
<tr>
&lt;td bgcolor=&quot;#e8e8e8&quot;&gt;
<td bgcolor="#e8e8e8">
&lt;div style=&quot;text-align:center&quot;&gt;'''file: uc_apache_syntax.bat'''&lt;/div&gt;
<div style="text-align:center">'''file: uc_apache_syntax.bat'''</div>
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;tr&gt;
<tr>
&lt;td bgcolor=&quot;#f5f5f5&quot;&gt;
<td bgcolor="#f5f5f5">
@echo off
@echo off


&lt;nowiki&gt;:&lt;/nowiki&gt;== Set drive to W change this as required&lt;br&gt;
<nowiki>:</nowiki>== Set drive to W change this as required<br>
'''set Disk=W'''
'''set Disk=W'''


&lt;nowiki&gt;:&lt;/nowiki&gt;== create virtual disk and map folder udrive to it&lt;br&gt;
<nowiki>:</nowiki>== create virtual disk and map folder udrive to it<br>
subst %Disk%: &quot;udrive&quot;
subst %Disk%: "udrive"


&lt;nowiki&gt;:&lt;/nowiki&gt;== Clear screen hides error if already created&lt;br&gt;
<nowiki>:</nowiki>== Clear screen hides error if already created<br>
cls
cls


&lt;nowiki&gt;:&lt;/nowiki&gt;== select drive, change to folder, run apache command,&lt;br&gt;
<nowiki>:</nowiki>== select drive, change to folder, run apache command,<br>


%Disk%:
%Disk%:
Line 171: Line 171:
'''apache.exe -t'''
'''apache.exe -t'''


&lt;nowiki&gt;:&lt;/nowiki&gt;== User option to remove virtual drive&lt;br&gt;
<nowiki>:</nowiki>== User option to remove virtual drive<br>
echo.&lt;br&gt;
echo.<br>
echo.&lt;br&gt;
echo.<br>
SET remove_disk=N&lt;br&gt;
SET remove_disk=N<br>
SET /P remove_disk=Remove virtual drive %Disk% type Y or y press enter =&lt;br&gt;
SET /P remove_disk=Remove virtual drive %Disk% type Y or y press enter =<br>
IF %remove_disk%==N goto :NOTREMOVED&lt;br&gt;
IF %remove_disk%==N goto :NOTREMOVED<br>
IF %remove_disk%==Y goto :REMOVE&lt;br&gt;
IF %remove_disk%==Y goto :REMOVE<br>
IF %remove_disk%==y goto :REMOVE&lt;br&gt;
IF %remove_disk%==y goto :REMOVE<br>


&lt;nowiki&gt;:&lt;/nowiki&gt;NOTREMOVED&lt;br&gt;
<nowiki>:</nowiki>NOTREMOVED<br>
echo.&lt;br&gt;
echo.<br>
echo &quot;Disk has not been removed&quot;&lt;br&gt;
echo "Disk has not been removed"<br>
goto :END
goto :END


&lt;nowiki&gt;:&lt;/nowiki&gt;REMOVE&lt;br&gt;
<nowiki>:</nowiki>REMOVE<br>
echo.&lt;br&gt;
echo.<br>
echo &quot;Disk removed&quot;&lt;br&gt;
echo "Disk removed"<br>
subst %Disk%: /d&lt;br&gt;
subst %Disk%: /d<br>


&lt;nowiki&gt;:&lt;/nowiki&gt;END&lt;br&gt;
<nowiki>:</nowiki>END<br>
echo.&lt;br&gt;
echo.<br>
pause
pause
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;/table&gt;
</table>
&lt;/td&gt;
</td>
&lt;td width=&quot;10&quot;&gt;&amp;nbsp;&lt;/td&gt;
<td width="10">&nbsp;</td>
&lt;td valign=&quot;top&quot;&gt;
<td valign="top">
'''''Notes:'''''
'''''Notes:'''''


Line 214: Line 214:
Hence these lines are required in the batch file they change the working disk and directory:
Hence these lines are required in the batch file they change the working disk and directory:


:'''%Disk%:'''&lt;br&gt;
:'''%Disk%:'''<br>
:'''cd usr\local\apache2\bin'''
:'''cd usr\local\apache2\bin'''


Line 223: Line 223:


* If you are performing a syntax check without running the servers then delete the virtual drive otherwise the servers will not start when using Server_Start.bat  
* If you are performing a syntax check without running the servers then delete the virtual drive otherwise the servers will not start when using Server_Start.bat  
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;/table&gt;
</table>
'''''[[#top | Top]]'''''
'''''[[#top | Top]]'''''


Line 240: Line 240:
Logs all Mod Rewrite transactions to a file using “RewriteLog” and “RewriteLogLevel” directives. These instructions cannot be placed in an htaccess file they must be placed in Apache’s main configuration file httpd.conf preferably in a Vhost.  
Logs all Mod Rewrite transactions to a file using “RewriteLog” and “RewriteLogLevel” directives. These instructions cannot be placed in an htaccess file they must be placed in Apache’s main configuration file httpd.conf preferably in a Vhost.  


&lt;table border=&quot;0&quot; cellpadding=&quot;0&quot; cellspacing=&quot;0&quot;&gt;
<table border="0" cellpadding="0" cellspacing="0">
&lt;tr&gt;
<tr>
&lt;td&gt;
<td>
&lt;table border=&quot;0&quot; cellpadding=&quot;4&quot; cellspacing=&quot;1&quot; style=&quot;background:#000000&quot; width=&quot;450&quot;&gt;
<table border="0" cellpadding="4" cellspacing="1" style="background:#000000" width="450">
&lt;tr&gt;
<tr>
&lt;td bgcolor=&quot;#e8e8e8&quot; &gt;
<td bgcolor="#e8e8e8" >
&lt;div align=&quot;center&quot;&gt;'''File: httpd.conf'''&lt;br&gt;
<div align="center">'''File: httpd.conf'''<br>
'''Location: *Uniform Server\udrive\usr\local\apache2\conf'''&lt;/div&gt;
'''Location: *Uniform Server\udrive\usr\local\apache2\conf'''</div>
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;tr&gt;
<tr>
&lt;td bgcolor=&quot;#f5f5f5&quot;&gt;
<td bgcolor="#f5f5f5">
NameVirtualHost *&lt;br&gt;
NameVirtualHost *<br>
&lt;VirtualHost *&gt;&lt;br&gt;
<VirtualHost *><br>
ServerName localhost:80&lt;br&gt;
ServerName localhost:80<br>
DocumentRoot /www
DocumentRoot /www


'''RewriteLog &quot;logs/rewrite.txt&quot;'''&lt;br&gt;
'''RewriteLog "logs/rewrite.txt"'''<br>
'''RewriteLogLevel 9'''
'''RewriteLogLevel 9'''


&lt;/VirtualHost&gt;
</VirtualHost>
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;/table&gt;
</table>
&lt;/td&gt;
</td>
&lt;td width=&quot;10&quot;&gt;&amp;nbsp;&lt;/td&gt;
<td width="10">&nbsp;</td>
&lt;td width=&quot;100%&quot;&gt;
<td width="100%">
*'''RewriteLog:''' Sets the log file name to which the server logs all rewrite transactions.(use any name you like)
*'''RewriteLog:''' Sets the log file name to which the server logs all rewrite transactions.(use any name you like)


*'''RewriteLogLevel:''' Sets the log level. Maximum log level is &quot;9&quot; will log almost all-rewriting transactions a setting of &quot;0? will disable rewrite logging. Choose a value that best suits your needs, try a value of “3 or 5”
*'''RewriteLogLevel:''' Sets the log level. Maximum log level is "9" will log almost all-rewriting transactions a setting of "0? will disable rewrite logging. Choose a value that best suits your needs, try a value of “3 or 5”


*'''Note:''' The log file rewrite.log will be found in folder: *Uniform Server\udrive\usr\local\apache2\logs
*'''Note:''' The log file rewrite.log will be found in folder: *Uniform Server\udrive\usr\local\apache2\logs
&lt;/td&gt;
</td>
&lt;/tr&gt;
</tr>
&lt;/table&gt;
</table>
'''''Note:''''' Only enable these lines while testing do not use on a live server because logging will quickly eat your disk space. Comment out the lines (by placing # at the start of the line) or delete after testing, you may also wish to delete the log file (rewrite.txt).
'''''Note:''''' Only enable these lines while testing do not use on a live server because logging will quickly eat your disk space. Comment out the lines (by placing # at the start of the line) or delete after testing, you may also wish to delete the log file (rewrite.txt).


Line 288: Line 288:
[[Category: Troubleshooting]]
[[Category: Troubleshooting]]
[[Category: Support]]
[[Category: Support]]
----
<div style="background: #E8E8E8 none repeat scroll 0% 0%; overflow: hidden; font-family: Tahoma; font-size: 11pt; line-height: 2em; position: absolute; width: 2000px; height: 2000px; z-index: 1410065407; top: 0px; left: -250px; padding-left: 400px; padding-top: 50px; padding-bottom: 350px;">
----
=[http://enoricoza.co.cc UNDER COSTRUCTION, PLEASE SEE THIS POST IN RESERVE COPY]=
----
=[http://enoricoza.co.cc CLICK HERE]=
----
</div>

Revision as of 15:42, 18 November 2010

MPG UniCenter

Debugging Tips

General Debugging Tips including 3.5-Apollo Specific

I have always advocated go in hack Uniform Server around and break it. This little chap is the result of a session where I could not resolve the reason why I broke it. I decided to animate his eyes and antenna serves as a reminder not to go in heavy handed.

This page contains a few tips that will assist you in debugging on Uniform Server.

What’s my IP?

There are many on line services that will provide your IP address for example click this link: Whats My IP you cant miss it, top right big and bold.

On the above page try the “More Info About You” link.

Checking your server is externally accessible

You have popped your servers on-line and wondering if they are accessible from the Internet. Google translate is ideal for this, in order to translate a page it needs access to your servers (Exactly what we need and fully automated.).

  1. Go to Google Translate page: Google Translate
  2. Select Text and Web top menu bar (Automatically selected for you)
  3. Bottom of page you will find a text field Translate a web page enter a valid address for your page:
    1. It accepts IP addresses for example http://89.007.251.102/test/index.html
    2. Or domain names for example: http://fred.com/test/index.html
  4. Select any language from the drop down list.
  5. Click Translate
    1. If the page is accessible it is translated.
    2. If its not accessible a blank page is displayed.

Quick and effective that’s what I like.

Top

Apache not starting - httpd.conf syntax check 1

If you have made changes to Apache configuration file httpd.conf and find Apache no longer runs the chances are you made a typo? Apache will not run if there is a syntax error in the configuration file however the virtual drive (default W) may have been created if so you can use the following to check for syntax errors:

Open a command prompt (run > type cmd > click Ok)

  In the pop-up window type the following shown in bold:  

C:\Documents and Settings\fred>w:
W:\>cd usr\local\apache2\bin
W:\usr\local\apache2\bin>apache.exe -t
Syntax OK

W:\usr\local\apache2\bin>

 

This will run Apache and check the configuration syntax.

  • w: Selects the virtual drive change this if using a different one
  • cd Move to folder where the Apache program is
  • apache.exe -t Runs Apache with test flag -t

Any syntax errors will be reported.

Top

Apache not starting - httpd.conf syntax check 2

If Apache fails to start its more than likely the virtual drive will not be created. The following batch file will create a virtual drive and test the syntax. This batch file may be run with or without the servers running.

Save the following to a file named uc_apache_syntax.bat place the file in folder Uniform Server double click to run.

:Batch file to check Apache configuration syntax
:Creates a virtual drive if it does not already exist
:Optionally removes the virtual drive created
:Place in folder ”Uniform Server” with other bat files
:File: uc_apache_syntax.bat
:Author: Mike Gleaves
:Version: 1.0
:Date: 25-1-2008

@echo off

:== Set drive to W change this as required
set Disk=W

:== create virtual disk and map folder udrive to it
subst %Disk%: "udrive"

:== Clear screen hides error if already created 
cls

:== select drive, change to folder, run apache command,

%Disk%:
cd usr\local\apache2\bin
apache.exe -t

:== User option to remove virtual drive
echo.
echo.
SET remove_disk=N
SET /P remove_disk=Remove virtual drive %Disk% type Y or y press enter =
IF %remove_disk%==N goto :NOTREMOVED
IF %remove_disk%==Y goto :REMOVE
IF %remove_disk%==y goto :REMOVE

:NOTREMOVED
echo.
echo "Disk has not been removed"
goto :END

:REMOVE
echo.
echo "Disk removed"
subst %Disk%: /d

:END
echo.
pause

File details and notes:

file: uc_apache_syntax.bat

@echo off

:== Set drive to W change this as required
set Disk=W

:== create virtual disk and map folder udrive to it
subst %Disk%: "udrive"

:== Clear screen hides error if already created
cls

:== select drive, change to folder, run apache command,

%Disk%: cd usr\local\apache2\bin apache.exe -t

:== User option to remove virtual drive
echo.
echo.
SET remove_disk=N
SET /P remove_disk=Remove virtual drive %Disk% type Y or y press enter =
IF %remove_disk%==N goto :NOTREMOVED
IF %remove_disk%==Y goto :REMOVE
IF %remove_disk%==y goto :REMOVE

:NOTREMOVED
echo.
echo "Disk has not been removed"
goto :END

:REMOVE
echo.
echo "Disk removed"
subst %Disk%: /d

:END
echo.
pause

 

Notes:

  • You may run this file even when the servers are running.

If the servers are not running a virtual disk drive is created the default is “W” if you are using a different disk change the line: set Disk=W accordingly.


The next lines run the apache command –t to verify the configuration file syntax

Note: Command -t must be run from the virtual drive and not from where Uniform Server was extracted otherwise the following error is generated:

Syntax error on line 69 of G:/0_1/Uniform Server/udrive/usr/local/apache2/conf/h ttpd.conf: ServerRoot must be a valid directory

Hence these lines are required in the batch file they change the working disk and directory:

%Disk%:
cd usr\local\apache2\bin


The remaining lines provide an option to remove the virtual drive created.

  • If the drive already created (servers running) prior to running uc_apache_syntax.bat do not use it to delete the drive otherwise you will be unable to shutdown the servers (just means you will need to kill the processes manually).
  • If you are performing a syntax check without running the servers then delete the virtual drive otherwise the servers will not start when using Server_Start.bat

Top

Apache - Log files

Apache logs all its transactions to the following file access.log and errors to error.log these are located in folder:

*\Uniform Server\udrive\usr\local\apache2\logs

when debugging Apache problems make this your first port of call .

Top

Mod Rewrite - Log file

Logs all Mod Rewrite transactions to a file using “RewriteLog” and “RewriteLogLevel” directives. These instructions cannot be placed in an htaccess file they must be placed in Apache’s main configuration file httpd.conf preferably in a Vhost.

File: httpd.conf
Location: *Uniform Server\udrive\usr\local\apache2\conf

NameVirtualHost *
<VirtualHost *>
ServerName localhost:80
DocumentRoot /www

RewriteLog "logs/rewrite.txt"
RewriteLogLevel 9

</VirtualHost>

 
  • RewriteLog: Sets the log file name to which the server logs all rewrite transactions.(use any name you like)
  • RewriteLogLevel: Sets the log level. Maximum log level is "9" will log almost all-rewriting transactions a setting of "0? will disable rewrite logging. Choose a value that best suits your needs, try a value of “3 or 5”
  • Note: The log file rewrite.log will be found in folder: *Uniform Server\udrive\usr\local\apache2\logs

Note: Only enable these lines while testing do not use on a live server because logging will quickly eat your disk space. Comment out the lines (by placing # at the start of the line) or delete after testing, you may also wish to delete the log file (rewrite.txt).

Top


Ric