Differences between revisions 2 and 8 (spanning 6 versions)
Revision 2 as of 2006-10-27 14:32:40
Size: 1592
Comment:
Revision 8 as of 2009-07-15 14:32:38
Size: 3338
Editor: localhost
Comment: converted to 1.6 markup
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Describe PACS/FM ILT Procedures/CCMprocedures here. ---------
<!> /!\
~+
''' All the procedures below are defined for the ''oper'' account on the host ''pacs5'''''.
+~
<!> /!\
---------
<<TableOfContents(2)>>
Line 3: Line 10:
[[TableOfContents(2)]] = Standard Procedures =
Line 5: Line 12:
= A new MIB (combination) is available and ready to be used =

A single procedure named "loadMIB" is used to ingest the MIB
into both the operations and the CUS development databases.
== A new MIB (combination) is available and ready to be used ==
Line 13: Line 17:
loadMIB --loadmib PACS_MIB_TAG EGSE_MIB_TAG CDMSSIM_MIB_TAG ccm -loadmib PACS_MIB_TAG EGSE_MIB_TAG CDMSSIM_MIB_TAG
Line 17: Line 21:
loadMib --loadmib=MIB_LABEL ccm -loadmib=MIB_LABEL
Line 23: Line 27:
= A new (modifiable) instrumentModel shall be created using new MIB definition =
== A new (modifiable) instrumentModel shall be created using new MIB definition ==

The MIB must be already ingested into the database using the above procedure.

Depending from the source for the initial CUS definitions two command options
are available.

 * Using an existing version from the CUS CVS repository specified by a CVS tag name which is formed like a MissionConfigurationLabel.
 {{{
 ccm -createmodel -usemib=MIB_LABEL -usecus=cvs=CvsTagName -cvscomment=comment
 }}}

 * Using the current CUS definitions from an existing (modifiable) instrumentModel in the database specified by an InstrumentModelLabel name.
 {{{
 ccm -createmodel -usemib=MIB_LABEL -usecus=im=InstrumentModelLabel -cvscomment=comment
 }}}

A dialog window will pop-up to enter a CVS comment if none was entered at the command line.

Each of these options will create an instrumentModel, load it with the specified MIB, load the requested CUS
definitions (also updating the CVS repository) and create the first missionConfiguration for this new instrumentModel. Finally the property file
will be updated with the new instrumentModel and missionConfiguration and the test-control server will be
restarted.

<!> '''Note:''' The CUS editor "cusgui" must be restarted to view (and edit) the new modifiable instrumentModel.

== Publish CUS modifications for the current instrumentModel ==

Whenever you want to make the CUS modification edited with the CUS editor available for commanding you must
commit your changes to the database to update the instrumentModel and you must use the following command to
create a new missionConfiguration and make it available.
Line 26: Line 61:
createInstrumentModel --create MIB_LABEL ccm -updatecus -cvscomment=comment
Line 29: Line 64:
This command will create a new modifiable instrumentModel in the operations
database. The corresponding MIB will automatically associated with this new
instrumentModel.
A dialog window will pop-up to enter a CVS comment if none was entered at the command line.
Line 33: Line 66:
The [:InstrumentModelLabel: instrumentModel label] in the database will be formed according the given
[:MibLabels: MibLabel]. If there is already an instrumentModel with this label the command
will fail. To create a new version use the ''--force'' option.
== Monitoring TestControl and TmIngestion ==

To monitor and control both Tm``Ingestion and Test``Control convinience procedures exist.
Line 37: Line 71:
createInstrumentModel --create MIB_LABEL --force TestControl start # starting TestControl, it will run in the background
TestControl stop # stopping TestControl
TestControl status # showing the output of "ps -lf" of TestControl (if it runs)
TestControl log # showing the tail of the TestControl log file and continue to monitor it

TmIngestion start # starting TmIngestion, it will run in the background
TmIngestion stop # stopping TmIngestion
TmIngestion status # showing the output of "ps -lf" of TmIngestion (if it runs)
TmIngestion log # showing the tail of the TmIngestion log file and continue to monitor it
Line 40: Line 82:
To load the initial CUS definitions (procedures and table) two options exist. Either copy
the CUS definitions from an existing instrumentModel or use a tagged version from the CVS repository.
Line 43: Line 83:
{{{
createInstrumentModel --loadcus=cvs=tagname instrumentModelLabel
}}}
or
{{{
createInstrumentModel --loadcus=instmodel=label instrumentModelLabel
}}}
= Recovery Procedures =

== Reloading a MIB for an already existing instrumentModel ==

== Ingesting a MIB version which is already in the database ==


<!> /!\ All the procedures below are defined for the oper account on the host pacs5. <!> /!\


Standard Procedures

A new MIB (combination) is available and ready to be used

The MIB to be ingested can be specified in two different ways, either by the CVS MibTags or by the database MibLabels.

ccm -loadmib PACS_MIB_TAG EGSE_MIB_TAG CDMSSIM_MIB_TAG

or

ccm -loadmib=MIB_LABEL

The MIB loading does not affect any ongoing operation. It can be executed at any time.

A new (modifiable) instrumentModel shall be created using new MIB definition

The MIB must be already ingested into the database using the above procedure.

Depending from the source for the initial CUS definitions two command options are available.

  • Using an existing version from the CUS CVS repository specified by a CVS tag name which is formed like a MissionConfigurationLabel.

     ccm -createmodel -usemib=MIB_LABEL -usecus=cvs=CvsTagName -cvscomment=comment
  • Using the current CUS definitions from an existing (modifiable) instrumentModel in the database specified by an InstrumentModelLabel name.

     ccm -createmodel -usemib=MIB_LABEL -usecus=im=InstrumentModelLabel -cvscomment=comment

A dialog window will pop-up to enter a CVS comment if none was entered at the command line.

Each of these options will create an instrumentModel, load it with the specified MIB, load the requested CUS definitions (also updating the CVS repository) and create the first missionConfiguration for this new instrumentModel. Finally the property file will be updated with the new instrumentModel and missionConfiguration and the test-control server will be restarted.

<!> Note: The CUS editor "cusgui" must be restarted to view (and edit) the new modifiable instrumentModel.

Publish CUS modifications for the current instrumentModel

Whenever you want to make the CUS modification edited with the CUS editor available for commanding you must commit your changes to the database to update the instrumentModel and you must use the following command to create a new missionConfiguration and make it available.

ccm -updatecus -cvscomment=comment

A dialog window will pop-up to enter a CVS comment if none was entered at the command line.

Monitoring TestControl and TmIngestion

To monitor and control both TmIngestion and TestControl convinience procedures exist.

TestControl start       # starting TestControl, it will run in the background
TestControl stop        # stopping TestControl
TestControl status      # showing the output of "ps -lf" of TestControl (if it runs)
TestControl log         # showing the tail of the TestControl log file and continue to monitor it

TmIngestion start       # starting TmIngestion, it will run in the background
TmIngestion stop        # stopping TmIngestion
TmIngestion status      # showing the output of "ps -lf" of TmIngestion (if it runs)
TmIngestion log         # showing the tail of the TmIngestion log file and continue to monitor it

Recovery Procedures

Reloading a MIB for an already existing instrumentModel

Ingesting a MIB version which is already in the database

Herschel: PACS/FM_ILT_Procedures/CCMprocedures (last edited 2009-07-15 14:32:38 by localhost)