|
Size: 4658
Comment:
|
Size: 5017
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 2: | Line 2: |
---- |
|
| Line 10: | Line 8: |
| ---- Author: Erich Wiezorrek[[BR]] Version: 1.0[[BR]] Date: October 28, 2205[[BR]] ---- |
[[TableOfContents(2)]] |
| Line 28: | Line 18: |
| All | All commands below assume that you are logged using the ''pacs'' account on host ''hos4-d'' and that the ''psetup'' configuration has been executed. {{{ ssh -X pacs@hos4-d psetup }}} All CUS patches are collected in the ''/home/pacs/cus'' directory tree. |
| Line 32: | Line 29: |
Go to the directory where to place the input MIB files. Create the directory if it doesn't exist (BUT is shall exist on our operational server). |
Go to the ''/home/pacs/cus'' and create a cus patch directory for today in the format ''patches_YYYYMMDD''. When there is more than one patches append ''A'',''B'' ... to the date to distinguish them. Copy all new CUS procedures and uplink tables to this directory. |
| Line 36: | Line 33: |
| cd ~/mib/raw }}} Unzip the empty_mib_files.zip archive to make sure all necessary input files for the MIBingestion exists.[[BR]] Unzip the PACS_MIB_7_18.zip archive. When asked to overwrite files select the option to overwrite all files.[[BR]] On the operational server those archives are in the parent directory. {{{ unzip ../empty_mib_files.zip unzip ../PACS_MIB_7_18.zip }}} Go to the parent directory and run MIBpreparation and MIBingestion. {{{ cd .. preparemib ~/mib/raw ~/mib ingestmib | & tee test.log |
cd ~/cus mkdir patches_YYYYMMDD cd patches_YYYYMMDD cp fromeSomewhere . |
| Line 54: | Line 39: |
| Congratulation, it's done. | Assuming that all CUS procedures file names and only those end with ''.txt'' following command is ingesting them to the database. {{{ cus -f -m"XXXth update for EQM IMT" -import *.txt }}} Replace ''XXXth'' with the current ordinal number for this CUS update. The same command is used to update the ''readonly'' database as well. Don't miss the parenthesis around the command otherwise your terminal session will be permamently configured to use this readonly database. {{{ ( readonlyCUS; cus -f -m"xxxth update for EQM IMT" -import *.txt ) }}} Similar commands are used to ingest the uplink calibration tables. {{{ cus -f -m "XXXth update for EQM IMT" -uploadcal tableFileName ( readonlyCUS; cus -f -m "XXXth update for EQM IMT" -uploadcal tableFileName ) }}} <!> {X} [[BR]] As updates to the CUS procedures can change to number and order of thte telecommand sequence of an observation mode the procedure step [#CheckTemplates "Recreating TCL template scripts and comparing with a previous release"] must be executed.[[BR]] <!> {X} |
| Line 58: | Line 63: |
| == Loading the initial CUS definitions: == | == Upgrading TCL template scripts for the HPCSS: == |
| Line 60: | Line 65: |
Go to the directory where to place CUS files. Create the directory if it doesn't exist (BUT is shall exist on our operational server). |
Create a patch directory named ''CCS_template_scripts_update_YYYYMMDD''. Go to this directory. |
| Line 64: | Line 68: |
| cd ~/cus }}} Unzip the cus-definitions.zip archive which holds all initial CUS definitions including the CUS tables.. {{{ unzip cus-definitions.zip }}} Load the TC definitions from the currently loaded MIB {{{ cd ~/cus cus -loadmib 1 <<EOF |& tee test.log initial MIB version EOF }}} Load the CUS tables {{{ cat listOfCalibrationTables |xargs -t -i cus -m "Initial version" -uploadcal tables/\{\} \{\} }}} Load the CUS definitions (observing modes, building blocks, procedures) {{{ cus -m "Initial version" -import registryDefinitions |
mkdir ~/cus/CCS_template_scripts_update_YYYYMMDD cd ~/cus/CCS_template_scripts_update_YYYYMMDD |
| Line 87: | Line 72: |
| The way how to upgrade your TCL templates depends on the input from the operations group: * voice or email describing changes to the requested observation parameters * nice CSV files describing templates requests * Helmut's Exel sheet file '''(not described here)''' |
|
| Line 88: | Line 77: |
| Congratulation, it's done. | === voice or email describing changes to the requested observation parameters === |
| Line 90: | Line 79: |
| === nice CSV files describing templates requests === | |
| Line 91: | Line 81: |
| == Loading a MIB update == | <!> {X} [[BR]] It is very important to update to link pointing to the most recent ''createTemplates'' files. Otherwise future updates will get confusing. {{{ ln -sf `pwd`/createTemplates ../createTemplates }}} <!> {X} |
| Line 93: | Line 89: |
| [[Anchor (CheckTemplates)]] == Recreating TCL template scripts and comparing with a previous release == |
|
| Line 94: | Line 92: |
| Go to the directory where to place the input MIB files. Create the directory if it doesn't exist (BUT is shall exist on our operational server). Remove all existing files ending with "*.dat". |
Create a patch directory named ''CCS_template_scripts_update_YYYYMMDD'' if not created already in the previous section. Go to this directory. |
| Line 98: | Line 95: |
| cd ~/mib/raw rm *.dat |
mkdir ~/cus/CCS_template_scripts_update_YYYYMMDD cd ~/cus/CCS_template_scripts_update_YYYYMMDD |
| Line 101: | Line 98: |
| Unzip the empty_mib_files.zip archive to make sure all necessary input files for the MIBingestion exists.[[BR]] Unzip the new PACS MIB archive. When asked to overwrite files select the option to overwrite all files.[[BR]] On the operational server the empty_mib_files.zip archive is in the parent directory. |
Either use the '''createTemplates''' created in the previous section or copy the one linked by the ''~/cus/createTemplates'' to the current patch directory. |
| Line 108: | Line 102: |
| unzip ../empty_mib_files.zip unzip yourPath/PACS_MIB_x_y.zip |
cp ~/cus/createTemplates . #BUT only if NO createTemplates files is created in the previous section |
| Line 111: | Line 104: |
| Go to the parent directory and run MIBpreparation and MIBingestion. | Create all TCL template files by executing the ''createTemplates'' script. This will last some minutes. {{{ ./createTemplates }}} To compare these TCL template files with those generated by the previous patch |
| Line 114: | Line 113: |
| preparemib ~/mib/raw ~/mib ingestmib | & tee test-PACS-MIB-x-y.log |
./compareTCLtemplates.sh CURRENT_PATCH_DIR PREVIOUS_PATCH_DIR | grep -v identical |
| Line 117: | Line 115: |
| If the MIB contains new TC definitions to be used by CUS those definitions must be loaded by CUS.[[BR]] The problem is to know the new MIB version number to be used during loading. The "cus -listmibs" shall list MIB versions which have not been loaded yet. If there is only a line printed "New mibs available" but no numbers this means there are NO new MIBs. |
When there are files list as being different or missing then execute the following procedure step to transfer the TCL template scripts to the HPCSS. |
| Line 124: | Line 118: |
| In the statements below replace TBW with the MIB version number to be used listed with the "cus -listmibs" command. |
== Transferring TCL template scripts to the HPCSS == First print out the list of different of missing TCL template scripts. |
| Line 127: | Line 122: |
| cd ~/cus cus -listmibs cus -loadmib TBW <<EOF |& tee test-TBW.log MIB version TBW EOF |
./compareTCLtemplates.sh CURRENT_PATCH_DIR PREVIOUS_PATCH_DIR | grep -v identical | a2ps -1 -P printer |
| Line 134: | Line 125: |
| Congratulation, it's done. == Loading an update of CUS definitions (observation, building block, procedure): == Go to the directory where to place CUS files.[[BR]] Create the directory a patch directory and step into this directory.[[BR]] '''Don't''' use "patch1" but use a more verbose name.[[BR]] |
Put the special USB stick from Stijn into an USB port of the host hos4-d. Copy all TCL template scripts to an directory on the USB stick. '''Don't forget to umount the USB stick'''. |
| Line 145: | Line 128: |
| cd ~/cus mkdir patch1 cd patch1 |
cd CURRENT_PATCH_DIR cp -v *tcl /media/usb-storage-0904B2110E0009E5:0:0:0p1/ su -c "/bin/umount /media/usb-storage-0904B2110E0009E5:0:0:0p1/" |
| Line 149: | Line 132: |
| Place the CUS definition text files in this directory. {{{ cp whatever . }}} Loading the CUS tables if there are any updates.[[BR]] Replace COMMENT with a real comment, FILE is the actual filename. The TABLE name is optional if missing the filename is used. {{{ cus -f -m "COMMENT" -uploadcal FILE [TABLE] }}} Load the CUS definitions (observing modes, building blocks, procedures) if there are any updates.[[BR]] Replace COMMENT with a real comment, FILE is the actual filename. {{{ cus -f -m "COMMENT" -import FILE }}} Congratulation, it's done. |
Updating the CUS database for IMT at Astrium
Procedure
- to update the PACS EQM IMT database with the CUS procedure definitions
- to update the PACS EQM IMT database with the CUS uplink table definitions
to recreate the CcsHandler template TCl scripts for the HPCSS
General:
Usually updates for the CUS database are received via email form where they have to be extracted to single files. The rest of this procedure descriptions assumes following file extensions.
- .txt for the CUS procedures (modes, blocks, ...)
- no extension (at least not .txt or .csv) for CUS uplink tables
.csv for CcsHandler "AOT" calls definitions
All commands below assume that you are logged using the pacs account on host hos4-d and that the psetup configuration has been executed.
ssh -X pacs@hos4-d psetup
All CUS patches are collected in the /home/pacs/cus directory tree.
Updating CUS procedures and tables
Go to the /home/pacs/cus and create a cus patch directory for today in the format patches_YYYYMMDD. When there is more than one patches append A,B ... to the date to distinguish them. Copy all new CUS procedures and uplink tables to this directory.
cd ~/cus mkdir patches_YYYYMMDD cd patches_YYYYMMDD cp fromeSomewhere .
Assuming that all CUS procedures file names and only those end with .txt following command is ingesting them to the database.
cus -f -m"XXXth update for EQM IMT" -import *.txt
Replace XXXth with the current ordinal number for this CUS update.
The same command is used to update the readonly database as well. Don't miss the parenthesis around the command otherwise your terminal session will be permamently configured to use this readonly database.
( readonlyCUS; cus -f -m"xxxth update for EQM IMT" -import *.txt )
Similar commands are used to ingest the uplink calibration tables.
cus -f -m "XXXth update for EQM IMT" -uploadcal tableFileName ( readonlyCUS; cus -f -m "XXXth update for EQM IMT" -uploadcal tableFileName )
BR As updates to the CUS procedures can change to number and order of thte telecommand sequence of an observation mode the procedure step [#CheckTemplates "Recreating TCL template scripts and comparing with a previous release"] must be executed.BR
Upgrading TCL template scripts for the HPCSS:
Create a patch directory named CCS_template_scripts_update_YYYYMMDD. Go to this directory.
mkdir ~/cus/CCS_template_scripts_update_YYYYMMDD cd ~/cus/CCS_template_scripts_update_YYYYMMDD
The way how to upgrade your TCL templates depends on the input from the operations group:
- voice or email describing changes to the requested observation parameters
- nice CSV files describing templates requests
Helmut's Exel sheet file (not described here)
voice or email describing changes to the requested observation parameters
nice CSV files describing templates requests
BR It is very important to update to link pointing to the most recent createTemplates files. Otherwise future updates will get confusing.
ln -sf `pwd`/createTemplates ../createTemplates
Recreating TCL template scripts and comparing with a previous release
Create a patch directory named CCS_template_scripts_update_YYYYMMDD if not created already in the previous section. Go to this directory.
mkdir ~/cus/CCS_template_scripts_update_YYYYMMDD cd ~/cus/CCS_template_scripts_update_YYYYMMDD
Either use the createTemplates created in the previous section or copy the one linked by the ~/cus/createTemplates to the current patch directory.
cp ~/cus/createTemplates . #BUT only if NO createTemplates files is created in the previous section
Create all TCL template files by executing the createTemplates script. This will last some minutes.
./createTemplates
To compare these TCL template files with those generated by the previous patch
cd .. ./compareTCLtemplates.sh CURRENT_PATCH_DIR PREVIOUS_PATCH_DIR | grep -v identical
When there are files list as being different or missing then execute the following procedure step to transfer the TCL template scripts to the HPCSS.
Transferring TCL template scripts to the HPCSS
First print out the list of different of missing TCL template scripts.
./compareTCLtemplates.sh CURRENT_PATCH_DIR PREVIOUS_PATCH_DIR | grep -v identical | a2ps -1 -P printer
Put the special USB stick from Stijn into an USB port of the host hos4-d. Copy all TCL template scripts to an directory on the USB stick. Don't forget to umount the USB stick.
cd CURRENT_PATCH_DIR cp -v *tcl /media/usb-storage-0904B2110E0009E5:0:0:0p1/ su -c "/bin/umount /media/usb-storage-0904B2110E0009E5:0:0:0p1/"