com.eurotech.framework.system
Interface SystemService

All Known Implementing Classes:
SystemServiceImpl

public interface SystemService

Service to provide basic system information including Operating System information, JVM information and filesystem information.


Field Summary
static String CONFIG_CONSOLE_DEVICE_MANAGE_SERVICE_IGNORE
           
static String ESF_CONFIG
           
static String ESF_PROPS_FILE
           
static String KEY_BIOS_VERSION
           
static String KEY_DEVICE_NAME
           
static String KEY_ESF_DATA_DIR
           
static String KEY_ESF_HAVE_NET_ADMIN
           
static String KEY_ESF_HAVE_WEB_INTER
           
static String KEY_ESF_HOME_DIR
           
static String KEY_ESF_NAME
           
static String KEY_ESF_PLUGINS_DIR
           
static String KEY_ESF_SNAPSHOTS_COUNT
           
static String KEY_ESF_SNAPSHOTS_DIR
           
static String KEY_ESF_STYLE_DIR
           
static String KEY_ESF_TMP_DIR
           
static String KEY_ESF_VERSION
           
static String KEY_FILE_SEP
           
static String KEY_FIRMWARE_VERSION
           
static String KEY_JAVA_HOME
           
static String KEY_JAVA_VENDOR
           
static String KEY_JAVA_VERSION
           
static String KEY_JAVA_VM_INFO
           
static String KEY_JAVA_VM_NAME
           
static String KEY_JAVA_VM_VERSION
           
static String KEY_MODEL_ID
           
static String KEY_MODEL_NAME
           
static String KEY_OS_ARCH
           
static String KEY_OS_DISTRO
           
static String KEY_OS_DISTRO_VER
           
static String KEY_OS_NAME
           
static String KEY_OS_VER
           
static String KEY_OSGI_FW_NAME
           
static String KEY_OSGI_FW_VERSION
           
static String KEY_PART_NUMBER
           
static String KEY_PLATFORM
           
static String KEY_PRIMARY_NET_IFACE
           
static String KEY_SERIAL_NUM
           
static String OS_CLOUDBEES
           
static String OS_LINUX
           
static String OS_MAC_OSX
           
static String UNKNOWN
           
static String UNSUPPORTED
           
 
Method Summary
 String getBiosVersion()
          Gets the BIOS version of the device.
 org.osgi.framework.Bundle[] getBundles()
          Returns the OSGi bundles currently installed
 List<String> getDeviceManagementServiceIgnore()
          Returns a list of services that should be ignored by the Everyware Cloud Console
 String getDeviceName()
          Returns a friendly name assigned to this device.
 String getEsfDataDirectory()
          Gets the location where all ESF persistent data should be stored.
 String getEsfHome()
          Gets the location where the ESF root directory is stored in the filesystem.
 int getEsfSnapshotsCount()
          Returns the maximum number of snapshots to be retained in the file system.
 String getEsfSnapshotsDirectory()
          Gets the location where all Configuration Snapshots will be stored.
 String getEsfStyleDirectory()
          Gets the location where all custom style information is stored.
 String getEsfTemporaryConfigDirectory()
          Gets the location where all volatile ESF specific configuration and status information should be stored.
 String getEsfVersion()
          Gets the product version for this unit.
 String getEsfWebEnabled()
           
 String getFileSeparator()
          Gets the system file separator used by the filesystem.
 String getFirmwareVersion()
          Gets the firmware version.
 long getFreeMemory()
          Returns the free memory for Java instance.
 String getJavaHome()
          Gets the location where the JVM is stored in the filesystem.
 String getJavaVendor()
          Gets the vendor of the Java VM that is currently being used.
 String getJavaVersion()
          Gets the Java version that is currently being used.
 String getJavaVmInfo()
          Gets the Java Virtual Machine information that is currently being used.
 String getJavaVmName()
          Gets the Java Virtual Machine name that is currently being used.
 String getJavaVmVersion()
          Gets the Java Virtual Machine version that is currently being used.
 String getModelId()
          Gets the model identification of the device.
 String getModelName()
          Gets the model name of the device.
 int getNumberOfProcessors()
          Returns the number of processors visible to this Java platform.
 String getOsArch()
          Gets the Operating System architecture for the system.
 String getOsDistro()
          Gets the Operating System Distribution name if appropriate.
 String getOsDistroVersion()
          Gets the Operating System Distribution version if appropriate.
 String getOsgiFwName()
          Gets the name of the OSGI Framework that is currently being used.
 String getOsgiFwVersion()
          Gets the version of the OSGI Framework that is currently being used.
 String getOsName()
          Gets the Operating System name for the system.
 String getOsVersion()
          Gets the Operating System version for the system.
 String getPartNumber()
          Gets the part number.
 String getPlatform()
          Gets the platform name ESF is running on.
 String getPrimaryMacAddress()
          Gets the primary MAC address of the system
 String getPrimaryNetworkInterfaceName()
          Gets the name of the 'primary' network interface.
 Properties getProperties()
          Returns all EsfProperties for this system.
 String getSerialNumber()
          Gets the serial number of the device.
 long getTotalMemory()
          Returns the total memory visible to this Java instance.
 

Field Detail

ESF_CONFIG

static final String ESF_CONFIG
See Also:
Constant Field Values

ESF_PROPS_FILE

static final String ESF_PROPS_FILE
See Also:
Constant Field Values

OS_CLOUDBEES

static final String OS_CLOUDBEES
See Also:
Constant Field Values

OS_LINUX

static final String OS_LINUX
See Also:
Constant Field Values

OS_MAC_OSX

static final String OS_MAC_OSX
See Also:
Constant Field Values

UNKNOWN

static final String UNKNOWN
See Also:
Constant Field Values

UNSUPPORTED

static final String UNSUPPORTED
See Also:
Constant Field Values

KEY_ESF_NAME

static final String KEY_ESF_NAME
See Also:
Constant Field Values

KEY_ESF_VERSION

static final String KEY_ESF_VERSION
See Also:
Constant Field Values

KEY_DEVICE_NAME

static final String KEY_DEVICE_NAME
See Also:
Constant Field Values

KEY_PLATFORM

static final String KEY_PLATFORM
See Also:
Constant Field Values

KEY_MODEL_ID

static final String KEY_MODEL_ID
See Also:
Constant Field Values

KEY_MODEL_NAME

static final String KEY_MODEL_NAME
See Also:
Constant Field Values

KEY_PART_NUMBER

static final String KEY_PART_NUMBER
See Also:
Constant Field Values

KEY_SERIAL_NUM

static final String KEY_SERIAL_NUM
See Also:
Constant Field Values

KEY_BIOS_VERSION

static final String KEY_BIOS_VERSION
See Also:
Constant Field Values

KEY_FIRMWARE_VERSION

static final String KEY_FIRMWARE_VERSION
See Also:
Constant Field Values

KEY_PRIMARY_NET_IFACE

static final String KEY_PRIMARY_NET_IFACE
See Also:
Constant Field Values

KEY_ESF_HOME_DIR

static final String KEY_ESF_HOME_DIR
See Also:
Constant Field Values

KEY_ESF_PLUGINS_DIR

static final String KEY_ESF_PLUGINS_DIR
See Also:
Constant Field Values

KEY_ESF_DATA_DIR

static final String KEY_ESF_DATA_DIR
See Also:
Constant Field Values

KEY_ESF_TMP_DIR

static final String KEY_ESF_TMP_DIR
See Also:
Constant Field Values

KEY_ESF_SNAPSHOTS_DIR

static final String KEY_ESF_SNAPSHOTS_DIR
See Also:
Constant Field Values

KEY_ESF_SNAPSHOTS_COUNT

static final String KEY_ESF_SNAPSHOTS_COUNT
See Also:
Constant Field Values

KEY_ESF_HAVE_NET_ADMIN

static final String KEY_ESF_HAVE_NET_ADMIN
See Also:
Constant Field Values

KEY_ESF_HAVE_WEB_INTER

static final String KEY_ESF_HAVE_WEB_INTER
See Also:
Constant Field Values

KEY_ESF_STYLE_DIR

static final String KEY_ESF_STYLE_DIR
See Also:
Constant Field Values

KEY_OS_ARCH

static final String KEY_OS_ARCH
See Also:
Constant Field Values

KEY_OS_NAME

static final String KEY_OS_NAME
See Also:
Constant Field Values

KEY_OS_VER

static final String KEY_OS_VER
See Also:
Constant Field Values

KEY_OS_DISTRO

static final String KEY_OS_DISTRO
See Also:
Constant Field Values

KEY_OS_DISTRO_VER

static final String KEY_OS_DISTRO_VER
See Also:
Constant Field Values

KEY_JAVA_VERSION

static final String KEY_JAVA_VERSION
See Also:
Constant Field Values

KEY_JAVA_VENDOR

static final String KEY_JAVA_VENDOR
See Also:
Constant Field Values

KEY_JAVA_VM_NAME

static final String KEY_JAVA_VM_NAME
See Also:
Constant Field Values

KEY_JAVA_VM_VERSION

static final String KEY_JAVA_VM_VERSION
See Also:
Constant Field Values

KEY_JAVA_VM_INFO

static final String KEY_JAVA_VM_INFO
See Also:
Constant Field Values

KEY_OSGI_FW_NAME

static final String KEY_OSGI_FW_NAME
See Also:
Constant Field Values

KEY_OSGI_FW_VERSION

static final String KEY_OSGI_FW_VERSION
See Also:
Constant Field Values

KEY_JAVA_HOME

static final String KEY_JAVA_HOME
See Also:
Constant Field Values

KEY_FILE_SEP

static final String KEY_FILE_SEP
See Also:
Constant Field Values

CONFIG_CONSOLE_DEVICE_MANAGE_SERVICE_IGNORE

static final String CONFIG_CONSOLE_DEVICE_MANAGE_SERVICE_IGNORE
See Also:
Constant Field Values
Method Detail

getPrimaryMacAddress

String getPrimaryMacAddress()
Gets the primary MAC address of the system

Returns:

getPrimaryNetworkInterfaceName

String getPrimaryNetworkInterfaceName()
Gets the name of the 'primary' network interface.

Returns:

getPlatform

String getPlatform()
Gets the platform name ESF is running on. This could be catalyst, duracor1200, helios, isis, proteus, etc.

Returns:
The platform name.

getModelId

String getModelId()
Gets the model identification of the device.

Returns:
Model ID.

getModelName

String getModelName()
Gets the model name of the device.

Returns:
Model name.

getPartNumber

String getPartNumber()
Gets the part number.

Returns:
Part number.

getSerialNumber

String getSerialNumber()
Gets the serial number of the device.

Returns:
Serial number.

getDeviceName

String getDeviceName()
Returns a friendly name assigned to this device.

Returns:

getBiosVersion

String getBiosVersion()
Gets the BIOS version of the device.

Returns:
BIOS version.

getFirmwareVersion

String getFirmwareVersion()
Gets the firmware version.

Returns:
Firmware version.

getOsArch

String getOsArch()
Gets the Operating System architecture for the system.

Returns:
The Operating System architecture as defined by the Java System property os.arch.

getOsName

String getOsName()
Gets the Operating System name for the system.

Returns:
The Operating System name as defined by the Java System property os.name.

getOsVersion

String getOsVersion()
Gets the Operating System version for the system.

Returns:
The Operating System version as defined by the Java System property os.version.

getOsDistro

String getOsDistro()
Gets the Operating System Distribution name if appropriate.

Returns:
A String representing the Operating System Distribution name if appropriate.

getOsDistroVersion

String getOsDistroVersion()
Gets the Operating System Distribution version if appropriate.

Returns:
A String representing the Operating System Distribution version if appropriate.

getJavaVendor

String getJavaVendor()
Gets the vendor of the Java VM that is currently being used.

Returns:
The Java Runtime version as defined by the Java System property java.vendor.

getJavaVersion

String getJavaVersion()
Gets the Java version that is currently being used.

Returns:
The Java version as defined by the Java System property java.version.

getJavaVmName

String getJavaVmName()
Gets the Java Virtual Machine name that is currently being used.

Returns:
The Java Virtual Machine name as defined by the Java System property java.vm.name.

getJavaVmVersion

String getJavaVmVersion()
Gets the Java Virtual Machine version that is currently being used.

Returns:
The Java Virtual Machine version as defined by the Java System property java.vm.version.

getJavaVmInfo

String getJavaVmInfo()
Gets the Java Virtual Machine information that is currently being used.

Returns:
The Java Virtual Machine version as defined by the Java System property java.vm.version.

getOsgiFwName

String getOsgiFwName()
Gets the name of the OSGI Framework that is currently being used.

Returns:
The OSGI Framework Name as defined by the System property osgi.framework.name.

getOsgiFwVersion

String getOsgiFwVersion()
Gets the version of the OSGI Framework that is currently being used.

Returns:
The OSGI Framework Version as defined by the System property osgi.framework.version.

getFileSeparator

String getFileSeparator()
Gets the system file separator used by the filesystem.

Returns:
The system file separator used by the system.

getJavaHome

String getJavaHome()
Gets the location where the JVM is stored in the filesystem.

Returns:
The location of the root JVM directory.

getEsfVersion

String getEsfVersion()
Gets the product version for this unit. The product version is defined as the version in the release.xml file. The release.xml file is stored in /etc/esf/ and has the format: PRODUCT_NAME_release-VERSION-VERSION_NUMBER.xml For example this is a valid product name: helios_denali_release-1.2.3.xml. The version number would be 1.2.3. This would be an invalid product name: my-product-name_release-1.2.3.xml. This is because the product name has '-' characters in it. They should be '_' to be valid. So, the correct representation would be: my_product_name_release-1.2.3.xml. It's version number would be 1.2.3. The use of '-' characters should only be used immediately before the version number and the use of '.' characters should only be used immediately after the version number.

Returns:
The version number as denoted in the release.xml file.

getEsfHome

String getEsfHome()
Gets the location where the ESF root directory is stored in the filesystem.

Returns:
The root ESF directory.

getEsfTemporaryConfigDirectory

String getEsfTemporaryConfigDirectory()
Gets the location where all volatile ESF specific configuration and status information should be stored. The convention for each bundle that has filesystem dependencies is for those filesystem components to be stored in the configuration directory root followed by a file separator followed by the project name that needs some configuration. This will keep separate configuration components tied to their appropriate projects.

Returns:
The location of the volatile ESF configuration and status directory root.

getEsfSnapshotsDirectory

String getEsfSnapshotsDirectory()
Gets the location where all Configuration Snapshots will be stored. It is recommended for this directory not to be volatile so that the configuration information can survive reboots and service configuration can be restored.

Returns:
The location of the volatile ESF configuration and status directory root.

getEsfSnapshotsCount

int getEsfSnapshotsCount()
Returns the maximum number of snapshots to be retained in the file system. When the maximum number is reached, a garbage collector will deleted the older snapshots.

Returns:
maximum number of snapshots to be retained.

getEsfStyleDirectory

String getEsfStyleDirectory()
Gets the location where all custom style information is stored.

Returns:
The location of the custom style directory.

getEsfWebEnabled

String getEsfWebEnabled()

getEsfDataDirectory

String getEsfDataDirectory()
Gets the location where all ESF persistent data should be stored.

Returns:
The location of the persistent ESF data directory root.

getProperties

Properties getProperties()
Returns all EsfProperties for this system. The returned instances is initialized by loading the esf.properties file. Properties defined at the System level - for example using the java -D command line flag - are used to overwrite the values loaded from the esf.properties file in a hierarchical configuration fashion.


getBundles

org.osgi.framework.Bundle[] getBundles()
Returns the OSGi bundles currently installed

Returns:

getNumberOfProcessors

int getNumberOfProcessors()
Returns the number of processors visible to this Java platform.

Returns:

getTotalMemory

long getTotalMemory()
Returns the total memory visible to this Java instance.

Returns:

getFreeMemory

long getFreeMemory()
Returns the free memory for Java instance.

Returns:

getDeviceManagementServiceIgnore

List<String> getDeviceManagementServiceIgnore()
Returns a list of services that should be ignored by the Everyware Cloud Console

Returns:


Copyright © 2013. All Rights Reserved.