Differences

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

--- installingmixonrpi [2026/10/27 16:15] – tputman
+++ installingmixonrpi [2026/10/27 17:06] (current) – tputman
@@ Line 9: / Line 9: @@
 </code>
-MIX requires **Java 25 or newer**.
+MIX requires **Java 25**.
 The validated Raspberry Pi installation used:
@@ Line 19: / Line 19: @@
 The normal MIX web port is **7226** unless ''%%mix.port%%'' in ''%%mix.properties%%'' has been changed.
-The normal MIX addresses are:
+The MIX setup page is:
 <code text>
-http://<Pi-address>:7226/index.html
 http://<Pi-address>:7226/setup.html
 </code>
-The first opens the deployed application. The second opens the MIX setup page.
+After an MIStudio project is deployed, the validated application URL is:
+<code text>
+http://<Pi-address>:7226/index.html
+</code>
 ===== 1. Copy the MIX runtime to the Raspberry Pi =====
@@ Line 92: / Line 95: @@
 If the copied MIX installation contains an ''%%ErgoIOTLicense_*.lic%%'' file from another computer, remove or move that file before starting MIX.
-Each Raspberry Pi must use the license generated for that Pi.
+Each Raspberry Pi must use the runtime license associated with that Pi.
 ===== 2. Verify Java 25 =====
@@ Line 146: / Line 149: @@
 and its MIX build number.
-If a Raspberry Pi license has not yet been installed, MIX will display the system's pre-license key.
+If a Raspberry Pi runtime license has not yet been installed, MIX will display the system's pre-license key:
-For example:
 <code text>
@@ Line 156: / Line 157: @@
 Keep this key for the license request.
-===== 4. Install the Raspberry Pi license =====
+===== 4. Install the Raspberry Pi runtime license =====
 Each Raspberry Pi requires an ErgoTech runtime license associated with that system.
-The pre-license key can be obtained from the MIX startup output or from the MIX setup page:
+The pre-license key is shown during MIX startup. It can also be viewed from the MIX setup page:
 <code text>
@@ Line 166: / Line 167: @@
 </code>
-On the setup page, select **Get Pre-License Key**.
+Select **Get Pre-License Key** and send the displayed key to ErgoTech.
-Send the displayed pre-license key to ErgoTech.
 Copy the license provided for the Raspberry Pi into:
@@ Line 181: / Line 180: @@
 ErgoIOTLicense_<pre-license-key>.lic
 </code>
+If TransSECS has already been licensed on the same Raspberry Pi using the same pre-license key, the Pi-specific ErgoIOT runtime license can also be copied into the MIX runtime directory.
 Start MIX again:
@@ Line 187: / Line 188: @@
 cd /home/mix/mixruntime
-MIX_JAVA_HOME=/opt/java/zulu25.34.17-ca-fx-jdk25.0.3-linux_aarch64
+MIX_JAVA_HOME=/opt/java/zulu25.34.17-ca-fx-jdk25.0.3-linux_aarch64 \
 ./scripts/MIX.sh
 </code>
@@ Line 196: / Line 197: @@
 Valid IOT System Runtime License detected.
 </code>
-Opening **Get Pre-License Key** also provides a way to update the Raspberry Pi's date and time.
-The setup page also contains **Network Configuration** for systems which use MIX to manage Raspberry Pi network settings.
 ===== 5. Verify the MIX web server =====
@@ Line 222: / Line 219: @@
 Verify that the MIX setup page loads.
-After an MIStudio application has been deployed, the application can be opened at:
-<code text>
-http://<Pi-address>:7226/index.html
-</code>
 ===== 6. Deploy an MIStudio project to the Raspberry Pi =====
@@ Line 246: / Line 237: @@
 Enter the configured MIX password.
-Save the MIStudio project.
+Save the MIStudio project and select **Deploy**.
-Select **Deploy**.
+During a successful deployment, MIX should:
-During deployment, MIX should:
   * authenticate the MIStudio deployment request,
   * stop the currently loaded application logic,
   * replace the deployed application files,
-  * load the new application files and ''%%VIBLogic.jar%%'',
+  * receive the new ''%%VIBLogic.jar%%'' and application files,
-  * reload the application,
+  * reload the application logic,
   * continue running without requiring the MIX process to be stopped manually.
@@ Line 265: / Line 254: @@
 </code>
-Verify that the deployed application loads.
+Verify that the newly deployed application loads.
-The MIX console should show the deployment being received and the application logic being reloaded.
+The MIX console should show the deployment files being received and the application logic being reloaded.
-For production systems, change the default ''%%ergouser%%'' password.
-The MIX user administration page is:
-<code text>
-http://<Pi-address>:7226/servlet/UserManager
-</code>
 ===== 7. Stop the manual MIX process =====
-Before configuring the automatic service, stop the manually started MIX process.
+Before configuring automatic startup, stop the manually started MIX process.
-If MIX is still running in the foreground, press:
+If MIX is running in the foreground, press:
 <code text>
@@ Line 303: / Line 284: @@
 </code>
-Create the systemd service:
+Create:
 <code text>
@@ Line 333: / Line 314: @@
 Save with **Ctrl+O**, **Enter**, **Ctrl+X**.
-Reload systemd and enable MIX:
+Reload systemd, enable MIX at boot, and start it:
 <code text>
@@ Line 359: / Line 340: @@
 </code>
-The process should use the Java 25 installation under:
+The process should use:
 <code text>
-/opt/java/zulu25.34.17-ca-fx-jdk25.0.3-linux_aarch64
+/opt/java/zulu25.34.17-ca-fx-jdk25.0.3-linux_aarch64/bin/java
 </code>
-Verify port 7226:
+Verify that MIX is listening on port 7226:
 <code text>
@@ Line 385: / Line 366: @@
 </code>
-The log should contain Java and MIX startup messages.
+Check the MIX build, pre-license key, and license result:
-Check the MIX build and license:
 <code text>
@@ Line 394: / Line 373: @@
 </code>
-A successful startup should contain lines similar to:
+A successfully licensed startup should contain lines similar to:
 <code text>
@@ Line 402: / Line 381: @@
 </code>
-When systemd creates ''%%runmix-console.log%%'', the file may be owned by:
+Verify the console log file:
 <code text>
-root root
+ls -l /home/mix/mixruntime/logs/runmix-console.log
 </code>
-Verify if needed:
+With the validated systemd configuration, the active console log was created as:
 <code text>
-ls -l /home/mix/mixruntime/logs/runmix-console.log
+root root
 </code>
@@ Line 439: / Line 418: @@
 Save with **Ctrl+O**, **Enter**, **Ctrl+X**.
-Check the configuration:
+Check the rule:
 <code text>
@@ Line 451: / Line 430: @@
   * ''%%5 rotations%%''
-If the current log is smaller than 5 MB, ''%%logrotate%%'' will report that it does not need rotating.
+If the current file is smaller than 5 MB, ''%%logrotate%%'' will report that it does not need rotating. This is normal.
-To test the rule, force one rotation:
+To verify the rule completely, force one rotation:
 <code text>
@@ Line 459: / Line 438: @@
 </code>
-Verify the files:
+Check the result:
 <code text>
 ls -lh /home/mix/mixruntime/logs/runmix-console.log*
+systemctl status mix --no-pager
+pgrep -af 'com.ergotech.mix.server.HeadlessController'
 </code>
-The previous contents should be copied to:
+The previous console contents should be copied to:
 <code text>
@@ Line 471: / Line 452: @@
 </code>
-The active ''%%runmix-console.log%%'' should be truncated.
+The active ''%%runmix-console.log%%'' should be truncated while the same MIX process remains running.
-Verify that MIX is still running:
-<code text>
-systemctl status mix --no-pager
-pgrep -af 'com.ergotech.mix.server.HeadlessController'
-</code>
 Generate a new request:
@@ Line 499: / Line 473: @@
 Default Servlet : GET Request: /setup.html
 </code>
-''%%MIX.log%%'' is controlled separately by the MIX Log4j configuration.
 ===== 11. Reboot and verify MIX =====
@@ Line 534: / Line 506: @@
 </code>
-Verify the MIX build and license from the new boot:
+Verify that the current boot started MIX and accepted the runtime license:
 <code text>
@@ Line 541: / Line 513: @@
 </code>
-Verify general system status:
+Verify:
-<code text>
+  * MIX is ''%%active (running)%%''.
-df -h /
+  * MIX is running with Java 25.
-ls -lh /var/log/syslog*
+  * Port 7226 is listening.
-ls -lh /var/log/daemon.log*
+  * The current MIX build started successfully.
-cat /var/log/ergotech-boot-maintenance.log
+  * The Raspberry Pi runtime license is accepted.
-</code>
+  * ''%%runmix-console.log%%'' contains startup messages from the current boot.
 Finally, open:
@@ Line 556: / Line 528: @@
 </code>
-Verify:
+and verify that the deployed application is available after the reboot.
-  * MIX is ''%%active (running)%%'' after reboot.
-  * MIX is running with Java 25.
-  * Port 7226 is listening.
-  * The Raspberry Pi runtime license is accepted.
-  * ''%%runmix-console.log%%'' contains startup messages from the current boot.
-  * The deployed MIStudio application loads in the browser.
-  * The SD card has sufficient free space.
-  * Linux system logs remain bounded.
-  * The boot-maintenance log shows a successful run after reboot.
-At this point MIX is installed, licensed, running automatically, accepting MIStudio deployments, serving the deployed application, and rotating its console log correctly.
-If this SD card will become a master image, verify the complete system once more before imaging it.
+At this point MIX is installed, licensed, configured for automatic startup, accepting MIStudio deployments, serving the deployed application, and rotating its console log correctly.