Differences between revisions 2 and 3
Revision 2 as of 2017-02-21 16:15:38
Size: 8744
Editor: MarkBarton
Comment:
Revision 3 as of 2017-02-21 16:23:17
Size: 8748
Editor: MarkBarton
Comment:
Deletions are marked like this. Additions are marked like this.
Line 9: Line 9:
burtgooey which invokes two command line tools, burtwb and burtrb. The burtrb tool needs a BURT request ``burtgooey'' which invokes two command line tools, burtwb and burtrb. The burtrb tool needs a BURT request

KAGRA VIS Operations Manual - Info on BURT

Cut and pasted from PDF of LIGO version - needs major editing!

Back to Operation Manual main page

Background

BURT is a tool for backing up and restoring some or all of the EPICS state of one or more models. There is a GUI interface, burtgooey which invokes two command line tools, burtwb and burtrb. The burtrb tool needs a BURT request file (.req) specifying a list of channels to be backed up and generates a BURT snapshot file (.snap) containing a list of channel names and saved values. The burtwb tool then loads the values back into the model. Each model should have a autoBurt.req file specifying a default list of channels to be backed up (not all will be of interest). A background task backs up all models according to their autoBurt.req files at regular intervals (currently hourly), but additional snapshots can be taken manually. The kill scripts which shut down models in an orderly fashion (e.g., killh1susmc2 for H1:MC2) do a backup first. (Startup scripts, e.g., starth1susmc2 for H1:MC2, invoke the corresponding kill script first and thus also trigger a backup.)

Each model should have a safe.snap file representing a safe state in which the suspension or other system is least likely to be a danger to itself or the rest of the system. Each model is automatically restored to the safe.snap state after a reboot of the front-end computer. The "safe" state is currently defined as having the damping filters ON but the master switch and most other sources of excitation OFF.

The Guardian system will use additional files similar to safe.snap to define standard states. The lock.snap files define the desired state for locking the cavity of which the suspension is a part, with the damping, master switch, alignment offsets and locking filters all on. Need to check this!!!

Directory structure

Many BURT related utilities put or expect to find BURT-related files at /opt/rtcds/${site}/${ifo}/target/ , e.g., /opt/rtcds/lho/h1/target/ . These are organized by the name of the Simulink model controlling the suspension: /opt/rtcds/${site}/${ifo}/target/${model}/${model}epics/, e.g., for H1:MC2, /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/ . The autoBurt.req file is /opt/rtcds/${site}/${ifo}/target/${model}/${model}epics/autoBurt.req , e.g. for H1:MC2, /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/autoBurt.req. The safe.snap file used when a model is started is /opt/rtcds/${site}/${ifo}/target/${model}/${model}epics/burt/safe.snap e.g., for H1:MC2, /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/burt/safe.snap . However by convention, all safe.snap files are now symbolic links into the SVN-controlled area at /opt/rtcds/userapps/release/sus/${ifo}/burtfiles/, e.g, /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/burt/safe.snap -> /opt/rtcds/userapps/release/sus/burtfiles/h1susmc2_safe.snap Because BURT (burtgooey etc) is not smart enough to follow a symbolic link and write to the location pointed to (rather, it replaces the link with a plain data file), it is important always to give it a explicit path into the userapps area so as not to break the link. Snapshot files generated by kill scripts are at /opt/rtcds/${site}/${ifo}/target/${model}/${model}epics/burt , e.g., for H1:MC2, /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/burt/ . with names like h1susmc2_burt_121204_124643.snap (i.e., with a yymmdd_hhmmss date/time stamp). Hourly backups live at /ligo/cds/${site}/${ifo}/burt organized by year, month, day, time, and model, e.g., /ligo/cds/lho/h1/burt/2013/01/04/09:00/h1susmc2epics.snap.

Saving snapshots

The following sections explain several different tools for making snapshots.

Updating a safe.snap file via Matlab

There is a Matlab function save_safe_snap() to make new safe.snap files conveniently. (Currently there is no equivalent save_lock_snap(), but stay tuned.) It saves the current state of a suspension, puts it into the safe state, saves the state again with the appropriate name in the userapps working copy area, restores the original state and prints an svn command that can be used to commit the new file to the userapps repository. 1. Run Matlab and navigate to the `^trunk/Common/MatlabTools directory. $ matlab& > cd /ligo/svncommon/SusSVN/sus/trunk/Common/MatlabTools 2. Invoke save_safe_snap() with the desired ifo and suspension. > save_safe_snap('H1','ITMY') 3. Copy and paste the svn command that is printed by the function and paste it into the Matlab window. (Note the use of ! to execute shell commands within Matlab - omit it if you prefer to use a regular terminal window.) > !svn commit -m "New safe.snap file for H1:ITMY" /opt/rtcds/userapps/release/sus/h1/burtfiles/h1susitmy_safe.snap

Creating a snapshot manually

1. Put the suspension in the desired state. For safe.snap files, check the following: [DAMP] filter outputs should be ON. [MASTER_SWITCH] should be OFF. [TEST] filter outputs should be OFF. [LOCK] filter outputs should be OFF. [OPTICALIGN] filter outputs should be OFF. For lock.snap files check the following [Need to check this!]: [DAMP] filter outputs should be ON. [MASTER_SWITCH] should be ON. [TEST] filter outputs should be OFF. [LOCK] filter outputs should be ???. [OPTICALIGN] filter outputs should be ON. 2. Open burtgooey in the command window: $ burtgooey & 3. Click [Backup]. In the new window, click [Request Files]. The Request File Selector dialog appears. 4. Navigate to the /opt/rtcds/${site}/${ifo}/target/ area for your site and ifo, and go down two levels to locate the autoBurt.req file for your suspension, e.g., /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/ for H1 MC2. Click on autoBurt.req, then [OK] and [Cancel] (the UI allows for adding more than one file, hence the need for [Cancel]). 5. In the [Snapshot Filename] field, enter in THE ENTIRE PATH and desired filename for the snapshot. For safe.snap and lock.snap files, this should be in the part of the userapps directory containing the suspension's individual safe.snap file, e.g., /opt/rtcds/userapps/release/sus/h1/burtfiles/h1susmc2_safe.snap. 6. Click the [Backup] then the [Done] buttons. 7. If the snapshot is in the userapps SVN directory sure to commit the newly-written file: $ cd /opt/rtcds/userapps/release/sus/h1/burtfiles/ $ svn commit -m "New safe.snap for MC2"

Restoring from snapshots

Restoring to a snap.snap file with the GDS_TP screen

1. Open the SITEMAP. 2. Open the screen for the suspension. 3. Click on the button which opens the GDS TP screen for the user model, e.g., for H1:MC2, [H1SUSMC2 GDS TP]. 4. Click on the [BURT] button.

Restoring from an arbitrary saved state with the BURT GUI

1. Open burtgooey in the command window: $ burtgooey & 2. Click on [Restore]. The Restore window appears. 3. Click on [Snapshot Files ...]. The Snapshot File Selector dialog appears. 4. Navigate to the directory with the backup file For kill script backups, navigate to /opt/rtcds/${site}/${ifo}/target/${model}/${model}epics/burt/ e.g., for H1 MC2, /opt/rtcds/lho/h1/target/h1susmc2/h1susmc2epics/burt/. For hourly backups, navigate to /ligo/cds/${site}/${ifo}/burt/${YYYY}/${MM}/${DD}/${hh}:{mm}/ 5. Identify and a select a file from a known good time, then click [OK] and [Cancel] (the UI allows for adding more than one file, hence the need for [Cancel]). Kill script snapshots have a date/time in yymmdd_hhmmss format at the end of their name, e.g., h1susmc2_burt_121204_124643.snap. Hourly backups are called ${model}epics.snap, e.g, for H1:MC2, h1susmcsepics.snap. 6. Check that the file selected in the previous step is the only one in the list. If not clear unwanted files from the list with [Remove Selected]. 7. Click [Restore]. After a few seconds the indicator immediately to the right should turn green and display "OK". If there is a problem (the indicator turns red and says "Not OK"), in which clear the file from the list and choose a better one.

Restoring from an hourly backup

The burtrestore utility is a convenient way of restoring to an hourly backup. It takes the hourly snapshot file name for a particular model (i.e., the name of the model plus "epics") and as many of time, day, month and year as are necessary: $ burtrestore h1susmc2epics 09:00 % restore to 9 o'clock this morning $ burtrestore h1susmc2epics 09:00 02 % restore to 9 o'clock on the 2nd of this month $ burtrestore h1susmc2epics 09:00 02 01 % restore to 9 o'clock on the 2nd of January this year $ burtrestore h1susmc2epics 09:00 02 01 2012 % restore to 9 o'clock on 1/2/12

KAGRA/Subgroups/VIS/OpsManual/BURT (last edited 2019-04-16 11:23:30 by MarkBarton)