Installation of the FESA3 Development Environment for FESA3 2.2.2 / 2.3.2

ASLCluster asl73x

Machines that are to be used @GSI for FESA3 development: asl730-asl734. Log in is possible with a valid GSI Linux account only. For more information on this please contact GSI's accelerator infrastructure.

In the environment named above the latest FESA3 development environment is available. Everything that is required to develop FESA3 equipment software is located in /opt/fesa/fesa-fwk/2.x.x.

Eclipse Luna

Eclipse Luna including CDT is pre-installed in order to develop FESA3 equipment software. The FESA Eclipse plug-in must be installed via an update-site. Each additional Eclipse plug-in will be installed in the users home directory into a hidden folder named .eclipse-luna.

The Eclipse IDE may be started and detached from the console window with the command

eclipse-luna&

FESA3 Plug-In Update Site

The FESA3 Eclipse Plug-in's update site URL is https://www-acc.gsi.de/data/eclipse-luna/fesa . To install additionally required plug-ins make sure "Contact all update sites during install to find required software" is checked.

First Initialization

If a new user has never used Eclipse / the FESA plug-in before Eclipse's Secure Storage mechanism needs to be configured. Since the user's credentials are required for SVN repository checks during delivery of FESA software projects the credentials need to be stored in a secure way.

Once the FESA plug-in is launched for the first time the user is asked to enter his credentials. This should be done once. But unfortunately there is an issue: The next time this dialog pops up it should be canceled. Afterwards the secure storage settings can be performed by setting a master password. Afterwards the FESA plug-in is usable.

Recommended Plug-Ins

• For remote debugging: ELT Terminal - http://elt.googlecode.com/git/update-site
• For remote debugging: Remote Systems Explorer End-User Runtime / User Actions from http://download.eclipse.org/releases/luna, section Mobile and Device Development

Useful Update Sites - Pre-installed Plug-Ins - deprecated

(For completeness only other useful update sites are given:

• Eclipse Kepler - http://download.eclipse.org/releases/luna

)

It is generally recommended to restart the Eclipse IDE between the different plug-in installations as suggested.

Update

If you want to update the already installed FESA3 Eclipse plug-in please uninstall the existing plugin first (Menu: Help > Install new software... > What is already installed?). Restart eclipse as suggested. Install the plug-in from the update site https://www-acc.gsi.de/data/eclipse-luna/fesa as described above. A possible error during installation is a Checktrust-Error. This can happen if a package is not properly copied from the server. An expert may update the necessary files manually if necessary, please refer to the FESA core team at GSI.

---

FESA Settings

Check the FESA3 settings in Window > Preferences > FESA.

Build

The FESA software will be compiled in parallel on multi-core machines. The number of parallel threads may be defined on this preference page. The default is set to 8. On single-core machines this parameter is automatically ignored during compilation.

Editors

Editor colors: these settings allow to define your own color settings for the FESA design view. The idea is to be able to increase the contrast in comparison to the default settings of Eclipse's XML Editor. A few color schemes are prepared.

Expert

This GSI specific preferences page allows to tweak the desired workflow to simplify development of FESA3 software. Please use these settings only if you know what you do.

Delivery Options:

• Don't check source code repository: allows to skip source code repository checks during delivery
• Don't generate source code: allows to skip synchronisation of the source code during the delivery process.
• Don't compile source code: allows to skip the automatic compilation during delivery
• Export to database: opt-in to export FESA class / deploy-unit designs to the database during delivery

Class Creation:

• Allow invalid class design templates: when selecting own class template files during class creation skip the validation
• Format FESA design documents on save: format the XML design documents during save of the documents

Linux Delivery Options

• FESA installation command
• FESA user group name

FESA administrators may change the installation parameters that are used to deploy the FESA software.

Framework

If you are a FESA administrator, set the XML resources directory to opt/fesa/fesa-fwk/ or your preferred (local) FESA development directory. This field is visible only when having FESA administration rights. Otherwise no other fields will be displayed.

Logging

• Log level: INFO : allows to select the level of the log messages displayed in the Console View.
• Output log directory: /home/<username>/.logs/fesa-plugin : allows to define the location of the plug-in log file, the default is in the user's home directory.
• Bring console to the top for every log message

Repository

• Login: Linux account name
• Password: matching password

The repository password is stored encrypted using Eclipse's secure storage mechanism. It is possible to define questions/answers that might help to retrieve the secure storage master password if it is forgotten. The secure storage password is requested upon start-up of the FESA3 plug-in and is needed when accessing the SVN repository. More information on working with Eclipse's Secure Storage Mechanism is found in the FESA3 FAQ section.

Settings

Common expert settings section.

• Do not check repository during delivery : skip the SVN checks during delivery
• Format XML documents on save : automatically pretty-prints FESA design documents during save.
• Allow broken FESA class templates : during creation of new FESA classes it is allowed to load class templates different than the basic ones. These must not necessarily be valid. If that is the case this option is required.
• Auto Save : Define the interval in which FESA design documents are automatically saved.

FESA Perspective

Open the FESA3 perspective using Window/Open Perspective/Other.../FESA. The FESA perspective contains the Project Explorer on the left, the Outline and the C++ Make Targets View on the right. The FESA plug-in makes use of the usual Eclipse views and provides a view for FESA projects and their relevant files:

• Console View - display FESA information and error messages depending on the log level settings
• Browser View - displays FESA documentation depending on the selected element in a FESA document or displays the created HTML documentation
• Problems View - display validation errors of FESA documents per FESA project
• FESA Workspace* - display FESA projects only in a clearly arranged manner and provide the most significant FESA functions

FESA3 Eclipse Configuration

In order to use Eclipse's SVN Repository View to gain access to the SVN repository locations the user credentials have to be entered for at least one repository location. The SVN repository locations for FESA3 development are provided automatically by the FESA3 Eclipse Plug-In, only the access has to be configured for the SVN connector. The following screenshot displays the recommended settings.

C++ Settings

If code analysis does not work properly this may be caused by a erroneous setting in the C/C++ Indexer Preferences. Please ensure that the build configuration for the C/C++ Indexer is set to "Use active build configuration". In Eclipse check Window>Preferences>C/C++>Indexer>Build configuration for indexer.

---

Troubleshooting

Eclipse does not allow to switch to the FESA perspective: Delete the folder .eclipse/org.eclipse.equinox.security_* in your home directory. This folder contains the secure storage information. When editing the FESA repository preferences select a new secure storage password.

---

* GSI feature