Differences

This shows you the differences between two versions of the page.

--- blocks:manage_script_directory [2024-03-20 14:22]
mattias [Update]
+++ blocks:manage_script_directory [2024-09-23 12:59] (current)
mattias [Manual update]
@@ Line 1: / Line 1: @@
 =====Manage the script directory=====
-We keep the latest version on our script environment in our [[https://github.com/pixilab/blocks-script|blocks-script repo on github]].
+We always keep the latest version on our script environment in our [[https://github.com/pixilab/blocks-script|blocks-script repo on github]].
+:!: Before doing anything with an existing script directory in a working system, it is always recommended to make a security copy of the /PIXILAB-Blocks-root/script/ directory in case something goes wrong.
-:!: Before doing anything with an existing script directory in a working system, it is always recommended to:
-  * stop the server
-  * make a security copy of the /PIXILAB-Blocks-root/script/ directory in case something goes wrong.
 ====First time installation====
@@ Line 12: / Line 12: @@
 ===Get the files===
-There are a few different methods to obtain the files, but in general for any desktop environments one can download a zip of the repo by clicking the green <CODE> dropdown and select the option to [[https://github.com/pixilab/blocks-script/archive/refs/heads/master.zip|Download ZIP]]. This zip will contain all the files.
+There are a few different methods to obtain the files, but in general for any desktop environments one can download a compressed .zip archive of the repo ([[https://github.com/pixilab/blocks-script|]]) by clicking the green <CODE> dropdown and select the option to [[https://github.com/pixilab/blocks-script/archive/refs/heads/master.zip|Download ZIP]]. This zip will contain all the latest files.
 ===Decompress the files===
@@ Line 25: / Line 25: @@
 ====Update the script directory====
 An update of the files is the same thing as with the fresh install for any desktop environment. For linux there is a script that automates this:
-===Production Linux environments===
+===Production Linux Desktop environments===
-For production Linux environments, one can use the update_scripts.sh that automates the procedure. Before running the script, cd into the /script/ directory in the cli.
+For production Linux environments provisioned with our image, one can use the update_scripts.sh that automates the whole procedure including making a security copy and stopping the server. Before running the script, cd into the /script/ directory in the cli. The script has some dependencies that may be missing in i.e virtual machines not provisioned by the image.
 <code>
 pixi-server@pixi:~$ cd PIXILAB-Blocks-root/script/
@@ Line 34: / Line 34: @@
 pixi-server@pixi:~/PIXILAB-Blocks-root/script$ ./update_scripts.sh
 </code>
-In case the environment has not been set up from the Pixilab image, one may have to make the file excutable before running the script.
+The script makes a backup copy of the directory, downloads the latest files and merges them into the existing scripts directory.
+If the update_scripts.sh is not present it can be done manually using the cli method below.
+====Manual update====
+Follow the steps for the appropriate OS to manually update the files.
+===Linux CLI===
 <code>
-pixi-server@pixi:~/PIXILAB-Blocks-root/script$ chmod +x update_scripts.sh
+#Navigate in to the script directory.
+$ cd PIXILAB-Blocks-root/script
+#Clone the current git repo from github.
+$ git clone -q https://github.com/pixilab/blocks-script.git
+#Merge the new and updated files into the existing directory.
+$ cp -r blocks-script/*
+#Remove the now obsolete cloned files.
+$ rm -r -f blocks-script
 </code>
-===Linux Desktop===
+>
-===Linux CLI===
-===Windows desktop===
+===Desktop environments===
-===Window CLI===
+Make a copy of the existing PIXILAB-Blocks-root/script/
+Download the files from [[ https://github.com/pixilab/blocks-script|github.]] This is done by clicking the green Code button and select Download ZIP archive from the drop-down menu.
+{{ :blocks:manage_script_directory:screenshot_2024-09-23_144107.png?600 |}}
+This will put a zip file in your default downloads directory.
+Doubleclick the zip and uncompress it to a temporary destination of your choice.
+Navigate to the blocks-script-master sourcedirectory in your temp destination and select and copy all files.
+{{ :blocks:manage_script_directory:screenshot_2024-09-23_145305.png?400 |}}
+Paste the source files into the existing PIXILAB-Blocks-root/script/ directory and select overwrite on all conflicts.
-===MacOS desktop===
+Restart the server.
-===MacOS CLI===