Purpose:
The event reporter that notifies about changes in the environment configuration.
Event specification:
Substitution group: event_data
Name |
Min/Max |
Type |
|
|
Subscription name:
env_config_subscription
See subscribe
for more information about subscriptions.
Description:
This event triggers when the configuration of a server changes. The event reports configuration changes for every server that the Agent is aware of. If you subscribe for the event on the Master Node in a Virtuozzo group, you will receive the notifications about the configuration changes of every server in the entire group.
The env_config_event
element substitutes the event_data
element in the eventType
structure.
Example:
Input
Subscribing to the environment configuration change events.
<packet version="4.0.0" id="2">
<data>
<system>
<subscribe>
<name>env_config_subscription
</name>
</subscribe>
</system>
</data>
</packet>
Output
Subscription was a success.
<packet id="2" priority="0" version="4.0.0">
<origin>gend</origin>
<target>vzclient2</target>
<dst>
<director>gend</director>
</dst>
<data>
<system>
<ok/>
</system>
</data>
</packet>
Output
The following is a notification message received when one of the configuration of one of the Environments was manually changed. The message contains the environment ID that generated the event, the text message that may be presented to the user, and the event data (the new configuration information). Note that one of the target
elements contains the same value as the one we used in the name
element of the request, which is env_config_subscription
. Please also note that the inner data
structure contains the elements specific to this event type. In this particular case, this is the env_config_event
element.
<packet version="4.0.0" time="2006-08-12T08:53:16+0000">
<target>events_subscription</target>
<target>env_config_subscription</target>
<src>
<director>gend</director>
</src>
<data>
<event>
<eid>62ec514e-bc38-4aee-830d-cc802ee2aadd</eid>
<time>1155372796</time>
<source></source>
<category>env_config_subscription</category>
<sid>XXX</sid>
<data>
<env_config_event>
<eid>62ec514e-bc38-4aee-830d-cc802ee2aadd</eid>
<virtual_config>
<offline_management>1</offline_management>
<on_boot>0</on_boot>
<os_template>
<version>20060615</version>
<name>redhat-as3-minimal</name>
</os_template>
<ve_root>/vz/root/$VEID</ve_root>
<ve_private>/vz/private/$VEID</ve_private>
<address>
<ip>10.17.4.132</ip>
</address>
<address>
<ip>10.17.5.132</ip>
</address>
<hostname>myhost1</hostname>
<qos>
<id>avnumproc</id>
<hard>40</hard>
</qos>
<qos>
<id>cpuunits</id>
<hard>1000</hard>
</qos>
<qos>
<id>dcachesize</id>
<hard>1097728</hard>
<soft>1048576</soft>
</qos>
<qos>
<id>dgramrcvbuf</id>
<hard>132096</hard>
<soft>132096</soft>
</qos>
<!-- the rest of the QoSs are omitted for brevity -->
<veid>101</veid>
<type>virtuozzo</type>
<disabled>0</disabled>
Linux
<platform/>
<version>20060615</version>
<name>redhat-as3-minimal</name>
</os>
</virtual_config>
</env_config_event>
</data>
<info>
<message>RW52aXJvbWVudCAlZWlkJSBjb25maWcgY2hhbmdlZA==</message>
<name></name>
<translate/>
<parameter>
<message>NjJlYzUxNGUtYmMzOC00YWVlLTgzMGQtY2M4MDJlZTJhYWRk</message>
<name>eid</name>
</parameter>
</info>
</event>
</data>
</packet>