This document describes the current state of automated PV archiving procedures and scripts for LCLS.
Unless otherwise noted all scripts operate on and connect to the LCLS Archiver Appliance instance (managed directly via http://lcls-archapp.slac.stanford.edu/mgmt/ui/index.html).
lclsResumePausedPVs
Cronjob:
lcls-prod01 00 * * * * /afs/slac/g/lcls/package/ArchiverAppliance/tools/script/lclsResumePausedPVs.sh
Log:
/tmp/lclsResumePausedPVs.log
Schedule: Every hour
Description:
Gets a list of PVs that are paused and then resumes the archive request for each active PV.
Optionally, we can pass in a folder with a list of .archive files.
Only those paused PV's which are present in archive files that have been modified recently will be checked.
Notes:
lclsProcessArchiveFiles
==================
Cronjob: lcls-prod01 00 1 * * * /afs/slac/g/lcls/package/ArchiverAppliance/tools/script/lclsProcessArchiveFiles.sh
Log: /tmp/lclsProcessArchiveFiles.log
Schedule: Daily at 01:00
Description:
This is one of the steps used in automation of archiver configuraiton.
This assumes the requests for the archiver are somehow stored in the IOC (perhaps in INFO fields) and then submitted as archive files.
Archive files are consolidated together into a IOC_DATA like folder and can be identified using a bash glob expression.
Archive files are space/tab separated text files with these rules
1) They can have blank lines
2) They can have comment lines beginning with a #
3) Space/tab separated lines are interpreted as PVName, sampling period (in secs), sampling method (one of scan/monitor).
4) The PVName is mandatory; the other two are optional in which case defaults (optional arguments to this script) are applied.
Notes:
- Archives PVs in $IOC_DATA/<IOC>/archive/*.archive files modified within the past 7 days
- Defaults archive parameters for PVs to 1.0s, MONITOR
lclsPauseDisconnectedPVs
=====================
Cronjob: lcls-prod01 00 2 * * 3,4 /afs/slac/g/lcls/package/ArchiverAppliance/tools/script/lclsPauseDisconnectPVs.sh
Log: /tmp/lclsPauseDisconnectedPVs.log
Schedule: Every Wednesday and Thursday at 02:00
Description:
Gets a list of PVs that are disconnected and then pauses those that have not connected for a specified amount of time.
Notes:
- Pauses PVs that have not connected for the past 24 hours
lclsResumeAllPausedPVs
====================
Cronjob: lcls-prod01 00 3 * * * /afs/slac/g/lcls/package/ArchiverAppliance/tools/script/lclsResumeAllPausedPVs.sh
Log: /tmp/lclsResumeAllPausedPVs.log
Schedule: Daily at 03:00
Description:
This script gets a list of PVS that are paused and then resumes the archive request for each active PV.
Optionally, we can pass in a folder with a list of .archive files.
Only those paused PV's which are present in archive files that have been modified recently will be checked
Notes:
- Attempts to resume all paused PVs in the LCLS Archiver Appliance instance
- Waits 2 seconds for PVs to connect
- Processes 10 PVs at a time
lclsSetupEnv
==========
Notes:
- Runs from custom Python3 conda environment
- Uses EPICS 3.15.5-1.0 environment
- Sends emails to controls-cd@slac.stanford.edu
- Sets IOC_DATA to LCLS production directory