lcfg-sysinfo - System Information
This documentation refers to lcfg-sysinfo version 1.0.0
This is an LCFG virtual component which is used to store per-host system information. It is designed to contain generic information which is not associated with any specific aspect or service (e.g. apache) on a machine.
This documentation only describes the resources available. See the SEE ALSO section below for details on how to query the information.
The sysinfo component has a set of resources which represent aspects of a machine covering the associated people, the operating system, and the paths to the various standard LCFG locations.
The list of resources has evolved over many years of usage within the Edinburgh University School of Informatics and as such may not include what you need, if there is something for which you would like support added then get in touch with us.
This is the hostname for the machine. The default value is taken from the value of the profile.node resource.
This is the domain for the machine. The default value is taken from the value of the profile.domain resource.
This is a string representing the manager (i.e. sysadmin) for the
machine. There is no default value but this string can be set via the
_ADMIN macro in an LCFG profile.
This is a string representing the user to which the machine has been allocated. There is no default value.
This is a string representing the owner for the machine. This may be
the same as the allocated field but often a machine is owned by a
particular organisation and allocated to an individual within that
organisation. There is no default value but this string can be set via
the _ORG macro in an LCFG profile.
This is a string which holds the serial number for the machine. There is no default value.
This is a string which holds the model type for the machine. There is
no default value but if you also use the standard LCFG hardware
headers (e.g. lcfg/hw/dell_optiplex_755.h) it will be set
automatically.
This is a string which holds information on the location of the
machine. There is no default value but this string can be set via the
_LOCATION macro in an LCFG profile.
This is a string which can hold any comments you want to associate with the machine. There is no default value.
This string holds information on the release and version of the LCFG
headers currently being used. The default value of the release part is
taken from the value of the profile.release resource and the
version part is taken from the LCFG_RELEASE_VERSION macro, the two
parts are separated with a forward-slash.
This is a string which holds a short identification name (e.g. ``sl5'')
for the particular distribution of the operating system being
used. There is no default value but this string can be set via the
OS_ID macro, if you use the standard LCFG operating-system headers
(e.g. lcfg/os/sl5.h) it will be set automatically.
This is a string which holds the name (e.g. ``linux'') for the operating
system being used. There is no default value but this string can be
set via the OS_NAME macro, if you use the standard LCFG
operating-system headers (e.g. lcfg/os/sl5.h) it will be set
automatically.
This is a string which holds a the version (e.g. ``scientific'') of the
operating system being used. There is no default value but this string
can be set via the OS_VERSION macro, if you use the standard LCFG
operating-system headers (e.g. lcfg/os/sl5.h) it will be set
automatically.
This is a string which holds the version number (e.g. ``5'') for the
particular distribution of the operating system being used. There is
no default value but this string can be set via the OS_RELEASE
macro, if you use the standard LCFG operating-system headers
(e.g. lcfg/os/sl5.h) it will be set automatically.
This is a string which holds the architecture (e.g. i386) for the
operating system being used. There is no default value but this string
can be set via the ARCH_NAME macro, if you use the standard LCFG
operating-system headers (e.g. lcfg/os/sl5.h) it will be set
automatically.
This resource holds the list of sysinfo resources which should be
displayed on the LCFG server status web pages for this particular
host. The order within the list controls the order in which the
resources appear on the page. Aliases can be given to improve the
presentation of the short resource names. An alias should be put in
front of the resource name, separated with an equals sign (=). Spaces
can be created using the tilde character (~). For example,
Serial~No=sno would present the value of the serial number resource
with the title ``Serial No''. The default value for this resource is
model location Serial~No=sno allocated manager owner OS=os_id
Release~Version=release_version
This is an LCFG tag list with each key representing a standard LCFG path. By default the following paths are defined: lcfglib, lcfgdata, lcfgbin, lcfgsbin, lcfgcomp, lcfgvar, lcfgstatus, lcfglog, lcfglock, lcfgrotated, lcfgtmp, lcfgconf, lcfgpod, lcfgom
This resource contains the value for the path associated with a
particular key. For example, sysinfo.path_lcfglib is
/usr/lib/lcfg on a standard LCFG linux machine.
There is a a Perl interface for querying the LCFG system information,
see the LCFG::SysInfo manpage for details. For Perl-based LCFG components it
can also be queried via the GetSysInfo helper method in
the LCFG::Component manpage. For shell-bashed LCFG components it can be queried
via the GetSysInfo and GetSysPath functions in lcfg-ngeneric(8).
This is the list of platforms on which we have tested this software. We expect this software to work on any Unix-like platform which is supported by Perl.
Fedora3, Solaris9, Fedora5, Fedora6, ScientificLinux5
Stephen Quinney <squinney@inf.ed.ac.uk>
Copyright (C) 2008 University of Edinburgh. All rights reserved.
This library is free software; you can redistribute it and/or modify it under the terms of the GPL, version 2 or later.