Service Grid Configuration Files

Added by Gilad David Maayan, last edited by Aleia Hutcherson on Jun 30, 2008  (view change)
  GigaSpaces 5.X

Documentation Home
Quick Start Guide
Release Notes

Previous release
  Search Here
Searching GigaSpaces Platform 5.X Documentation

                                               
Summary: Main parameters of services.config: GSM, GSC, LUS configuration, and compute resource settings.

Overview

The Service Grid has two main configuration files.

Filename Location Description
services.config <GigaSpaces Root>/ServiceGrid/config/services/ Defines configuration for the Grid Service Container (GSC), Grid Service Manager (GSM), and Lookup Service (LUS), and the compute resource participating in the service grid.
adminui.config <GigaSpaces Root>/ServiceGrid/config/tools/ Defines configuration for the Service Grid Admin UI.


These configuration files are based on the Jini configuration specification, a Java-based syntax that provides strict type definition and runtime configuration capabilities.

Currently, only services.config is documented in this page.

services.config

GSC Configuration

com.gigaspaces.grid.gsc {
    initialLookupGroups =
        org.jini.rio.boot.BootUtil.toArray("${com.gigaspaces.grid.groups}");
    serviceName = "Grid Service Container";
    serviceComment = "GigaSpace Technologies Dynamic Grid Service Container";
    provisionEnabled = Boolean.valueOf(true);
    opStringName = "Service Grid";
 
    nativeLibDirectory = new String[]{
                             "${com.gigaspaces.grid.home}${/}lib${/}native"
                         };
 
    //initialServices = new String[] {"../config/deployment/GigaSpacesService.xml"};
    //initialSpaces = new String[] {"/./NY?schema=cache"};
 
    /* Declare logging levels and handlers */
    loggerConfigs = new LoggerConfig[] {
                        ...
    };
}
Parameter Default Value Description
initialLookupGroups gs_grid Read by a Grid Service Container at initialization, to determine the initial set of specific lookup services the Grid Service Container should register with. Any future changes to the set of discovery groups should be made via Grid Service Container's admin proxy, using the JoinAdmin interface.
serviceName Grid Service Container The name the Grid Service Container should use as a Name Entry, and for display purposes.
provisionEnabled False ServiceBean instances may require external software to be resident on the compute resource the Grid Service Container represents. Setting this property allows the Grid Service Container to install external software defined by ServiceBeans.
opStringName "" The name of the deployment descriptor the Grid Service Container is a part of.
nativeLibDirectory   The default directory to load native libraries from is <gigaspaces-home-directory>/native. The Grid Service Container home directory is determined by the system property com.gigaspaces.grid.gsc.home. If this property does not exist, the default location is <User Home Directory>/.gigaspaces/native.
loggerConfigs   The LoggerConfig class declares a configuration attribute that specifies Logger attributes (Level, Handler, etc.), which are not dependent on the machine-resident logger.properties configuration attributes.
For more details on the GSC configuration, see Javadoc.

GSM Configuration

org.jini.rio.monitor {
    /* Set the groups to join */
    initialLookupGroups =
        org.jini.rio.boot.BootUtil.toArray("${com.gigaspaces.grid.groups}");
    serviceName = "Grid Service Manager";
    serviceComment = "Grid Service Management";
    opStringName = "Service Grid";
 
    /* Declare logging levels and handlers */
    loggerConfigs = new LoggerConfig[] {
            ...      
    };
   
    /* Configure a FaultDetectionHandler for the Grid Service Monitor */
    fdh = "org.jini.rio.resources.client.HeartbeatFaultDetectionHandler";
    configArg = new Object[]{ new String[]{"-"} };
    faultDetectionHandler =
        new org.jini.rio.core.ClassBundle(fdh,
                                          null,  // load from classpath
                                          new String[]{"setConfiguration"},
                                          new Object[]{ configArg });
}
Parameter Default Value Description
initialLookupGroups gs_grid Read by a Grid Service Manager at initialization, to determine the initial set of specific lookup services the Grid Service Manager should register with. Any future changes to the set of discovery groups should be made via the Grid Service Manager's admin proxy using the JoinAdmin interface.
serviceName "Grid Service Manager" The name of the service as it appears in the Admin UI.
opStringName null The name of the deployment descriptor that should be started upon startup.
loggerConfigs   Declares logging levels and handlers for subcomponents.
fdh   Fault Detection Handler. For more details, see Javadoc.

Lookup Service Configuration

com.sun.jini.reggie {
    initialMemberGroups =
         org.jini.rio.boot.BootUtil.toArray("${com.gigaspaces.grid.groups}"+" "+
                                            "${com.gs.jini_lus.groups}");
    unicastDiscoveryHost = org.jini.rio.boot.BootUtil.getHostAddress();
 
    initialLookupAttributes =
        new net.jini.core.entry.Entry[] {
            new net.jini.lookup.entry.Name("Lookup"),
            new org.jini.rio.entry.OperationalStringEntry("Service Grid")
        };
}
Parameter Description
initialMemberGroups The group this lookup will be part of.
initialLookupAttributes Attributes for this LUS.

Compute Resource Configuration

org.jini.rio.qos {
    host = org.jini.rio.boot.BootUtil.getHostAddress();
    address = java.net.InetAddress.getByName(host);
    systemCapabilitiesLoader =
        new com.gigaspaces.management.SystemCapabilities();
    reportInterval = 30000;
    /* Declare platform capabilities */
    platformCapabilities =
        new org.jini.rio.qos.capability.PlatformCapability[] {
            new SoftwareSupport (
                new Object[]{SoftwareSupport.DESCRIPTION,  "Jini",
                             SoftwareSupport.MANUFACTURER, "Sun Microsystems",
                             SoftwareSupport.VERSION,      "2.1"})
        };
}
Parameter Default Value Description
Host Hostname of the current machine The hostname of this machine.
Address The IP address of the current machine The IP address of this machine.
reportInterval Report every 30 seconds Specifies how often the compute resource informs registered Observers of a state change. A state change is determined if any of the MeasurableCapability components contained within this ComputeResource provide an update in the interval specified by the reportInterval property.

CPU measurement configuration

com.gigaspaces.management.system.cpu {
    /* Report every 10 seconds with a sample size of 2, which means a result
     * will be produced every 20 seconds */
    reportRate = 10000;
    sampleSize = 2;
}
Parameter Default Value Description
reportRate 10 [seconds] The rate at which the CPU is sampled.
sampleSize 2 Number of samples per measurement.
The effective reporting rate of the CPU utilization also depends on the reportInterval. The reportInterval determines the rate at which the measured samples are communicated to the Grid Server Manager (GSM). If the value is set to 30 seconds, the system samples the CPU utilization every 10 seconds (reportRate); two samples (sampleSize) are used to smooth the utilization curve.

RELATED TOPICS

Service Deployment Descriptor
Service Grid Configuration Files
Testing Service Grid Environment

Wiki Content Tree

Your Feedback Needed!

We need your help to improve this wiki site. If you have any suggestions or corrections, write to us at techw@gigaspaces.com. Please provide a link to the wiki page you are referring to.

Labels