How to Join sharkGrid

Welcome to the sharkGrid! The sharkGrid allows you to donate spare cycles of your computer to whale shark research. Specifically, the processing power of your computer can be “borrowed” for resource intensive tasks, such as pattern recognition or data mining. sharkGrid uses “global volunteer computing” to distribute intensive tasks between multiple computers to allow them to complete much more quickly.

There are a few quick things you should know before participating in sharkGrid.

1. Once running, the sharkGrid client must stay open to allow your computer to aid in whale shark spot pattern processing. If for any reason you want to leave the grid, close the client. If you restart your computer, you must restart sharkGrid to participate.

2. Your Internet connection must remain open to participate in sharkGrid. sharkGrid obtains all patterns to compare from the World Wide Web.

3. Your computer must have Java Runtime Environment (JRE) version 7 or higher installed. You can download a JRE from the Java web site. The JRE is different from the Java Virtual Machine (JVM) that runs in your browser. The JRE allows Java applications to run as programs on your desktop.

4. Please disable any power-saving features enabled on your computer. For example, many PCs will enter a suspended state (a.k.a. “System standby”) after a period of time with no user interaction. Other power-saving schemes stop the hard drive(s), which will also interfere with the sharkGrid client.

5. sharkGrid participation is subject to the Wildbook for Whale Sharks Visitor Agreement. By visiting this web site and joining sharkGrid, you are agreeing to the terms and conditions therein.

6. sharkGrid can run in the background while you perform other tasks on your computer. However, sharkGrid is used for intensive computation, and other applications running on your computer simultaneously with sharkGrid may slow down somewhat.

7. sharkGrid requires significant computing power. We recommend you only run sharkGrid on computers with 1 gigabyte (GB) of RAM or more.

Downloading the sharkGrid client

You can download a zip file containing the sharkGrid client here.

Installing and starting the sharkGrid client

To install the sharkGrid client to your desktop, follow these instructions.


Figure 1. The sharkGrid client running successfully.

Windows

1. Unzip the sharkGrid client zip file to a custom folder on your Desktop or elsewhere on your computer. This is the folder that sharkGrid will run from.

2. Determine how much memory is available on your computer.

3. In the sharkGrid folder, right-click StartGridClient.bat and select Edit. This is the command-line statement used to start sharkGrid.

   java -classpath .;jdo2-api-2.0.jar;jpox-1.1.9.jar -Xms512m -Xmx1g workApplet3 

You should edit ONLY the parameter ”-Xmx1g” to match the memory on your computer. You can specify your memory as megabytes (m) or gigabytes (g). The following are sample settings:

  • ”-Xmx1g” or ”-Xmx1024m” for 1 gigabyte of RAM, which is also 1024 megabytes.
  • ”-Xmx2g” or ”-Xmx2048m” for 2 gigabytes of RAM, which is also 2048 megabytes.

4. Save your changes to StartGridClient.bat.

5. Double-click StartGridClient.bat. You should see the sharkGrid client start and begin looking for work to do.

6. If the sharkGrid client fails to start, you may need to manually set the JAVA_HOME environment variable on your computer. This variable tells your computer where Java is installed so that it can use it when the “java” command is issued to start the sharkGrid client. Follow these steps on Windows to set JAVA_HOME:

 1. Right click on the My Computer icon on your desktop and select Properties.
 2. Click the Advanced Tab.
 3. Click the Environment Variables button.
 4. Under System Variables, click New.
 5. Enter the variable name as JAVA_HOME.
 6. Enter the variable value as the base directory of the JRE, such as C:\Program Files\Java\jre1.5.0_09. 
    The value you set depends on where the JRE was installed on your computer.
 7. Click OK.
 8. Double-click StartGridClient.bat. You should see the sharkGrid client start and begin looking for work to do.

Linux

1. Unzip the sharkGrid client zip file to a custom folder on your Desktop or elsewhere on your computer. This is the folder that sharkGrid will run from.

2. Determine how much memory is available on your computer.

3.This is the command-line statement used to start sharkGrid from the folder you unzipped it to.

   java -classpath .:jdo2-api-2.0.jar:jpox-1.1.9.jar -Xms512m -Xmx1g workApplet3

You should edit ONLY the parameter ”-Xmx1g” to match the memory on your computer. You can specify your memory as megabytes (m) or gigabytes (g). The following are sample settings:

  • ”-Xmx1g” or ”-Xmx1024m” for 1 gigabyte of RAM, which is also 1024 megabytes.
  • ”-Xmx2g” or ”-Xmx2048m” for 2 gigabytes of RAM, which is also 2048 megabytes.

This command assumes that Java 7 or higher is already installed and available from the command line. Click here for instructions for installing Java on Linux.

4. Create a shell script containing this command and consider creating a cron job to run this script during the times of the day that you know your machine will be idle.

Mac

TBD

 
how_to_join_sharkgrid.txt · Last modified: 2014/07/19 23:22 by webadmin     Back to top