aboutsummaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorCollin J. Doering2024-09-27 17:37:13 -0400
committerCollin J. Doering2024-09-27 17:37:13 -0400
commit1e3376308549d39e27c32e9b4705bd4b0cc19a4e (patch)
tree48bd49798631cbc1c90880145d5384a562213aef /docs
parent55198472bc88feab9d9e634c2d52491611650e30 (diff)
downloadguix-north-america-1e3376308549d39e27c32e9b4705bd4b0cc19a4e.tar.gz
Update documentation
* README.org: Add new README that details how to use cuirass.genenetwork.org, and provides links to other reference documents. * docs/administration.org: Add a new, initially sparse, reference document detailing administration and maintenance of cuirass.genenetwork.org. * docs/initial-setup.org: Adjust abstract phrasing.
Diffstat (limited to 'docs')
-rw-r--r--docs/administration.org32
-rw-r--r--docs/initial-setup.org6
2 files changed, 35 insertions, 3 deletions
diff --git a/docs/administration.org b/docs/administration.org
new file mode 100644
index 0000000..8dd2b82
--- /dev/null
+++ b/docs/administration.org
@@ -0,0 +1,32 @@
+#+TITLE: Administration of cuirass.genenetwork.org
+#+AUTHOR: Collin J. Doering
+
+#+begin_abstract
+This document details maintenance and administration of cuirass.genenetwork.org.
+#+end_abstract
+
+* Updating cuirass.genenetwork.org
+
+1. Fetch the most recent channel file.
+
+ #+begin_src shell
+ curl -O https://git.genenetwork.org/guix-north-america/plain/channels.scm
+ #+end_src
+
+2. Update guix using the most recent channel file.
+
+ #+begin_src shell
+ sudo -i guix pull -C $(relapath channels.scm)
+ #+end_src
+
+3. Update the system.
+
+ #+begin_src shell
+ sudo guix system reconfigure -e '((@ (guix-na config balg02) balg02) %system)'
+ #+end_src
+
+4. Reboot.
+
+ #+begin_src shell
+ sudo reboot
+ #+end_src
diff --git a/docs/initial-setup.org b/docs/initial-setup.org
index 99c61a3..d7d2f28 100644
--- a/docs/initial-setup.org
+++ b/docs/initial-setup.org
@@ -1,9 +1,9 @@
-#+TITLE: Guix North America
+#+TITLE: Balg02 Initial Setup Instructions
#+AUTHOR: Collin J. Doering
#+begin_abstract
-This repository contains setup and management instructions for a Guix North American Build
-Farm.
+This document details the initial setup of a genenetwork.org sponsored server hosted at the
+University of Tennessee.
#+end_abstract
* Install Guix on debian to be used to bootstrap the Guix os installation