Changes between Initial Version and Version 1 of ManagerImpl


Ignore:
Timestamp:
Jul 7, 2010, 12:19:40 AM (14 years ago)
Author:
charlief
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • ManagerImpl

    v1 v1  
     1[[PageOutline]]
     2
     3= Launching the BOINC Client from the BOINC Manager =
     4
     5
     6This is a proposed specification for launching the BOINC Client.
     7
     8Contents of this document:
     9
     10[[PageOutline(1-10,,inline)]]
     11
     12== Ways to launch the BOINC Client ==
     13
     14There are several ways to launch the BOINC Client:
     15 * Automatically at system startup as a daemon / service (launched by system)
     16 * Manually by the user
     17 * Automatically by the BOINC Manager
     18
     19The BOINC Manager can launch the Client either when the Manager itself is launched, or it can relaunch the Client when it detects that the Client has stopped running.
     20
     21The default behavior of the BOINC Manager depends on the platform (OS):
     22
     23== Windows ==
     24
     25  When the manager is launched, it launches the Client only if the Client was not already running.
     26
     27  If it detects that the Client has stopped running, it automatically relaunches the Client only if:
     28   * the connected Client was on the same (local) computer,
     29   and
     30   * the Client was originally launched by the Manager.
     31
     32  The location of the Client executable and the Client's data directory are read from the Windows System Registry.  The information was written there by the BOINC installer.
     33
     34
     35== Macintosh ==
     36
     37
     38 When the manager is launched, it launches the Client only if the Client was not already running.
     39
     40  If it detects that the Client has stopped running, it automatically relaunches the Client only if:
     41   * the connected Client was on the same (local) computer,
     42
     43On the Mac, the Manager can restart the Client even if it had been running as a service, so it restarts the local Client whether or not the Client was originally launched by the Manager.
     44
     45  The Client executable is embedded in the Manager's application bundle.
     46 
     47  The Client's data directory is at the fixed path:
     48                /Library/Application Support/BOINC Data/
     49
     50 
     51== Linux ==
     52
     53
     54  Under Linux, the Client executable and data directories can be located anywhere.  The executable maybe in the data directory or anywhere else.  This limits the ability of the Manager to launch the Client.
     55
     56  When the manager is launched, it launches the Client only if the Client was not already running. 
     57
     58  By default, it assumes that the Client executable and its data are in the same directory as the Manager executable.  If the Client executable is not in the expected directory, the attempt to launch the Client fails and an alert is displayed informing the user.
     59
     60  The default directories for launching the Client can be changed by passing command-line arguments to the Manager:
     61  The directory containing the Client executable can be specified by either
     62     -e <path>
     63   or
     64     --clientdir=<path>
     65
     66  The BOINC data directory can be specified by either
     67    -d <path>
     68  or
     69    --datadir=<path>
     70
     71  If clientdir is not specified, then the Client executable is assumed to be in the same directory as the Manager executable.
     72
     73  If datadir is not specified, then the data directory is assumed to be the same as the directory containing the Client executable.
     74
     75  If it detects that the Client has stopped running, it automatically relaunches the Client only if it originally launched the Client successfully.