|
Size: 1587
Comment:
|
← Revision 8 as of 2024-03-13 12:07:42 ⇥
Size: 1842
Comment: Adding how to set up your website
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| == Reverse Proxy == Member domains (''username''.ucc.asn.au) and the main website resolve as CNAMEs to mooneye. |
== Web Serving == Member domains (''username''.ucc.asn.au) and the main website resolve as CNAMEs to [[Mussel]]. |
| Line 6: | Line 6: |
| The configuration for member VirtualHosts is on mooneye in {{{/etc/apache2/sites-available/members}}}. These VirtualHost entries simply proxy pass-through to {{{http://realwww.ucc.gu.uwa.edu.au/~username}}} (a CNAME to mussel). ProxyPassthroughReverse is also used so that HTTP headers don't come back to the user with the wrong domain name. For some reason this doesn't seem to work for URLs pointing to a directory without a trailing slash. | The configuration for member !VirtualHosts is on mussel in {{{/etc/apache2/sites-enabled/members.conf}}}. These !VirtualHost entries simply set the !DocumentRoot to the {{{public-html/}}} folder in the user's home directory. The {{{members.conf}}} configuration file is automatically generated by {{{zonemake.py}}}, a Python script which manages DNS zones on [[Monnik]]. |
| Line 8: | Line 8: |
| == Web Serving == Most web-serving happens on mussel, and most of the configuration for this is stored in {{{/etc/apache2/sites-available/}}}. Most of the file names are fairly self-explanatory, but it is worth noting that both the main website and member webspace are configured in {{{default}}}. |
=== How to Set Up Your Website === When you log in to your home directory, use the command {{{cd}}} into the file called {{{public-html}}}. Use the command {{{ls}}} to view the files in this folder. It will have a file called {{{index.html}}}, this is the text file connected to the member domain of your website. To edit the {{{index.html}}} file open it up with a text editor such as {{{nano}}} or {{{vim}}}. You will need to use html code to edit the file. |
| Line 12: | Line 12: |
| Most HTTPS services are hosted under https://secure.ucc.asn.au, which also points to mussel (though it uses the interface listening on 130.95.13.28, not 130.95.13.18). Originally, this was because we didn't want to buy an SSL certificate for every machine. Now we have a wildcard certificate, so subdomains* can be accessed using HTTPS as well! | /* [CJN] - should probably add some info about how SSL is currently done rather than secure.ucc.asn.au since that isn't really used anymore */ |
| Line 14: | Line 14: |
| * SSL wildcards are not actually wildcards — they only support one level of subdomain, so {{*.ucc.asn.au}}} won't match {{{something.weird.ucc.asn.au}}}. Have a look at {{{/etc/apache2/sites-available/secure}}} on mussel to see how it's configured (it's world-readable). |
Historically, HTTPS services were hosted under https://secure.ucc.asn.au, which also points to mussel (though it uses the interface listening on 130.95.13.28, not 130.95.13.18). Originally, this was because we didn't want to buy an SSL certificate for every machine. Now we have a wildcard certificate, so subdomains<<FootNote(SSL wildcards are not actually wildcards — they only support one level of subdomain, so {{{*.ucc.asn.au}}} won't match {{{something.weird.ucc.asn.au}}}.)>> can be accessed using HTTPS as well! Have a look at {{{/etc/apache2/sites-available/secure.conf}}} on mussel to see how it's configured (it's world-readable). |
UCC uses Apache 2 as a webserver for its website and member web-hosting services.
Web Serving
Member domains (username.ucc.asn.au) and the main website resolve as CNAMEs to Mussel.
The configuration for member VirtualHosts is on mussel in /etc/apache2/sites-enabled/members.conf. These VirtualHost entries simply set the DocumentRoot to the public-html/ folder in the user's home directory. The members.conf configuration file is automatically generated by zonemake.py, a Python script which manages DNS zones on Monnik.
How to Set Up Your Website
When you log in to your home directory, use the command cd into the file called public-html. Use the command ls to view the files in this folder. It will have a file called index.html, this is the text file connected to the member domain of your website. To edit the index.html file open it up with a text editor such as nano or vim. You will need to use html code to edit the file.
SSL
Historically, HTTPS services were hosted under https://secure.ucc.asn.au, which also points to mussel (though it uses the interface listening on 130.95.13.28, not 130.95.13.18). Originally, this was because we didn't want to buy an SSL certificate for every machine. Now we have a wildcard certificate, so subdomains1 can be accessed using HTTPS as well! Have a look at /etc/apache2/sites-available/secure.conf on mussel to see how it's configured (it's world-readable).
SSL wildcards are not actually wildcards — they only support one level of subdomain, so *.ucc.asn.au won't match something.weird.ucc.asn.au. (1)
