Main Page: Difference between revisions

From techdocs
Jump to navigation Jump to search
No edit summary
No edit summary
 
(65 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{|width=50%
|<span style="color: red;">After migrating pages to Confluence, move each page to the "Pre-confluence" namespace '''without''' leaving a redirect behind. This ensures that it's obvious the page is gone and displays a "paper trail" if anyone tries to access the page.</span>
|-
|<span style="color: red;">Pages can be migrated by copying-and-pasting the wikitext ("View source" if you're not logged in) into a file, running:
pandoc -f mediawiki -t docx -o /tmp/dummy.docx ''&lt;wikitextfile&gt;''
And then importing <code>/tmp/dummy.docx</code> into a blank Confluence page.</span>
|}
<br />
{|style="float: right;"|
{|style="float: right;"|
|[[Guide to TechDocs for administrators and content creators|Guide to TechDocs for<br />administrators and content creators]]
|[[Guide to TechDocs for administrators and content creators|Guide to TechDocs for<br />administrators and content creators]]
|-
|Style info:
Hosts classes are normal font and when referenced<br />in prose are contained in double quotes
|-
|[[MediaWiki:Common.css]]
|-
|[https://taggi.cse.unsw.edu.au/FAQ/ Taggi]
|-
|[https://www.cse.unsw.edu.au/~virtualexam/ Virtual exam environment]
|-
|[[File:CSE_network_diagram_-_September_2023.pdf]]
|}
|}


== Overview ==
== Overview ==


* [[New world versus Old World]]
* [[Ceph testing and development cluster]]
* [[New World versus Old World]]
* [[conform gives way to cfengine]]
* [[conform gives way to cfengine]]
* [[Configuration management and operation with cfengine]]
* [[What does the CSE UDB (User DataBase) do?]]
== Uncategorized as yet ==
* [[Storage and compute cluster]]
** [[Ceph operation, maintenance and repair]]
* [[New World gitlab server]]
* [[/unsw]]
* [[Connecting to Wifi]]
* [[vncsend]] and [[vncrecv]], VLAB and lab screen session sharing - for tutors and for working in pairs
* [[User virtual machines on VLAB servers]]
* [[RoboLab VLAB server]]
* [[Proposed home directory architecture, configuration and management]]
* [[Academic allocations]]
== To do ==
# Merge notes re [[debpkgsv2]] into some relevant page
# Review [[Special:LonelyPages|orphaned pages]]
# Review [[Special:WantedPages|wanted pages]]
# Do something with this page: [[MediaWiki]]
# [[AWS IPsec links]]
# Consider adding expiry and owner info to [[hostlist.csv]]
# [[ZZEN9217 H6 O.S. Fundamentals for Security: VM platform notes]]
# Do something with [[Lifecycle management of accounts (draft notes)]]
# Do something with [[Extra]]


== Subject categories ==
== Subject categories ==
Line 12: Line 62:
{|
{|
!Management and operation of systems
!Management and operation of systems
!Maintenance procedures
!Individual systems, applications and services
!Individual systems, applications and services
!Teaching tech
|-
|-
|
|
Line 21: Line 73:
* [[Host and server installation and setup]]
* [[Host and server installation and setup]]
* [[User session and account management]]
* [[User session and account management]]
* [[User database, authentication and authorisation]]
* [[Configuration management and operation with cfengine]]
* [[Configuration management and operation with cfengine]]
* [[Software package management and Debian]]
* [[Software package management and Debian]]
|
* [[Monitoring - nagios, graphing, auto-configuration by update_hosts]]
* [[Email]]
* [[Email]]
* [[Old UDB]]
* [[New UDB]]
* [[bandleader]]
* [[maillard]]
* [[PostFix]]
* [[Printing]]
* [[Printing]]
* [[Kerberos]]
* [[Monitoring framework]]
* [[LDAP]]
* [[Virtual exam environment]]
* [[New World file system layout]]
* [[New World Backup System]]
|
* [[Resize the root/boot volume of an AWS host]]
|
* [[podman]]
* [[podman]]
* [[pandoc]]
* [[pandoc]]
* [[SNMP query examples]]
* [[priv scripts and sudo]]
|
* [[give]]
* [[SMS]]
* [[WebCMS3]]
* [[classrun]]
* [[Virtual exam environment]]
* [[CASTLE]]
* [[talloc]]
* [[gitlab.cse.unsw.edu]]
* [[run_student_code]]
* [[running software from other Debian releases]]
* [[dcc]]
* [[autotest]]
* [[Controlling Resources & Privileges with Linux namespaces, cgroups & limits]]
* <s>TODO: Examine the SyntaxHighlight extension<br />from the point of view of demands on<br />the host (suggested by AndrewT, see also https://phabricator.wikimedia.org/T250763)</s><br /><syntaxhighlight lang="bash">
#!/bin/bash
set -x
echo "The MediaWiki SyntaxHighlight extension is enabled"
exit 0
</syntaxhighlight><syntaxhighlight lang="c">
#include <stdio.h>
int main () {
printf ("Hello, world!\n");
return (0);
}
</syntaxhighlight>
|}
|}
__TOC__
== Grab-bag of unsorted topics ==
* Examine the SyntaxHighlight extension from the point of view of demands on the host (suggested by AndrewT, see also https://phabricator.wikimedia.org/T250763)
* [[Linux namespaces and cgroups]]
* [[Controlling Resources & Privileges with Linux namespaces, cgroups & limits]]
* [[conform]] - [[nodeinfo]]
* [[Pages yet to be created]]


== Page categories ==
== Page categories ==


* [[:Category:Pages needing work|Pages needing work]]
* [[:Category:Pages needing work|Pages needing work]]
A bit more specifically, each New World host's filesystem is handled thusly:
{|
!Path
!Handled by
|-
|<code>/etc</code>
|Jointly managed by <code>apt</code> which mostly provides default versions of configuration files, and <code>cfengine</code> which installs CSE-specific versions of configuration files
|-
|style="white-space: nowrap;"|<code>/usr/local/[[extrafiles]]</code><br /><code>/usr/local/[[extrapackages]]</code><br /><code>/usr/local/[[debpkgs_lists]]</code><br /><code>/usr/local/[[vmimages]]</code>
|<code>cfengine</code>
|-
|<code>/proc</code><br /><code>/sys</code><br /><code>/dev</code>
|The kernel
|-
|<code>/tmp</code><br /><code>/var</code>
|Whatever processes are running on the host
|-
|<code>/export</code>
|The kernel's <code>nfsd</code> (i.e., NFS server)
|-
|<code>/import</code><br /><code>/home</code>
|The [[automounter]]
|-
|Everything else
|<code>apt</code>
|}
== Debian package management (<code>apt</code>) ==
== Configuration management (<code>cfengine</code>) ==
The [[cfengine hub]].
----
== MediaWiki installation leftovers ==
<strong>MediaWiki has been installed.</strong>
Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
== Getting started ==
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Configuration_settings Configuration settings list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:FAQ MediaWiki FAQ]
* [https://lists.wikimedia.org/postorius/lists/mediawiki-announce.lists.wikimedia.org/ MediaWiki release mailing list]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Localisation#Translation_resources Localise MediaWiki for your language]
* [https://www.mediawiki.org/wiki/Special:MyLanguage/Manual:Combating_spam Learn how to combat spam on your wiki]


[[Category:Pages needing work]]
[[Category:Pages needing work]]

Latest revision as of 12:20, 1 Mayıs 2024

After migrating pages to Confluence, move each page to the "Pre-confluence" namespace without leaving a redirect behind. This ensures that it's obvious the page is gone and displays a "paper trail" if anyone tries to access the page.
Pages can be migrated by copying-and-pasting the wikitext ("View source" if you're not logged in) into a file, running:
pandoc -f mediawiki -t docx -o /tmp/dummy.docx <wikitextfile>

And then importing /tmp/dummy.docx into a blank Confluence page.


Guide to TechDocs for
administrators and content creators
Style info:

Hosts classes are normal font and when referenced
in prose are contained in double quotes

MediaWiki:Common.css
Taggi
Virtual exam environment
File:CSE network diagram - September 2023.pdf

Overview

Uncategorized as yet

To do

  1. Merge notes re debpkgsv2 into some relevant page
  2. Review orphaned pages
  3. Review wanted pages
  4. Do something with this page: MediaWiki
  5. AWS IPsec links
  6. Consider adding expiry and owner info to hostlist.csv
  7. ZZEN9217 H6 O.S. Fundamentals for Security: VM platform notes
  8. Do something with Lifecycle management of accounts (draft notes)
  9. Do something with Extra

Subject categories

Management and operation of systems Maintenance procedures Individual systems, applications and services Teaching tech

Page categories