Changes between Initial Version and Version 1 of Documentation/Howto/SetupHiveSlave


Ignore:
Timestamp:
06/27/11 15:39:05 (11 years ago)
Author:
ascheibe
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Documentation/Howto/SetupHiveSlave

    v1 v1  
     1= Hive Slave setup =
     2
     3There exist two installers for the Hive Slave:
     4
     5- `HeuristicLab.Clients.Hive.Slave.SlaveWindowsServiceSetup`: This setup installs and starts the Hive Slave Windows service. 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.
     6- `HeuristicLab.Clients.Hive.Slave.TrayIconSetup`: Installs 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. There is a shortcut created in the Start Menu as well as in the Autostart folder so the Tray Icon gets started automatically when a user logs in on the machine.
     7
     8Please note that you need local administration privileges on your computer to execute the installers.
     9
     10\\ [[Image(installer.png)]] \\
     11
     12The installers ask you for the installation path and if you want to install the application for all users. The defaults should be ok.
     13The Slave Windows Service is now visible in the Windows Service Viewer and can be started and stopped from there:
     14\\ [[Image(service.png)]] \\
     15The Slave Windows Service Setup also creates an Event Source. You can view entries with the Windows Event Viewer.
     16If something goes wrong while executing jobs, the slave tries to get the exceptions to the server so that the user can view them in the Experiment Manager. In cases where the slave doesn't know how to react to an exception and has to shut down, these exceptions are logged as Windows Event entries. [[BR]]
     17
     18
     19\\ [[Image(trayicon.png)]] \\
     20
     21The Slave Tray Icon application shows on the first page some overview of the slave.
     22The "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.
     23The "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.
     24Start resumes operation. If the service is stopped, it tries to start the service. If the slave is paused, it tells the service to accept new jobs.
     25
     26[[BR]]
     27For testing purposes or if you don't have local administration privileges you can use the `HeuristicLab.Clients.Hive.Slave.ConsoleClient-3.4`.
     28The Slave console client is a simple console application which you can execute without the need to install it.
     29It starts the slave and shows information as output on the console:
     30\\ [[Image(consoleclient.png)]] \\
     31