org.lsst.ccs.startup

Class BootUtils

java.lang.Object

org.lsst.ccs.startup.BootUtils

public class BootUtils
extends Object

A collection of static utilities linked to boot operations. Note that:

• a descriptive node represents a configuration description
• an effective node is the real subsystem and module hierarchy (ready to run)
• a "raw" subsystem is without configuration data

Author:

bamade

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	BootUtils.LocalBootObject Very important class: when an instance is created you can have : a descriptive Node the names of subsystem, configuration, tag the corresponding Effective Node a Subsystem ready to run (but not started)

Constructor Summary

Constructors

Constructor and Description
BootUtils()

Method Summary

Modifier and Type	Method and Description
static void	bootFromCache()
static org.lsst.ccs.config.SubsystemDescription	buildSubsystemDescription(String subsystemName, String tagName, org.lsst.ccs.description.DescriptiveNode descriptiveNode, org.lsst.ccs.config.DataFlavour dataFlavour) creates a new SubsystemDescription populated with "empty" ParameterDescriptions.
static void	checkStaticCompatibleConfiguration(org.lsst.ccs.config.ConfigProfile profile) To be invoked before registering a ConfigProfile This method creates a real dummy EffectiveNode to check for parameters that have preconditions.
static org.lsst.ccs.description.DescriptiveNode	getLatestInCache()
static Subsystem	getSubsystemFromFile(String descriptionName) Builds a Subsystem instance out of a description file.
static Subsystem	getSubsystemFromFile(String descriptionName, String configName) Builds a Subsystem given a description name and an initial configuration.
static Subsystem	getSubsystemFromFile(String pathName, String propertiesFileName, String subsystemAlias) Builds a Subsystem given a description name, an initial configuration and a alias.
static org.lsst.ccs.description.DescriptiveNode	modifyDescriptiveNode(org.lsst.ccs.description.DescriptiveNode node, Set<? extends org.lsst.ccs.config.ParameterConfiguration> parmConfigs) Modifies the node in argument with respect to the set of ParameterConfiguration TODO : from the ParameterConfiguration objects we only need their name and current value.
static void	saveInCache(org.lsst.ccs.description.DescriptiveNode node, String subsystemName, String configName, String tag) saves the latest run configuration in a local cache.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

BootUtils

public BootUtils()

Method Detail

buildSubsystemDescription

public static org.lsst.ccs.config.SubsystemDescription buildSubsystemDescription(String subsystemName,
                                                                                 String tagName,
                                                                                 org.lsst.ccs.description.DescriptiveNode descriptiveNode,
                                                                                 org.lsst.ccs.config.DataFlavour dataFlavour)

creates a new SubsystemDescription populated with "empty" ParameterDescriptions. The object is not in the database since the list of descriptions should be modified first.

Parameters:

subsystemName -

tagName -

descriptiveNode -

dataFlavour -

Returns:

a SubsystemDescription object containing the description of the parameters as described in descriptiveNode.

getSubsystemFromFile

public static Subsystem getSubsystemFromFile(String descriptionName)
                                      throws Exception

Builds a Subsystem instance out of a description file.

Parameters:

descriptionName -

Returns:

a subsystem ready to run.

Throws:

Exception

getSubsystemFromFile

public static Subsystem getSubsystemFromFile(String descriptionName,
                                             String configName)
                                      throws Exception

Builds a Subsystem given a description name and an initial configuration.

Parameters:

descriptionName - the name of the subsystem description

configName - the name of the configuration the subsystem is started with

Returns:

a ready to run subsystem

Throws:

Exception

getSubsystemFromFile

public static Subsystem getSubsystemFromFile(String pathName,
                                             String propertiesFileName,
                                             String subsystemAlias)
                                      throws Exception

Builds a Subsystem given a description name, an initial configuration and a alias. The subsystem will be named "alias" on the buses.

Parameters:

pathName -

propertiesFileName -

subsystemAlias -

Returns:

A ready to run subsystem

Throws:

Exception

saveInCache

public static void saveInCache(org.lsst.ccs.description.DescriptiveNode node,
                               String subsystemName,
                               String configName,
                               String tag)

saves the latest run configuration in a local cache. This is saved in a file (see naming convention handled by baseNameFromNames that will reside in tha cache directory. The name of this file will be reported in another text file in this directory named "latest.txt".

TODO: The path of the cache directory is to be determined.

Parameters:

node -

subsystemName -

configName -

tag -

getLatestInCache

public static org.lsst.ccs.description.DescriptiveNode getLatestInCache()

bootFromCache

public static void bootFromCache()

modifyDescriptiveNode

public static org.lsst.ccs.description.DescriptiveNode modifyDescriptiveNode(org.lsst.ccs.description.DescriptiveNode node,
                                                                             Set<? extends org.lsst.ccs.config.ParameterConfiguration> parmConfigs)

Modifies the node in argument with respect to the set of ParameterConfiguration TODO : from the ParameterConfiguration objects we only need their name and current value.

Parameters:

node -

parmConfigs -

Returns:

a modified descriptive node

checkStaticCompatibleConfiguration

public static void checkStaticCompatibleConfiguration(org.lsst.ccs.config.ConfigProfile profile)
                                               throws Exception

To be invoked before registering a ConfigProfile This method creates a real dummy EffectiveNode to check for parameters that have preconditions. This means that objects created this way should not affect the hardwares.

Parameters:

profile -

Throws:

Exception