1. #Development
   1. #Environment
   2. #Dependencies
   3. #Run inside Eclipse
   4. #Release from Eclipse

Development

Environment

• Effectively, you can only develop MPSGui inside Eclipse on lcls-builder.
• Check out the CVS module physics/mps/mpsgui into your workspace
  • From now on, the root of project is referred to as $MPSGUI_ROOT

    Dependencies

    For library paths, see the scripts $MPSGUI_ROOT/mpsgui or $MPSGUI_ROOT/mpscud
• ezJCA (version R0-0-10)
• javainterfaces (current version)
• MPS Config (current version)
  • Oracle JDBC driver
  • Sqlite JDBC driver
• SwingUtil (current version)
  • jgoodies.jar can be added at runtime for the Matlab look & feel
• xal4lcls
  • ext.jar (current version)
  • xal.jar (current version)

    Run inside Eclipse

• Select $MPSGUI_ROOT/src/edu.stanford.slac.mpsgui/MpsGuiLauncher
• 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 "MpsGuiLauncher" in the window on the left
  • Select the "Arguments" tab
  • Enter

    jdbc:sqlite:/usr/local/lcls/epics/iocTop/MachineProtection/mpsConfiguration/database/
    jdbc:sqlite:/usr/local/lcls/epics/iocTop/MachineProtection/mpsConfiguration/algorithm/
    jdbc:oracle:thin:MPS_HISTORY/current_password@mccqa.slac.stanford.edu:1521:MCCQA

    in the "Program arguments" area.
  • Replace current_password with the current password (can be found in the $MPSGUI_ROOT/mpsgui script)
  • Press "Run"

    Release from Eclipse

• Update the application version in $MPSGUI_ROOT/src/edu.stanford.slac.mpsgui.MpsGuiProperties
• Add a note in $MPSGUI_ROOT/RELEASE_NOTES
  • Increment the tag version accordingly
• Commit to CVS
• Tag with mpsgui-R###
• Check out the tagged version into production , e.g.

  cd $PHYSICS_TOP/release
  cvs co -r mpsgui-R0-1-8 -d mpsgui-R0-1-0 physics/mps/mpsgui r mpsgui-R### -d mpsgui-R##-# physics/mps/mpsgui

• Select File => New Java project => Create project from existing source
• Select $PHYSICS_TOP/release/mpsgui-R###
• Name the project mpsgui-R###
• Press "Finish"
• Right-click on the new project mpsgui-R### => Export...
• Select Java => JAR file
• Check mpsgui-R### in "Resources to export"
• Check "Export generated class files and resources"
• As the export destination, select and/or type

  $PHYSICS_TOP/release/mpsgui-R###/jar/mpsgui.jar

Immediate Release
java.lang.NullPointerException
at edu.stanford.slac.mpsgui.controller.ignorelogic.IgnoreLogicViewer.checkCurrentIgnoreLogic(IgnoreLogicViewer.java:80)
at edu.stanford.slac.mpsgui.controller.ignorelogic.IgnoreLogicViewer$1.run(IgnoreLogicViewer.java:44)
at java.lang.Thread.run(Thread.java:595)

...