IBM WebSphere eXtreme Scale

WebSphere eXtreme Scale Eclipse Project readme

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.

Table of contents

Software requirements

Getting started with Eclipse

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.

  1. Open Eclipse to a new or existing workspace.
  2. From the File menu, select Import.
  3. Expand the General folder, select Existing Projects into Workspace, and click Next.
  4. In the select root directory field, type or browse to the install_root/gettingstarted/client directory. Click Finish.
  5. 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:

  6. From the Window menu select Preferences.
  7. Expand the Java > Build Path branch, and select User Libraries.
  8. Click New.
  9. Type eXtremeScale in the User Library Name field and click OK.
  10. Select the new user library and click Add JARs.
  11. Browse, and select the objectgrid.jar file from the install_root/lib directory. Click OK.
  12. Substitute install_root with the path to the eXtreme Scale installation root directory or the root file path of the extracted eXtreme Scale trial.

    1. To include API documentation for the ObjectGrid APIs, select the API documentation location for the objectgrid.jar that you added in the previous step. Click Edit.
    2. In the API documentation location path box, type the following URL: http://www.ibm.com/developerworks/wikis/extremescale/docs/api/

      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:

  13. From the Run menu:
    In Eclipse 3.0 to 3.3, select Open Run Dialog.
    In Eclipse 3.4 or later, select Run Configurations.
  14. Right-click the Java Application category and select New.
  15. Select the new run configuration, named New_Configuration.
  16. In the right-hand pane, configure the profile as follows:
  17. Click Apply and close the window, or click Run if you have a catalog service and container instance currently running.
  18. 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.

Troubleshooting

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.

More information