Summary:
Retrieves a Hardware Node or a Virtuozzo Container configuration information.
Request specification:
Name |
Min/Max |
Type |
Description |
|
|
|
|
|
|
|
|
|
|
Server ID. When retrieving information for a Hardware Node, this element may be omitted. When retrieving information for a Virtuozzo Container, specify its Server ID, or omit the element to retrieve information for all Containers on the current host. |
|
|
|
|
Include this element to retrieve the Container configuration information. If the element is omitted, the output will contain only the basic information. |
|
|
|
Specify the configuration parameters that you want to be included in the output. The |
|
|
|
|
|
|
|
A list containing the names of the configuration parameter to include in the output. For a list of the available parameters see |
|
|
|
|
|
|
|
|
Returns:
Name |
Min/Max |
Type |
Description |
|
|
Configuration information. |
Description:
The call is available in the base envm
interface and in its descendant, the vzaenvm
interface. Use the envm
interface to retrieve the information for the Hardware Node that you are currently connected to. Use the vzaenvm
interface to get the information for a particular Virtuozzo Container.
When retrieving information for a Virtuozzo Container, the output will contain the Container virtual configuration information. Most of the configuration parameters are optional, so some may not be included in the output structure. If a parameter is not included, it means that its default value is currently used. To determine the default value, first use the envm/get_vt_setting
call. If you don't see the parameter in the output, then, depending on the parameter data type, the default value is determined as follows:
Data Type |
Default Value |
boolean |
false |
string |
Empty string |
int |
0 or maxint |
Example:
Retrieving information for the Hardware Node.
Input
<packet version="4.0.0" id="2">
<target>envm</target>
<data>
<envm>
<get_info>
<config/>
</get_info>
</envm>
</data>
</packet>
Output
<?xml version="1.0" encoding="UTF-8"?><packet xmlns:ns2="http://www.swsoft.com/webservices/vzl/4.0.0/types" xmlns:ns1="http://www.swsoft.com/webservices/vzl/4.0.0/envm" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" time="2007-11-21T07:10:35+0000" id="8c4747000ct18ber448" priority="0" version="4.0.0">
<origin>envm</origin>
<target>vzclient6-a0f0a8d0-6c35-c64b-8f16-c1f0e13295c6</target>
<dst>
<director>gend</director>
</dst>
<data>
<envm>
<env xsi:type="ns2:envType">
<parent_eid>00000000-0000-0000-0000-000000000000</parent_eid>
<eid>a0f0a8d0-6c35-c64b-8f16-c1f0e13295c6</eid>
<status xsi:type="ns2:env_statusType">
<state>6</state>
</status>
<alert>0</alert>
<config xsi:type="ns2:env_configType">
<type>generic</type>
<os xsi:type="ns2:osType">
<platform>Linux</platform>
<kernel>2.6.18-028stab049.1</kernel>
<name>Red Hat Enterprise Linux Server release 5 (Tikanga)</name>
</os>
<architecture>i386</architecture>
<hostname>dhcp-10-30-22-205.sw.ru</hostname>
<name>dhcp-10-30-22-205.sw.ru</name>
<address>
<ip>10.30.22.205</ip>
</address>
<nameserver>10.30.0.1</nameserver>
</config>
<virtual_config xsi:type="ns2:venv_configType"/>
</env>
</envm>
</data>
<src>
<director>gend</director>
</src>
</packet>
Example:
Retrieving information for a Virtuozzo Container.
Input
<packet version="4.0.0" id="2">
<target>vzaenvm</target>
<data>
<vzaenvm>
<get_info>
<eid>a5961178-14d2-40cc-b1e7-41b562a2f4c6</eid>
<config/>
</get_info>
</vzaenvm>
</data>
</packet>
Output
<ns1:packet priority="0" version="4.0.0">
<ns1:origin>vzaenvm</ns1:origin>
<ns1:target>vzclient5</ns1:target>
<ns1:data>
<ns2:vzaenvm>
<ns2:env xsi:type="ns3:envType">
<ns3:parent_eid>89e27960-97b8-461f-902f-557b4b16784b</ns3:parent_eid>
<ns3:eid>3e25fee2-1163-4336-9e74-8b8097936d47</ns3:eid>
<ns3:status xsi:type="ns3:env_statusType">
<ns3:state>6</ns3:state>
</ns3:status>
<ns3:alert>0</ns3:alert>
<ns3:config xsi:type="ns3:env_configType"/>
<ns3:virtual_config xsi:type="ns4:venv_configType">
<ns3:hostname>myhost</ns3:hostname>
<ns3:name>Mycomputer</ns3:name>
<ns3:offline_management>1</ns3:offline_management>
<ns3:on_boot>1</ns3:on_boot>
<ns3:os_template>
<ns3:version>20061020</ns3:version>
<ns3:name>redhat-as3-minimal</ns3:name>
</ns3:os_template>
<ns3:ve_root>/vz/root/$VEID</ns3:ve_root>
<ns3:ve_private>/vz/private/$VEID</ns3:ve_private>
<ns3:ve_type>
<ns3:veid>0</ns3:veid>
<ns3:type>1</ns3:type>
</ns3:ve_type>
<ns3:qos>
<ns3:id>avnumproc</ns3:id>
<ns3:hard>40</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>cpuunits</ns3:id>
<ns3:hard>1000</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>dcachesize</ns3:id>
<ns3:hard>1097728</ns3:hard>
<ns3:soft>1048576</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>dgramrcvbuf</ns3:id>
<ns3:hard>132096</ns3:hard>
<ns3:soft>132096</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>diskinodes</ns3:id>
<ns3:hard>220000</ns3:hard>
<ns3:soft>200000</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>diskspace</ns3:id>
<ns3:hard>1153434</ns3:hard>
<ns3:soft>1048576</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>kmemsize</ns3:id>
<ns3:hard>2936012</ns3:hard>
<ns3:soft>2752512</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>lockedpages</ns3:id>
<ns3:hard>32</ns3:hard>
<ns3:soft>32</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>numfile</ns3:id>
<ns3:hard>2048</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>numflock</ns3:id>
<ns3:hard>110</ns3:hard>
<ns3:soft>100</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>numiptent</ns3:id>
<ns3:hard>128</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>numothersock</ns3:id>
<ns3:hard>80</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>numproc</ns3:id>
<ns3:hard>65</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>numpty</ns3:id>
<ns3:hard>16</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>numsiginfo</ns3:id>
<ns3:hard>256</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>numtcpsock</ns3:id>
<ns3:hard>80</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>oomguarpages</ns3:id>
<ns3:hard>2147483647</ns3:hard>
<ns3:soft>6144</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>othersockbuf</ns3:id>
<ns3:hard>336896</ns3:hard>
<ns3:soft>132096</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>physpages</ns3:id>
<ns3:hard>2147483647</ns3:hard>
<ns3:soft>0</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>privvmpages</ns3:id>
<ns3:hard>24576</ns3:hard>
<ns3:soft>22528</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>quotatime</ns3:id>
<ns3:hard>0</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>shmpages</ns3:id>
<ns3:hard>8192</ns3:hard>
</ns3:qos>
<ns3:qos>
<ns3:id>tcprcvbuf</ns3:id>
<ns3:hard>524288</ns3:hard>
<ns3:soft>319488</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>tcpsndbuf</ns3:id>
<ns3:hard>524288</ns3:hard>
<ns3:soft>319488</ns3:soft>
</ns3:qos>
<ns3:qos>
<ns3:id>vmguarpages</ns3:id>
<ns3:hard>2147483647</ns3:hard>
<ns3:soft>6144</ns3:soft>
</ns3:qos>
<ns3:veid>101</ns3:veid>
<ns3:type>virtuozzo</ns3:type>
<ns3:offline_service>vzpp</ns3:offline_service>
<ns3:offline_service>vzpp-plesk</ns3:offline_service>
<ns3:os xsi:type="ns3:osType">
<ns3:platform>Linux</ns3:platform>
<ns3:kernel>2.6.9-023stab033.6</ns3:kernel>
<ns3:version>20061020</ns3:version>
<ns3:name>redhat-as3-minimal</ns3:name>
</ns3:os>
<ns3:net_device xsi:type="ns4:net_vethType">
<ns3:id>venet0</ns3:id>
<ns3:ip_address>
<ns3:ip>10.100.23.203</ns3:ip>
</ns3:ip_address>
<ns4:host_routed/>
</ns3:net_device>
<ns3:address>
<ns3:ip>10.100.23.203</ns3:ip>
</ns3:address>
</ns3:virtual_config>
</ns2:env>
</ns2:vzaenvm>
</ns1:data>
</ns1:packet>