Setup
Environment
...
- Select $MPSGUI_ROOT/src/edu.stanford.slac.mpshist/MpsHistManager
- Right-click => select Run As... => Java Application
- If you run the app for the first time, it should fail
- Go to Run in the Window menu
- Select "Open Run Dialog..."
- Select "MpsHistManager" in the window on the left
- Select the "Arguments" tab
- Enter the following arguments:
Code Block /usr/local/lcls/epics/iocTop/MachineProtection/mpsConfiguration/database/XYZ/mpsdb.sqlite3 password
- XYZ - the current Config version (caget IOC:BSY0:MP01:DBVERS)
- password - the current password (see also #Launch Script)
in the "Program arguments" area.
- Press "Run"
- Note: to actually receive messages, you have to stop the production server (see #Starting and Stopping #Start / Stop)
Development
Overview
Launch Script
...
- A runnable that periodically notifies MPS about a running server
- Sends out Datagram packets
Release
...
- Add a note in $MPSHIST_ROOT/RELEASE_NOTES
- Increment the tag version accordingly
- Commit to CVS
- Tag with mpshist-R#-#-#
- Check out the tagged version into production
Code Block cd $PHYSICS_TOP/release cvs co -r mpshist-R#-#-# -d mpshist-R#-#-# physics/mps/mpshist
- Select File => New Java project => Create project from existing source
- Select $PHYSICS_TOP/release/mpshist-R#-#-#
- Name the project mpshist-R#-#-#
- Press "Finish"
- Right-click on the new project mpshist-R#-#-# => Export...
- Select Java => JAR file
- Check mpshist-R#-#-# in "Resources to export"
- Check "Export generated class files and resources"
- As the export destination, type (and/or select)
Code Block $PHYSICS_TOP/release/mpshist-R#-#-#/jar/mpshist.jar
- Press "Finish"
- Move the symbolic link
Code Block cd $PHYSICS_TOP/ rm -rf mpshist; ln -s release/mpshist-R#-#-# mpshist
...
Start / Stop
- Only one MPS History Server is active at any time
- To start a new server, you must login as laci on lcls-daemon2
Code Block /etc/rc3.d/S99st.mpshist start
- To stop a production server, type
Code Block /etc/rc3.d/S99st.mpshist stop
...