• Reference
• /
• Functions
• /
• hubknowledge

hubknowledge

This function is only available in CFEngine Enterprise.

Prototype:hubknowledge(id)

Return type:string

The return value iscached.

Description: Read global knowledge from the CFEngine Database host byid.

This function allows for is intended for use in distributed orchestration.If the identifier matches a persistent scalar variable (such as is used tocount distributed processes in CFEngine Enterprise) then this will be returnedpreferentially. If no such variable is found, then the server will look for aliteral string in a server bundle with a handle that matches the requested object.

It is recommended that you use this function sparingly, using classes as guards,as it contributes to network traffic and depends on the network for its function.Unlikeremotescalar(), the result ofhubknowledge() is not stored locally.

This function behaves similarly to theremotescalar() function, except that italways gets its information from the CFEngine Enterprise Database by an encryptedconnection. It is designed for spreading globally calibrated information abouta CFEngine system back to the client machines. The data available through thischannel are generated automatically by discovery, unlikeremotescalar whichaccesses user defined data.

Arguments:

• id:string - Variable identifier - in the range:[a-zA-Z0-9_$(){}\[\].:]+

Example:

vars:guard::"global_number"string=>hubknowledge("number_variable");

See also:remotescalar(),remoteclassesmatching(),hostswithclass()

Still need help?

Chat

Ask a question on Github

Mailing list