BOINC:客户端配置

来自中国分布式计算总站
Julian Yuen讨论 | 贡献2008年10月1日 (三) 22:31的版本
跳转到导航 跳转到搜索

翻译自 BOINC Client configuration

BOINC配置综述

The BOINC client software can be configured to:
BOINC客户端软件可以被配置为:

  • Produce more detailed log messages. These messages appear in the 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.
生成更加详细的日志信息。这些信息将显示在BOINC管理器的消息页(黑色为报告信息,红色为错误信息)。在Windows操作系统下,它们将被写入文件(stdoutdae.txt)中。在Unix操作系统下,它们将被写至标准输出。
  • Control various behavioral parameters, such as how many simultaneous file transfers to allow.
控制各种不同的行为参数,比如可以设置同时传输的文件的个数。

The configuration is read from a file cc_config.xml. If this file is absent, the default configuration is used. This file has the following format:

配置信息将从 cc_config.xml 文件中读取。 如果该文件不存在,则将使用默认的配置信息。 该文件采用如下格式:

<cc_config>
    <log_flags>
        [ flags ]
    </log_flags>
    <options>
        [ <save_stats_days>N</save_stats_days> ]
        [ <dont_check_file_sizes>0|1</dont_check_file_sizes> ]
        [ <http_1_0>0|1</http_1_0> ]
        [ <ncpus>N</ncpus> ]
        [ <max_file_xfers>N</max_file_xfers> ]
        [ <max_file_xfers_per_project>N</max_file_xfers_per_project> ]
        [ <suppress_net_info>0|1</suppress_net_info> ]
        [ <disallow_attach>0|1</disallow_attach> ]
        [ <os_random_only>0|1</os_random_only> ]
        [ <no_alt_platform>0|1</no_alt_platform> ]
        [ <simple_gui_only>0|1</simple_gui_only> ]
        [ <max_stdout_file_size>N</max_stdout_file_size> ]
        [ <max_stderr_file_size>N</max_stderr_file_size> ]
        [ <alt_platform>platform_name</alt_platform> ]
        [ ... ]
        [ <report_results_immediately>0|1</report_results_immediately> ]
        [ <run_apps_manually>0|1</run_apps_manually> ]
        [ <use_certs>0|1</use_certs> ]
        [ <use_certs_only>0|1</use_certs_only> ]
        [ <exclusive_app>important.exe</exclusive_app> ]
    </options>
</cc_config>

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.

举例来说,如果你希望看到有关CPU调度的信息,可以用文本编辑器(例如Notepad)创建具有以下内容的文件, 并以 cc_config.xml 为文件名保存在您的BOINC目录下。

<cc_config>
    <log_flags>
        <cpu_sched>1</cpu_sched>
    </log_flags>
</cc_config>

日志标记 ( Logging flags )

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:
<log_flags> 内部的标记被用于选择开启或关闭不同类型的消息(<tag>0</tag> 为关闭,<tag>1</tag> 为开启):下列消息是默认开启的:

<task>
The start and completion of compute jobs (should get two messages per job).
计算任务的开始与完成(每个任务应该有两个信息)。
<file_xfer>
The start and completion of file transfers.
文件传输的开始与完成。
<sched_ops>
Connections with scheduling servers.
与调度服务器进行的连接。

The following messages are disabled by default (typically they generate lots of output, and are used for specific debugging purposes):

下列消息默认是关闭的(通常由于它们产生大量的输出信息,而且常被用于特定的调试目的):

<app_msg_receive>
Shared-memory messages received from applications.
收取自程序的共享存储器的消息
<app_msg_send>
Shared-memory messages sent to applications.
发送至程序的共享存储器的消息
<benchmark_debug>
Debugging information about CPU benchmarks. 新功能在5.8版本引入
关于CPU基准测试的调试信息
<checkpoint_debug>
Show when applications checkpoint. 新功能在5.10版本引入
在程序进行存盘时进行显示
<cpu_sched>
CPU scheduler actions (preemption and resumption).
CPU调度行为(优先抢占与再度继续)
<cpu_sched_debug>
Explain CPU scheduler decisions.
解释CPU调度决定
<debt_debug>
Changes to project debt.
对项目债务的改变
(2007-09-10更新)debt的详细解释,请看以下帖子:12
<file_xfer_debug>
Show completion status of file transfers.
显示文件传输的完成状态
<guirpc_debug>
Debugging information about GUI RPC operations.
关于GUI远程操作的调试信息
<http_debug>
Debugging information about HTTP operations.
关于HTTP操作的调试信息
<http_xfer_debug>
Debugging information about network communication.
关于网络通讯的调试信息
<mem_usage_debug>
Application memory usage.
程序的存储器占用
<network_status_debug>
Network status (whether need physical connection).
网络状态(不论是否需要物理连接)
<poll_debug>
Show what poll functions do.
显示投票功能都做了些什么
<proxy_debug>
Debugging information about HTTP proxy operations.
关于HTTP代理操作的调试信息
<rr_simulation>
Results of the round-robin simulation used by CPU scheduler and work-fetch.
被用于CPU调度程序与任务获取的轮叫调度模拟过程的结果
<sched_op_debug>
Details of scheduler RPCs; also shows deferral intervals and other low info. 新功能在5.10.24版本引入
调度程序的远程调用的细节;同时也显示延迟的时间间隔及其他底层信息
<scrsave_debug>
Debugging information about the screen saver.
关于屏幕保护程序的调试信息
<state_debug>
Show summary of client state after scheduler RPC and garbage collection; also show garbage collection actions, and when state file is read/written.
在完成调度程序的远程调用和垃圾回收之后显示客户端状态摘要;同时也显示垃圾回收行为,及何时对状态文件进行读/写
<task_debug>
Low-level details of process start/end (status codes, PIDs etc.), and when applications checkpoint.
进程开始/结束的底层细节(状态代码,进程标识符 等等),以及在程序存盘时进行显示
<time_debug>
Updates to on_frac, active_frac, connected_frac.
更新on_frac,active_frac,connected_frac。
<unparsed_xml>
Show any unparsed XML.
显示任何未被解析的XML
<work_fetch_debug>
Work fetch policy decisions.
任务获取的决定策略

行为参数 ( Behavioral parameters )

The following options control the behavior of BOINC:
以下选项控制BOINC的行为:

<alt_platform>
Specify an alternate platform name, to be included in scheduler requests. 新功能在5.10.26版本引入
<disallow_attach>
If enabled, the client won't attach to new projects. 新功能在5.10版本引入
<dont_contact_ref_site>
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. 新功能在5.10.14版本引入

. This flag also suppresses a periodic fetch of a project list from boinc.berkeley.edu. 新功能在5.10.31版本引入

<dont_check_file_sizes>
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.
<http_1_0>
Set this flag to use HTTP 1.0 instead of 1.1 (this may be needed with some proxies).
<max_file_xfers>
Maximum number of simultaneous file transfers (default 8).
<max_file_xfers_per_project>
Maximum number of simultaneous file transfers per project (default 2).
<max_stderr_file_size>
Specify the maximum size of the standard error log file (stderrdae.txt); default is 2 MB. 新功能在5.10.28版本引入
<max_stdout_file_size>
Specify the maximum size of the standard out log file (stdoutdae.txt); default is 2 MB. 新功能在5.10.28版本引入
Sample: <max_stdout_file_size>3145728</max_stdout_file_size> equals 3 MB.
NB: A Client restart may be needed to have changes take effect!
<ncpus>
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.
<no_alt_platform>
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. 新功能在5.9.10版本引入
<os_random_only>
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. 新功能在5.10版本引入
<save_stats_days>
How many days to save the per-project credit totals that are displayed in the Statistics tab of the BOINC Manager. Default is 30.
<simple_gui_only>
If enabled, the BOINC Manager will display only the simple GUI.
<suppress_net_info>
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. 新功能在5.10版本引入
<report_results_immediately>
If set, each job will be reported to the project server as soon as it's finished, with an inbuild 60 second delay from completion of result upload. (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. 新功能在6.1版本引入
<run_apps_manually>
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. 新功能在6.1.7版本引入
<start_delay>
Specify a number of seconds to delay running applications after client startup. 新功能在6.1.6版本引入
<force_auth>
When authenticating against a proxy server use a specific authentication method. Valid parameters are: basic, digest, gss-negotiate, ntlm 新功能在5.10.41版本引入
(Setting of particular importance for World Community Grid to facilitate SSL/HTTPS communications)
<use_certs>
Accept applications signed using X509 certificates, as well as those that have BOINC signatures.
<use_certs_only>
Accept only applications signed with X509 certificates. 新功能在6.3.11版本引入
<exclusive_app>
BOINC will suspend computing whenever the executable is running (e.g., a game). Multiple applications can be specified. 新功能在6.3.13版本引入


相关链接

  1. 本文原始地址 BOINC Client configuration
  2. 本站论坛的 BOINC自动查看存盘点的方法 + BOINC客户端参数设置信息 (注:此文较本页更早,故更新内容请以本页面及英文原始页面为准)