Help Version: 2.12
Last Update: 03/13/01

Troubleshooting the Installation

Please verify that you have all of the Hosting requirements met. 

PLEASE READ THE ERROR MESSAGE VERY CAREFULLY.
It will most always tell you what is wrong.

If it says it can't find a file, check to see if it exists in the directory it is looking for it. The error message will tell you where it is looking for the file. If it says it can't write to a file, make sure your permissions on that directory or file are set correctly. Etc... The error messages will almost always tell you what is wrong. Learn to read these carefully.


Listed below are common errors encountered during the test of your QuikStore installation. We will list them by symptom so they will be easier to find.

  1. "404 File not found" error when executing a file in my cgi-bin directory
  2. Blank screen when I try to run the Quikstore.cgi file on my server.
  3. The program tells me it can't find the qs_main.cgi file.
  4. An error that tells me it can't find one of the other files.
  5. An error that tells me the program can't open a lock file.
  6. An error when I try to run the script using my IP address.
  7. My images are not showing up correctly on my web pages.
  8. My images are not showing up in Catalog Wizard. It causes an error!
  9. Dead Letter Error Message
  10. All Users Get the same Cart ID.
  11. I get e-mail from AuthorizeNet, but not from my store.
  12. I keep getting $ signs in the wrong position on the view cart page.
 
  1. I get a 404 File not found error when trying to execute a file in my cgi-bin directory

    Contact your hosting service as it appears that the virtual directory on your web server is incorrectly set

  2. I get a blank screen when I try to run the Quikstore.cgi file on my server.
     
    1. If you did not use the Installation Wizard to upload the files, did you make sure to upload the files in ASCII mode? All files except the graphics must be uploaded in ASCII mode.

      NOTE: MS Frontpage uploads ALL files in Binary mode. You will need to re-upload the files in ASCII to your server. You cannot use the FrontPage publisher to upload these files.

    2. Are all of the files on the server in the proper location? See Uploading Files To The Server
    3. Did the Installation Wizard program transfer only part of one of the configuration files. Make sure the entire file has been uploaded.
    4. Is the search.html file in the correct directory?
    5. Did you redefine the directory paths in the configuration file? If so, are they correct?
    6. You may have to check the path to PERL on your specific server. Ask your ISP what the path to Perl 5 is and then open the QuikStore.cgi script using an TEXT ONLY editor, and change the first line in the script ...

      from:   #!/usr/bin/perl

        To:   #!/usr/local/bin/perl 
       
         -or-
       
        To:   #!/usr/bin/perl5

    Of course you will need to get the proper path from your ISP.

    ALL "cgi", "pl", and "ini" files MUST be saved as text only after editing them.


  3. I get an error that tells me the program can't find the qs_main.cgi file.

Are the configuration files in the cgi-bin directory or the directory where the quikstore.cgi program resides?

If yes, does the error contain the words "cgi-wra"? or " /suid/" or come back with a message similar to this:

Content-type: text/html
I'm sorry but the script cannot find the /www/cgi-bin/cgi-wrap/cgiwra/qs_main.cgi.
I'm sorry but the script cannot find the /www/cgi-bin/cgi-wrap/cgiwra/qs_main.cgi. at /www/home/yoursite/cgi-bin/quikstore.cgi line 727.

This is a system used on some servers called cgi-wrap. The script may have trouble finding the $cwd (current working directory)  when this is used. Open the quikstore.cgi file in a text only editor (VERY IMPORTANT) and scroll down to about line 20 in the program script. There you will see instructions for setting the CWD manually. Just uncomment this line (remove the # sign in front) and enter the directory path to your cgi-bin directory on your site. When you are done, it should look something like this:

$cwd = "/www/home/yoursite/cgi-bin";

Note:  Notice how the error message tells us on its last line that the path to the quikstore script is /www/home/yoursite/cgi-bin.  Thus you can copy and paste this into your quikstore.cgi script directly.


  1. I get an error that tells me it can't find a file.

If you look at this carefully, it tells you exactly what is wrong.

  1. The file does not exist - Why Not?
  2. The name of the file it was looking for - Is it spelled right?
  3. The name and line number of the subroutine in the QuikStore program that was expecting to find the file. ( this is mostly for us to support you better. You really can't make changes to this. )

While most of this is self explanatory, pay close attention to the last line. This tells you where the program is running from. This gives you the exact location of the quikstore.cgi script. If you have redefined the directory paths in the quikstore.cfg file, make sure to pay close attention to the paths above. Again, they will tell you what is wrong if you take the time to look carefully at them. Then adjust you paths as needed.


  1. I get an error that tells me the program can't open a lock file.

The lock file error happens when the QuikStore program can't write to one of the log files. This is usually because the "log_files" directory permissions are set incorrectly.

The lock file is used to temporarily "Lock" the log file so that only one user can write into the file at a time. This lock file gets deleted once the information has been written to the file by the program. If it is NOT deleted, there is a permissions problem.


  1. I get an error when trying to run the script using my IP address rather than the domain name.

    When the ISP first sets up the domain, they put in the domain name but it is not yet registered with InterNic to reflect the correct IP Address for that server.

    The QuikStore script uses this server information and will report an error. To temporarily correct this until your domain is fully registered, you can enter the ip address rather than the domain name in the Configuration Editor.

    Just select the "Config File" tab and change the Script URL to the ip address like this:

    http://209.211.28.1/cgi-bin/quikstore.cgi

    Substitute in your number of course, the cgi-bin or cgi-local folder (as your case may be), the quikstore.cgi or quikstore.pl script name.

  2. My images are not showing up correctly on my web pages.

Have you defined the graphics directory URL in the Installation Wizard? You must set this to the FULL URL to the graphics directory on your site. 

Right click on the missing image in your browser and view the properties. It will show what path it's looking for and you can adjust the path in the Installation Wizard from this information as needed.


  1. My images are not showing up in Catalog Wizard. It causes an error!

If you are having trouble with the import of graphics into Catalog Builder, this is usually caused by missing graphic filters on your system.

To fix this, explore the Quikstore CD and look for the Catalog Builer/Graphic Filters directory. Run the install.bat file in this directory to install the filters onto your system.


  1. Dead Letter Error Message.  Are you or does your customer get the following message?

User unknown /nonexistent/dead.letter... cannot open /nonexistent/dead.letter:  No such file or directory.

This error lets you know the store owner or customer email address that was entered is not a valid email address and could not be delivered to that email account.


  1. All Users Get the same Cart ID.

What happens many times is that people edit the quikstore template pages on-line, through the browser. You can do that with some browsers. The problem is that QuikStore adds variables to the page in hidden fields which are suppose to change from customer to customer entering the site. 

If you edit the page on-line and save it, it will cause problems because the page that was displayed is specific to that session and not generic to everyone, thus the cart id is now hard coded into the page and will remain the same from now on. This happens quite often with new users of Quikstore. The fix is to search your pages for the id number that is being used over and over, then fix that page to look like the example below, or replace it with an original copy of the page.

This is what the input box should be.  If the value is equal to a hard number such as 2345678, it is wrong.

<Input type=hidden name=cart_id value=%%cart_id%%>


  1. I get e-mail from my Credit Card Processor, but not from my store.

Authorizenet

Check the Authorizenet configuration parameters you set at Authorizenet. Sometimes, there is a "space" in front of the return site URL address (your web site URL pointing to your QuikStore script) which causes NetScape users to loose the connection back to the storefront.

Return script or link URL:
   
 https://www.clss.com/cgi-quikstore/quikstore/quikstore.cgi

...make sure there is no space between the start of the text input box and the url.

Other processors

99.9% of the time, the error is caused by a user overlooking a small part of the instructions in the setup.txt file that came with the plug-in. Go back over every step carefully. Check to make sure that variable names are correct and that settings on your Credit Card Processing Admin screens are entered properly.


  1. I keep getting $ signs in the wrong position on the view cart or order form pages

The $ sign problem is due to the language configuration file, qs_lang.cgi,  being corrupted (sent in binary as opposed to ASCII). Upload another copy of it and then run the program again. That should do it. Other erratic behavior may be related to having uploaded the other files in binary. If in doubt, reload them.

All QuikStore files except the graphics need to be uploaded in ASCII.


Copyright 1997-2003 iSoft-Solutions, inc.