From aa3bcf4c38c4c0179356aaf1b67c5c7e13eee743 Mon Sep 17 00:00:00 2001
From: watts <benjamin.watts@psi.ch>
Date: Tue, 26 Aug 2025 19:14:03 +0200
Subject: [PATCH] Add Update-Pixelator-Version

---
 Update-Pixelator-Version.-.md | 38 +++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)
 create mode 100644 Update-Pixelator-Version.-.md

diff --git a/Update-Pixelator-Version.-.md b/Update-Pixelator-Version.-.md
new file mode 100644
index 0000000..5e9f22a
--- /dev/null
+++ b/Update-Pixelator-Version.-.md
@@ -0,0 +1,38 @@
+# Structure
+
+The instructions for installing Pixelator involve downloading the code into the `/home/control/work/stxm/` directory. To allow the installation of multiple versions, it is best to put each version in a new directory in `work/` and make a _stxm_ soft link that points to the one you wish to use such that the startup scripts will still work the same. For example:
+```
+control@pixelator-1:~/work$ ls -l
+total 20
+drwxr-xr-x 14 control control 4096 Jul  7  11:20 stxm-20250520
+drwxr-xr-x 14 control control 4096 Aug 22  15:07 stxm-20250822
+lrwxrwxrwx  1 control control   13 Jul  4  22:54 stxm -> stxm-20250520
+```
+
+At PolLux, we use 2 different links together with startup scripts for a _stxm-stable_ and a _stxm-test_ version:
+```
+control@x07da-stxm-1:~/work$ ls -l
+total 20
+drwxr-xr-x 14 control control 4096 Feb  3  2025 stxm
+drwxr-xr-x 14 control control 4096 Jul  7 11:20 stxm-20250520
+drwxr-xr-x 14 control control 4096 Aug 13 17:30 stxm-20250702-russ
+drwxr-xr-x 14 control control 4096 Aug 13 18:02 stxm-20250813-russ
+drwxr-xr-x 14 control control 4096 Aug 22 15:07 stxm-20250822
+lrwxrwxrwx  1 control control   13 Jul  4 22:54 stxm-stable -> stxm-20250520
+lrwxrwxrwx  1 control control   20 Aug 13 17:33 stxm-test -> ./stxm-20250813-russ
+```
+
+# Download New Code
+
+The new code can be downloaded from `gitea.psi.ch`. There are 3 ways to do this:
+
+1. Use the `git clone` command with an **https** link - requires a token from gitea.psi.ch
+2. Use the `git clone` command with an **ssh** link - requires uploading your public key to gitea.psi.ch
+3. Log in to gitea.psi.ch and use the blue `<> code` button menu to download a ZIP or TAR.GZ archive
+
+# Activate a Different Version
+
+A different version can be made active by redirecting the link to point at the directory of the desired version. From the `~/work/` directory, use the command: 
+```ln -sf $TARGET $LINK_NAME```
+where `$TARGET` is the directory name of the desired version and $LINK_NAME is the path that your startup scripts expect (e.g. `stxm` or `stxm-test`).
+