In addition to the script-based getting started sandbox described in the GETTINGSTARTED_README file, a basic Eclipse project is included to get you started on your own eXtreme Scale development activities. The project consists of a single Java file, which is the entirety of the Create, Read, Update, and Delete (CRUD) sample program invoked by the provided command line scripts.
The provided project has been tested with Eclipse 3.x and later and only requires the standard Java development project perspective. The following steps guide you through the setup of your eXtreme Scale development environment.
Substitute install_root with the path to the eXtreme Scale installation root directory or the root file path of the extracted eXtreme Scale trial.
You should now see the 'client' project in your workspace. There are some build errors you must resolve by defining the eXtreme Scale user library, as described in the following steps:
Substitute install_root with the path to the eXtreme Scale installation root directory or the root file path of the extracted eXtreme Scale trial.
Attention: The ObjectGrid API documentation archive can also be downloaded from the following location: http://www.ibm.com/developerworks/wikis/x/OgWoBg
The correct classes and libraries are now in the build path, and the project should be error free. You can review and experiment with the code in Client.java. Finally, create a run configuration to execute the client sample and perform grid operations using the following steps:
Substitute install_root with the path to the eXtreme Scale installation root directory or the root file path of the extracted eXtreme Scale trial.
Tips:
The previous configuration will always insert the value, HelloWorld with the
key, key1. Vary the Program Arguments in the run profile to run
different operations with different values. The details of the operations and
parameters are located in the GETTINGSTARTED_README.txt file.
Ensure that you substitute the correct path to the location where eXtreme Scale is installed or where the trial was extracted (one level up from the location of this Readme). The previous steps express this location as install_root.
ORB issues are a common setup problem. The errors resemble the following:
Caused by: java.lang.RuntimeException: The ORB that comes with the Sun Java implementation does not work with ObjectGrid at this time. Use the IBM ORB until the Oracle ORB works.
If this error occurs, check the value provided in the VM Arguments field of the run configuration. The path to java.endorsed.dirs must be an absolute path with no variables or shortcuts.
Attention: There is a known issue with this configuration on the Mac OSX version of Java version 1.5. Use Java version 1.6 to avoid any problems.