Previous page

Next page

Locate page in Contents

Print this page

get_info

Summary:

Retrieves a Hardware Node or a Virtuozzo Container configuration information.

Request specification:

Name

Min/Max

Type

Description

get_info

 

 

 

{

 

 

 

eid

0..[]

eid_type

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.

config

0..1

none

Include this element to retrieve the Container configuration information. If the element is omitted, the output will contain only the basic information.

filter_config

0..1

 

Specify the configuration parameters that you want to be included in the output. The config element (above) must also be included in the request. If this element is omitted then all available configuration parameters will be retrieved.

{

 

 

 

<xs:any>

 

xs:any

A list containing the names of the configuration parameter to include in the output. For a list of the available parameters see env_configType structure (Hardware Node information), or venv_configType (Virtuozzo Container configuration).

}

 

 

 

}

 

 

 

Returns:

Name

Min/Max

Type

Description

env

0..[]

envType

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>

Please send us your feedback on this help page