| 1 | | = Choosing a project URL = |
| | 1 | = The master URL = |
| | 2 | |
| | 3 | Each project is publicly identified by a '''master URL'''. |
| | 4 | The page at this URL has two functions. |
| | 5 | |
| | 6 | * It is the home page of the project; when viewed in a browser it describes the project |
| | 7 | and contains links for downloading the BOINC client. |
| | 8 | * It contains XML elements of the form |
| | 9 | {{{ |
| | 10 | <scheduler>http://host.domain.edu/cgi/scheduler</scheduler> |
| | 11 | <scheduler>http://host2.domain.edu/cgi/scheduler</scheduler> |
| | 12 | }}} |
| | 13 | that give the URLs of the project's scheduling servers. |
| | 14 | These tags can be embedded within HTML comments. |
| | 15 | The BOINC client reads and parses the master page to locate scheduling servers. |
| | 16 | If at any point it is unable to connect to any scheduling server for a project, |
| | 17 | it rereads the master page. |
| | 18 | This mechanism lets a project move or add scheduling servers. |
| | 19 | |
| | 20 | Some ISPs remove HTML comments from downloaded pages. |
| | 21 | To avoid problems with that, an alternative syntax is allowed: |
| | 22 | {{{ |
| | 23 | <link rel="boinc_scheduler" href="http://host.domain.edu/cgi/scheduler"> |
| | 24 | }}} |
| | 25 | You should still use the `<scheduler>` format too, since older clients won't parse this new syntax. |
| | 26 | |
| | 27 | The [MakeProject make_project] script creates a master page in `project/html/user/index.php`. |
| | 28 | This file includes the file 'schedulers.txt', |
| | 29 | which contains the list of `<scheduler>` (and `<link>`) elements. |
| | 30 | |
| | 31 | == Choosing a project URL == |
