WebSphere eXtreme Scale readme

WebSphere eXtreme Scale is an in-memory data grid for applications that are written in Java, and has extreme transaction processing (XTP) capabilities. It can be used simply as an in-memory data cache, or it can be used to distribute data across a network. It accomplishes horizontal scalability through data partitioning and provides vertical scalability by judicious use of threading.

Getting started
Installation packages
Installation environments
Installation directories
ObjectGrid directories
Included libraries for stand-alone environments
Included libraries for WebSphere Application Server environments
More information

Getting started

A simple sample is provided that demonstrates how to start eXtreme Scale servers and includes a sample client. See the gettingstarted subdirectory and the WebSphere eXtreme Scale Getting Started readme file for details on running the sample. Additional samples can be found at the WebSphere eXtreme Scale community Wiki: http://www.ibm.com/developerworks/wikis/display/extremescale

Installation packages

WebSphere eXtreme Scale is available in one of three installation packages:

Full installation package

Includes all eXtreme Scale features, installation program, support tools and Java Runtime Environment.
Client installation package

Includes all eXtreme Scale features available for running eXtreme Scale client applications, installation program, support tools and Java Runtime Environment.
Trial zip archive package

Includes time-limited eXtreme Scale core features.

Installation environments

The full and client installation packages can be installed in one of the following two environments:

As a stand-alone deployment.

When eXtreme Scale is installed into a new or empty directory, it is a stand-alone deployment, which includes a Java SE Runtime Environment, support tools and eXtreme Scale runtime to build and run eXtreme Scale applications.
Integrated with WebSphere Application Server.

When installed into an existing WebSphere Application Server directory, it becomes integrated with WebSphere Application Server and can run within the WebSphere Application Server processes, allowing first class Java EE application integration, while still using WebSphere Application Server's management capabilities. You can also run eXtreme Scale stand-alone Java SE applications when integrated with WebSphere Application Server.

Installation directories

The full and client installation packages include the following relevant directories within the installation root directory:

/isalite_wxs: IBM Support Assistant Lite utility for gathering data for IBM support.
/java: The Java Runtime Environment.
/logs: Installation log files.
/ObjectGrid: The eXtreme Scale product files.
/uinstall_wxs: The uninstallation program for uninstalling the eXtreme Scale product.

ObjectGrid directories

All product installation packages create an ObjectGrid sub-directory. The ObjectGrid sub-directory contains the eXtreme Scale product files:

/ObjectGrid/bin: Scripts for running and administering eXtreme Scale servers and utilities.
/ObjectGrid/console: The eXtreme Scale monitoring console server runtime.
/ObjectGrid/dynacache: The eXtreme Scale dynamic cache provider.
/ObjectGrid/gettingstarted: The eXtreme Scale getting started sample.
/ObjectGrid/hyperic: The Hyperic HQ agent plug-in.
/ObjectGrid/legacy: Deprecated function and componentry.
/ObjectGrid/lib: Libraries required for building and running eXtreme Scale applications.
/ObjectGrid/lib/endorsed: The Object Request Broker (ORB) used for running eXtreme Scale clients and servers.
/ObjectGrid/native: Platform specific, native libraries required for running eXtreme Scale.
/ObjectGrid/properties: Configuration property files and sample property files.
/ObjectGrid/restservice: The eXtreme Scale REST data service.
/ObjectGrid/samples: eXtreme Scale sample applications
/ObjectGrid/session: The eXtreme Scale HTTP Session manager.
/ObjectGrid/wasce: WebSphere Application Server Community Edition support files.

Included libraries for stand-alone environments

This section describes the most commonly used libraries. Each of the following libraries are located in the /ObjectGrid/lib directory.

JAR File Name	Runtime Environment	Specific Support
objectgrid.jar	Client and Server	Available for Java Platform, Standard Edition version 5 and later and Java Platform, Enterprise Edition environments that are not running WebSphere Application Server, and Eclipse Gemini OSGi frameworks, version 3.6.1 or later. Note: This JAR is not available with the client install package or when the server install option is not selected during install.
ogclient.jar	Client Only	Available for Java Platform, Standard Edition version 5 and later and Java Platform, Enterprise Edition environments that are not running WebSphere Application Server, and Eclipse Gemini OSGi frameworks, version 3.6.1 or later.
wsogclient.jar	Client Only	Available for WebSphere Application Server or WebSphere Application Server Network Deployment versions 6.1 and later, including stack products.

See the following information center topic for a detailed list of all JAR files available for deployments integrated with WebSphere Application Server: http://publib.boulder.ibm.com/infocenter/wxsinfo/v7r1m1/topic/com.ibm.websphere.extremescale.admin.doc/txsinstallwas.html

Included libraries for WebSphere Application Server environments

This section describes the most commonly used libraries when eXtreme Scale is integrated with WebsSphere Application Server. Each of the following libraries are located in the /lib directory in the root of the application server installation.

JAR File Name	Runtime Environment	Specific Support
wsobjectgrid.jar	Client and Server	Available for WebSphere Application Server or WebSphere Application Server Network Deployment versions 6.1 and later, including stack products. Note: This JAR is not available with the client install package or when the server install option is not selected during install.
wsogclient.jar	Client Only	Available for WebSphere Application Server or WebSphere Application Server Network Deployment versions 6.1 and later, including stack products.

More information

For help and support, see the WebSphere eXtreme Scale forum.
For the latest information, samples, hints, tips and troubleshooting information, see the WebSphere eXtreme Scale community Wiki.
Use the following links for additional information about WebSphere eXtreme Scale: