Changes between Version 5 and Version 6 of Documentation/Howto/SetupHiveSlave
- Timestamp:
- 10/20/15 13:47:13 (9 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Documentation/Howto/SetupHiveSlave
v5 v6 2 2 3 3 HeuristicLab Hive is a distributed computing software that follows the master - slave model: The master (or server) holds the jobs that should be calculated and is responsible for scheduling these. The slaves (or clients) are computers that poll the server for these jobs: they fetch them, run them and send the results back. 4 The HeuristicLab Hive Slave is a modular application that is compr omised of the core application logic and some views for visualization. These parts can be run in different ways and combinations:4 The HeuristicLab Hive Slave is a modular application that is comprised of the core application logic and UIs. These parts can be run in different ways and combinations: 5 5 * Console client with text output 6 6 * HeuristicLab app with visualization 7 7 * Windows service with optional tray icon 8 8 9 The following gives an overview:10 9 11 10 == Console client == … … 19 18 If you compile the `HeuristicLab.Clients.Hive.Slave.App-3.3` project, you get a new icon ''Hive Slave'' in the HL starter: 20 19 \\ [[Image(starter.png)]] \\ 21 When starting this application, the hive slave is starte ttogether with an UI that shows some statistics and a log window. This again does not need any special privileges to run.20 When starting this application, the hive slave is started together with an UI that shows some statistics and a log window. This again does not need any special privileges to run. 22 21 23 22 … … 29 28 === HeuristicLab.Clients.Hive.Slave.WindowsService === 30 29 This needs to be compiled to get the binaries for the Hive Slave Windows service. After doing that, an installer can be generated that installs the slave and registers it as a windows service on the client computer. The installer is created with the NSIS (Nullsoft Scriptable Install System). Download and install NSIS from http://nsis.sourceforge.net/. The installer scripts are located in the `Installers` directory in the source tree. Right-click on the file `HiveSlaveInstaller.nsi` and select ''Compile NSIS Script''. If everything works, you get, in the same directory, a file called ''HeuristicLab Hive Slave Installer.exe''. You can now copy and install this file on your clients. Please note that you have to compile the HeuristicLab Slave Windows Services solution before as the installer just takes the binaries and creates the installer out of them. You can open *.nsi files with a text editor to see what's actually happening. You can also find there at the beginning of the file that BUILDCONFIGURATION is set to Debug. If you want to package Release binaries change this in the nsi file and rebuild the solution using Release mode. 31 When installed, the service runs in the background and connects to the Hive server, from which it fetches jobs and calculates them. If you don't want the slave to always calculate jobs, you can install the Slave Tray Icon where you can control the behavior of the service. Or you can use the Hive Administrator to define times when slaves or groups of slaves are not allowed to calculate jobs.30 When installed, the service runs in the background and connects to the Hive server, from which it fetches jobs and calculates them. If you don't want the slave to always calculate jobs, you can install the Slave tray icon where you can control the behavior of the service. Or you can use the Hive Administrator to define times when slaves or groups of slaves are not allowed to calculate jobs. 32 31 Please note that you need local administration privileges on your computer to execute the installer. 33 32 \\ [[Image(installer.png)]] \\ … … 39 38 40 39 === HeuristicLab.Clients.Hive.Slave.TrayIcon === 41 This is an application which sits in the Windows taskbar and shows you information about your locally installed slave. Besides the information it shows, you can use the Tray Icon to pause or stop the Slave service.40 This is an application which sits in the Windows taskbar and shows you information about your locally installed slave. Besides the information it shows, you can use the tray icon to pause or stop the Slave service. 42 41 [[BR]] 43 42 44 43 \\ [[Image(trayicon.png)]] \\ 45 44 46 The Slave Tray Icon application shows on the first page an overview of the slave.45 The Slave tray icon application shows on the first page an overview of the slave. 47 46 The Kill button lets you stop the Windows service. If you are not logged in as administrator, UAC asks you to confirm this operation and the tray icon restarts with administration privileges. You may notice that the icon on the kill button changed and if you click it now, the service is stopped. 48 47 The Stop button can be used to pause the Slave. This means that the slave is still connected to the Hive, but the server doesn't send new jobs to the slave.