Lozinski's Calendar!

Common Problems and Questions


  1. I'm receiving an "Internal Server Error". Help!
  2. Premature end of script headers
  3. When I try to run the program, I receive a "Forbidden Error".
  4. When running the calendar, I get nothing but the perl code in my browser displayed as text, or my browser tries to download the file
  5. I cannot access the configuration form
  6. Cannot save the calendar configurations
  7. Images are not displaying
  8. User specified images are not displaying
  9. Icons are not displaying
  10. My "template files" are not displaying
  11. Cannot save events to the calendar
  12. Cannot move, edit, or delete an event
  13. Emails aren't working
  14. I need to change the file extension to my scripts to end with ".cgi" (or something else)
  15. How do I stop the "Last modified by" displaying?
  16. How do I turn off the detailed "popup" window?
  17. Can I export the data to other programs, such as Microsoft Excel?
  18. I only want the administrator and webmaster to be able to post events. How do I do this?
  19. Can users sign up to join a calendar automatically?



I'm receiving an "Internal Server Error". Help!

This error can be caused by any number of hundreds of reasons (depending on which language is being used) and can be hard to trace. Some possible reasons for this error message are:
  • a simple syntax error in the program, possibly from edits. ASP and PHP are generally more friendly than Perl in this respect and tend to pointout where the error lies.


  • incorrect path to perl specified on the first line of the ".pl" file. Make sure the first line of each ".pl" file reflects the correct path to perl (this is especially important for Unix users).


  • incorrect file permissions -- the scripts don't have "execute" permissions. Make sure the files, as well as the directory they are located in, have the proper permissions for scripts to run.


  • file uploaded to the server in "binary" rather than "ascii" or "text" mode. Some "smart" ftp programs aren't that smart, and will occassionally upload the files in "binary" mode rather than "ascii text" mode. Make sure the files were uploaded to the server in "ASCII TEXT" mode.


  • script files not having the proper extension (ex: some webservers will only run perl files if they end in an extension other than ".pl"). Check with the system administrator if the file extensions need to be changed.

If none of the above seem to work, to track down the possible cause of this error, try to do one of the following:
  1. view the server's error logs and see if it provides a more specific cause for the error.
  2. if using perl, run the perl script from the DOS or Unix shell. Perl has no issue with spitting out the reason it doesn't want to run
    • In Windows, go to the "Start Menu", the "Programs", and select "Command Prompt". When the DOS window appears, change to the directory where perl is installed, and type the name of the perl file.
    • In Unix, either telnet or SSH into your account. Change to the directory where the perl file is located, and type "./calendar.pl" (or the name of whatever perl file you are trying to run).

    If you cannot do this, ask your system administrator to do so. In either instance, if the program will not run, perl will give you detailed feedback as to why the program will not run.


Premature end of script headers

See above, "Internal Server Error"


Forbidden Error

Either the program itself, or the directory it is located in does not have appropriate "read" and "execute" permissions. Double check the permissions.


When running the calendar, I get nothing but the perl code in my browser displayed as text, or my browser tries to download the file

This generally only affects Perl users, and indicates a configuration problem with the webserver in that it is either not configured to:
  1. execute perl files
  2. execute perl files with the given extension you have on the perl files
  3. the perl files are not located in a directory where the webserver is "allowed" to execute perl files (typically in a cgi-bin directory)
Check with your system administrator for your server's specifications and requirements.


I cannot access the configuration form

If you do not get the login screen for the particular configuration form you are trying to access, then you are providing an incorrect URL.


Cannot save the calendar configurations

This generally happens for any of the following reasons:
  1. Double check the permissions on the directory specified in the Location of Calendar Config Files setting. The directory needs to have the appropriate "write" permissions.

  2. The path to the directory is incorrect. Double check the operating system path to the directory specified. IT SHOULD NOT BE A URL!


Images are not displaying

All the images for the calendar do not display. This may be happening because:
  1. The Use Images option is not enabled. Enable images from the calendar's configuration form.

  2. The images or the directory they are in do not have proper "read" permissions. Check and correct as appropriate.


  3. The URL specified for the images is incorrect. Double check the URL. Try accessing the images directly from the browser.

    For example, if the images are located in the "months" directory within a "calendar" subdirectory, the type:
    http://www.yourdomain.com/calendar/months/image_name.gif

    If the image is there but does not display, then check the file permissions (as noted above) or move on to the next possible cause below

  4. The images may have to be moved to another location on the server. If the images are located in a subdirectory within a "cgi-bin" subdirectory, that could be the problem. Some servers are configured to execute ANYTHING within the cgi-bin directory. Thus, when the images are called, the server might be trying to run them as an executable file. Since they are not an executable, they don't run, and hence no image is displayed.

    Test this by trying to access the images directly.

    For example, http://www.yourdomain.com/cgi-bin/calendar/images/months/April.gif.

    If the image does not display, then move all the images outside of the cgi-bin subdirectory on the webserver.


User images do not display

Images that users specify do not display. This may be happening because:
  1. The Use Images option is not enabled for the calendar. Enable this option.

  2. The Use Images option is enabled for the calendar, but the Post Event Image Options is not set properly.

  3. The URL the user provided to the image is not correct


Icons are not displaying

Possible causes:
  1. The Use Images option is not enabled for the calendar.

  2. The Use Images option is enabled for the calendar, but the Post Event Image Options is not set properly.

  3. The URL to this Calendar's Icons is not correct.

  4. The Full Operating System Path to this Calendar's Icons is not correct.

  5. The file permissions for the directory containing the icons is not correct.

  6. The file permissions for the icons themselves are not correct.


My "template files" are not displaying

  1. Are the template options enabled for the calendar? See the section Template Options

  2. Is the full operating system path to the template files correct? No URLS should be specified!

  3. Do the template files and the directory they are stored in have correct "read" permissions?


Cannot save events to the calendar

This is generally caused by either of the following issues:
  1. A URL and not an operating system path was specified for the Datafile Directory. To correct, provide a full operating system path, NOT a URL.

  2. The specified Datafile Directory does not have appropriate "write" permissions allowing the program to save information. Double-check the file permissions on the directory.


Cannot move, edit, or delete an event

The user trying to do this must be the one who originally entered the event or modified it last unless the user is a webmaster or administrator.

Viewing the event in the detailed information window will show the last user was that modified the event provided this information is enabled under Extra Information to show when viewing an event's "details".


Emails aren't working

  • There MUST be an SMTP email server located on the same machine as the webserver.

  • The SMTP server isn't running or enabled.

  • If sending emails to an ISP account, the ISP may not be accepting emails from your server or domain. Try specifying a local email account.


I need to change the file extension to my scripts to end with ".cgi" (or something else)

See "Program File Extension" under Administrative Settings.



How do I stop the "Last modified by" displaying?

See the section Extra Information to show when viewing an event's "details"



How do I turn off the detailed "popup" window?

Disable the feature Use Popup



Can I export the data to other programs, such as Microsoft Excel?

Yes. See the section Exporting Data and the Display



I only want the administrator and webmaster to be able to post events. How do I do this?

  1. Disable the option Show Fields to allow a user to edit an event.

  2. Access the calendar using the special URL as described in the section Show Fields to allow a user to edit an event


Can users sign up to join a calendar automatically?

No. There are no plans to implement this.

"An error does not become a mistake until you refuse to correct it."
http://www.davelozinski.com