services.xml - 'admin'

Reference documentation for <admin> in services.xml.

admin [version]
  adminserver [hostalias, baseport, jvmargs]
  cluster-controllers
    cluster-controller [hostalias, baseport, jvmargs]
  configserver [hostalias, baseport, jvmargs]
  configservers
    configserver [hostalias, baseport, jvmargs]
  logserver
  slobroks
    slobrok [hostalias, baseport, jvmargs, index]
  filedistribution
    downloadbitrate
    uploadbitrate
  monitoring
    interval
    systemname

Attributes:

NameRequiredValueDefaultDescription
version required number 2.0 in this version of Vespa
Example:
<admin version="2.0">
  <adminserver hostalias="node0" />
  <configservers>
    <configserver hostalias="node1" />
    <configserver hostalias="node2" />
    <configserver hostalias="node3" />
  </configservers>
  <logserver hostalias="node1" />
  <slobroks>
    <slobrok hostalias="node1" />
    <slobrok hostalias="node2" />
    <slobrok hostalias="node3" />
  </slobroks>
</admin>

adminserver

The configured node will be the default administration node in your Vespa system, which means that unless configured otherwise all administrative services - i.e. the log server, the configuration server, the slobrok, and so on - will run on this node. Attributes:

NameRequiredValueDefaultDescription
hostalias required string
baseport optional number
jvmargs optional string

cluster-controllers

Container for one or more cluster-controller elements. When having one or more content clusters, configuring at least one cluster controller is required. Attributes:

NameRequiredValueDefaultDescription
standalone-zookeeper optional true/false false Will by default share the ZooKeeper instance with configserver. If configured to true a separate ZooKeeper instance will be configured and started on the set of nodes where you run cluster controller on. The set of cluster controllers nodes cannot overlap with the set of nodes where config server is running. If this setting is changed from false to true in a running system all previous cluster state information will be lost as the underlaying ZooKeper changes. Cluster controllers will re-discover the state, but nodes that have been manually set as down will again be considered to be up.

cluster-controller

Specifies a host on which to run the Cluster Controller service. The Cluster Controller manages the state of the cluster in order to provide elasticity and failure detection. Attributes:

NameRequiredValueDefaultDescription
hostalias required string
baseport optional number
jvmargs optional string
Example:
<cluster-controllers standalone-zookeeper="true">
  <cluster-controller hostalias="node1" />
  <cluster-controller hostalias="node2" />
  <cluster-controller hostalias="node3" />
</cluster-controllers>

configservers

Container for one or more configserver elements.

configserver

Specifies a host on which to run the Configuration Server service. If contained directly below <admin> you may only have one, so if you need to configure multiple instances of this service, contain them within the <configservers> element. Attributes:

NameRequiredValueDefaultDescription
hostalias required string
baseport optional number
jvmargs optional string
Example:
<configservers>
  <configserver hostalias="node1" />
  <configserver hostalias="node2" />
  <configserver hostalias="node3" />
</configservers>

logserver

Specifies a host on which to run the Vespa Log Server service. Attributes:

NameRequiredValueDefaultDescription
hostalias required string
baseport optional number
jvmargs optional string
Example:
<logserver hostalias="node1" />

slobroks

This is a container for one or more slobrok elements.

slobrok

Specifies a host on which to run the Service Location Broker (slobrok) service. Attributes:

NameRequiredValueDefaultDescription
hostalias required string
baseport optional number
jvmargs optional string
index Number
Example:
<slobroks>
  <slobrok hostalias="node1" baseport="12345" index="1" />
  <slobrok hostalias="node2" baseport="12345" index="2" />
  <slobrok hostalias="node3" baseport="12345" index="3" />
</slobroks>

filedistribution

Settings for file distribution. Example:

<filedistribution>
  <downloadbitrate>1024k</downloadbitrate>
  <uploadbitrate>4.5M</uploadbitrate>
</filedistribution>
downloadbitrate Download bitrate for file distribution. DEPRECATED.
uploadbitrate Upload bitrate for file distribution. DEPRECATED.

monitoring

Settings for how to pass metrics to a monitoring service

<monitoring>
  <interval>1</interval>
  <systemname>name-in-metrics-system</systemname>
</monitoring>
interval The rate at which metrics are passed to the monitoring system, in minutes
systemname The name of the application in question in the monitoring system