1. #Setup
   1. #Environment
   2. #Dependencies
   3. #Test inside Eclipse
2. #Development
   1. #Overview
   2. #Launch Script
   3. #Classes and Functions
      1. #Message
      2. #Other
3. #Release with Eclipse
   1. #Start/Stop
   2. #Starting and Stopping
4. #Troubleshoot

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

...