node

allowed_networks

scopable

False

required

False

default

10.0.0.0/8 172.16.0.0/24 192.168.0.0/16

scope order

specific > generic

convert

list

The list of cidr blocks the agents allows creation of backend network into. Should be restricted to match your site constraints.

asset_env

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

branch

scopable

False

required

False

default

None

scope order

specific > generic

Set the targeted opensvc agent branch. The downloaded upgrades will honor that branch. If not set, the repopkg imposes the target branch, which is not recommended with a public repopkg.

dbcompliance

scopable

False

required

False

default

Same protocol, server and port as dbopensvc, but with an different path.

scope order

specific > generic

Set the uri of the collector’s main xmlrpc server. The path part of the uri can be left unspecified.

dblog

scopable

False

required

False

default

True

scope order

specific > generic

convert

boolean

If true and dbopensvc is set, the objects action logs are reported to the collector. Set to false to disable log reporting to the collector, event if dbopensvc is set.

dbopensvc

scopable

False

required

False

default

None

scope order

specific > generic

Set the uri of the collector main xmlrpc server. The path part of the uri can be left unspecified. If not set, the agent does not try to communicate with a collector.

env

scopable

False

required

False

default

TST

scope order

specific > generic

candidates

CERT | DEV | DRP | FOR | INT | PRA | PRD | PRJ | PPRD | QUAL | REC | STG | TMP | TST | UAT

A non-PRD service can not be brought up on a PRD node, but a PRD service can be startup on a non-PRD node (in a DRP situation).

loc_addr

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_building

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_city

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_country

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_floor

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_rack

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_room

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

loc_zip

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

maintenance_grace_period

scopable

False

required

False

default

60

scope order

specific > generic

convert

duration

A duration expression, like 1m30s, defining how long the daemon retains a remote in-maintenance (daemon restart or upgrade) node data. The maintenance state is announced to peers on daemon stop and daemon restart. The upgrade state is announced to peers on daemon stop for upgrade. The maintenance grace period does not apply to shutdown state. As long as the remote node data are retained, the local daemon won’t try to takeover its running instances. This parameter should be adjusted to span the daemon restart time.

max_parallel

scopable

False

required

False

default

10

scope order

specific > generic

convert

integer

Allow a maximum of max_parallel subprocesses to run simultaneously on om <selector> –parallel <action> commands.

min_avail_mem

scopable

False

required

False

default

2%

scope order

specific > generic

convert

size

The minimum required available memory to allow orchestration.

min_avail_swap

scopable

False

required

False

default

10%

scope order

specific > generic

convert

size

The minimum required available swap to allow orchestration.

pkg_format

scopable

False

required

False

default

auto

scope order

specific > generic

candidates

tar | auto

Force usage of a package format. Only the tar format can be forced.

ready_period

scopable

False

required

False

default

5

scope order

specific > generic

convert

duration

A duration expression, like 10s, defining how long the daemon monitor waits before starting a service instance in ready state. A peer node can preempt the start during this period. Usually set to allow at least a couple of heartbeats to be received.

rejoin_grace_period

scopable

False

required

False

default

90

scope order

specific > generic

convert

duration

A duration expression, like 90m, defining how long the daemon restrains from taking start decisions if no heartbeat has been received from a peer since daemon startup. This should be adjusted to the maximum delay you can afford to give a chance to services to start on their placement leader after a simultaneous node reboot.

repo

scopable

False

required

False

default

None

scope order

specific > generic

Set the uri of the opensvc agent package repository and compliance modules gzipped tarball repository. This parameter is used by the om node updatepkg and om node updatecomp commands.

Expected repository structure:

ROOT
+- compliance
 +- compliance-100.tar.gz
 +- compliance-101.tar.gz
 +- current -> compliance-101.tar.gz
+- packages
 +- deb
 +- depot
 +- pkg
 +- sunos-pkg
 +- rpms
  +- current -> 2.0/current
  +- 1.9
   +- current -> opensvc-1.9-50.rpm
   +- opensvc-1.9-49.rpm
   +- opensvc-1.9-50.rpm
  +- 2.0
   +- current -> opensvc-2.0-90.rpm
   +- opensvc-2.0-90.rpm
 +- tbz

repocomp

scopable

False

required

False

default

None

scope order

specific > generic

Set the uri of the opensvc compliance modules gzipped tarball repository. This parameter is used by the om node updatecomp command.

Expected repository structure:

ROOT
+- compliance-100.tar.gz
+- compliance-101.tar.gz
+- current -> compliance-101.tar.gz

repopkg

scopable

False

required

False

default

None

scope order

specific > generic

Set the uri of the opensvc agent package repository. This parameter is used by the om node updatepkg command.

Expected repository structure:

ROOT
+- deb
+- depot
+- pkg
+- sunos-pkg
+- rpms
 +- current -> 2.0/current
 +- 1.9
  +- current -> opensvc-1.9-50.rpm
  +- opensvc-1.9-49.rpm
  +- opensvc-1.9-50.rpm
 +- 2.0
  +- current -> opensvc-2.0-90.rpm
  +- opensvc-2.0-90.rpm
+- tbz

ruser

scopable

False

required

False

default

root

scope order

specific > generic

Set the remote user to use to login to a remote node with ssh and rsync. The remote user must have the privileges to run as root the following commands on the remote node: * om * rsync The default ruser is root for all nodes. ruser accepts a list of user[@node] … If @node is ommited, user is considered the new default user.

sec_zone

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

secure_fetch

scopable

False

required

False

default

True

scope order

specific > generic

convert

boolean

If set to false, disable ssl authentication checks on all uri fetches.

split_action

scopable

False

required

False

default

crash

scope order

specific > generic

candidates

crash | reboot

Commit suicide method when cluster split occur. Default is crash. reboot method may be used instead of crash when it is not simple to poweron node after crash.

team_integ

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.

team_support

scopable

False

required

False

default

None

scope order

specific > generic

An asset information to push to the collector on pushasset, overriding the currently stored value.