Installation Notes

Java

Oracle Java Platform 8 (JDK) must be installed. Installation packages can be downloaded from here:

Java Platform, Standard Edition: http://www.oracle.com/technetwork/java/javase/downloads/index.html

Note: Open-JDK cannot be used because of the lack of JavaFX support.

Java 9/10

Current version of CS-Studio doesn't run on the Java 9/10 VM. If you have installed Java 9 (possibly because you are evaluating or working with it) and Java 8, then you need to tell CS-Studio to used Java 8.

On MacOS X
  • Right-click on the ESS CS-Studio.app application and select Show Package Contents menu item;
  • Navigate into the Contents/Eclipse folder and edit the ESS CS-Studio.ini file;
  • Before --launcher.library add the following two lines:

-vm

/Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk/Contents/Home/jre/bin

where jdk1.8.0_181.jdk should be replaced by the Java 8 version you have installed.

On CentOS
  • Edit the /opt/cs-studio/ESS CS-Studio.ini file;
  • Before --launcher.library add the following two lines:

-vm

/usr/java/jdk1.8.0_181/jre/bin

where jdk1.8.0_181 should be replaced by the Java 8 version you have installed.

On Windows (Unsupported Platform)
  • Edit the ESS CS-Studio.ini file inside the application folder;
  • Before --launcher.library add the following two lines:

-vm

C:\Program Files\Java\jdk1.8.0_181\jre\bin\

where jdk1.8.0_181 should be replaced by the Java 8 version you have installed.

Memory

CS-Studio runs pretty well on machine with at least 4 GBytes. If it must be run from inside the ESS DM, at least 8 GBytes are necessary, allocating 4 for the DM.

css-update

The supported method to update CS-Studio in the DM is described here.

Documentation

Development

Ver. 4.6.1.12

What Is Changed

  • BOY Fix: Combo box: Ignore mouse wheel on Linux without breaking use on Mac.
  • RDB Archive Fix: Write NaN for scalar component of zero-sized array.
  • Display Builder Fix: Don't use image cache in edit mode in Picture and Symbol widgets.
  • Display Builder Fix: Refresh embedded display when changing its macros.
  • Display Builder Fix: Reload Display in editor mode should check whether the file is saved.
  • Display Builder Fix: Text widgets use their text in tool tip's $(pv_value).

Production

Ver. 4.6.1.11 (28.11.2018)

Various fixes and updates.

What Is Changed

  • Display Builder Fix: More object disposed when an OPI is closed, speeding up GC.
  • Display Builder Fix: Further improvements on Meter widgets initial PV value display.
  • Display Builder Fix: Tooltip not working in Ellipse, Arc, Polygon and Polyline.
  • Display Builder Fix: Vertical scrollbar widget not redrawn when height changed.
  • Display Builder Update: Debug option to show update rate in plots.
  • Display Builder Update: Added missing labels to ByteMonitor widget.
  • Display Builder Update: Added missing "foreground" property to CheckBox and Image widgets.
  • Phoebus Integration New: Added integration with the Phoebus Alarms applications.
  • Phoebus Integration New: Added integration with the Phoebus ChannelFinder application.

Ver. 4.6.1.10 (23.10.2018)

Various fixes and updates.

What Is Changed

  • Display Builder Fix: Symbol widget not always loading images correctly.
  • Display Builder Fix: Better handling of SVGs in Symbol and Picture widgets.
  • Display Builder Fix: Gauges and Meter widgets not initially displaying the current PV value.
  • Display Builder Fix: Knob widget in strange state if right-clicked into the thumb lane.
  • Display Builder Fix: Spinner widget autonomously spinning if right-clicked or dragged on its buttons.
  • Display Builder Fix: ScrollBar widget autonomously increasing/decreasing if right-clicked on its buttons.
  • Display Builder Fix: ScaledSlider widget updating value is right-clicked on its thumb lane.
  • Display Builder Fix: Meter widget minor ticks can disappear if minimum is negative and minor thicks space is non-integer.
  • Display Builder Update: Meters examples.

Ver. 4.6.1.9 (02.10.2018)

Various fixes and updates.

What Is Changed

  • Display Builder Fix: '!' used in text inside rules converted to 'not'.
  • Display Builder Fix: Newly (empty) created Table widget not attached to a PV displays one strange cell of data. 
  • Display Builder Update: It is now possible to choose which .opi files should be opened in BOY when the action is performed inside a Display Builder OPI. By default all .opi files will be opened by BOY unless the same file with extension .bob is found instead.
  • Display Builder Update: Script API help.
  • Display Builder Update: Jython script engine updated to ver. 2.7.1.
  • Display Builder New: Added a property to allow verbose .bob files.
  • Display Builder New: Slider Button widget. 
  • BOY Fix: Reverted the default named colours and fonts, leaving only the specific Display Builder's non-default ones.
  • EDM/EDL Converter Update: Settings updated.

Ver. 4.6.1.8 (03.09.2018)

Various fixes and updates.

What Is Changed

  • CS-Studio Fix: Problems connecting to MySQL databases after driver updates.
  • CS-Studio Update: Improved the build system to keep only the last 7 builds of the development version.
  • BOY: Added Display Builder's colours and fonts definition to BOY's ones.
  • Display Builder Update: Table widget behaviour  now similar to a spreadsheet (e.g. Excel).

Ver. 4.6.1.7 (23.08.2018)

Various fixes and updates.

What Is Changed

  • Archiver Fix: The archive engine takes time to start and archive samples.
  • Data Browser Fix: Cancel button fails on to cancel search if it is taking a long time.
  • Data Browser Fix: Automatic value axes naming can be wrong sometimes.
  • Data Browser Update: In non-scrolling mode, the future area is shaded gray.
  • Data Browser Update: Help page.
  • Data Browser Update: Allow plot_bins as scaling factor for display width.
  • Display Builder Fix: BLUE-BORDER colour.
  • Display Builder Fix: Single-image Symbol widget not properly saved if created by D&D.
  • Display Builder Fix: Symbol widget not updated if a symbol file is updated.
  • Display Builder Fix: Text not perfectly centred in LEDs.
  • Display Builder Fix: Widget initial value update in case PV sent value before listening.
  • Display Builder Fix: No context menu in standalone windows.
  • Display Builder Fix: ScriptUtil.closeDisplay(widget) not working for standalone windows.
  • Display Builder New: Allow dragging widget's primary "pv_name" as text from the OPI runtime.
  • Display Builder Update: Added LEDs colours to ESS colour themes.
  • Display Builder Update: Flat LEDs, improving their contrast and legibility.
  • Display Builder Update: Added line_color to LED and MultiStateLED.
  • Display Builder Update: X/Y Plot with unnamed tracks will not display the EGU.
  • Display Builder Update: More details in Plot Configuration Dialog.
  • Waveform View Update: support multiple traces.
  • CS-Studio New: First implementation of a Phoebus integration plugin.
  • CS-Studio Update: MySQL drivers updated to ver. 8.

Ver. 4.6.1.6 (02.08.2018)

Various fixes and updates.

What Is Changed

  • Display Builder Fix: PVs can't contain '=' inside their name.
  • Display Builder Fix: Rules using expressions with <= and >= are no more working.
  • Display Builder Update: X/Y Plot allows scalar, showing them only when Point Type is different from None.

Ver. 4.6.1.5 (27.07.2018)

Various fixes and updates.

What Is Changed

  • Fix: ESS fonts not correctly loaded when the folder name contains blanks.
  • Fix: Archiver link to a PV can't be established if the PV name has macro inside.
  • Fix: PVUtil.getVType(…) made visible to scripts.
  • Fix: Locales are ignored when changing a PV value.
  • Fix: NPE on right-clicking the runtime of an empty display model.
  • Fix: Missing Data Browser foreground colour.
  • Fix: Initial symbol (not SVG) not displayed by Symbol widget.
  • Fix: SVGs no more displayed by BOY.
  • New: Logarithmic X scale in X/Y Plot widget.
  • New: Confirmation dialog added to CheckBoxWidget, RadioWidget, ComboWidget, ActionWidget.
  • New: Find Widgets… menu item in the Overview tree contextual menu.
  • Update: Display Builder Script API help.

Ver. 4.6.1.4 (18.06.2018)

Various fixes and updates.

Ver. 4.6.1.3 (05.06.2018)

New font selector. Widget name editable from Overview. Bug fixes and improvements.

Ver. 4.6.1.2 (22.05.2018)

Improved SVG visualisation. Standalone windows always on top of the main one.

Ver. 4.6.1.1 (17.05.2018)

Eclipse RCP 4.7 Oxygen, and bug-fixes.

Ver. 4.6.1.0 (27.04.2018)

New features, performance improvements and bug-fixes.

Ver. 4.5.7.1 (21.03.2018)

New features, performance improvements and bug-fixes.

Ver. 4.5.7.0 (08.03.2018)

New features including improved workflow and usability in Rules dialog, performance improvements and bug-fixes.

Ver. 4.5.6.1 (13.02.2018)

New features including improved workflow and usability in Rules dialog, performance improvements and bug-fixes.

Ver. 4.5.6.0 (31.01.2018)

New features including Thumb Wheel widget, performance improvements and bug-fixes.

Ver. 4.5.1.1 (24.10.2017)

Mostly bug fixes and performance improvements.

Ver. 4.5.1.0 (28.08.2017)

First version including the Knob widget for Display Builder.

Ver. 4.5.0.2 (07.08.2017)

Including SymbolWidget and TextSymbolWidget.

Ver. 4.5.0.1 (10.07.2017)

Various improvements and bug fixes.

Ver. 4.5.0.0 (22.03.2017)

Web menu items pointing to ESS services.

Ver. 4.4.1.4 (14.03.2017)

First version including meters and gauges widgets in Display Builder.

Ver. 4.4.1.3 (31.01.2017)

First version including the new Data Sources preference pages.

Ver. 4.4.1.2 (16.01.2017)

First version including the new Data Sources preference pages.

Ver. 4.4.1.1 (18.10.2016)

First version including the new Display Builder OPI engine.

Ver. 4.4.1.0 (26.08.2016)

First official ESS version of CS-Studio.

Community Editions

CS-Studion Community Editions (CE).


  • No labels

4 Comments

  1. Claudio Rosati I stumbled onto this by accident. It solved my installation problems on my windows 10 when I added

    -XX:-UseCompressedOops
    -vm
    C:\Program Files\Java\jdk1.8.0_191\jre\bin\
    -vmargs


    The page is not part of any space, could you link/move it to where the other CS Studio pages are?

  2. Hello Nicklas Holmberg

    If you installed Java 8 as your default one, you should not need to add -vm thing. Moreover remember that we don't officially support Windows. Anyway, I'll add few lines in the installation notes.

    This page is not part of any space because it is visible from the outside without need of logging into Confluence. Which are the pages you would like to have a link? If you're in Confluence you can just search for CS-Studio Releases and it comes out with the link.

    1. Ok, I just had a bit of difficulty to find the installation instructions. My intuition led me to the CS-Studio page, but I did not think to look in ESS CS-Studio Releases for these instructions.

  3. OK, thank you. I'll add it to this page too.