building_a_website_on_sdf
Differences
This shows you the differences between two versions of the page.
Next revision | Previous revisionLast revisionBoth sides next revision | ||
building_a_website_on_sdf [2021/03/11 19:15] – created peteyboy | building_a_website_on_sdf [2022/08/10 23:34] – regularize paths as italic, and monospace for commands peteyboy | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Building a website on SDF ====== | + | ====== Building a website on SDF ====== |
Creating your own websites can be fun and SDF gives webspace to all its validated users, so the moment you become validated you can begin creating your own websites straight away. | Creating your own websites can be fun and SDF gives webspace to all its validated users, so the moment you become validated you can begin creating your own websites straight away. | ||
- | In this tutorial when text looks like "this" | + | In this tutorial when text looks like '' |
==== Getting Started ==== | ==== Getting Started ==== | ||
- | '' | + | '' |
So first, run at your ($) prompt: | So first, run at your ($) prompt: | ||
Line 13: | Line 13: | ||
$ mkhomepg | $ mkhomepg | ||
- | ===== Your First Page! ===== | + | ==== Your First Page! ==== |
Creating your first page is **__SO__** easy! First you'll need to open a text editor. SDF has many text editors installed but new users to UNIX often find that " | Creating your first page is **__SO__** easy! First you'll need to open a text editor. SDF has many text editors installed but new users to UNIX often find that " | ||
- | '' | + | '' |
< | < | ||
Line 29: | Line 29: | ||
</ | </ | ||
- | Now that you have copied the text out into ' | + | Now that you have copied the text out into ''nano'', you need to save the file. To do this, hold down the ' |
- | Right, now, do you remember that URL you selected when you ran '"mkhomepg"'? Open a web browser and type that into the address bar. Hopefully, after a few seconds. You should see your very own web page! | + | Right, now, do you remember that URL you selected when you ran ''mkhomepg''? Open a web browser and type that into the address bar. Hopefully, after a few seconds. You should see your very own web page! |
+ | |||
+ | |||
+ | |||
+ | ==== More Pages ==== | ||
+ | Okay, now that you have your first web page up, here are some [[resources_for_website_builders|Resources for Developing Your Website]] | ||
+ | |||
+ | An important thing: your website files need to be set to particular user permissions in order to be viewable by the world. When you add pages or subdirectories to your web site, the easiest way to make sure it will all continue to work is to **remember, after you are done with your changes**, to run the command < | ||
+ | | ||
+ | </ | ||
+ | The '' | ||
+ | |||
+ | |||
+ | |||
+ | Here are all the options for the mkhomepg command, which you can see by running it with the '' | ||
+ | |||
+ | < | ||
+ | usage: | ||
+ | mkhomepg -p (set appropriate file permissions) | ||
+ | mkhomepg -a (set or unset your custom URL) | ||
+ | mkhomepg -d (set or unset http:// | ||
+ | mkhomepg -t | ||
+ | |||
+ | </ | ||
+ | |||
+ | ===== Web Page Locations ===== | ||
+ | |||
+ | As you can see above with the '' | ||
+ | * **Standard Site:** By default, your web site files go in your user folder on the cluster in the '' | ||
+ | * **' | ||
+ | * **Virtual Host:** If you have a [[vhost]], you should place files for it in your //< | ||
+ | * **[[metaarray|The MetaArray]]: | ||
===== Problems ===== | ===== Problems ===== | ||
- | The most important thing you need to have is **patience**. Sometimes updates when running | + | The most important thing you need to have is **patience**. Sometimes updates when running |
In case a page is not found on your site, the client may be forwarded to a page of sdf.org or redmartian, which can be confusing (but which is in fact completely reasonable, as all the domains belong to one entity). If you want to prevent this also for broken links, you have to set up error handler documents. Please consult the FAQ, [[https:// | In case a page is not found on your site, the client may be forwarded to a page of sdf.org or redmartian, which can be confusing (but which is in fact completely reasonable, as all the domains belong to one entity). If you want to prevent this also for broken links, you have to set up error handler documents. Please consult the FAQ, [[https:// | ||
- | ===== Diagnose | + | ==== Diagnose ==== |
- | If your site is hosted on sdf.org (you are an ARPA member) then you can grep inside the httpd log file in /// | + | One way to try to figure out what is going wrong when you HTTP requests are made to your site is to look at http access logs. |
+ | |||
+ | === Finding Your Logs on the Main Cluster === | ||
+ | |||
+ | If your site is hosted on sdf.org (you are an ARPA member) then you can grep inside the httpd log file in /// | ||
$ grep abc123.sdf.org / | $ grep abc123.sdf.org / | ||
+ | | ||
+ | === Finding Your Logs on the Metaarray === | ||
- | If your site is hosted on ma.sdf.org (you are a MetaARPA member) then your can look inside the log file for your web site in "/meta/log". For example: | + | If your site is hosted on ma.sdf.org (you are a MetaARPA member) then you can look inside the log file for your web site in ///meta/log//. For example: |
$ less / | $ less / | ||
+ | |||
+ | === Finding Your Logs for VHOSTs === | ||
+ | If your site is VHOSTed, then you can access your site's own log file by ssh-ing to the '' | ||
+ | $ ssh peteyboy@irulecomputers.com | ||
+ | ... (login stuff) | ||
+ | $ less / | ||
+ | | ||
+ | ==== Web Server Details ==== | ||
+ | Problems you may be having may relate to what web server your pages are running on. That depends, as above, on where you are storing the pages: | ||
+ | |||
+ | ^Host ^Web Server Software | ||
+ | | sdf | Apache | ||
+ | | faeroes | Apache | ||
+ | | iceland | Apache | ||
+ | | norge | nginx | ||
+ | | mab | nginx | ||
+ | |||
+ | ====== | ||
For additional help, check the information in the FAQ page [[https:// | For additional help, check the information in the FAQ page [[https:// | ||
----- | ----- | ||
- | legacy | + | |
+ | Traditional | ||
building_a_website_on_sdf.txt · Last modified: 2023/04/19 17:57 by peteyboy