=========================================================================== == 4.0 Upgrading from previous versions =========================================================================== If you are upgrading from previous versions of POD, it is best to use the 'pvconv.pl' file to convert your podvars.pm into a format compatible with the new version. This program will automatically setup new variables, change name of old ones etc. =========================================================================== == 4.0.1 Setting the path to Perl =========================================================================== First of all, you need to tell pvconv.pl where your Perl interpreter is. If you aren't sure where Perl is, have a look at 'Appendix A - Finding Perl'. Now load pvconv.pl into your text editor, and look at the first line: #!/usr/bin/perl change this to reflect where your Perl interpreter is. For example, if Your Perl Interpreter is in: Then this line needs to read: /usr/bin/perl #!/usr/bin/perl /usr/perl/perl #!/usr/perl/perl /bin/perl #!/bin/perl Now upload the script to your webspace (using ftp) and run it. Ideally it should be uploaded into your cgi-bin . =========================================================================== == 4.0.2 Setting the path the old podvars.pm =========================================================================== This is the step that often causes the most problems (but if you've followed set 3.3.2 you will probably find this very familar) In line 18 of pvconv.cgi you need to tell the script where the old podvars.pm is located so that it can read in all your settings - if you don't set this correctly pvconv.pl will fail. If you upload podvars.pm and pvconv.pl into the same directory, you can normally get pvconv.pl to work by using the line: require "podvars.pm"; but if this doesn't work, you need to set the full server path of the location of podvars.pm. If you aren't quite sure where podvars.pm is stored in the server path, try telnetting to your server, logging in, going to the directory that podvars.pm and typing: pwd This (at least on Posix machines - ie Unix, Linux, BSD etc.) returns the current path such as: /home/user/public_html/cgi-bin/ Then just set the 'requires' line to this, thusly: require "/home/user/public_html/cgi-bin/podvars.pm"; If you are having serious difficulties in getting pvconv.pl to work, you can try cutting and pasting the entire podvars.pm file into the pvconv.pl. If you are upgrading from a pre-v1.70d version of podvars.pm the podvars.pm file should be pasted where the 'requires' line is, and the 'requires' line should be removed. If upgrading from later versions, just paste the text at the end of the pvconv.pl . Then you just need to insert a hash character in front of the require line to disable the inclusion section - ie #require "anything at all"; Now save the pvconv.pl file and now you are ready to upload.... =========================================================================== == 4.0.3 Uploading pvconv.pl =========================================================================== Uploading is normally the simple half of this two part process - the file permission settings are usually the hardest part. If you have installed a cgi program before, this bit should be second nature :) First you need to upload pvconv.pl into your cgi-bin. This directory (cgi-bin) may not be called cgi-bin, it may be called 'cgibin', 'cgis', 'bin' etc. It may also be located either inside your html directory (ie in /home/user/public_html/cgi-bin ) or outside ( /home/user/cgi-bin ). If you can't find a suitably named directory, don't panic. Your server administrator can probably tell you where you should upload Perl cgi programs (if you can run them on your server). You may be told that you don't need to put them in a specific directory - if so, just upload them anywhere! (within reason of course :) ). Now to set the file permissions... pvconv.pl needs to be executable and readable by everyone accessing it - but the method of doing so various from setup to setup, have a look at 'Appendix B - Setting file permissions' for details =========================================================================== == 4.0.4 Running pvconv.pl =========================================================================== Just access pvconv.pl from your browser and it will output your new podvars.pm file. Now either cut and paste from your browser window or Save Source and cut from between the markers. Save this as your new podvars.pm file and you are ready to go!