Operational Modii
There are five different ways to run the nZEDb engine.
- Screen Sequential
- Screen Threaded
- tmux Sequential Disabled
- tmux Basic Sequential
- tmux Complete Sequential
This mode is well suited to smaller systems (e.g. ARM based) or installations that will index up to five groups.
cd misc/update/nix/screen/sequential/ && screen sh simple.sh
There is also a more advanced screen sequential script provided by wally73, simple-expanded.sh
cd misc/update/nix/screen/sequential/ && screen sh simple-expanded.sh
cd misc/update/nix/screen/threaded/ && screen sh start.sh
This will spawn 3 screen sessions. The first one runs update_binaries to retrieve headers from your Usenet provider. The second session (named RELEASES) will run update_releases. The third session (named POST) runs post processing.
Useful commands:
screen -list # List active sessions
screen -r RELEASES # Attach to the update_releases session
screen -r POST # Attach to the post-processing session
CTRL-a d # Detach from session
This mode is similar to above, however it sequentially invokes each script with multi-processing enabled. The number of threads used for each function is set in Site-Edit (at the bottom).
nZEDb supplies a tmux.conf definition that is compatible with screen, namely use of CNTL-a instead on CNTL-b. Should you want another setup, this file will need to be changed.
NOTE: nZEDb currently does not function at all with tmux versions v2.1 and v2.2. Versions v1.8 -> v2.0 are compatible with all nZEDb tmux modes. Versions 2.3 and higher currently only function in "Complete Sequential" mode.
The desired tmux mode is set via the web interface Site-Edit -> Tmux-Settings. Beginners should stay with the installation defaults. Start the selected nZEDb tmux mode with:
cd /var/www/nZEDb/misc/update/nix/tmux/ && php start.php
tmux Sequential Disabled
This is the fully parallel way to run nZEDb. Well suited for larger installations running on multi-core, large RAM servers.
tmux Basic Sequential
Basic Sequential runs update_binaries, backfill and update_releases sequentially.
tmux Complete Sequential
To use this mode, you first need to copy this file to user_threaded.sh
cp /var/www/nZEDb/misc/update/nix/screen/sequential/threaded.sh /var/www/nZEDb/misc/update/nix/screen/sequential/user_threaded.sh
cd /var/www/nZEDb/misc/update/nix/tmux/ && php start.php
The script threaded.sh works "as-is". This mode allows complete customisation of how/when individual nZEDb functions are called and is suitable for advanced users. user_threaded.sh will not be overwritten during nZEDb software updates.
Useful commands:
CTRL-a d # Detach from tmux session
CTRL-a 0 # Switch to window number 0 (Monitor)
tmux attach -t nZEDb # Re-attach to running nZEDb tmux session