Differences

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

--- blocks:server:tweaks [2020-06-21 18:53]
admin Added offline option
+++ blocks:server:tweaks [2024-10-08 11:01] (current)
admin Change "orange suitcase"
@@ Line 3: / Line 3: @@
 PIXILAB regularly revisits and improves the Linux server image, resulting in newer releases. The release is indicated by the date shown as part of the filename. However, for a running installation, it's not practical to re-image the server regularly. Instead, we provide important notes here on what you can do to keep up to date with the state of the art, keeping your server working as well as possible.
-This article describes how to update server images based on Ubuntu 18. If you're using server image version 200525 or later, which is based on Ubuntu 20, this has already been taken care of. However, you may still want to update your operating system from time to time to keep up-to-date with security patches.
+This article describes how to update server images based on Ubuntu 18. If you're using server image version 200525 or later, based on Ubuntu 20, most of what's described below is already been taken care of. However, you may still want to update your operating system from time to time to keep up-to-date with security patches.
 :!: If you're using an older version of server, based on Ubuntu 16, released before 2019-05-28, first follow [[blocks:server:tweaks-ubuntu16|this guide]], then proceed as follows below.
@@ Line 13: / Line 13: @@
   - Make sure the server has Internet access (test by opening the pre-installed web browser and going to a web address).
   - Switch to the pixi-admin user (password is "pixi" if you haven't changed it).
-  - Click the orange "suitcase" icon in the toolbar on the left hand side, titled "Ubuntu Software".
+  - Click the gray A-in-a-circle icon in the toolbar on the left hand side titled "Software Updater".
-  - Select the "Updates" tab.
+  - If it indicates that software updates are available, consider installing those.
-  - If you see "OS updates", click the "Install" button next to it.
+  - Restart the server to make sure the updates take effect.
-  - Restart the server to make the updates take effect.
 ===== Update Java =====
-Blocks 4.1 and later uses a newer version of Java. Before updating Blocks, you need to update your Java version. If your server has internet access, proceed as follows (see below for an off-line alternative).
+Blocks 4.1 and later uses a newer version of Java. If your server currently has an older version of Blocks, you need to update Java to version 11 (see below for how to check what version is installed). If your server has internet access, proceed as follows (see below for an off-line alternative).
   - Switch to the pixi-admin user.
-  - Open a terminall window using the terminal icon on the left hand side.
+  - Open a terminal window using the terminal icon on the left hand side.
   - Copy and paste the following commands into the terminal window:
 <code>
-wget -qO - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | sudo apt-key add -
-sudo apt-get install -y software-properties-common
-sudo add-apt-repository --yes https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/
 sudo apt-get update
-sudo apt-get install  -y adoptopenjdk-11-hotspot
+sudo apt-get install -y wget apt-transport-https
+sudo wget -O - https://packages.adoptium.net/artifactory/api/gpg/key/public | sudo tee /usr/share/keyrings/adoptium.asc
+sudo echo "deb [signed-by=/usr/share/keyrings/adoptium.asc] https://packages.adoptium.net/artifactory/deb $(awk -F= '/^VERSION_CODENAME/{print$2}' /etc/os-release) main" | sudo tee /etc/apt/sources.list.d/adoptium.list
+sudo apt-get update
+sudo apt-get install -y temurin-11-jdk
 </code>
@@ Line 40: / Line 40: @@
 </code>
-When prompted, type the number corresponding to "adoptopenjdk-11-hotspot-amd64" in auto mode (likely number 0) and press return. Note that this command can be used to switch back to the older Java version if desired, without having to reinstall anything.
+When prompted, type the number corresponding to "temurin-11-jdk-amd64" in auto mode (likely number 0) and press return. If auto mode is not available, choose manual mode, then run the command again and auto mode should appear. Note that this command can be used to switch back to the older Java version if desired, without having to reinstall anything.
 Finally, verify that Java 11 is now selected:
@@ Line 48: / Line 48: @@
 </code>
-The output should indicate "openjdk version 11.0.7" (where 11 is the important number, following digits may be different).
+The output should indicate "openjdk version 11.0.15" (where 11 is the important number, following digits may be different).
-=== Offline Procedure ===
+==== Offline Procedure ====
 If your Linux-based Blocks server doesn't have Internet access, or you for some other reason can't use the online method, you can instead proceed as follows:
-  - On a computer with internet access, open a web browser and go [[https://adoptopenjdk.jfrog.io/adoptopenjdk/deb/pool/main/a/adoptopenjdk-11-hotspot/|here]].
+  - On a computer with internet access, open a web browser and go [[https://packages.adoptium.net/ui/native/deb/pool/main/t/temurin-11/|here]].
-  - Doing so shows a list of files. If you receive an error message, the offline files may have been moved, in which case a google search for "adoptopenjdk java 11 hotspot" may help track them down.
+  - Doing so shows a list of files. If you receive an error message, the offline files may have been moved, in which case a google search for "temurin java 11" may help track them down.
-  - Download the file named adoptopenjdk-11-hotspot_11.0.7+10-2_arm64.deb, or some later version if available.
+  - Download the file named temurin-11-jdk_11.0.15.0.0+10_amd64.deb, or some later version if available.
-  - Move the downloaded DEB file using a USB stick to your Blocks server.
+  - Move the downloaded deb file using a USB stick to your Blocks server.
-  - On your Blocks server, open a terminal window and type the following command (but don't press Enter).
+  - On your Blocks server, log in as the pixi-admin user.
+  - Open a terminal window and type the following command (but don't press Enter).
 <code>
@@ Line 64: / Line 65: @@
 </code>
-Make sure there's a space after the word //install//, then drag the file transferred using the USB stick into the terminal window, so its path appears at the end of the command (separated by a space). Now press Enter to execute the command, which installs the update from the file. You can now enable the newer java version using the //sudo update-alternatives// command shown above and then verify that you have the current version.
+Make sure there's a space after the word install, then drag the file transferred using the USB stick into the terminal window, so its path appears at the end of the command (separated by a space). Now press Enter to execute the command, and type the password for the pixi-admin user. This installs the update from the deb file. You can now enable the newer java version using the sudo update-alternatives command shown above and finally verify that you have the correct version.
 ===== Updating Blocks =====
@@ Line 71: / Line 72: @@
-===== Removing Unifi Wifi Support =====
-If you're not using your Blocks server as a Unifi wifi network controller, we recommend that you remove that software:
-  - Switch to the pixi-admin user.
-  - Open a terminall window using the terminal icon on the left hand side.
-  - Type (or copy/paste) the following commands into the terminal window:
-<code>
-sudo apt remove mongodb-org
-sudo apt remove unifi
-</code>