aboutsummaryrefslogtreecommitdiff
path: root/content/en/docs/adyxax.org
diff options
context:
space:
mode:
Diffstat (limited to '')
-rw-r--r--content/en/docs/adyxax.org/_index.md11
-rw-r--r--content/en/docs/adyxax.org/services/_index.md8
-rw-r--r--content/en/docs/adyxax.org/services/checkmk.md16
-rw-r--r--content/en/docs/adyxax.org/services/nethack.md56
-rw-r--r--content/en/docs/adyxax.org/services/www.md60
-rw-r--r--content/en/docs/adyxax.org/this_website.md39
6 files changed, 146 insertions, 44 deletions
diff --git a/content/en/docs/adyxax.org/_index.md b/content/en/docs/adyxax.org/_index.md
index 3cfe834..9fbd29e 100644
--- a/content/en/docs/adyxax.org/_index.md
+++ b/content/en/docs/adyxax.org/_index.md
@@ -3,18 +3,19 @@ title: "adyxax.org"
linkTitle: "adyxax.org"
weight: 1
description: >
- adyxax.org is how I call my personal computer infrastructure.
+ adyxax.org is my personal computer infrastructure. This section details how I built it and why, and how I maintain it.
---
## What is adyxax.org?
-adyxax.org is how I call my personal computer infrastructure. It is very much like a small personnal private cloud of servers hosted here and there. I am using my experience as a
-sysadmin to make it all work and provide various services that are useful to me and people close to me.
+adyxax.org is very much like a small personnal cloud of servers hosted here and there. I am using my experience as a
+sysadmin to make it all work and provide various services that are useful to me and people that are close to me. As a good sysadmin, I am trying to be lazy and build the most self
+maintainable solution, with as little maintenance overhead as possible.
-It relies on gentoo and openbsd servers interconnected with point to point openvpn links. Services run inside lxd containers and communications between all those services is assured
+It relies on mostly gentoo (and some optional openbsd) servers interconnected with point to point openvpn links. Services run inside lxd containers and communications between all those services work
thanks to dynamic routing with bird and ospf along those openvpn links.
## Why write about it?
It is a rather unusual infrastructure that I am proud of, and writing about it helps me to reflect on what I built. Gentoo, OpenBSD and LXD is not the most popular combination of
-technologies but it allowed me to build something simple, flexible and I believe somewhat elegant and beautiful.
+technologies but I leveraged it to build something simple, flexible and I believe somewhat elegant and beautiful.
diff --git a/content/en/docs/adyxax.org/services/_index.md b/content/en/docs/adyxax.org/services/_index.md
new file mode 100644
index 0000000..405c2ca
--- /dev/null
+++ b/content/en/docs/adyxax.org/services/_index.md
@@ -0,0 +1,8 @@
+---
+title: "Services"
+linkTitle: "Services"
+weight: 1
+description: >
+ Here are the services provided by adyxax.org
+---
+
diff --git a/content/en/docs/adyxax.org/services/checkmk.md b/content/en/docs/adyxax.org/services/checkmk.md
new file mode 100644
index 0000000..f8a8bf6
--- /dev/null
+++ b/content/en/docs/adyxax.org/services/checkmk.md
@@ -0,0 +1,16 @@
+---
+title: "checkmk"
+linkTitle: "checkmk"
+weight: 1
+description: >
+ checkmk
+---
+
+TODO
+
+## Updating
+
+- Download latest raw edition package from http://mathias-kettner.com/check_mk_download_version.php?HTML=yes&version=1.2.8p15&edition=cre and install it.
+- `run omd backup adyxax adyxax.bak`
+- `run omd update adyxax`
+- If all went well, apt purge the previous check_mk version to free space.
diff --git a/content/en/docs/adyxax.org/services/nethack.md b/content/en/docs/adyxax.org/services/nethack.md
new file mode 100644
index 0000000..e9aa7a7
--- /dev/null
+++ b/content/en/docs/adyxax.org/services/nethack.md
@@ -0,0 +1,56 @@
+---
+title: "nethack"
+linkTitle: "nethack"
+weight: 1
+description: >
+ nethack
+---
+
+## dgamelaunch
+
+TODO
+
+{{< highlight sh >}}
+groupadd -r games
+useradd -r -g games nethack
+git clone
+{{< /highlight >}}
+
+## nethack
+
+TODO
+
+{{< highlight sh >}}
+{{< /highlight >}}
+
+## scores script
+
+TODO
+
+{{< highlight sh >}}
+{{< /highlight >}}
+
+## copying shared libraries
+
+{{< highlight sh >}}
+cd /opt/nethack
+for i in `ls bin`; do for l in `ldd bin/$i | tail -n +1 | cut -d'>' -f2 | awk '{print $1}'`; do if [ -f $l ]; then echo $l; cp $l lib64/; fi; done; done
+for l in `ldd dgamelaunch | tail -n +1 | cut -d'>' -f2 | awk '{print $1}'`; do if [ -f $l ]; then echo $l; cp $l lib64/; fi; done
+for l in `ldd nethack-3.7.0-r1/games/nethack | tail -n +1 | cut -d'>' -f2 | awk '{print $1}'`; do if [ -f $l ]; then echo $l; cp $l lib64/; fi; done
+{{< /highlight >}}
+
+## making device nodes
+
+TODO! For now I mount all of /dev in the chroot :
+{{< highlight sh >}}
+#mknod -m 666 dev/ptmx c 5 2
+mount -R /dev /opt/nethack/dev
+{{< /highlight >}}
+
+## debugging
+
+{{< highlight sh >}}
+gdb chroot
+run --userspec=nethack:games /opt/nethack/ /dgamelaunch
+{{< /highlight >}}
+
diff --git a/content/en/docs/adyxax.org/services/www.md b/content/en/docs/adyxax.org/services/www.md
new file mode 100644
index 0000000..c50ffa6
--- /dev/null
+++ b/content/en/docs/adyxax.org/services/www.md
@@ -0,0 +1,60 @@
+---
+title: "www"
+linkTitle: "www"
+weight: 1
+description: >
+ adyxax.org main entry website. www.adyxax.org, wiki.adyxax.org and blog.adyxax.org all point here.
+---
+
+This is the website you are currently reading. It is a static website built using [hugo](https://github.com/gohugoio/hugo). This article details how I
+installed hugo, how I initialised this website and how I manage it. I often refer to it as wiki.adyxax.org because I hosted a unique dokuwiki for a long
+time as my main website (and a pmwiki before that), but with hugo it has become more than that. It is now a mix of wiki, blog and showcase of my work and interests.
+
+## Installing hugo
+
+{{< highlight sh >}}
+go get github.com/gohugoio/hugo
+{{< / highlight >}}
+
+You probably won't encounter this issue but this command failed at the time I installed hugo because the master branch in one of the dependencies was
+tainted. I fixed it with by using a stable tag for this project and continue installing hugo from there:
+{{< highlight sh >}}
+cd go/src/github.com/tdewolff/minify/
+tig --all
+git checkout v2.6.1
+go get github.com/gohugoio/hugo
+{{< / highlight >}}
+
+This did not build me the extended version of hugo that I need for the [docsy](https://github.com/google/docsy) theme I chose, so I had to get it by doing :
+{{< highlight sh >}}
+cd ~/go/src/github.com/gohugoio/hugo/
+go get --tags extended
+go install --tags extended
+{{< / highlight >}}
+
+## Bootstraping this site
+
+{{< highlight sh >}}
+hugo new site www
+cd www
+git init
+git submodule add https://github.com/google/docsy themes/docsy
+{{< / highlight >}}
+
+The docsy theme requires two nodejs programs to run :
+{{< highlight sh >}}
+npm install -D --save autoprefixer
+npm install -D --save postcss-cli
+{{< / highlight >}}
+
+## hugo commands
+
+To spin up the live server for automatic rebuilding the website when writing articles :
+{{< highlight sh >}}
+hugo server --bind 0.0.0.0 --minify --disableFastRender
+{{< / highlight >}}
+
+To publish the website in the `public` folder :
+{{< highlight sh >}}
+hugo --minify
+{{< / highlight >}}
diff --git a/content/en/docs/adyxax.org/this_website.md b/content/en/docs/adyxax.org/this_website.md
deleted file mode 100644
index c346534..0000000
--- a/content/en/docs/adyxax.org/this_website.md
+++ /dev/null
@@ -1,39 +0,0 @@
-# This website
-
-This website is a static website build using [hugo](https://github.com/gohugoio/hugo). This article details how I installed hugo, how I initialised this website and how I manage it.
-
-## Installing hugo
-
-{{< highlight sh >}}
-go get github.com/gohugoio/hugo
-{{< / highlight >}}
-
-This failed because the master branch in one of the dependencies was tainted, I fixed it with :
-{{< highlight sh >}}
-cd go/src/github.com/tdewolff/minify/
-tig --all
-git checkout v2.6.1
-go get github.com/gohugoio/hugo
-{{< / highlight >}}
-
-This didn't build me the extended version of hugo that I need for the theme I chose, so I had to do :
-{{< highlight sh >}}
-cd ~/go/src/github.com/gohugoio/hugo/
-go get --tags extended
-go install --tags extended
-{{< / highlight >}}
-
-## Bootstraping this site
-
-{{< highlight sh >}}
-hugo new site www
-cd www
-git init
-git submodule add https://github.com/alex-shpak/hugo-book themes/book
-{{< / highlight >}}
-
-## Live server for automatic rebuilding when writing
-
-{{< highlight sh >}}
-hugo server --bind 0.0.0.0 --minify
-{{< / highlight >}}