[BOINC 开发文档]Creating a BOINC project 部分

碧城仙

Creating a BOINC project 部分

待翻译的页面列表见：http://boinc.berkeley.edu/create_project.php
http://boinc.equn.com/dev/create_project.html

Creating a BOINC project

　　·What is a project?
　　　　The BOINC database
　　　　Directory structure
　　　　The project configuration file
　　·Compile BOINC software
　　·How to create a project
　　　　The make_project script
　　　　Adding applications/platforms
　　　　Adding application versions
　　　　Project creation cookbook
　　　　Another cookbook, from Jacques Fontignie
　　　　Another cookbook, from Don Bashford
　　·Project control
　　·Project security
　　　　Code signing
　　·Upgrading a project's server software

[ Last edited by 碧城仙 on 2006-4-17 at 22:10 ]

烦人

这个部分的官方版本有改动了,碧仙有时间的话要改一下总站上面的相关页面了,或者等我们翻译好了再更新也可以.
这几天比较空,我开始在翻译前面几页了.为避免重复工作,还是老规矩,我先申请翻译以下几页:
●Setting up a BOINC server
●What is a project?
  ○The BOINC database
  ○Directory structure
  ○The project configuration file
     ■Project options
     ■Daemons
     ■Periodic tasks


水平有限,求校对.

[ 本帖最后由 烦人 于 2007-2-23 20:42 编辑 ]

烦人

此部分还有以下页面待译:

● How to create a project
  ○The make_project script
  ○Adding applications/platforms
  ○Adding application versions
  ○Project creation cookbook
  ○Project control
  ○Project security
     ■Code signing
  ○Upgrading a project's server software
  ○Increasing server capacity
  ○Beta-test applications

烦人

原文: http://boinc.berkeley.edu/server.php
[English Version]Last modified 8:11 PM UTC, November 08 2006.
Translated By 烦人//2007-02-23

Setting up a BOINC server
配置BOINC服务器

You can potentially use any Unix system as a BOINC server. Our recommendations are:

• Hardware: use a host with good CPU capacity (dual Xeon or Opteron), at least 2 GB of RAM, and at least 40 GB of free disk space. Do whatever you can to make it highly reliable (UPS power supply, RAID disk configuration, hot-swappable spares, tempurature-controlled machine room, etc.). If you anticipate a high-traffic project, use a machine whose RAM capacity is 8 GB or more, and that uses 64-bit processors.

If your server capacity is exceeded, you can increase capacity using multiple server hosts. However, we recommend that you not do this initially. In most cases one host is enough.

• Software: use a recent Linux release.

你可以使用任意的UNIX系统作为BOINC服务器操作系统.我们的建议是:

• 硬件:使用拥有高性能CPU(双志强或皓龙),至少2GB内存以及至少40GB剩余磁盘空间的主机.尽你所能提高可靠性(UPS供电,配置RAID磁盘阵列,热备份,温控机房等).如果你期望的是一个高速的项目,就该使用8GB以上内存容量的机器,并使用64位处理器.

如果你的服务器超负荷了,可以通过使用多服务器来提高性能,但我们建议你不要在开始时就这么做.大多数情况下,一台主机已经足够了.

• 软件:使用新版的Linux.

Groups and permissions
组以及权限

We recommend that you create a separate user and group for the BOINC server, and add the web-server user to this group. Details are here.
我们建议为BOINC创建独立的用户和组,并且将Web服务用户添加到这个组.详细说明.


Installing BOINC software
安装BOINC软件

• Download and install whatever software prerequisites are needed on your system.
• 下载并安装任何适合你操作系统的必备软件.
• Download the BOINC software.
• 下载BOINC软件.
• Configure and build the BOINC software.
• 配置并编译BOINC软件.

Operating system configuration
操作系统配置

Some parts of the BOINC server (the feeder and scheduling server) use shared memory. Hosts where these run must have shared memory enabled, with a maximum segment size of at least 32 MB. How to do this depends on the operating system; some information is here.
BOINC服务器的某些部分(信息员和调度服务器)使用共享内存.运行这些服务的主机必须允许使用共享内存,至少32MB的最大段容量.设置方法依赖于操作系统.参考信息

MySQL notes
MySQL注意事项

• After installing and running the server, grant permissions for your own account and for the account under which Apache runs ('nobody' in the following; may be different on your machine). All mysql accounts should be password protected including root.
• 安装并运行服务器后,需要对你自己的帐号以及运行Apache的帐号(下面以'nobody'表示,在你的机子上可能不同)进行授权.所有的mysql帐号包括root都应该使用密码来进行保护.

    mysql -u root
    grant all on *.* to [email=yourname@localhost]yourname@localhost[/email] identified by 'password';
    grant all on *.* to yourname identified by 'password';
    grant all on *.* to [email=nobody@localhost]nobody@localhost[/email] identified by 'password';
    grant all on *.* to nobody identified by 'password';

• Set your PATH variable to include MySQL programs (typically /usr/local/mysql and /usr/local/mysql/bin).
• 设置你的PATH变量以包含MySQL程序(典型的是 /usr/local/mysql/ 和 /usr/local/mysql/bin).
• You'll need to back up your database. Generally this requires stopping the project, making a copy or snapshot, and restarting. An example is here.
• 你需要备份数据库.一般要求暂停项目,制作一份拷贝或快照,然后重启.这里有个例子.
• BOINC gets MySQL compiler and linker flags from a program called mysql_config which comes with your MySQL distribution. This sometimes references libraries that are not part of your base system installation, such as -lnsl or -lnss_files. You may need to install additional packages (often you can use something called 'mysql-dev' or 'mysql-devel') or fiddle with Makefiles.
• BOINC通过MySQL分发中自带的一个叫做mysql_conifg的程序来获取MySQL编译器和连接器标记.有时它所引用的库在你的系统上是不存在的,比如-lnsl或-lnss_files.你可能需要安装额外的软件包(通常你可以使用'mysql-dev'或者'mysql-devel'之类的)或者修改make程序描述文件.
• MySQL can be the bottleneck in a BOINC server. To optimize its performance, read about configuring MySQL for BOINC.
• MySQL可能会成为BOINC服务器的瓶颈.要优化它的性能,请阅读针对BOINC的MySQL配置.
• Notes on running MySQL on a cluster.
• 在集群上运行MySQL的注意事项.

MySQLclient notes
MySQLclient注意事项

• Configure mysql with the --enable-thread-safe-client switch.
• 配置mysql包含--enable-thread-safe-client开关.
• Set your LD_LIBRARY_PATH to refer to the correct library.
• 设置你的LD_LIBRARY_PATH指向正确的库.

Apache notes
Apache注意事项

In httpd.conf, set the default MIME type as follows (otherwise you'll get file upload signature verification errors):
在httpd.conf中设置以下默认MIME类型(否则会出现文件上传签名验证错误):

DefaultType application/octet-stream


PHP notes
PHP注意事项

• Make sure 'magic quotes' are enabled (this is the default). The file /etc/php.ini should contain
• 务必使'magic quotes'是允许的(这也是默认的设置)./etc/php.ini文件中应包含

magic_quotes_gpc = On

• By default, BOINC uses PHP's mail function to send email to participants. This uses sendmail. If this doesn't work, you can use PHPMailer instead, which is a very flexible mail-sending mechanism. To do this:
• 缺省情况下,BOINC使用PHP的邮件函数来向用户发送电子邮件.它用于发送邮件.如果这不起作用,你可以用PHPMailer来代替.它是一种灵活的邮件发送模块.使用方法:

              □ Download PHPMailer and put it under PROJECT/html/inc/phpmailer.
              □下载PHPMailer后把它放在PROJECT/html/inc/phpmailer目录下.

              □ Set the following variables in your PROJECT/html/project/project.inc file (substitute your own values):
              □在你的PROJECT/html/project/project.inc文件中设置以下变量(替换为你的实际值):
= true;
= "xxx.xxx.xxx";
= "smtp";

[ 本帖最后由 烦人 于 2007-2-23 22:33 编辑 ]

烦人

原文: http://boinc.berkeley.edu/server_components.php
[English Version]Last modified 3:29 AM UTC, July 28 2006.
Translated By 烦人//2007-02-23

What is a project?
什么是项目?

A BOINC project consists of the following components:
一个BOINC项目由下列组件构成:

• A database
• 数据库
• A directory structure
• 目录结构
• A configuration file, which specifies options, daemons, and periodic tasks.
• 详细说明选项、后台程序和周期性任务的配置文件

Multiple BOINC projects can exist on the same host. This can be handy for creating separate projects for testing and debugging.
同一台主机上可以存在多个项目,以便于为测试和调试创建独立的项目.

The easiest way to create a project is with the make_project script, which creates skeletal versions of the above components.
创建一个项目最简单的方法是使用make_project脚本,它将建立上述组件的框架版本.

A project must be stopped when maintenance activities (e.g. changing the configuration file or database) are being performed. This is done using project control scripts.
当维护作业(如修改配置文件或数据库)正在进行时,必须将项目停止.这项工作由项目控制脚本来完成.


The master URL
主URL

Each project is publicly identified by a master URL. The master page at this URL has two functions.
每个项目都由一个主URL来公开标识.该URL上的主要页面有两个功能.

• It is the home page of the project; when viewed in a browser it describes the project and contains links for registering and for downloading the core client.
• 它是项目的主页;当在浏览器中显示时它描述了项目并包含了注册及下载客户端的链接.
• It contains XML elements of the form
• 它还含有以下形式的XML元素

<scheduler>http://host.domain.edu/cgi/scheduler</scheduler>
<scheduler>http://host2.domain.edu/cgi/scheduler</scheduler>

that give the URLs of the project's scheduling servers. These tags can be embedded within HTML comments. The BOINC core client reads and parses the master page to locate scheduling servers. If at any point it is unable to connect to any scheduling server for a project, it rereads the master page. This mechanism lets a project move or add scheduling servers.
这给出了项目调度服务器的URL.这些标签可以被嵌入HTML注释.BOINC客户端核心程序会读入并解析该主页面并定位到调度服务器.如果在任意点上都无法连接到项目的任何调度服务器,它将重新读取该主页面.通过这种机制可以给项目迁移或增加调度服务器.

make_project creates a master page in project/html/user/index.php. This file includes the file 'schedulers.txt', which contains the list of <scheduler>elements.
make_project脚本创建一个主页面,保存在project/html/user/index.php.该文件包含了一个含有<scheduler>元素列表的'schedulers.txt'文件.

[ 本帖最后由 烦人 于 2007-2-23 22:31 编辑 ]

碧城仙

原帖由 烦人 于 2007-2-23 02:05 发表
这个部分的官方版本有改动了,碧仙有时间的话要改一下总站上面的相关页面了,或者等我们翻译好了再更新也可以.

好的，谢谢。

jszhang98

○The make_project script
  ○Adding applications/platforms
  ○Adding application versions
  ○Project creation cookbook
  ○Project control
  ○Project security
     ■Code signing

碧城仙

谢谢支持！

jszhang98

原文:http://boinc.berkeley.edu/make_project.php
[english version] last modified at 2007-03-07 13:57



The make_project script  
MAKE_PROJECT 脚本
     

--------------------------------------------------------------------------------

The make_project script creates the server components of a BOINC project. To use it, set up a BOINC server. Then, for example, type:
MAKE_PROJECT脚本用来建立BOINC项目的服务器组件。用它来建立BOINC服务器。例如，输入：
    cd tools/
    ./make_project cplan

creates a project with master URL http://<hostname>/cplan/ whose directory structure is rooted at $HOME/projects/cplan.
建立实际目录在$HOME/projects/cplan，主地址在URL http://<hostname>/cplan/的项目。

More specifically, make_project does the following:

Create the project directory and its subdirectories.
Create the project's encryption keys if necessary. NOTE: before making the project visible to the public, you must move the code-signing private key to a highly secure (preferably non-networked) host, and delete it from the server host.
Create and initialize the MySQL database
Copy source and executable files
Generate the project's configuration file.
具体说明如下：
建立项目目录和子目录。
如果需要，建立项目的加密密钥。注意：在项目被发布之前，你需要将"代码签字私有密钥"存放到高度安全（最好没有网络连接）的主机上，并且从服务器主机上删除。
建立并初始化MYSQL数据库。
考备源文件和可执行文件。
产生项目配置文件。


The script gives further instructions, namely
It generates a template Apache config file that you can insert into /etc/apache/httpd.conf (path varies), or Include directly.
It generates a crontab line to paste.

The command-line syntax is as follows:
make_project [options] project_name [ 'Project Long Name ' ]

此脚本给出了进一步用法说明，换句话说
它产生了直接可以放到/etc/apache/httpd.conf(path varies)中的Apache配置文件，或者直接包含。
命令行语法如下所示：
make_project [options] project_name [ 'Project Long Name ' ]


Options are as follows (normally you don't need to include any of them):
directory options
--project_root Project root directory path. Default: $HOME/projects/PROJECT_NAME
--key_dir Where keys are stored. Default: PROJECT_ROOT/keys
--url_base Determines master URL Default: http://$NODENAME/
--no_query Accept all directories without yes/no query
--delete_prev_inst Delete project-root first (from prev installation)
URL options
--html_user_url User URL. Default: URL_BASE/PROJECT/
--html_ops_url Admin URL. Default: URL_BASE/PROJECT_ops/
--cgi_url CGI URL. Default: URL_BASE/PROJECT_cgi/
database options
--db_host Database host. Default: none (this host)
--db_name Database name. Default: PROJECT
--db_user Database user. Default: current user
--db_passwd Database password. Default: None
--drop_db_first Drop database first (from prev installation)
debugging options
--verbose={0,1,2} default: 1
-v alias for --verbose=2
-h or --help Show options

参数据选项如下（通常不需要包含任何参数）：
目录参数
--project_root           指定项目根目录。 缺省为： $HOME/projects/PROJECT_NAME
--key_dir                密钥存储路径。缺省为：PROJECT_ROOT/keys
--url_base               指定主URL地址 缺省为：http://$NODENAME/
--no_query               不提示 yes/no 询问
--delete_prev_inst       首先清空项目根目录（从前一次安装）
URL参数
--html_user_url          用户URL。 缺省为：URL_BASE/PROJECT/
--html_ops_url           管理员URL。缺省为：URL_BASE/PROJECT_ops/
--cgi_url                CGI URL. 缺省为：URL_BASE/PROJECT_cgi/
数据库参数
--db_host                数据库主机。缺省为：当前主机
--db_name                数据库名称。缺省为：项目名称
--db_user                数据库用户。缺省为：当前用户
--db_passwd Database password. Default: None
--drop_db_first          首先删除数据库（从前一次安装）
调试参数
--verbose={0,1,2} 　　　　缺省为：1
-v                       参数--verbose=2别名
-h或--help               显示参数

jszhang98

原文：http://boinc.berkeley.edu/tool_xadd.php
[english version] last modified at 2007-03-07 14:28


xadd - tool for adding database items
XADD - 增加数据库记录工具



xadd adds platform and application records to the BOINC database. Information is read from an XML file project.xml in the project's root directory. Run xadd from the project root directory, i.e.:
cd ~/projects/project_name
bin/xadd

XADD 命令可以向BOINC数据库增加平台和应用的记录。需要从项目根目录下的project.xml文件中读取信息。在项目根目录下运行XADD，例如：
cd ~/projects/project_name
bin/xadd



The contents of project.xml should look like this:
project.xml文件内容大致如下：

  <boinc>
    <app>
        <name>setiathome</name>
        <user_friendly_name>SETI@home</user_friendly_name>
        [ <beta>1</beta> ]
    </app>
    ...
    <platform>
        <name>anonymous</name>
        <user_friendly_name>anonymous</user_friendly_name>
    </platform>
    <platform>
        <name>i686-pc-linux-gnu</name>
        <user_friendly_name>Linux/x86</user_friendly_name>
    </platform>
    <platform>
        <name>windows_intelx86</name>
        <user_friendly_name>Windows/x86</user_friendly_name>
    </platform>
    <platform>
        <name>powerpc-apple-darwin</name>
        <user_friendly_name>Mac OS X</user_friendly_name>
    </platform>
    ...
  </boinc>

The 'name' of each item should be short and without spaces or other special characters. The 'user friendly name' (shown to end users) has no restrictions. An example project.xml file is in source/tools/.
'name'部份应比较简短且没有空格和其它特殊字符。'user friendly name'(显示给最终用户)没有限制。project.xml的示例文件在source/tools/下面可以找到。

xadd only adds new items; entries that conflict with existing database entries are ignored.
XADD 只添加新记录；如数据库中已经存在，则不进行任何操作。

jszhang98

原文：http://boinc.berkeley.edu/tool_update_versions.php
[english version] last modified at 2007-03-07 15:42


Releasing application versions  
发布应用版本
     

--------------------------------------------------------------------------------
The update_versions script releases new application versions. It creates database entries and copies files to the download directory.
update_versions 脚本用来发布新的应用版本。它将建立数据记录并且考备文件到下载目录。
To use:
使用说明：

If it doesn't already exit, create an directory 'apps' under the project directory, and add an <app_dir> element to config.xml giving the path of the apps directory.
Create a subdirectory for each application, with the short name of the application. Put new application files here (see below). update_versions scans these directories for new application versions.
From the project's root directory, run bin/update_versions
如果应用还没有建立，在project目录下建立目录apps，然后在config.xml中添加一个<app_dir>元素，将其值定义为所建的apps目录。
用简易名称为每个应用在apps下建立子目录。放入应用文件(看下文)。update_version会在发布新版本时扫描这些目录。


Single-file application versions
File names must be of the form NAME_VERSION_PLATFORM[.ext], e.g.:
单文件应用版本
文件名应符合格式NAME_VERSION_PLATFORM[.ext]，例如：

boinc_3.17_i686-pc-linux-gnu
astropulse_7.17_windows_intelx86.exe



Platform strings must match the names of platforms in the database. If needed, add the platform to the DB.
PLATFORM 字串需与数据库中的保持一致。如果数据库中没有，需要添加到数据中。


Multiple-file application versions
Application versions can consist of multiple files, one of which is the main program. To create a multiple-file application version, create a directory with the same name as the main program (of the form NAME_VERSION_PLATFORM[.ext]). and put the files in that directory.
If your application includes executable files other than the main file, make sure that their protection flags include the user execute (u+x) bit.
多文件应用版本
应用版本可能由多个文件组成，其中一个是主程序。建立多文件应用版本需建立一个与主程序文件名相同的目录，且将所有文件放入。
如果你的用除了主程序文件外还包括其它可执行文件，注意确认文件保护标志包含可执行位（u+x）。



Passing extra information about files
传递文件的额外信息

If a file of the form
FILENAME.sig
is found, its contents will be used as a digital signature for the corresponding file. Recommended code-signing practices are described here.
如果一个文件的形式
FILENAME.sig
被发现，它的内容将被用来做为对应文件的数据签名。推荐使用这里所描述的代码签名。

If a file of the form
FILENAME.file_ref_info
is found, its contents will be added to the <file_ref> element describing the file (you can use this for attributes like <copy_file>).
如果一个文件的形式
FILENAME.file_ref_info
被发现，它的内容将被添加到<file_ref>中用来描述此文件(<copy_file>属性也能这样使用)

If a file of the form
LOGICAL_NAME=PHYSICAL_NAME
is found, the given logical and physical names will be used (i.e., the application will be able to access the file by passing the logical name to boinc_resolve_filename()).
如果一个文件的形式
LOGICAL_NAME=PHYSICAL_NAME
被发现，它所给出的逻辑和物理名称将会被使用（例如，应用可以通过将逻辑名称传递给boinc_resolve_filename()函数来访问其物理文件）

--------------------------------------------------------------------------------

Return to BOINC main page
Last modified 8:53 PM UTC, June 14 2006.
Copyright ? 2007 University of California. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation.

jszhang98

原文：http://boinc.berkeley.edu/project_cookbook.php
[english version] last modified at 2007-03-07 22:42

Project creation cookbook  
项目创建过程说明
     

--------------------------------------------------------------------------------

Make skeletal project
创建框架项目

Install and configure all prerequisite software (follow the directions carefully). Make sure MySQL is configured and running.
Get the BOINC
Compile the BOINC software, say into HOME/boinc.
Run HOME/boinc/tools/make_project
Append the contents of projects/PROJECT/PROJECT.httpd.conf to httpd.conf and restart Apache.
Use 'crontab' to insert a cron job to run the project's periodic tasks, e.g.
0,5,10,15,20,25,30,35,40,45,50,55 * * * * HOME/projects/PROJECT/bin/start --cron
(if cron cannot run 'start', try using a helper script to set PATH and PYTHONPATH)
Copy project.xml from HOME/boinc/tools to HOME/projects/PROJECT, edit it to reflect your applications and platforms, and run bin/xadd.
Edit html/project/project.inc, changing the master URL and copyright holder.
Protect the html/ops directory (e.g. by putting .htaccess and .htpasswd files there).
安装和配置所有必要的软件(严格按照说明进行)。确保MySQL数据库被正确配置和运行。
取得BOINC的源程序
编译BOINC软件，并且放到HOME/boinc。
添加文件/projects/PROJECT/PROJECT.httpd.conf的内容到httpd.conf，然后重新启动Apach服务。
使用'crontab'命令增加项目的需定期执行任务，例如：
0,5,10,15,20,25,30,35,40,45,50,55 * * * * HOME/projects/PROJECT/bin/start --cron
(如果cron不能运行'start'，可以试试运行脚本来设置PATH和PYTHONPATH)
将project.xml从HOME/boinc/tools复制到HOME/projects/PROJECT，编辑project.xml以与你的应用和平台相适应，然后运行bin/xadd。
编辑html/project/project.inc，改变主URL路径和版权人。
保护目录html/ops(例如，放入.htaccess和.htpasswd文件)

Visible result: the project web site is up. The database 'platforms' table has several rows.
Troubleshooting: check the Apache access and error logs.
结果检查：项目网站正常运行。数据库表'platforms'存在几行数据。
错误处理：检查apache访问和错误日志






Create an application version
Create a BOINC application executable (if you're in a hurry, use the test application).
Copy the executable to HOME/projects/PROJECTNAME/apps/APPNAME
cd to HOME/projects/PROJECTNAME
run bin//update_versions, type y or return.
run ./stop && ./start
Visible result: the web site's Applications page has an entry.
建立应用版本
建立BOINC应用可执行程序(如果你比较忙，使用测试应用)
复制可执行程序到HOME/projects/PROJECTNAME/appls/appName
cd to HOME/projects/PROJECTNAME
运行bin/update_verisons，输入Y或返回
运行./stop && ./start
结果检查：网站Application页有一条记录




Create a work unit
Using a text editor, create a work unit template file and a result template file.
Run create_work
Edit config.xml to add <daemon> records for make_work, feeder, transitioner, file_deleter, the trivial validator, and the trivial assimilator. For example
<daemon>
    <cmd>validate_test -app appname</cmd>
    <output>validate_test.log</output>
    <pid_file>validate_test.pid</pid_file>
</daemon>
Visible result: after a project restart, 'status' shows the above daemon processes running.
Troubleshooting: check the log files of all daemon processes.
创建工作单元
使用文本编辑器建立一个工作单元模板和一个结果模板文件。
运行create_work
编辑config.xml，为make_work,transitioner,file_deleter,trivial validator 和trivial assimilator建立daemon记录.例如：
<daemon>
    <cmd>validate_test -app appname</cmd>
    <output>validate_test.log</output>
    <pid_file>validate_test.pid</pid_file>
</daemon>
结查检查：项目重启后，'status'显示上面的守候进程正在运行。
错误处理：检查错误日志和所有的守候进程。




Test the system
Create a client directory (on the same computer or different computer), say HOME/boinc_client. Copy the core client there.
Using the web interface, create an account on the project.
Run the core client; enter the project URL and the account key.
Visible result: the client does a stream of work; the web site shows credit accumulating.
Troubleshooting: check the log files of all daemon processes.
测试系统
建立客户端目录(可在相同或不同的计算机上)，如/home/boinc_client。将核心客户端复制到这。
使用WEB接口建立账户
结果检查：客户端处理工作流；网站显示信用积分。
错误处理：检查错误日志和所有的守候进程。


Develop back end components
Write a work generator.
Write a validator.
Write an assimilator.
Edit the configuration file to use these programs instead of the place-holder programs.
Make sure everything works correctly.
开发后台程序组件
编写工作发生器
编写较验器
编写模拟器
编辑配置文件用这些程序取代place_holder程序。
确保所有工作正常完成


Extras
Add message board categories: see html/ops/create_forums.php
其它
增加留言版功能：参考html/ops/create_forums.php



--------------------------------------------------------------------------------

Return to BOINC main page
Last modified 9:17 PM UTC, September 12 2006.
Copyright &copy; 2007 University of California. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation.

jszhang98

请校验一下。
有些地方翻译的不太准确。

碧城仙

谢谢谢谢，这几天我们会先大概检查一下，然后就转到页面里去，再上传到我们的中文站里面。

jszhang98

原文：http://boinc.berkeley.edu/tool_start.php
[english version] last modified at 2007-03-09 10:27

Project control  
项目控制
     

--------------------------------------------------------------------------------

Project control scripts
The following Python scripts control a project:
bin/start Start the project: start all daemons, and remove the stop_sched and stop_daemon files (see below).
bin/stop Stop the project (create the stop_sched and stop_daemon files)
bin/start --cron If the project is started, perform all periodic tasks that are past due, and start any daemons that aren't running. Otherwise do nothing.
bin/status Show whether the project is stopped. Show the status of all daemons. Show the status of all periodic tasks (e.g., when they were last executed).

项目控制脚本
如下PYthon脚本用来控制项目：
bin/start                                启动项目：启动所有的守候进程，删除stop_sched 和stop_daemon 文件(请看下文).
bin/stop                        停止项目(建立stop_sched和stop_daemon文件)
bin/start -cron     如果项目被启动，执行所有未执行的周期性任务，开始任何一个守候进程。否则什么也不做。
bin/status                        显是是否项目被停止了。显示所有进程状态。显示所有周期性执行的任务状态（如，最后一次执行时间）



Trigger files
The following files (in the project root directory) can be used to turn off various parts of a project.

stop_sched Have the scheduler return 'project down' messages.
stop_daemons Tell all daemon process to exit.
stop_web Have the web site return 'project down' messages for all functions that require database access.
stop_upload Have the file upload handler return transient error messages to clients (they'll back off and retry later).



The presence of a file triggers the function. For example, to turn off data-driven web pages, type

   touch stop_web

and to turn them back on, type
   rm stop_web

If the first three files are all present, no database access will occur. You should do this during most maintenance functions (such as upgrading software).

触发文件
下面文件(在项目根目录下)能关闭项目的很多部分
stop_sched              让时间表返回"project down"消息
stop_daemons　　停止所有进程
stop_web                                为需要访问数据库的功能在网站上返回"Project down"消息
stop_upload                        使文件上传功能模块返回传输错误消息(他们将取消或稍后重试)

使用触发文件功能。例如，关闭网页数据驱动，输入：
touch stop_web

打开，输入
rm stop_web

如果前三个文件被运行完成，将不会再有数据库访问。你应该在做功能维护时运行他们（例如升级软件）。


--------------------------------------------------------------------------------

Return to BOINC main page
Last modified 10:18 PM UTC, July 14 2006.
Copyright ? 2007 University of California. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation.