07 March 2024

Generating a Dump File

You can generate a dump file that includes information about the runtime environment for a specific host, or across the entire environment.

Start the Web Management Console, click Generate Dump, and select the relevant option:

This can be done for all hosts, all hosts but only information on GSCs, or just an overview. For a specific host, you can click the tool-box icon.

Specific GSC Grid Service Container. This provides an isolated runtime for one (or more) processing unit (PU) instance and exposes its state to the GSM. dump:

Any of the above will display the following dialog:

dump3

Select the required options and click Generate.

The "JVM Java Virtual Machine. A virtual machine that enables a computer to run Java programs as well as programs written in other languages that are also compiled to Java bytecode. Heap Dump" option determines whether a JVM heap dump should be generated for the JVMs. It is recommended to choose this only on a specific host or GSC that a Java heap dump should be generated for.
The "Only Live Services Log Dump" determines if the dump should include only services that are currently running, or also services that have been terminated (useful for troubleshooting failover scenarios).

Generate Overview

The "Generate Overview" provides general information about the system deployment. This information is useful to quickly gather the system settings in production, for example when reporting a support case.

When clicking on the Generate Overview option:

This downloads a zip file containing an overview.txt file directly to the Downloads folder. The dump overview structure looks like this:

Overview
    Time        2016-09-18 14:05:16.101
    XAP GigaSpaces eXtreme Application Platform.
Provides a powerful solution for data processing, launching, and running digital services version ENTERPRISE
    Client      License Version=12;Type=type;Customer=customer;Expiration=never;Hash=hash
    Number of Machines 1
    Grid Components GSA Grid Service Agent.
This is a process manager that can spawn and manage Service Grid processes (Operating System level processes) such as The Grid Service Manager, The Grid Service Container, and The Lookup Service. Typically, the GSA is started with the hosting machine's startup. Using the agent, you can bootstrap the entire cluster very easily, and start and stop additional GSCs, GSMs and lookup services at will.(1), LUS Lookup Service.
This service provides a mechanism for services to discover each other. Each service can query the lookup service for other services, and register itself in the lookup service so other services may find it.(1), GSM Grid Service Manager.
This is is a service grid component that manages a set of Grid Service Containers (GSCs). A GSM has an API for deploying/undeploying Processing Units. When a GSM is instructed to deploy a Processing Unit, it finds an appropriate, available GSC and tells that GSC to run an instance of that Processing Unit. It then continuously monitors that Processing Unit instance to verify that it is alive, and that the SLA is not breached.(1), GSC(2)

Processing Units This is the unit of packaging and deployment in the GigaSpaces Data Grid, and is essentially the main GigaSpaces service. The Processing Unit (PU) itself is typically deployed onto the Service Grid. When a Processing Unit is deployed, a Processing Unit instance is the actual runtime entity. (none)

Hosts
    192.168.33.159[192.168.33.159] Cores [4]
        JVM Version Oracle Corporation Java HotSpot(TM) 64-Bit Server VM 1.8.0_71
        Utilization cpu[7.5%] memory[11GB (66%)] 
        GSA(1), LUS(1), GSM(1), GSC(2)
        GSCs
            GSC[54416] Heap: Init[512MB], Max[491MB], Used[82MB], Committed[491MB]
            GSC[54419] Heap: Init[512MB], Max[491MB], Used[98MB], Committed[491MB]
...

Dump File Structure

The dump file structure looks like this:

dump_file.zip

    gsa-10.10.10.249-23610--1284928573201
        network.txt
        summary.txt
        threads.txt
        logs
            2010-09-19~08.22-gigaspaces-gsa-10.10.10.249-23610.log

    gsc-10.10.10.249-23739--1284928573169
        network.txt
        summary.txt
        threads.txt
        logs
            2010-09-19~08.22-gigaspaces-gsc_1-10.10.10.249-23739.log
        processing-units
            space
                1
                    pu This is the unit of packaging and deployment in the GigaSpaces Data Grid, and is essentially the main GigaSpaces service. The Processing Unit (PU) itself is typically deployed onto the Service Grid. When a Processing Unit is deployed, a Processing Unit instance is the actual runtime entity..xml
                    spaces
                        space
                            summary.txt

    gsc-10.10.10.249-23766--1284928573079
        network.txt
        summary.txt
        threads.txt
        logs
            2010-09-19~08.22-gigaspaces-gsc_2-10.10.10.249-23766.log
        processing-units
            mirror
                1
                    pu.xml
                    spaces
                        mirror
                            summary.txt
            space
                1_1
                    pu.xml
                    spaces
                        space
                            summary.txt

    gsm-10.10.10.249-24112--1284928573193
        network.txt
        summary.txt
        threads.txt
        logs
            2010-09-19~08.22-gigaspaces-gsm_3-10.10.10.249-24112.log
    lus-10.10.10.249-24127--1284928573201
        network.txt
        summary.txt
        threads.txt
        logs
            2010-09-19~08.22-gigaspaces-lus_4-10.10.10.249-24127.log