Main Page: Difference between revisions

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

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 orphaned pages
Review 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

Management and operation of systems	Maintenance procedures	Individual systems, applications and services	Teaching tech
Home and shared directories Virtualisation and cloud Policies and principles Networking Host and server installation and setup User session and account management User database, authentication and authorisation Configuration management and operation with cfengine Software package management and Debian Email Printing Monitoring framework Virtual exam environment New World file system layout New World Backup System	Resize the root/boot volume of an AWS host	podman 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 TODO: Examine the SyntaxHighlight extension from the point of view of demands on the host (suggested by AndrewT, see also https://phabricator.wikimedia.org/T250763) #!/bin/bash set -x echo "The MediaWiki SyntaxHighlight extension is enabled" exit 0 #include <stdio.h> int main () { printf ("Hello, world!\n"); return (0); }

Page categories

Pages needing work

@@ Line 1: / Line 1: @@
-== Introduction ==
+{|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:
-For over twenty years the configuration of CSE's servers and lab computers has been managed by a home-grown product called <code>conform</code>. <code>conform</code> micromanaged the entire filesystem of each computer and handled the copying in of all configuration files, binaries, scripts, libraries, data files, etc, from a central repository called "the conformary". Very powerful, but also very labour intensive and very limiting. This is the ''Old World''.
+ pandoc -f mediawiki -t docx -o /tmp/dummy.docx ''&lt;wikitextfile&gt;''
-The ''New World'' grew out a HoS-supported project to move as much CSE infrastructure as possible out of CSE's K17 data centre and into "the cloud", specifically Amazon's AWS. Early on, a decision was made that <code>conform</code> would be left behind and that all new servers and hosts set up in AWS would be managed some other way. This other way ended up being -- after a review of configuration management tools -- a split between <code>cfengine</code> and Debian's <code>apt</code> family of package manager utilities (<code>apt</code>, <code>dpkg</code>, <code>apt-get</code>, <code>apt-file</code>, etc.) In this split, <code>apt</code> handles all Debian package management (mainly installs and updates) and <code>cfengine</code> handles the rest, mostly configuration files.
+And then importing <code>/tmp/dummy.docx</code> into a blank Confluence page.</span>
+|}
-Debian was chosen because CSE's existing teaching platform was heavily based on Debian and the principle of least surprise was applied.
+<br />
-A bit more specifically, each New World host's filesystem is handled thusly:
+{|style="float: right;"|
+|[[Guide to TechDocs for administrators and content creators|Guide to TechDocs for<br />administrators and content creators]]
-{|
-!Path
-!Handled by
 |-
-|<code>/etc</code>
+|Style info:
-|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
+Hosts classes are normal font and when referenced<br />in prose are contained in double quotes
 |-
-|style="white-space: nowrap;"|<code>/usr/local/extrafiles</code><br /><code>/usr/local/extrapackages</code><br /><code>/usr/local/debpkgs_lists</code>
+|[[MediaWiki:Common.css]]
-|<code>cfengine</code>
 |-
-|<code>/proc</code><br /><code>/sys</code><br /><code>/dev</code>
+|[https://taggi.cse.unsw.edu.au/FAQ/ Taggi]
-|The kernel
 |-
-|<code>/tmp</code><br /><code>/var</code>
+|[https://www.cse.unsw.edu.au/~virtualexam/ Virtual exam environment]
-|Whatever processes are running on the host
 |-
-|Everything else
+|[[File:CSE_network_diagram_-_September_2023.pdf]]
-|<code>apt</code>
 |}
-----
+== Overview ==
+* [[Ceph testing and development cluster]]
+* [[New World versus Old World]]
+* [[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]]
-== MediaWiki installation leftovers ==
+== Subject categories ==
+{|
+!Management and operation of systems
+!Maintenance procedures
+!Individual systems, applications and services
+!Teaching tech
+|-
+|
+* [[Home and shared directories]]
+* [[Virtualisation and cloud]]
+* [[Policies and principles]]
+* [[Networking]]
+* [[Host and server installation and setup]]
+* [[User session and account management]]
+* [[User database, authentication and authorisation]]
+* [[Configuration management and operation with cfengine]]
+* [[Software package management and Debian]]
+* [[Email]]
+* [[Printing]]
+* [[Monitoring framework]]
+* [[Virtual exam environment]]
+* [[New World file system layout]]
+* [[New World Backup System]]
+|
+* [[Resize the root/boot volume of an AWS host]]
+|
+* [[podman]]
+* [[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>
+|}
-<strong>MediaWiki has been installed.</strong>
+== Page categories ==
-Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents User's Guide] for information on using the wiki software.
+* [[:Category:Pages needing work|Pages needing work]]
-== Getting started ==
+[[Category:Pages needing work]]
-* [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]