| | 1 | = The make_project script = |
| | 2 | |
| | 3 | The make_project script creates the server components of a BOINC project. To use it, [http://boinc.berkeley.edu/server.php set up a BOINC server]. Then, for example, type: |
| | 4 | {{{ |
| | 5 | cd tools/ |
| | 6 | ./make_project cplan |
| | 7 | }}} |
| | 8 | creates a project with master URL http://<hostname>/cplan/ whose directory structure is rooted at $HOME/projects/cplan. |
| | 9 | |
| | 10 | More specifically, make_project does the following: |
| | 11 | |
| | 12 | * Create the project directory and its subdirectories. |
| | 13 | * 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. |
| | 14 | * Create and initialize the MySQL database |
| | 15 | * Copy source and executable files |
| | 16 | * Generate the project's configuration file. |
| | 17 | |
| | 18 | The script gives further instructions, namely |
| | 19 | |
| | 20 | * It generates a template Apache config file that you can insert into /etc/apache/httpd.conf (path varies), or Include directly. |
| | 21 | * It generates a crontab line to paste. |
| | 22 | |
| | 23 | The command-line syntax is as follows: |
| | 24 | {{{ |
| | 25 | make_project [options] project_name [ 'Project Long Name ' ] |
| | 26 | }}} |
| | 27 | Options are as follows (normally you don't need to include any of them): |
| | 28 | |
| | 29 | == directory options == |
| | 30 | || --project_root || Project root directory path. Default: $HOME/projects/PROJECT_NAME || |
| | 31 | || --key_dir || Where keys are stored. Default: PROJECT_ROOT/keys || |
| | 32 | || --url_base || Determines master URL Default: http://$NODENAME/ || |
| | 33 | || --no_query || Accept all directories without yes/no query || |
| | 34 | || --delete_prev_inst || Delete project-root first (from prev installation) || |
| | 35 | == URL options == |
| | 36 | || --html_user_url || User URL. Default: URL_BASE/PROJECT/ || |
| | 37 | || --html_ops_url || Admin URL. Default: URL_BASE/PROJECT_ops/ || |
| | 38 | || --cgi_url || CGI URL. Default: URL_BASE/PROJECT_cgi/ || |
| | 39 | == database options == |
| | 40 | || --db_host || Database host. Default: none (this host) || |
| | 41 | || --db_name || Database name. Default: PROJECT || |
| | 42 | || --db_user || Database user. Default: current user || |
| | 43 | || --db_passwd || Database password. Default: None || |
| | 44 | || --drop_db_first || Drop database first (from prev installation) || |
| | 45 | == debugging options == |
| | 46 | || --verbose={0,1,2} || default: 1 || |
| | 47 | || -v || alias for --verbose=2 || |
| | 48 | || -h or --help || Show options || |
