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

Design

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

...

• 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 the following arguments:

    Code Block
    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

...

with 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

  Code Block
  cd $PHYSICS_TOP/release cvs co -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, type (and/or select)

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

• Press "Finish"
• Move the symbolic link

  Code Block
  cd $PHYSICS_TOP/ rm -rf mpsgui; ln -s release/mpsgui-R#-#-# mpsgui

• Launch from lclshome
  • MPS Global => MPS GUI...
  • MPS Global => MPS CUD...

...