HP BL680c XenServer Administrator's Guide 4.1.0 - Page 66

host-get-system-status, 4.5.12. host-get-system-status-capabilities

Page 66 highlights

Command line interface The xapi agent forgets about the specified XenServer Host without contacting it explicitly. Tip This command is useful if the XenServer Host to "forget" is dead; however, if the XenServer Host is live and part of the pool, you should use xe pool-eject instead. 5.4.5.11. host-get-system-status host-get-system-status filename=name for status file [entries=comma-separated list ] [output=tar.bz2 | zip ] [ host-selector=host-selector value...] Download system status information into the specified file. The optional parameter entries is a comma-separated list of system status entries, taken from the capabilities XML fragment returned by the hostget-system-status-capabilities command. See Section 5.4.5.12, "host-get-system-status-capabilities" for details. If not specified, all system status information is saved in the file. The parameter output may be tar.bz2 (the default) or zip; if this parameter is not specified, the file is saved in tar.bz2 form. The host(s) on which this operation should be performed are selected via the standard selection mechanism (see host selectors above). 5.4.5.12. host-get-system-status-capabilities host-get-system-status-capabilities [ host-selector=host-selector value...] Get system status capabilities for the specified host(s). The capabilities are returned as an XML fragment that looks something like this: ... Each capability entity has a number of attributes. Attribute key content-type default-checked min-size, max-size min-time, max-time Description A unique identifier for the capability. Can be either text/plain or application/data. Indicates whether a UI can render the entries for human consumption. Can be either yes or no. Indicates whether a UI should select this entry by default. Indicates an approximate range for the size, in bytes, of this entry. -1 indicates that the size is unimportant. 60

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108

Command line interface
60
The xapi agent forgets about the specified XenServer Host without contacting it explicitly.
Tip
This command is useful if the XenServer Host to "forget" is dead; however, if the XenServer Host
is live and part of the pool, you should use
xe pool-eject
instead.
5.4.5.11. host-get-system-status
host-get-system-status
filename=
name for status file
[entries=
comma-separated list
]
[output=
tar.bz2 | zip
] [
host-selector
=
host-selector value
...]
Download system status information into the specified file. The optional parameter
entries
is a com-
ma-separated list of system status entries, taken from the capabilities XML fragment returned by the
host-
get-system-status-capabilities
command. See Section 5.4.5.12, “host-get-system-status-capabilities” for
details. If not specified, all system status information is saved in the file. The parameter
output
may be
tar.bz2
(the default) or
zip
; if this parameter is not specified, the file is saved in
tar.bz2
form.
The host(s) on which this operation should be performed are selected via the standard selection mechanism
(see host selectors above).
5.4.5.12. host-get-system-status-capabilities
host-get-system-status-capabilities
[
host-selector
=
host-selector value
...]
Get system status capabilities for the specified host(s). The capabilities are returned as an XML fragment
that looks something like this:
<?xml version="1.0" ?>
<system-status-capabilities>
<capability content-type="text/plain" default-checked="yes" key="xenserver-logs"
\
max-size="150425200" max-time="-1" min-size="150425200" min-time="-1" \
pii="maybe"/>
<capability content-type="text/plain" default-checked="yes" \
key="xenserver-install" max-size="51200" max-time="-1" min-size="10240" \
min-time="-1" pii="maybe"/>
...
</system-status-capabilities>
Each capability entity has a number of attributes.
Attribute
Description
key
A unique identifier for the capability.
content-type
Can be either
text/plain
or
application/data
. Indicates
whether a UI can render the entries for human
consumption.
default-checked
Can be either
yes
or
no
. Indicates whether a UI should
select this entry by default.
min-size, max-size
Indicates an approximate range for the size, in bytes, of
this entry.
-1
indicates that the size is unimportant.
min-time, max-time