Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
blocks:server:mirror [2025-01-02 10:54]
admin clarified link local conflicts
blocks:server:mirror [2025-06-14 18:42] (current)
admin Added note on BLOCKS_HOME
Line 268: Line 268:
   * Server Disk Space. Indicates the amount of free space on the Blocks Server itself. This also makes sens to keep an eye on – especially before adding a significant amount of new content.   * Server Disk Space. Indicates the amount of free space on the Blocks Server itself. This also makes sens to keep an eye on – especially before adding a significant amount of new content.
   * Server Time. Shows the current time of the clock in the Blocks Server. If your server has Internet access, this is generally adjusted automatically. If not, you may want to check this every few monts to make sure that it is reasonably accurate.   * Server Time. Shows the current time of the clock in the Blocks Server. If your server has Internet access, this is generally adjusted automatically. If not, you may want to check this every few monts to make sure that it is reasonably accurate.
 +  * Sync Errors. Cumulative count of data sync errors that have occurred, if any. Check the Mirror log file for details.
  
-The SYNCHRONIZE NOW button can be used to force a full synchronization. Use this after making manual changes to the files in the /home/pixi-server directory of the Blocks server, such as updating Blocks itself or the mirroring service (the files PIXILAN.jar and MIRROR.jar respectvely). Doing so pushes those changes over to the Mirror Server immediately rather than waiting for the next scheduled full synchronization.+The "Synchtronize Now" button can be used to force a full synchronization. Use this after making manual changes to the files in the /home/pixi-server directory of the Blocks server, such as updating Blocks itself or the mirroring service (the files PIXILAN.jar and MIRROR.jar respectvely). Doing so pushes those changes over to the Mirror Server immediately rather than waiting for the next scheduled full synchronization.
  
 ===== Testing the Mirror Server ===== ===== Testing the Mirror Server =====
Line 331: Line 332:
  
 <code> <code>
-  nic: enp2s0+  interface: enp2s0
   subnet: 192.168.0.0/24   subnet: 192.168.0.0/24
 </code> </code>
Line 337: Line 338:
 :!: **NOTE**: There are two spaces at the beginning of each line, as required when used under the "mirror:" heading. :!: **NOTE**: There are two spaces at the beginning of each line, as required when used under the "mirror:" heading.
  
-  * The //nic// setting is useful if your computer have more than one network interface with link local addressing. If so, use this setting to specify the name of the desired synchronization backdoor network interface.+  * The //interface// setting is useful if your computer have more than one network interface with link local addressing. If so, use this setting to specify the name of the desired synchronization backdoor network interface.
   * The //subnet// setting lets you specify a non link local subnet (in CIDR notation) for use as the data synchronization backdoor. This is useful in cases where you may want to use this interface for other purposes, such as remote management of the servers. You would then either set fixed addresses (within the specified subnet) or use dynamically assigned addresses (DHCP).   * The //subnet// setting lets you specify a non link local subnet (in CIDR notation) for use as the data synchronization backdoor. This is useful in cases where you may want to use this interface for other purposes, such as remote management of the servers. You would then either set fixed addresses (within the specified subnet) or use dynamically assigned addresses (DHCP).
  
Line 348: Line 349:
   * Disable any such interface(s). in some cases this may need to be done in the computer's BIOS settings.   * Disable any such interface(s). in some cases this may need to be done in the computer's BIOS settings.
   * Change their addresses to keep them out of this address range.   * Change their addresses to keep them out of this address range.
-  * Use the advanced //nic// setting to specify which interface to use. +  * Use the advanced //interface// setting to specify which interface to use. 
    
 === Verifying over SSH === === Verifying over SSH ===
Line 357: Line 358:
 </code> </code>
  
 +=== Custom path to Blocks' Executable Files ===
 +The Mirror service assumes that the main Blocks executable file (named "PIXILAN.jar") is located in /home/pixi-server/, which is the case if you're using our Linux server image. However, if you're configuring a server on your own and chose to locate Blocks executable files elsewhere, you must specify the directory where PIXILAN.jar resides using the BLOCKS_HOME envirtonment variable. This is an advanced configuration option, and is normally not required.
  
 =====Implementation Notes===== =====Implementation Notes=====