BOINC:客户端配置

来自中国分布式计算总站
跳转到导航 跳转到搜索

翻译自 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版本引入
指定交替平台的名称,将被包含在调度程序的请求中。(译注:参<no_alt_platform>)
<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版本引入

.

为了确定是否有物理网络连接存在,客户端偶尔会与一个高度有效的网页(google.com)进行联系。如果设置了该标志位,则该行为将被禁止。
This flag also suppresses a periodic fetch of a project list from boinc.berkeley.edu. 新功能在5.10.31版本引入
该标志位还会禁止定期从boinc.berkeley.edu获取项目列表。
<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).
设置该标志位,以便用 HTTP 1.0 来替换 1.1 (这可能被某些代理所需要)
<max_file_xfers>
Maximum number of simultaneous file transfers (default 8).
同时传输文件的最大数目(默认值为8个)。
<max_file_xfers_per_project>
Maximum number of simultaneous file transfers per project (default 2).
每个项目同时传输文件的最大数目(默认值为2个)。
<max_stderr_file_size>
Specify the maximum size of the standard error log file (stderrdae.txt); default is 2 MB. 新功能在5.10.28版本引入
指定标准错误日志文件 (stderrdae.txt) 的最大值;默认为 2 MB 。
<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!
指定标准输出日志文件 (stdoutdae.txt) 的最大值;默认为 2 MB 。
例子: <max_stdout_file_size>3145728</max_stdout_file_size> 等于 3 MB。
NB: 可能需要重启客户端才能使变更发生作用。
<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.
当作有N个CPU时来运作:同时运行N个任务。这被用于调试,比如在仅有1个CPU的时候来模拟2个CPU。不要使用它来限制BOINC所使用的CPU数目;使用BOINC的参数设置来进行调节。
<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版本引入
如果开启该参数,则客户端将仅运行其首要平台的程序。例如,一台Win64的机器将只运行Win64的程序,而不会运行Win32的程序。(译注:参<alt_platform>)
<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.
在BOINC管理器的统计页里所显示的各个项目先前所获得的积分信息所保存的天数。默认值为30。
<simple_gui_only>
If enabled, the BOINC Manager will display only the simple GUI.
如果开启该参数,BOINC管理器将只显示简单图形用户界面。
<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版本引入
如果开启该参数,将不会发送该主机的IP地址和域名到服务器。否则这些信息将被发送并保存在服务器上。该信息仅在网上对您可视(而非其他用户)。
<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版本引入
如果设置该标志位,每个完成的任务在完成结果上传之后,经过内置的60秒的延迟,即报告给项目服务器。(通常来说,这个报告过程最多可能会延迟到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版本引入
指定在客户端启动后延迟多少秒后再启动计算程序。当运行一个程序时,客户端将会做除了真正运行那个程序之外的所有事,比如,它将会建立slot目录,创建共享存储器段,等等。然后它会继续下去,就像程序已经运行起来了一下,并且之后你就可以手动的用调试器来运行slot目录下的您的程序。注意:客户端将不会注意您的程序的终止。
<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)
当验证与代理服务器相冲突时使用特定的验证方法。有效的参数有: basicdigestgss-negotiatentlm 。( 该设置对帮助进行 World Community Grid 的 SSL/HTTPS 通讯非常重要。)
<use_certs>
Accept applications signed using X509 certificates, as well as those that have BOINC signatures.
认可用X509证书来签名的程序,及有BOINC签名的程序。
<use_certs_only>
Accept only applications signed with X509 certificates. 新功能在6.3.11版本引入
仅认可用X509证书来签名的程序。
<exclusive_app>
BOINC will suspend computing whenever the executable is running (e.g., a game). Multiple applications can be specified. 新功能在6.3.13版本引入
BOINC将在该程序执行的时候暂停计算( 比如,一个游戏程序 )。可以指定多个程序。

相关链接

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