Managed by UT-Battelle for the Department of Energy Kay Kasemir ORNL/SNS 2011, October at CEA Saclay, France Control System Studio Training - Compiling, configuring, running CSS

2Managed by UT-Battelle for the Department of Energy Getting CSS to run from source code 1.Get Java, Eclipse, CSS Sources 2.Start Eclipse 3.“Import” sources into Workspace 4.Open CSS *.product file, Launch 5.Maybe export *.product

3Managed by UT-Battelle for the Department of Energy Java, Eclipse  Check: Is java available? java -version Need Java 1.6, Sun/Oracle; Not GCJ, OpenJDK  Start Eclipse eclipse/eclipse “Workspace”: use CSS/Workspace in your home directory

4Managed by UT-Battelle for the Department of Energy Eclipse Workspace  Workspace: Directory with “.metadata” subdir. –Tracks currently open window, …  Source code: May be in Workspace dir. or elsewhere –We use CSS/Sources in home dir.

5Managed by UT-Battelle for the Department of Energy Eclipse Workspace “Import” Sources into Workspace: –File/Import…, General, Existing Projects into Workspace –Select source directory, import all projects found –Do not “Copy projects into Workspace” Note: Need to “Import” even if sources are already located in workspace directory

6Managed by UT-Battelle for the Department of Energy Run Product Open org.csstudio.basic.epics.product/*.product Press 1.Synchronize 2.Launch an Eclipse application

7Managed by UT-Battelle for the Department of Energy Control System Want to concentrate on CSS.. still need a control system to talk to a)Use built-in simulation PVs sim://sine sim://ramp sim://noise b)Use provided demo databases softIoc -m user=demo1 –s -d tank.db -d control.db Use your group number instead of “1”. Run ‘dbl’ to see list of records.

8Managed by UT-Battelle for the Department of Energy First Steps  Check CSS/Preferences/CSS Core/EPICS –Channel Access address list: ?  CSS/Diagnostic Tools/Probe  CSS/Diagnostic Tools/EPICS PV Tree  Move Windows around  Context menu

9Managed by UT-Battelle for the Department of Energy Check Point We can compile, launch, use CSS  Brief Look: Composition of a “Product”  Hierarchical Preferences

10Managed by UT-Battelle for the Department of Energy Product, Features

11Managed by UT-Battelle for the Department of Energy Brief Look: Plugins, Extension Points  org.csstudio.diag.probe – plugin.xml –Dependency on..utility.pv  org.csstudio.utility.pv –Extension point pvfactory  org.csstudio.utility.pv.epics –Implements that ext. point for “ ca ” –Depends on..libs.epics  org.csstudio.platform.libs.epics

12Managed by UT-Battelle for the Department of Energy Hierarchical Preferences  org.csstudio.platform.libs.epics preferences.ini: addr_list=  Product’s plugin_customization.ini: org.csstudio.platform.libs.epics/addr_list=  Command-line

13Managed by UT-Battelle for the Department of Energy Exercise: Preferences  In your home directory, create a file “my_css_settings.ini”  Add a line org.csstudio.platform.libs.epics/addr_list= –Use the IP address of your computer instead of  Run CSS with option -pluginCustomization /path/to/your/my_css-settings.ini –Need to check menu Run/Run Configurations… to do this from within the IDE  When you now view the CSS/Preferences/CSS Core/EPICS settings, press “Default”, does it use the value from your settings.ini?

14Managed by UT-Battelle for the Department of Energy Exporting a Product Export Product –Root Directory Name, e.g. “ css ” no path! –Destination Directory Path, e.g. /usr/fred/CSS/bin –Un-check “Generate metadata repository”  Finish, try the result

15Managed by UT-Battelle for the Department of Energy Exercise: Various smaller CSS Products  Find all *.product files (see docbook)  Start from IDE, or export & then start: org.csstudio.archive.engine/ArchiveEngine.product org.csstudio.archive.config.rdb/ArchiveConfigTool.product org.csstudio.alarm.beast.server/AlarmServer.product org.csstudio.alarm.beast.configtool/AlarmConfigTool.product org.csstudio.sns.jms2rdb/JMS2RDB.product The point is to be able to start these tools. They will exit with errors, for example about missing database connections. For now you should simply be able to start them.

16Managed by UT-Battelle for the Department of Energy Advanced Exercise: Update Repository  Export product, copy somewhere –This will be the “old” product.  Change something in code –Product’s into/overview.xml? –Product’s plugin_customization.ini settings  Increment version number of affected plugin, feature, product  Export new product with “Generate metadata repository” –This is now the “new” product. Locate the generated repository.  You could run the new product, but start the old Product, then use Help/.. to update from repository to the new product

17Managed by UT-Battelle for the Department of Energy Advanced Exercise: Headless Build  Read the docbook chapter  Check scripts of one or more existing headless build setups  Try to use one