Current Page:  Documentation / Troubleshooting

Don't Panic!

We will take you step-by-step through a checklist that will hopefully see your tdg installation up and running as quickly as possible...

  1. if you see an error message from tdg itself (i.e. a box with an animated exclamation mark and a description of an error), then you'll be pleased to know that your problem is easy to resolve; simply follow the instructions returned by tdg.  If tdg doesn't return an error message then the program itself probably isn't running... this indicates a server problem (but nothing serious)

  2.  
  3. ensure that you have uploaded all tdg files as ASCII file-types, NOT as binaries (only applies to those users who have used the FTP service to copy their tdg files on to a remote web-server)

  4.  
  5. check the first line of each ".pl" file... it should include the complete (physical) path to the Perl interpreter on your web-server (your System Administrator or ISP should be able to help with this).  Note: this is not required for Microsoft Windows NT servers running IIS (Internet Information Server) so you can leave this line unchanged (do not delete it though).  Note: This does not apply to "tdg_library.pl"

  6.  
  7. check that your web-server has a complete and working Perl version 5.6+ installation (your System Administrator or ISP should be able to help with this)

  8.  
  9. ensure that all the modules and libraries required by tdg are properly installed and in Perl's search path.  The libraries and modules that tdg requires are: "LWP::Simple", "Socket", "GDBM_File" and "CGI.pm" (your System Administrator or ISP should be able to help with this)

  10.  
  11. check the file permissions, all ".pl" files must be executable (refer to "Installing tdg" for more detailed documentation).  Some servers do not allow you to adjust file permissions via FTP, consult your System Administrator (or ISP) for help with this

  12.  
  13. Microsoft Windows NT / IIS (and other web-servers) require that file-types are "mapped" to a specific application (when there is an application dependency).  That is, the web-server needs to be told that files with an extension of ".pl" (for example) should be run by Perl (or whatever application a particular file-type is dependent on).  Some System Administrators configure their servers so that only files with a ".plx" extension run via the Perl interpreter.  Rename all ".pl" files with "*.plx" suffix to rectify this or consult your System Administrator (or ISP).  If you do this, remember to adjust your link so that it calls "tdg_view.plx", not "tdg_view.pl".  You could also try renaming the Perl files with a ".cgi" extension

  14.  
  15. certain Microsoft Windows NT / IIS installations won't work with tdg unless it sends an "OK" header before anything else...  edit all the ".pl" files so that the line which reads: # print "HTTP/1.0 200 OK\n"; does not have the "# " at the beginning of the line, save and upload to implement this

  16.  
  17. a very common problem with Perl CGI applications is the "500 Server Error" (or "Internal Server Error"), some reasons for this (and their solutions) are listed below:
     
    1. the path to Perl is incorrect – please confirm the correct location of Perl with your System Administrator or ISP and then verify that the first line of all ".pl" files (excluding "tdg_library.pl") is the same as the path they give you
       
      Note:  The path to Perl is "#!/usr/bin/perl" by default on the standard tdg distribution, some hosts use "#!/usr/local/bin/perl" - you could try this first for a possible quick fix

    2.  
    3. you have inadvertantly uploaded some or all of the tdg files as binary files - you should upload all tdg files as ASCII

    4.  
    5. the Apache Server "srm.conf" file does not have a correct "ScriptHandler" set for ".pl" extensions.  Consult with your System Administrator or ISP

    6.  
    7. the Apache Server "srm.conf" file does not allow "CGIExec".  Consult with your System Administrator or ISP

    8.  
    9. the ".plx" file extension is mapped to Perl but ".pl" is not.  Consult with your System Administrator or ISP.  Alternatively, rename all ".pl" files with a ".plx" suffix to rectify this.  If you do this, remember to adjust your link so that it calls "tdg_view.plx", not "tdg_view.pl"

  18.  
  19. search through the "tdg Support Forum" to see if your particular problem has been discussed (and solved) there.  If it hasn't - post a message, giving as much detail as possible about the error/problem you have encountered and the configuration of your web-server and Perl installation.  We're automatically notified of posts to the forum and we'll endeavour to come up with a solution as quickly as possible after any posting.  Other tdg users may also respond with help and advice

  20.  

 

CGI Doctor

To help you with troubleshooting your tdg installation, we have included a small diagnostic program ("doctor.pl") that will analyse your web-server and report back on what it finds there.  Edit "doctor.pl" so that the first line points to the Perl interpreter (see step 3, above), then upload it into the same directory as your ".pl" files and give it executable permissions (remember to upload the file as an ASCII file, not as a binary).

Run the "CGI Doctor" (point your web-browser at http://www.yourdomain.com/cgi-bin/doctor.pl - use the equivalent URL for your website).

"CGI Doctor" will return a detailed analysis of your server environment.  Please send this to us with any technical support enquiries or bug reports