FAQ: Difference between revisions

FAQ (view source)

Revision as of 13:54, 18 December 2015

835 bytes added , 13:54, 18 December 2015

→‎Directory related problems in FTP: add quote from Steve (in forum answer), and minor other clarifications

Sfws

5,838

edits

@@ Line 986: / Line 986: @@
 == Directory related problems in FTP ==
 The following pointers should help:
-* All universal resource locator (url) references are case sensitive.  So if your FTP server directory is ''public_html'', then 'Public_HTML' will not work!
+* All web site file references are case sensitive.  So if your FTP server directory is ''public_html'', then 'Public_HTML' will not work!
-* On the ''Internet settings'' screen in '''Sites/Options''' the optional Directory parameter required is the path from  your FTP root, to where the web pages are to be stored. Click the '''Help''' button for full explanation, or search the support forum as many people have found this is the hardest parameter to get right.
+* On the ''Internet settings'' screen in '''Sites/Options''' the optional Directory parameter required is ''the path from  your FTP root'', to where the web pages are to be stored. It is ''not'' the '''Universal Resource Locator (URL)''' that you would specify to view the web page in a browser.  Click the '''Help''' button for full explanation, or search the support forum (as many people before you have found this directory is the hardest parameter to get right).
-* The standard pages are uploaded after a 'change directory' attempting to select the directory you specified in '''Sites/Options'''; if this fails, the files will still be uploaded but to the FTP server root. So some mistakes do not matter because if no change of directory was actually required, these pages will be uploaded correctly.
+* The error window is not useful for diagnosing ftp problems; you need to '''turn on ''ftp logging'' '''and look at ftplog.txt. Most FTP directory problems are due to you quoting an incorrect ftp directory, and the ftp log will show an error when an attempt is made to change to the directory you have specified incorrectly.
-* Any files you specify for uploading at standard update frequency are uploaded between standard pages (if 'Include Standard Files' selected) and standard images (if 'Include Standard Images' selected), and in 'remote filenames' you specify the path including any web site directory, so there is no call to 'change directory'. In this case, if that web site directory is invalid, the upload fails.
+* Relative paths (without a leading slash) are always safer than absolute paths (with a leading slash) and you may find that just specifying (for example) "public_html" works OK, but this all depends on how your ftp server and your ftp account is set up.
-* The standard images for gauges and trends pages are uploaded after the standard pages, (and any pages you specify for uploading,) by performing a second 'change directory' this time fixed at 'images'; if this fails, the files will still be uploaded to the current web site directory (FTP root or the directory you specified in '''Sites/Options''').
-* If you have enabled ''Realtime'', the realtime.txt file is uploaded without doing a change directory, by appending "/realtime.txt" to the directory on the ''Internet settings'' screen in '''Sites/Options'''. In this case, if the web site directory is invalid, the upload fails.
-* On the ''NOAA Setup'' screen the optional Directory parameter required is the full path from your FTP root, to where the NOAA report pages are to be stored. (It is totally independent of the directory on the ''Internet settings'' screen in '''Sites/Options''').  Click the '''Help''' button for full explanation. Like realtime.txt, the upload is by appending the filename for the report to the NOAA directory and will fail if that directory is specified wrongly.
-See '''Setting up your website''' in Cumulus help for a simple guide to the subfolder structure you need to create and the list of files that need to be uploaded manually when first installing a website. Or see [[Website_setup]] for all the options including customised pages.
+* The ''standard pages'' are uploaded after a 'change directory' attempting to select the directory you specified in '''Sites/Options'''; if this fails, the files will still be uploaded but to the FTP server root. So some mistakes do not matter because if no change of directory was actually required, these pages will be uploaded correctly.
+* Any ''files you specify'' for uploading at standard update frequency are uploaded between standard pages (if 'Include Standard Files' selected) and (written for Cumulus 1) standard images (if 'Include Standard Images' selected), and you should specify the path (including any web site directory) in 'remote filenames', so there is no call to 'change directory'. In this case, if that path is invalid, the upload fails.
+* IN CUMULUS 1.x.y ONLY: The standard images for gauges and trends pages are uploaded after the standard pages, (and any pages you specify for uploading), by performing a second 'change directory' this time fixed at 'images'; if this fails, the files will still be uploaded to the current web site directory (FTP root or the directory you specified in '''Sites/Options''').
+* If you have enabled ''Realtime'', the realtime.txt file is uploaded without doing a change directory, (by appending "/realtime.txt" to the directory on the ''Internet settings'' screen in '''Sites/Options'''). In this case, if the web site directory in your settings is invalid, the upload of the real time file fails.
+* On the ''NOAA Setup'' screen the optional '''Directory''' parameter required is the relative path; from your FTP root, to where the NOAA report pages are to be stored. (It is totally independent of the directory on the ''Internet settings'' screen in '''Sites/Options''').  Click the '''Help''' button for full explanation. Like realtime.txt, the upload destination is determined by appending the file-name for the report to any NOAA directory, and will fail if that directory is specified wrongly.
+See '''Setting up your website''' in Cumulus help for a simple guide to the sub-folder structure you need to create and the list of files that need to be uploaded manually when first installing a website. Or see [[Website_setup]] for all the options including customised pages.
 == My standard web pages are uploading but the uploading fails for images, realtime and/or NOAA reports ==