Changes between Version 14 and Version 15 of WrapperApp

Timestamp:

Jul 20, 2007, 8:06:41 AM (17 years ago)

Author:

ijgeneral

Comment:

--

WrapperApp

@@ -52 +52 @@
  * Compile the program 'worker' from the [ExampleApps boinc_samples] tree, producing (say) 'worker_5.10_windows_intelx86.exe'. This is the legacy app. If reads from stdin and writes to stdout; it also opens and reads a file 'in', and opens and writes a file 'out'. It takes one command-line argument: the number of CPU seconds to use.
  * Compile the program 'wrapper' from the [ExampleApps boinc_samples] tree, producing (say) 'wrapper_5.10_windows_intelx86.exe'. This program executes your legacy application, and acts as a proxy for it (to report CPU time etc.).
- * [AppVersion Create an application] named 'worker', and a corresponding directory 'project/apps/worker'. In this directory, create a directory 'wrapper_5.10_windows_intelx86.exe'. Put the files 'wrapper_5.10_windows_intelx86.exe', and 'worker_5.10_windows_intelx86.exe' there.
+ * Using the [MakeProject make_project worker] command (in BOINC_SOURCE/tools/), create the server components of your project, called 'worker'. In the 'project/worker/apps' directory create the following sub-directories: 'worker/wrapper_5.10_windows_intelx86.exe/'. Put the files 'wrapper_5.10_windows_intelx86.exe', and 'worker_5.10_windows_intelx86.exe' there.
  * In the same directory, create a file 'job.xml=job_1.12.xml' (1.12 is a version number) containing
 {{{
@@ -65 +65 @@
 }}}
  This file (which has logical name 'job.xml' and physical name 'job_1.12.xml') is read by 'wrapper'; it tells it the name of the legacy program, what files to connect to its stdin/stdout, and a command line.
- * Create a workunit template file
+ * In the 'project/worker/templates' directory create a workunit template file, e.g., 'worker_wu'
 {{{
 <file_info>
@@ -87 +87 @@
 </workunit>
 }}}
- and a result template file
+ and a result template file, e.g., 'worker_result'
 {{{
 <file_info>
@@ -115 +115 @@
 </result>
 }}}
- * Run [UpdateVersions update_versions] to create an app version.
+ * Make sure the application name and the user friendly name (given in the make_project command above) in the last few lines of the 'project/worker/project.xml' file are correct ('worker' in this case).
+ * In the 'project/worker/config.xml' file change the value of <disable_account_creation> form 0 to 1 if you want to enable people connecting to your project to create accounts.
+ * At the end of this file is where you can change or add daemons to control your application.
+ * Run [XaddTool bin/xadd] from the '/project/worker' directory to add platform and application records to the BOINC database.
+ * Run [UpdateVersions bin/update_versions] to create an app version and to copy the files needed by Boinc to the 'project/worker/download' directory.
+ * Run [StartTool 'bin/start'] to start the daemons.
  * Run a script like
 {{{
@@ -126 +131 @@
 input input2
 }}}
- to generate a workunit.
+ to generate a workunit. Note that the order of the input files in the 'create_work' command has to be the same as in the workunit template file (worker_wu). If this is not satisfied, the client will generate errors when processing the workunit.
 
 To understand how all this works: at the beginning of execution, the file layout is: