Windows Installation


Latest guide:  


In order to having a correct and complete installation over Windows, you must install Phoebus, Java, Python as a auxiliary projects.
In addition, in order to use the SPARC control System you have to download the repository from https://baltig.infn.it/lnf-da-control/epik8-sparc
We provide a script  that automatize all the installation sequence.
In particular the script will:

  1. Install Git, Java, Python
  2. Install Phoebus
  3. Download the SPARC repository
  4. Synchronize the settings of Phoebus with the one used in the SPARC repository
  5. Associate Phoebus as default app for opening .bob
  6. Create a desktop shortcut named "SPARC LAUNCHER" that will open the root form of the control system.

The script has to be executed with Powershell.
Before launching the script, please check the execution policy of the scripts in your Windows pc with the following Powershell command:

Get-ExecutionPolicy

In case of Restricted, you must set the ExecutionPolicy at RemoteSigned with the following line:

Set-ExecutionPolicy RemoteSigned

Script location is inside the baltig repository, in the opi submodule: https://baltig.infn.it/lnf-da-control/sparc-epics-opi  You need to download it from baltig or use git clone to download with the whole project.
The script name is installPhoebusWindowsEnvironment.ps1

Complete installation

If you need the complete installation, open a Powershell and launch the script with the parameter "install"

./installPhoebusWindowsEnvironment.ps1 install

Note:
The script is designed to work as user "sparc". If you want install to a different folder, please edit into the script the variable $destinationPath.


Update installation


Once your setup is complete and your Phoebus installation is working is possible to use this script to update the epik8-sparc project and getting the updated Phoebus settings, launching the script without any parameter


./installPhoebusWindowsEnvironment.ps1


It is possible to launch the script in update version via normal command shell, and also via ssh.
Just add the call to the powershell in the command line, as follows:

powershell ./installPhoebusWindowsEnvironment.ps1

Note:
The script is designed to work as user "sparc". If you want install to a different folder, please edit into the script the variable $destinationPath.




 

Download and Setup 

For INFN user,  use customized phoebus version https://opensource.lnf.infn.it/binary/epics/phoebus/ .

There are distributions compiled for MAC (x86,arm), Windows. These distributions contains just application a java virtual machine >=17 must be present.

For MAC users


tar xvfz latest.tar.gz
unzip phoebus-macos-xxx.zip
mv product-<version>-INFN /Applications/CSS_Phoebus.app/ ## of a previous installation
## create a symbolic link
cd  /Applications/CSS_Phoebus.app/ 
ln -sf product-<version>-INFN/product.jar phoebus-product.jar
## create an alias inside .bashrc
alias phoebus="java -jar /Applications/CSS_Phoebus.app/phoebus-product.jar"


For linux users

wget https://opensource.lnf.infn.it/binary/epics/phoebus/linux/latest.tar.gz
tar xvfz latest.tar.gz

## ln -sf product-<version>-INFN/product.jar phoebus-product.jar
## create an alias inside .bashrc
alias phoebus="java -jar phoebus-product.jar"



A working control interface can be obtained by installing Phoebus (a variant of CSS that is going to replace CSS).

Steps:

  1. download and install Phoebus https://controlssoftware.sns.ornl.gov/css_phoebus/
  2. git clone https://baltig.infn.it/lnf-da-control/sparc-epics-opi.git --recurse-submodules
  3. follow instruction to setup settings https://control-system-studio.readthedocs.io/en/latest/preferences.html (settings.ini in the project setup the correct parameter to connect to the IOC)
  4. launch the application and open 
  5. run

Phoebus Online HELP

 phoebus.sh -settings settings.ini

Mac specific initialization

If previous setting fails do:

cd /Applications/CSS_Phoebus.app
cd phoebus-4.7.4-SNAPSHOT (or alternative version)
vi phoebus.desktop
## add -settings settings.ini # or other setting file
Exec=~/bin/phoebus -settings settings.ini -resource %f
 phoebus.bat -settings settings.ini

settings.ini:

settings.ini 
org.phoebus.pv.ca/addr_list=<Address of gateway of your k8s ECS installation>
org.csstudio.trends.databrowser3/urls=pbraw://<epicsarchiver of your installation>.okd-datest.lnf.infn.it/retrieval
org.csstudio.trends.databrowser3/archives=pbraw://<epicsarchiver of your installation>.apps.okd-datest.lnf.infn.it/retrieval


See EPIK8s Sparc for an example of these entrypoints


Training Materials


Training 2020 DisplayBuilder.pdf