Reference for RimuHosting's Data Structures (as used in our REST-ful APIs)

Name: HostServerInfo

Information about a host server, including its capabilities.

XML Example:
<HostServerInfo>
  <cpu_model_name>xsd:string</cpu_model_name>
  <default_kernel_i386>xsd:string</default_kernel_i386>
  <default_kernel_x86_64>xsd:string</default_kernel_x86_64>
  <host_mem_mb_free>xsd:long</host_mem_mb_free>
  <host_mem_mb_total>xsd:long</host_mem_mb_total>
  <host_num_cores>xsd:int</host_num_cores>
  <host_uptime_s>xsd:long</host_uptime_s>
  <host_xen_version>xsd:string</host_xen_version>
  zero or N[<hostload>xsd:float</hostload>]
  <is_host64_bit_capable>xsd:boolean</is_host64_bit_capable>
  <running_vpss>xsd:int</running_vpss>
</HostServerInfo>
JSON Example:
{"HostServerInfo":
 {
   "cpu_model_name": String,
   "default_kernel_i386": String,
   "default_kernel_x86_64": String,
   "host_mem_mb_free": Number,
   "host_mem_mb_total": Number,
   "host_num_cores": Number,
   "host_uptime_s": Number,
   "host_xen_version": String,
   "hostload": [Number],
   "is_host64_bit_capable": Boolean,
   "running_vpss": Number,
 }
}

Elements
NameTypeRequiredNillableDefault ValueDescription
cpu_model_namexsd:stringfalsefalseFor example 'Core 2 some model or another'
default_kernel_i386xsd:stringfalsefalseThe default kernel set on the server for i386 architectures.
default_kernel_x86_64xsd:stringfalsefalseThe default kernel set on the server for x86_64 architectures.
host_mem_mb_freexsd:longfalsefalseThe memory on the host server available to be allocated to VPSs.  Note that RimuHosting may reserve memory on the host.  So you may not be able to add all of this memory to your VPS.  e.g.
host_mem_mb_totalxsd:longfalsefalseThe memory size of the server.  Older/smaller shared hosts are typically 2-8GB.  Newer host servers have 72GB of memory or more.
host_num_coresxsd:intfalsefalseThe number of CPUs on the host server times the number of cores per CPU.
host_uptime_sxsd:longfalsefalseHow long the host server has been up and running, in seconds.  Typically host servers run until it is prudent to put a new version of the Xen hypervisor on them.  Or if they hit a hardware error.
host_xen_versionxsd:stringfalsefalseThe version of the Xen hypervisor on the host server.
hostloadzero or N[xsd:float]falsefalseThe minutely, 5 minutely and 15 minutely load on the host server.  You would typically want this to be as low as possible.  When it gets higher (e.g.
is_host64_bit_capablexsd:booleanfalsefalseWhether the host server can run VPSs with 64 bit kernels.
running_vpssxsd:intfalsefalseThe VPSs running on the host server.  Typically a host server can be very responsive with 6-16 VPS per host server CPU core.