Updating the CUS database for IMT at Astrium

Procedure

TableOfContents(2)

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.

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 )

<!> {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}

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

<!> {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}

Anchor (CheckTemplates)

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/"