Module 5: Use the xscmd tool to monitor data grids and maps

You can use the xscmd tool to show the primary data grids and map sizes of the Grid data grid. The xscmd tool uses the MBean to query all of the data grid artifacts, such as primary shards, replica shards, container servers, map sizes, and so on.

About this task

In this tutorial, the container and catalog servers are running in WebSphere® Application Server application servers. The WebSphere eXtreme Scale run time registers the Managed Beans (MBean) with the MBean server that is created by the WebSphere Application Server run time. The security that is used by the xscmd tool is provided by the WebSphere Application Server MBean security. Therefore, WebSphere eXtreme Scale specific security configuration is not necessary.

Procedure

Using a command-line tool, open the DMGR_PROFILE/bin directory.
Run the xscmd tool.
Use the -c showPlacement -sf P command to list the placement of the primary shards.
```
xscmd.sh -g Grid -ms mapSet -c showPlacement -sf P
```
```
xscmd.bat -g Grid -ms mapSet -c showPlacement -sf P
```
Before you can view the output, you are prompted to log in with your WebSphere Application Server ID and password.

Related tasksMonitoring with the xscmd utilityThe xscmd utility replaces the xsadmin sample utility as a fully supported monitoring and administration tool. With the xscmd utility, you can display textual information about your WebSphere eXtreme Scale topology.Administering with the xscmd utilityWith the xscmd utility, you can complete administrative tasks in the environment such as: establishing multi-master replication links, overriding quorum, and stopping groups of servers with the teardown command.

Lesson checkpoint

You used the xscmd tool in WebSphere Application Server.