Host Groups

_images/hostgroups.png

To define a Config, you will need 2 basic ingredients: Host Groups and Testspecs. A host group is a logical grouping of perfSONAR nodes, and you can reuse a single host group for multile Configs.

Click the large “+” (“Add New”) button to open a new host group dialog.

_images/hostgroup.png
  • Name: Name of the hostgroup

  • Service Type: You need to pick a service type for this hostgroup.

  • Admins: List of users who are admin of this hostgroup. Only admins can edit the hosts.

  • Hosts/Static

    Enter a hostname / service name to search from all available hosts that are currently cached from your service datasources. You can only select from hosts that provides the service that you have selected above.

  • Hosts/Dynamic

    Dynamic hostgroup allows you to construct a hostgroup that automatically updated based on your custom criteria and current list of hosts registered in your datasource. Please see below for more detail.

You can use host groups created by other users, but you can only edit ones with your name listed under Admins, unless you are a Super Admin.

Static Host Groups

A static hostgroup allows you to manually enter or select hosts to put in the group. In most environments, Static Host Groups are sufficient, and they are certainly simpler to set up, so unless you have a specific need for dynamic hostgroups, static is recommended.

Dynamic Host Groups

Dynamic Host Groups allow you to enter host selection criteria to be evaluated at runtime. This is useful if you want to construct a host group that changes its member based on the latest information from the global registry.

_images/dynamichosteditor.png

As you can see, dynamic Host Group editor will show a current list of hosts that matches the criteria - which may change over time.

Available Attributes inside the criteria editor

Inside the criteria editor, you can access service, and host object for each host. You can construct an arbitrary complex criteria in Javascript using this object (please see below for samples).

service object has following attributes

{
    "location": {
        "longitude": "9.9356",
        "latitude": "51.5339",
        "city": "Goettingen",
        "state": "Niedersachsen",
        "postal_code": "37077",
        "country": "DE"
    },
    "admins": ["lookup/person/b600b85a-f344-4f48-b8c8-4ea3016283d6"],
    "id": 13,
    "uuid": "7584634b-0434-4b1d-8d28-23e2cb065f7a.bwctl",
    "name": "GoeGrid bwctl",
    "type": "bwctl",
    "locator": "tcp://perfsonar01.goegrid.gwdg.de:4823",
    "lsid": "wlcg",
    "client_uuid": "7584634b-0434-4b1d-8d28-23e2cb065f7a",
    "sitename": "GoeGrid",
    "createdAt": "2016-01-23T03:18:28.253Z",
    "updatedAt": "2016-01-26T19:14:54.934Z",
    "ma": null,
}

You can also access host object which is sparsely populated (not all attributes are populated). Please see the Hosts tab in PWA UI for list of all information available.

{
    "info": {
        "hardware_processorcore": "1",
        "os_kernel": "2.6.32-642.13.1.el6.x86_64",
        "os_name": "Scientific Linux",
        "hardware_processorspeed": "2500.000 MHz",
        "os_version": "6.8",
        "bundle": "perfsonar-toolkit",
        "net_tcp_maxbuffer_recv": "124928 bytes",
        "net_tcp_autotunemaxbuffer_send": "4194304 bytes",
        "toolkitversion": "3.5.0.6",
        "hardware_cpuid": "Intel(R) Xeon(R) CPU E5-2670 v2 @ 2.50GHz",
        "hardware_processorcount": "1",
        "bundle_version": "3.5.0.6",
        "net_tcp_congestionalgorithm": "cubic",
        "net_tcp_autotunemaxbuffer_recv": "4194304 bytes",
        "hardware_memory": "1877 MB",
        "net_tcp_maxbuffer_send": "124928 bytes"
    },
    "communities": ["ATLAS", "GridKa", "WLCG"],
    "admins": null,
    "hostname": "se4.goegrid.gwdg.de",
    "toolkit_url": "auto",
    "no_agent": false,
    "ip": "134.76.97.128"
}

Sample Criteria

Select all hosts from ALGT2 site

if(service.sitename == "AGLT2") return true;

Select all hosts from US or Canada

if(host.info["location-country"] == "US" || host.info["location-country"] == "CA") return true;

Select all hosts from wlcg datasource

“wlcg” is from the datasource id that you have defined in the datasource.js

if(service.lsid == "wlcg") return true;

Select all hosts with hostname containing “cern.ch”

if(~host.hostname.indexOf("cern.ch")) return true;

Note

Not all hosts has hostname parameter. If you try to access an attribute that does not exist for a particular service, the criteria will throw an exception for that particular host, and such host will not be included in the hostgroup.

Select all hosts with toolkit version that starts with “3.5”

if(~host.info.toolkitversion.indexOf("3.5")) return true;

Select all hosts

Simply returning true will select all hosts with a specified service type from all datasources.

return true;

Select all hosts with more than 2GB of memory

var memory = parseInt(host.info.hardware_memory);
if(memory > 2000) return true;

Converting from Dynamic Host Group to Static Host Group

If you’d like to freeze the current search result produced by the dynamic hostgroup, you can simply click Static tab and it will copy the current criteria results to static list.

Please see Testspecs next.