Install directions

Build EPICS base

Warning

Make sure the disk partition hosting ~/epics is not larger than 2 TB. See tech talk and Diamond Data Storage document.

$ mkdir ~/epics
$ cd epics

• Download EPICS base latest release, i.e. 7.0.3.1., from https://github.com/epics-base/epics-base:

  $ git clone https://github.com/epics-base/epics-base.git
  $ cd epics-base
  $ make -sj
  

Build a minimal synApps

To build a minimal synApp:

$ cd ~/epics

• Download in ~/epics assemble_synApps.sh

• Edit the assemble_synApps.sh script as follows:

  1. Set FULL_CLONE=True

  2. Set EPICS_BASE to point to the location of EPICS base. This could be on APSshare (the default), or a local version you built.

  For mctoptics you need

  1. ASYN=R4-37

  2. AUTOSAVE=R5-10

  3. BUSY=R1-7-2

  4. XXX=R6-1

  You can comment out all of the other modules (ALLENBRADLEY, ALIVE, etc.)

• Run:

  $ assemble_synApps.sh
  

• This will create a synApps/support directory:

  $ cd synApps/support/
  

• Edit asyn-RX-YY/configure/RELEASE to comment out the lines starting with:

  IPAC=$(SUPPORT)/
  SNCSEQ=$(SUPPORT)/
  

Warning

If building for RedHat8 uncomment TIRPC=YES in asyn-RX-YY/configure/CONFIG_SITE

• Clone the mctoptics module into synApps/support:

  $ git clone https://github.com/tomography/mctoptics.git
  

• Edit configure/RELEASE add this line to the end:

  MCTOPTICS=$(SUPPORT)/mctoptics
  

• Edit Makefile add this line to the end of the MODULE_LIST:

  MODULE_LIST += MCTOPTICS
  

• Run the following commands:

  $ make release
  $ make -sj
  

Testing the installation

• Edit /epics/synApps/support/mctoptics/configure to set EPICS_BASE to point to the location of EPICS base, i.e.:

  EPICS_BASE=/APSshare/epics/base-3.15.6
  

• Start the epics ioc and associated medm screen with:

  $ cd ~/epics/synApps/support/mctoptics/iocBoot/iocMCTOptics
  $ start_IOC
  $ start_medm