home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 4 / boot-disc-1996-12.iso / Apps / Fusion / T2.Z / cgi_readme_second.txt < prev    next >
Text File  |  1996-08-23  |  5KB  |  87 lines
  1. Installing Forms-Handler and PERL5 on your Web server
  2. -----------------------------------------------------
  3.  
  4. Installing Forms-Handler completely is a two-part procedure.  This part of the procedure, part two, takes place on your Web server. The first part of the procedure that takes place within NetObjects Fusion is described in the file, cgi_readme_first.txt.
  5.  
  6. If you are not familiar with the Web server you are using, you will need to consult your ISP or Web server administrator for help with following these crucial procedures.
  7.  
  8. The Fusion-supplied CGI script, Forms-Handler.cgi, makes use of PERL5. 
  9.  
  10. The procedure outlined below involves two basic steps:
  11. 1. Getting PERL5 for your particular web server platform (if you don't already have it)
  12. 2. Setting up perl scripts (either for a UNIX server or a Windows NT server)
  13.  
  14.  
  15. Getting PERL5
  16. -------------
  17.  
  18.   In case your server does not have PERL5 already installed, we
  19.   recommend the following download sites:
  20.  
  21.   General Information:  
  22.     http://www.perl.com/perl/
  23.     http://www.metronet.com/perlinfo/perl5.html
  24.     
  25.   For UNIX, 
  26.   We have tested Forms-Handler.cgi on the UNIX server, Linux/BSD Perl 5.001 Unoffical patch level 1m.
  27.  
  28.   For Windows NT,
  29.   We recommend the following version of PERL5 because of its support of the flock/mutex operation:
  30.     http://website.ora.com/software/ntperl96.zip
  31.  
  32.  
  33. Setting up perl script on a UNIX server:
  34. ---------------------------------------
  35.  
  36. Open "Forms-Handler.cgi" in a text editor and change the first line of the script "#!/usr/bin/perl" to:
  37. "#!" plus the actual path to PERL5. 
  38.  
  39.  
  40. (You can type "which perl" at the unix prompt to find out the path)
  41.  
  42. $STORAGEDIR     -> the directory that the script will store the file into. 
  43.                    (needs local file location)
  44.                    For example, "/usr/local/webdata/"   
  45.  
  46. $TOKEN          -> the field separator between each field. For example, "{TAB},"
  47.  
  48. Setting Permissions in UNIX
  49. ---------------------------
  50.  
  51. The proper permissions have to be set for forms-handler.cgi so web browsers can execute it. This is something that the system administrator might have to do for you. The command is "chmod 705 Forms-Handler.cgi".  By default, the Netobjects Fusion publishing process does this for you.  The preceeding is just a pre-caution.
  52.  
  53. The storage directory($STORAGEDIR) permission's command should be "chmod 703 <your-directory-name>"
  54.  
  55.  
  56. Setting up perl script on a Windows NT server:
  57. ---------------------------------------------
  58.  
  59. Open Forms-Handler.cgi in a text editor and replace the following two fields at the top of the file:
  60.  
  61. $STORAGEDIR     -> the directory that the script will store the file into. 
  62.                    (needs local file location)
  63.                    For example, "c:\\Netscap\\web-data\\"   
  64.  
  65. $TOKEN          -> the field separator between each field. For example, "{TAB},"
  66.  
  67. NOTE: Because this is perl, all '\' marks need to be escaped out with an extra '\' infront of it.
  68.  
  69. For example, in NT/Window/Ms-dos, a path of "c:\Netscape\Server\docs\" would need to be "c:\\Netscape\\Server\\docs\\".
  70.  
  71.  
  72. Windows NT Server options
  73. -------------------------
  74. Because the latest Web Server software (e.g., Netscape FastTrack, Netscape Enterprise) follows the Windows NT File Manager's associations between file extension and applications, after installing the PERL5 interpretor, associate .cgi with perl.
  75.  
  76. NOTE: Some servers such as Netscape FastTrack require that you place shell scripts in a special shell script directory.
  77.  
  78. Because of security risks, we do not recommend older Windows NT Web Server software (e.g., Netscape 1.12 and older, Netscape Commerce Server, IIS older then 3/96, WebSite 1.1b and older). To solve this, we plan to make a C/Binary version available soon.  Please email support@netobjects.com to let us know your interest.
  79.                                                                
  80. In the interim, we recommend 2 possible solutions to access the perl cgi script with older Windows NT Web Server software:
  81.  
  82. 1) The NT user could write their own C-code and compile a binary that will make a system call.  For example: "c:\perl\perl.exe\Forms-Handler.cgi".  This is the safest option and is recommended since it would prevent the .bat security hack. However, it does require that you compile your C-code.
  83.  
  84. 2) Alternatively the NT user could make use of the .bat wrapper.  A sample is provided making the assumption of the Perl interpreter located at c:\perl5\perl.exe.  Make changes as necessary.  The weakness is that .bat wrapper has security flaws and on certain servers would give users access to your server disk.  Please consult "http://www-genome.wi.mit.edu/WWW/faqs/wwwsf8.html" for the .bat security weakness. If you choose this option, upload the Forms-Handler.bat wrapper from /NetObjects Fusion/Parts/SmartObjects/Cgi, and place in parallel with Forms-Handler.cgi.  Manually edit the html file that points to .cgi to .bat, and make sure that Forms-Handler.bat is referencing the PERL5 interpreter and perl file of the right path.
  85.  
  86.  
  87.