Changes between Version 39 and Version 40 of ClientMessages

Show
Ignore:
Author:
Nicolas (IP: 200.68.94.105)
Timestamp:
08/04/08 08:43:02 (1 year ago)
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • ClientMessages

    v39 v40  
    1 = Client configuration = 
    2  
    3 The BOINC client software can be '''configured''' to: 
    4  * Produce more detailed log messages. These messages appear in the [ManagerAdvanced#TheMessagestab Messages tab] of the BOINC Manager (informational messages in black, error messages in red). On Windows, they are written to a file (stdoutdae.txt). On Unix, they are written to standard output. 
    5  * Control various behavioral parameters, such as how many simultaneous file transfers to allow. 
    6  
    7 The configuration is read from a file '''cc_config.xml'''. 
    8 If this file is absent, the default configuration is used. 
    9 This file has the following format: 
    10  
    11 {{{ 
    12 <cc_config> 
    13     <log_flags> 
    14         [ flags ] 
    15     </log_flags> 
    16     <options> 
    17         [ <save_stats_days>N</save_stats_days> ] 
    18         [ <dont_check_file_sizes>0|1</dont_check_file_sizes> ] 
    19         [ <http_1_0>0|1</http_1_0> ] 
    20         [ <ncpus>N</ncpus> ] 
    21         [ <max_file_xfers>N</max_file_xfers> ] 
    22         [ <max_file_xfers_per_project>N</max_file_xfers_per_project> ] 
    23         [ <suppress_net_info>0|1</suppress_net_info> ] 
    24         [ <disallow_attach>0|1</disallow_attach> ] 
    25         [ <os_random_only>0|1</os_random_only> ] 
    26         [ <no_alt_platform>0|1</no_alt_platform> ] 
    27         [ <simple_gui_only>0|1</simple_gui_only> ] 
    28         [ <data_dir>/path/to/dir</data_dir> ] 
    29         [ <max_stdout_file_size>N</max_stdout_file_size> ] 
    30         [ <max_stderr_file_size>N</max_stderr_file_size> ] 
    31         [ <alt_platform>platform_name</alt_platform> ] 
    32         [ ... ] 
    33         [ <report_results_immediately>0|1</report_results_immediately> ] 
    34         [ <start_apps_manually>0|1</start_apps_manually> ] 
    35         [ <start_delay>X</start_delay> ] 
    36         [ <force_auth>auth-type</force_auth> ] 
    37     </options> 
    38 </cc_config> 
    39 }}} 
    40  
    41 For example, if you want to see messages about CPU scheduling, use a text editor (such as Notepad) to create the following file, and save it as `cc_config.xml` in your BOINC directory. 
    42  
    43 {{{ 
    44 <cc_config> 
    45     <log_flags> 
    46         <cpu_sched>1</cpu_sched> 
    47     </log_flags> 
    48 </cc_config> 
    49 }}} 
    50  
    51 == Logging flags == 
    52 The flags within `<log_flags>` are used to selectively turn different types of messages on and off (`<tag>0</tag>` for off, `<tag>1</tag>` for on): The following messages are enabled by default: 
    53  
    54  '''<task>''':: 
    55         The start and completion of compute jobs (should get two messages per job). 
    56  '''<file_xfer>''':: 
    57         The start and completion of file transfers. 
    58  '''<sched_ops>''':: 
    59         Connections with scheduling servers. 
    60  
    61 The following messages are disabled by default (typically they generate lots of output, and are used for specific debugging purposes): 
    62  
    63  '''<app_msg_receive>''':: 
    64         Shared-memory messages received from applications. 
    65  '''<app_msg_send>''':: 
    66         Shared-memory messages sent to applications. 
    67  '''<benchmark_debug>''':: 
    68         Debugging information about CPU benchmarks. [[T(VersionNew|5.8)]] 
    69  '''<checkpoint_debug>''':: 
    70         Show when applications checkpoint. [[T(VersionNew|5.10)]] 
    71  '''<cpu_sched>''':: 
    72         CPU scheduler actions (preemption and resumption). 
    73  '''<cpu_sched_debug>''':: 
    74         Explain CPU scheduler decisions. 
    75  '''<debt_debug>''':: 
    76         Changes to project debt. 
    77  '''<file_xfer_debug>''':: 
    78         Show completion status of file transfers. 
    79  '''<guirpc_debug>''':: 
    80         Debugging information about GUI RPC operations. 
    81  '''<http_debug>''':: 
    82         Debugging information about HTTP operations. 
    83  '''<http_xfer_debug>''':: 
    84         Debugging information about network communication. 
    85  '''<mem_usage_debug>''':: 
    86         Application memory usage. 
    87  '''<network_status_debug>''':: 
    88         Network status (whether need physical connection). 
    89  '''<poll_debug>''':: 
    90         Show what poll functions do. 
    91  '''<proxy_debug>''':: 
    92         Debugging information about HTTP proxy operations. 
    93  '''<rr_simulation>''':: 
    94         Results of the round-robin simulation used by CPU scheduler and work-fetch. 
    95  '''<sched_op_debug>''':: 
    96         Details of scheduler RPCs; also shows deferral intervals and other low info. [[T(VersionNew|5.10.24)]] 
    97  '''<scrsave_debug>''':: 
    98         Debugging information about the screen saver. 
    99  '''<state_debug>''':: 
    100         Show summary of client state after scheduler RPC and garbage collection; also show garbage collection actions, and when state file is read/written. 
    101  '''<task_debug>''':: 
    102         Low-level details of process start/end (status codes, PIDs etc.), and when applications checkpoint. 
    103  '''<time_debug>''':: 
    104         Updates to on_frac, active_frac, connected_frac. 
    105  '''<unparsed_xml>''':: 
    106         Show any unparsed XML. 
    107  '''<work_fetch_debug>''':: 
    108         Work fetch policy decisions. 
    109  
    110  
    111 == Behavioral parameters == 
    112 The following options control the behavior of BOINC: 
    113  
    114  '''<alt_platform>''':: 
    115         Specify an alternate platform name, to be included in scheduler requests. [[T(VersionNew|5.10.26)]] 
    116  '''<data_dir>''':: 
    117         Change the data directory where BOINC will keep project files. [[T(VersionNew|5.10.20)]] 
    118  '''<disallow_attach>''':: 
    119         If enabled, the client won't attach to new projects. [[T(VersionNew|5.10)]] 
    120  '''<dont_contact_ref_site>''':: 
    121         To determine if a physical network connection exists, the client occasionally contacts a highly-available web site (google.com). If this flag is set, this behavior is suppressed. [[T(VersionNew|5.10.14)]].  This flag also suppresses a periodic fetch of a project list from boinc.berkeley.edu. [[T(VersionNew|5.10.31)]] 
    122  '''<dont_check_file_sizes>''':: 
    123         Normally, the size of application and input files are compared with the project-supplied values after the files are downloaded, and just before starting an application. If this flag is set, this check is skipped. Use it if you need to modify files locally for some reason. 
    124  '''<http_1_0>''':: 
    125         Set this flag to use HTTP 1.0 instead of 1.1 (this may be needed with some proxies). 
    126  '''<max_file_xfers>''':: 
    127         Maximum number of simultaneous file transfers (default 8). 
    128  '''<max_file_xfers_per_project>''':: 
    129         Maximum number of simultaneous file transfers per project (default 2). 
    130  '''<max_stderr_file_size>''':: 
    131   Specify the maximum size of the standard error log file (stderrdae.txt); default is 2 MB. [[T(VersionNew|5.10.28)]] 
    132  '''<max_stdout_file_size>''':: 
    133   Specify the maximum size of the standard out log file (stdoutdae.txt); default is 2 MB. [[T(VersionNew|5.10.28)]] 
    134  '''<ncpus>''':: 
    135         Act as if there were N CPUs: run N tasks at once. This is for debugging, i.e. to simulate 2 CPUs on a machine that has only 1. '''Don't use it to limit the number of CPUs used by BOINC; use general preferences instead.''' 
    136  '''<no_alt_platform>''':: 
    137     If enabled, the client will run applications only for its primary platform. For example, a Win64 machine will run only Win64 apps, and not Win32. [[T(VersionNew|5.9.10)]] 
    138  '''<os_random_only>''':: 
    139         If enabled, the client will use only OS-level functions to generate a random GUI RPC password, and will exit if these functions fail. Without this flag, if OS secure random functions aren't available, the client will fall back to a random-string generator based on time of day, free disk space, and other host-specific information. [[T(VersionNew|5.10)]] 
    140  '''<save_stats_days>''':: 
    141         How many days to save the per-project credit totals that are displayed in the Statistics tab of the BOINC Manager. Default is 30. 
    142  '''<simple_gui_only>''':: 
    143     If enabled, the BOINC Manager will display only the simple GUI. 
    144 {{{ 
    145 #!comment (works by passing a flag in the [GuiRpc#function-get_cc_status get_cc_status] GUI RPC) 
    146 }}} 
    147  '''<suppress_net_info>''':: 
    148         If enabled, don't send this host's IP address and domain name to servers. Otherwise, this information is sent to, and stored on, servers. It is visible to you (but not other users) via the web. [[T(VersionNew|5.10)]] 
    149  '''<report_results_immediately>''':: 
    150        If set, each job will be reported to the project server as soon as it's finished (normally it's deferred for up to a day, so that several jobs can be reported in one request).  ''Using this option increases the load on project servers, and should generally be avoided''.  It's intended to be used on computer whose disks are reformatted every day. [[T(VersionNew|6.1)]] 
    151  '''<start_apps_manually>''':: 
    152     This is for debugging apps. When running an app, the client will do everything except actually run the app, i.e. it will set up the slot dir, create the shared mem segment, etc. It will then continue as if the app were actually running, and you can then manually run your app under a debugger in the slot directory. Note: the client won't notice the termination of your app. [[T(VersionNew|6.1.7)]] 
    153  '''<start_delay>''':: 
    154     Specify a number of seconds to delay running applications after client startup. [[T(VersionNew|6.1.6)]] 
    155  '''<force_auth>''':: 
    156     When authenticating against a proxy server use a specific authentication method. 
    157     Valid parameters are: {{{basic}}}, {{{digest}}}, {{{gss-negotiate}}}, {{{ntlm}}} [[T(VersionNew|5.10.41)]] 
    158     (Setting of particular importance for World Community Grid to facilitate SSL/HTTPS communications) 
     1[[T(MovedToMediaWiki|Client_configuration)]] 
If this page is incomplete or incorrect, please edit it or add it to the wiki to-do list. To do this, you must be logged in; click Login or Register above.