The samples consist of an ASP based client application, including source, is provided to run simple create, read, update, and delete (CRUD) functions to this basic grid. The client application can also be used to run simple create, read, update and delete functions to a simple grid hosted on a WebSphere DataPower XC10 appliance. To get started even quicker, download the XC10 Virtual Appliance.
Running the sample
- WebSphere eXtreme Scale Version 8.6 or later
- WebSphere eXtreme Scale Client for .NET Version 8.6 or later
- Visual Studio 2010 or later Internet Information Services (IIS) for Windows® Server (usually comes with Visual Studio)
Before importing and running the sample application, you must perform a full installation of WebSphere eXtreme Scale to start a grid. You then will require to install the WebSphere eXtreme Scale Client for .NET.
Importing the sample into Visual Studio
You should now see the solution in your Solution Explorer. If there are build errors, then you must resolve them by adding the eXtreme Scale DLL files as References, as described in the following steps:
The correct references are now in the solution, you should be able to compile and build your solution.
- Open Visual Studio
- From the File menu, select Open, Project/Solution...
- Browse to the directory of the downloaded sample, select IBM.WebSphere.caching.GettingStartedWeb.sln file, and click Okay.
- Expand the GettingStartedWeb solution, and then expand .
- If IBM.WebSphere.Caching.dll is not resolved, you can remove it and add it where it is located on your machine.
- Right click References, Add Reference....
- Select the Browse tab. Look in the eXtreme Scale Client for .NET install/bin directory for IBM.WebSphere.Caching.dll and click Okay. You cannot have two of the same named references, so if you did not delete the one that came with the solution to add your new reference, please remove it first.
Running the client application
The client application is a simple ObjectGrid client that connects to a remote or embedded ObjectGrid and performs Create, Read, Update and Delete (CRUD) operations. This client can be used with a WebSphere eXtreme Scale grid or a simple grid on a WebSphere DataPower XC10 appliance.
After you have imported your solution file into Visual Studio, you can then build it and run the application on the IIS Server that comes with Visual Studio.
- From the menu, select Build, Build Solution to compile.
- Then to run the compiled code on the IIS Server, select Debug, Start Debugging.
In a browser, enter the following server URL: http://hostname:port
The <hostname> is the host name or IP address of IIS Server and <port> is the web server port for your IIS Server. See the following example:
- In the Client Connection section, enter the hostname or IP address and port of the Remote catalog service endpoint in the form of hostname:port.
- In the Grid name and Map name fields, enter the names of the target grid and map. The default for the Server servlet application provided is Grid for the grid name and Map1 for the map name. If you are using this client with an XC10 appliance, you must first create a simple grid on the XC10 appliance. Use the name of the simple grid for both the grid name and the map name.
- After entering the catalog service endpoint, gridname, and mapname, click Connect to test the connection. If the connection is successful, you will see true for Client Connected.
- Enter a string value for Key and a string value for Value. Then, select the appropriate CRUD operation; either Add, Replace, Remove, or Get.
Please post any feedback on this sample as a comment on this page.