EPICS site GSI | Projects & Activities | EPICS site

EPICS installations at GSI - Base installation

1 Preface

1.1 Scripts: #!/bin/bash

Up-to-now: All tools rely on bash shell scripting.

1.2 some global environment variables during installation

During installation those environment variables are used to define a common setup environment

ALL_EPICS_TOP_DIR: top directory which holds different EPICS versions and whose bin directory is included in $PATH (e.g. ~epics, /usr/local/pub)
EPICS_DOWNLOAD_DIR: directory where you store your downloads
EPICS_HOME: directory where your current installation should be (installed)
EPICS_VERSION: version to be installed

therefore do the export here:


   # Global installation settings


 echo -n '<All Epics Top Directory>: ' && read ALL_EPICS_TOP_DIR &&  export  ALL_EPICS_TOP_DIR

 echo -n '<EPICS Home Directory>: ' && read EPICS_HOME &&  export  EPICS_HOME

 echo -n '<Download Directory>: ' && read EPICS_DOWNLOAD_DIR &&  export  EPICS_DOWNLOAD_DIR

 echo -n '<EPICS Version>: ' && read EPICS_VERSION &&  export  EPICS_VERSION

2 General Preparations

Following the corresponding https://epics-controls.org/base/R7-0/4-docs/README.html (local copy) section Building EPICS base (Unix and Win32) provided in the download area, which is titled Installation Instruction, do the following:

2.1 Checks

Check the supported compilers
Check the software requirements

Software requirements of version 7.0.4

GNU make: You must use GNU make, gnumake, for any EPICS builds. Set your path so that a gnumake version 3.81 or later is available.
gcc: You must have gcc version 3.4.2 or later.
Perl: You must have perl version 5.8 or later installed. The configure files do not specify the perl full pathname. You need the perl executable in your search path.
GNU readline or Tecla library: (optional, but recommened)

source: https://epics-controls.org/base/R7-0/4-docs/README.html

2.2 Create Directory and Download Sources

2.2.1 Preface - GSI: Facing different versions flavors of OS, architectures and compilers

Show ... (Expand all... Collapse all)

Since releases and versions are evolving and to be able to follow this trend, the normal user logged in to Linux system at GSI can rely on having the following environment variables available:

GSI_OS_FLAVOR
GSI_OS_VERSION
GSI_COMPILER_CC

Based on this the installations of epics can be found in directories based on the following scheme:

${GSI_OS_FLAVOR:?undefined}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/$[0-9]\+\.[0-9]\+$\.[0-9]\+/\1/g'/$(uname -m)/${GSI_COMPILER_CC:?undefined}

At the moment /u/epics/ holds all EPICS versions without considering this scheme, but will be in future:

/u/epics/EPICS/${GSI_OS_FLAVOR:?undefined}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/$[0-9]\+\.[0-9]\+$\.[0-9]\+/\1/g'/$(uname -m)/${GSI_COMPILER_CC:?undefined}/EPICS-X.YY.ZZ

...and a little bit later:

/usr/local/pub/${GSI_OS_FLAVOR:?undefined}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/$[0-9]\+\.[0-9]\+$\.[0-9]\+/\1/g'/$(uname -m)/${GSI_COMPILER_CC:?undefined}/EPICS-X.YY.ZZ

By using the epics script ( see below) every user is directed to the corresponding set of versions.

2.2.1.1 Directory Setup

Show ... (Expand all... Collapse all)

Here you can find a sketch of how the directories are related with each other

Nomenclature

file

link to a file

directory

link to a directory

/usr/local/bin
- contains (soft) links to <GSI's EPICS Installation Top Directory>/bin/
  - where at the moment:
    - <GSI's EPICS Installation Top Directory> is =~epics/EPICS =
  - but will be:
    - /usr/local/pub
- linked files
  - epics

<GSI's EPICS Installation Top Directory>

<GSI's EPICS Installation Top Directory>

bin/

epics

epicslogin.sh

fcn_addtopath.bash

uniqpaths

EPICS-<Version A.BB.CC>[_<optional Suffix>] (old structure, supported until new structure has established)

...

EPICS-<Version X.YY.ZZ> (old structure, supported until new structure has established)

EPICS

${GSI_OS_FLAVOR}${GSI_OS_VERSION}/$(uname -m)/${GSI_COMPILER_CC}

(same sub structure as for EPICS directory in the local installation, see below)

<All local EPICS top directory>

<All local EPICS top directory>

.profile / .bashrc

( could contain settings for EPICS_LOCAL_... settings for epics script:

EPICS_LOCAL_HOME_DIR=EPICS/${GSI_OS_FLAVOR}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/$.\..$\../\1/g')/$(uname -m)/${GSI_COMPILER_CC} )

bin

(should be included in the lookup path PATH)

epics

(recommended to be a (soft) link to <GSI's EPICS Installation Top Directory>/bin)

epicslogin.sh

(recommended to be a (soft) link to <GSI's EPICS Installation Top Directory>/bin)

fcn_addtopath.bash

(recommended to be a (soft) link to <GSI's EPICS Installation Top Directory>/bin)

uniqpaths

(recommended to be a (soft) link to <GSI's EPICS Installation Top Directory>/bin)

programs

pro/dev (optionally)

${GSI_OS_FLAVOR}${GSI_OS_VERSION}/$(uname -m)/${GSI_COMPILER_CC}

bin

(should be included in the lookup path PATH)

lib

(if necessary should be included in the lookup e.g. path LD_LIBRARY_PATH)

include

<Installation directory 1> (e.g. axis, missing libraries, tweaks)

...

<Installation directory N>

EPICS

${GSI_OS_FLAVOR}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/$.\..$\../\1/g')/$(uname -m)/${GSI_COMPILER_CC}

EPICS-<Version A.BB.CC>[_<optional Suffix>][_dev]

(w/ suffix: _dev: development versions, place for first installation of new/changed code, may not be working)

(w/o suffix: _dev: production versions, only changed, if changes work in _dev)

...

EPICS-<Version X.YY.ZZ>

myepicslogin.sh

(This setup file myepicslogin.sh is the only recommended place to change/tweak/modify settings for this local installation)

<other setup files> (optional: called by myepicslogin.sh)

epicslogin.sh

(recommended to be a (soft) link to <All local EPICS top directory>/bin)

fcn_addtopath.bash

(recommended to be a (soft) link to <All local EPICS top directory>/bin)

uniqpaths

(recommended to be a (soft) link to <All local EPICS top directory>/bin)

base ((soft) link auf base-<Version X.YY.ZZ>

base-<Version X.YY.ZZ>

configure

RELEASE : EPICS_BASE=$(EPICS_HOME)/base

CONFIG_SITE : =CROSS_COMPILE_TARGET_ARCH ... ==

startup

Site.profile

Site.profile.org.base.<DDYYMM>

extensions

(in case of problems, probably (soft) links to other ${GSI_COMPILER_CC} version directory)

configure (q.v. "base")

src

Makefile (master Makefile, edited during installation)

<Installation directory 1>

...

<Installation directory N>

modules

(in case of problems, probably (soft) links to other ${GSI_COMPILER_CC} version directory)

__bus__/...

configure (q.v. "base")

...

__soft__/...

configure (q.v. "base")

2.2.2 Download EPICS base

Version 7.0.4 (as of 2020 May 28 ).
Download from https://epics-controls.org/resources-and-support/base

Show ... (Expand all... Collapse all)

First export the environment variable(s)
- $element
containing the path to the home directory:
$> export EPICS_VERSION=7.0.4 $> export EPICS_HOME=<EPICS Home Directory>
Check neccessary ENVIRONMENT variables and stop if not set:
# Check installation environment variables %FOREACH{"env" in="EPICS_ALL_EPICS_TOP_DIR, EPICS_HOME_DIR, EPICS_DOWNLOAD_DIR, EPICS_VERSION"}% echo -n '%$env_DUMMY%: %$env_NAME% ->' && if [[ -z ${%$env_NAME%?} ]]; then die; false; else echo ${%$env_NAME%}; fi && %NEXT{"env"}% :
Then create home directory, if not yet existing:
$> mkdir -p $EPICS_HOME
Two alternatives open up:
- Git
  1. Download the version of Base (version as of 2020 May 28 is 7.0.4)
    from https://epics-controls.org/resources-and-support/base to the directory EPICS_HOME using gitr
    $> cd $EPICS_HOME && git clone --recursive -b 7-0 https://git.launchpad.net/epics-base base-7-0
- Tar Ball
  1. Then create download directory, if not yet existing:
    $> mkdir -p ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION}
  2. Download the version of Base (version as of 2020 May 28 is 7.0.4)
    from https://epics-controls.org/download/base to the directory ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION}
    $> cd ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION} && wget -N -nv https://epics-controls.org/download/base/base-7.0.4.tar.gz
  3. Untar and unpack the file to $EPICS_HOME
    $> cd $EPICS_HOME && tar -zxvf ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION}/base-7.0.4.tar.gz
Set the correct group (if you are a member of it): epicsadm , also set the correct access rights:
cd $EPICS_HOME && groups | grep -q -w epicsadm && chgrp -R epicsadm $EPICS_HOME && find $EPICS_HOME -user $(id -n -u) -exec chmod ug+rw {} \;
To make future settings easier:
$> cd $EPICS_HOME && ln -s -b base-* base

2.2.3 Download patches EPICS base

Starting from the page https://epics-controls.org/base/R7-0/4-docs/KnownProblems.html for each version may list several patches to be applied.

2.2.4 Compact - Directories/epics & Download of Base Sources

Show ... (Expand all... Collapse all)

2.3 Setting environment variables

There are at least two major possiblities:

recommended:
- either using simply epicslogin.sh_ (Site.profile set, fcn_addtopath.bash) and _myepicslogin.sh
- on top the epics script: epics (used for GSI installations)
minimum:
- Just EPICS_HOST_ARCH by hand

2.3.1 epics set of scripts

Show ... (Expand all... Collapse all)

2.3.1.1 epics

The epics script is a global script (used at GSI) to set the EPICS settings.

It relies on having ((symbolic) links to) myepicslogin.sh and epicslogin.sh in the EPICS versions home directories (installation, see below).
Usually it is only installed once for all EPICS distributions and is told (by default values, environment variables, options) where to look for the installations.
By just typing/sourcing epics (which is at GSI included in the default path) practical all settings are done.


   $> . epics

For more details use the help option: -h


   $> . epics -h

2.3.1.1.1 Usage: epics script

Show ... (Expand all... Collapse all)

epics has to be sourced as is, i.e. called with a leading dot

$> . epics -h

gives all information on options:


   epics [Options] [version]
   sets environment variables for EPICS
  
   * changes to corresponding EPICS HOME directory:
       [<HOME>/<PREFIX><VERSION>, default: /u/epics/EPICS-3.14.9]
   * and calls the (local) login script for this version
     * relies on having a (local) login script ( default: ./myepicslogin.sh ) 
       in the home directory of the corresponding EPICS installation
   * optionally might execute (source) scripts before and after the call to the login script
     * defaults:
        * before script: [ not set ]
        * after  script: [ not set ]

   arguments: 
       version: EPICS version (default: "3.14.9")

   options:
      -h : prints this Help
      -l : list all available versions in home directory /u/epics
      -s : stay at $EPICS_HOME directory
      -q : quiet no output, but error messages
      -v : verbose mode
      -d : debug mode, just echo no action
      -H argument : home directory of several EPICS versions
                    (default: "/u/epics")
      -P argument : version prefix for PREFIXversion
                    (default: "EPICS-")
      -L argument : login script looked for in $EPICS_HOME
                    (default: "./myepicslogin.sh")
      -B argument : script to be sourced before calling login script
                    (default: "[ not set ]")
      -A argument : script to be sourced after calling login script
                    (default: "[ not set ]")

   LOCAL environment variables:
     
      EPICS_LOCAL_HOME:
        the default home directory of the several EPICS versions can be modified
        by setting the environment variable 
        EPICS_LOCAL_HOME [at the moment not set]

      EPICS_LOCAL_DIR_PREFIX:
      the default search prefix for directories in /u/epics can be modified
        by setting the environment variable 
        EPICS_LOCAL_DIR_PREFIX [at the moment not set]

      EPICS_LOCAL_LOGIN_SCRIPT:
      the default call to the (local) login script
        in the epics installation directories can be modified
        by setting the environment variable 
        EPICS_LOCAL_LOGIN_SCRIPT [at the moment not set]

      EPICS_LOCAL_DEFAULT_VERSION:
      the EPICS version can be modified
        by setting the environment variable 
        EPICS_LOCAL_DEFAULT_VERSION [at the moment not set]

      EPICS_LOCAL_SCRIPT_BEFORE_LOGIN:
      the local script default for a script sourced befored login can be modified
        by setting the environment variable 
        EPICS_LOCAL_SCRIPT_BEFORE_LOGIN [at the moment not set]

      EPICS_LOCAL_SCRIPT_AFTER_LOGIN:
      the local script default for a script sourced after login can be modified
        by setting the environment variable 
        EPICS_LOCAL_SCRIPT_AFTER_LOGIN [at the moment not set]

   you have to call this script with a leading '. ', i.e. source it
--> i.e.: '. epics'

2.3.1.1.2 epics invocation scheme

Show ... (Expand all... Collapse all)

The setup script epics relies on other scripts in the EPICS versions home directories. Here you can see how those files are invoked:

Typically most of those files are just links to other places, except for myepicslogin.sh.
Based on the basic setup (see below) an adminstrator can add / modify / tweak at this recommended place.

. epics [ -Options ] [ <version> ]

general login script, able to call several EPICS installations

1. optional: <before script>

source <before script>

(set by environment variable: EPICS_LOCAL_BEFORE_SCRIPT, or overwritten by option -B <Path><bash script> )

2. <loginScript> "myepicslogin.sh"

source <loginScript>

local, i.e. to the single EPICS installation, login script

default :

"<epicsHome>/<epicsDirPrefix><version>/myepicslogin.sh"

overwritten by environment variable:

EPICS_LOCAL_LOGIN_SCRIPT

overwritten by option :

-L <Path><bash script>

2.1. optional <other local pre scripts> within <loginScript>:

source <other local pre scripts>

2.2. epicslogin.sh :

source <epicsHome>/<epicsDirPrefix><version>/epicslogin.sh

epicslogin.sh :

usually a (soft) link to $ALL_EPICS_TOP_DIR/bin

or to ${GSI_EPICS_INSTALLATIONS_TOP_DIR}/bin

2.2.1 source <epicsHome>/<epicsDirPrefix><version>/epicslogin.sh

in case it has been extended/changed to be wrapper this is a symbolic link to

$EPICS_HOME/base-<version>/startup/Site.profile.wrapper calling itself:

2.2.1.1 source $EPICS_HOME/base-<version>/startup/Site.profile.pre

most of the local default definitions before calling the former, but modified Site.profile

2.2.1.2 source $EPICS_HOME/base-<version>/startup/Site.profile.main

former Site.profile modified to be able to be more verbose

2.2.1.3 source $EPICS_HOME/base-<version>/startup/Site.profile.post

post jobs after calling Site.profile.main

2.3. optional: source <other local scripts, e.g. setting of PATHs, init of cross-compilers>

3. optional: source <after script>

(set by environment variable: EPICS_LOCAL_AFTER_SCRIPT, or overwritten by option -A <Path><bash script> )

Variables:
- <epicsHome>
  - default: ~epics/EPICS == (to become ==/usr/local/pub/${GSI_OS_FLAVOR:?undefined}$(echo ${GSI_OS_VERSION?undefined}| sed -e 's/$[0-9]\+\.[0-9]\+$\.[0-9]\+/\1/g'/$(uname -m)/${GSI_COMPILER_CC:?undefined})
  - override by environment variable: EPICS_LOCAL_HOME
  - overwritten by option: -H <Path>
- <epicsDirPrefix>
  - default: "EPICS-"
  - override by environment variable: EPICS_LOCAL_DIR_PREFIX
  - overwritten by option: -P <Prefix>
- <version>
  - default: 3.14.9
  - override by environment variable: EPICS_LOCAL_DEFAULT_VERSION
  - overwritten by argument: <Version>
- <loginScript>
  - default: "./myepicslogin.sh"
  - override by environment variable: EPICS_LOCAL_LOGIN_SCRIPT
  - overwritten by option -L <Path><bash script>
- <beforeScript>
  - default: [ not set ]
  - override by environment variable: EPICS_LOCAL_BEFORE_SCRIPT
  - overwritten by option -B <Path><bash script>
- <afterScript>
  - default: [ not set ]
  - override by environment variable: EPICS_LOCAL_AFTER_SCRIPT
  - overwritten by option -A <Path><bash script>

2.3.1.1.2.1 To install the epics script...

Only needed on non GSI cluster systems.

Show ... (Expand all... Collapse all)

Set ALL_EPICS_TOP_DIR to the top home directory of all epics installations (e.g. ~epics/EPICS)
$> export ALL_EPICS_TOP_DIR=<All Epics Top Directory>
If not yet existing create a bin directory ${ALL_EPICS_TOP_DIR}/bin
[ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p ${ALL_EPICS_TOP_DIR}/bin
If not yet existing create a tools directory ${ALL_EPICS_TOP_DIR}/tools
[ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p ${ALL_EPICS_TOP_DIR}/tools
User git clone --recursive to clone tools into $ALL_EPICS_TOP_DIR/tools== [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && git clone --recursive https://git.gsi.de/EPICS/epics-installations/all-epics-top-directories/tools.git ; ${ALL_EPICS_TOP_DIR}/tools 1 Change to the directory ==$ALL_EPICS_TOP_DIR/bin and create symbolic links to ${ALL_EPICS_TOP_DIR}/tools for at least the ${ALL_EPICS_TOP_DIR}/tools/bin/epics script.

 

       %FOREACH{"list" in="epics"}%
        %FOREACH{"item" in="$list"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :

make epics script available
- As superuser root you could create a soft link from /usr/local/bin to your epics script.
  or add $ALL_EPICS_TOP_DIR/bin to the PATH variable:
  #> if [ "$(id -u)" -eq 0 ]; then ln -s -b $ALL_EPICS_TOP_DIR/bin/epics /usr/local/bin else [ -d ${ALL_EPICS_TOP_DIR:?'undefined'}/bin ] && export PATH=ALL_EPICS_TOP_DIR}/bin:${PATH} fi

2.3.1.1.2.2 Compact - Epics Script Installation

Show ... (Expand all... Collapse all)

2.3.1.2 epicslogin.sh (fcn_addtopath.bash, uniqpaths, Site.profile / unix.sh set)

The recommended way is to use epicslogin.sh (bash script).

epicslogin.sh
which itself sources the script from <EPICS Base Directory>/startup/{Site.profile;unix.sh}
- uses those helper scripts to be put in a <Fcn Helper Bin Directory>
  (e.g. to the directory ${ALL_EPICS_TOP_DIR:-~epics}/bin)
  - fcn_addtopath.bash
    bash script containing some helping functions
  - uniqpaths
    perl script removing doubles in paths

2.3.1.2.1 Usage: epicslogin.sh

Show ... (Expand all... Collapse all)

epicslogin.sh has to be sourced as is, i.e. called with a leading dot

$> . ./epicslogin.sh

The option ' -h ' or anything else gives a help with all information on options and syntax:


           $> ./epicslogin.sh -h          
      epicslogin.sh [Options] [version]
   -- sets environment variables for EPICS
   -- calls the Site Profile: set via "-P" or default: "${baseDir}/startup/Site.profile"
   --
   -- version: EPICS version
   --          (default: "3.14.10")
   -- options:
   ----- -v : verbose mode
   ----- -h : prints this help
   ----- -H argument : sets $EPICS_HOME to argument
   -----               (default: "${homeofuser}/EPICS")
   ----- -B argument : sets $EPICS_BASE to argument or
   -----               if argument is a relative path it extends to $EPICS_HOME/argument
   -----               (default: "base-${epicsversion}")
   ----- -P argument : sets Site Profile to be sourced to argument
   -----               (default: "${baseDir}/startup/Site.profile"
   -----                where $basedir behaves like EPICS_BASE
   -----                as described for option "-B")
   ----- -A argument : sets path to necessary helper script "fcn_addtopath.bash":
   -----               (default: "/u/epics/bin/fcn_addtopath.bash")
   -----
   ----- if MY_EPICS_BASE (="") is externally set as base directory:
   -----    case "option -B not used":
   -----                       EPICS_BASE set to MY_EPICS_BASE
   -----    case "option -B used:
   -----                       MY_EPICS_BASE set to EPICS_BASE
   -----
   ----- version: version of EPICS
   -----          (used in the path <epicshome>/base-version)
   -----
   -- you have to call this script with a leading '. '
   --> i.e.: '. epicslogin.sh'

thus, e.g.

 
                  . ./epicslogin.sh  -v -H <EPICS Home Directory> -B <EPICS Base Directory> -A <EPICS Home Directory> <EPICS Version>

gives

   sourcing <EPICS Home Directory>/EPICS-<EPICS Version>/base-<EPICS Version>/startup/Site.profile
   EPICS_HOME               set to <EPICS Home Directory>/EPICS-<EPICS Version>
   EPICS_BASE               set to <EPICS Home Directory>/EPICS-<EPICS Version>/base-<EPICS Version>
   EPICS_EXTENSIONS         set to <EPICS Home Directory>/EPICS-<EPICS Version>/extensions
   EPICS_MODULES            set to <EPICS Home Directory>/EPICS-<EPICS Version>/modules
   PSPRINTER                set to lp
   EPICS_DISPLAY_PATH       set to <EPICS Home Directory>/EPICS-<EPICS Version>/extensions/medm/adl
   ORBITSCREENHOME          set to <EPICS Home Directory>/EPICS-<EPICS Version>/extensions
   EPICS_AR_PORT            set to 7002
   added <EPICS Home Directory>/EPICS-<EPICS Version>/extensions/javalib behind CLASSPATH
   EPICS_SNCSEQ_HOME        set to <EPICS Home Directory>/EPICS-<EPICS Version>/modules/seq
   EPICS_HOST_ARCH          set to linux-x86
   added <EPICS Home Directory>/EPICS-<EPICS Version>/extensions/bin/linux-x86 in front of PATH
   added /u/epics/bin:<EPICS Home Directory>/EPICS-<EPICS Version>/base-<EPICS Version>/bin/linux-x86 in front of PATH
   EPICS_CA_ADDR_LIST       set to <hostname>
   EPICS_CA_AUTO_ADDR_LIST  set to NO
   --> Created for each variable EPICS_* a copy EPICS_*_COPY
       to be used in CONFIGURE scripts where EPICS_ variables might be overwritten

2.3.1.2.1.1 To install epicslogin.sh (fcn_addtopath.bash, uniqpaths) ...

Show ... (Expand all... Collapse all)

Set ALL_EPICS_TOP_DIR to the top home directory of all epics installations (e.g. ~epics/EPICS)
$> export ALL_EPICS_TOP_DIR=<All Epics Top Directory>
If not yet existing create a bin directory ${ALL_EPICS_TOP_DIR}/bin
[ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p -p ${ALL_EPICS_TOP_DIR}/bin || die "something just went wrong"
1 Provided ${ALL_EPICS_TOP_DIR}/tools has been cloned (q.v. 'epics' script ) create symbolic links to ${ALL_EPICS_TOP_DIR}/tools .

 

       %FOREACH{"list" in="epics"}%
         %FOREACH{"list" in="epicslogin.sh,fcn_addtopath.bash,uniqpaths"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :

2.3.1.2.2 unix.sh set of files

* use instead of older Site.profile

- ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/wrapper.unix.sh contains the following scripts:
  
  unix.sh.wrapper
  wrapper script calling (modified) unix.sh script now named unix.sh.main, before unix.sh.pre and after unix.sh.post
  
  unix.sh.pre
  most of additional settings done here
  
  unix.sh.post
  cleaning up, if neccessary
- Strategy:
  1. backup orignal unix.sh
    - if already existing
      1. replace current by original
      2. backup original with new date to follow-up last changes
  2. soft link to ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/wrapper.unix.s files, cosmetic renaming
  3. optionally apply perl script to unix.sh.main
  4. soft link unix.sh.wrapper to unix.sh

2.3.1.2.2.1 To install unix.sh

Show ... (Expand all... Collapse all)

2.3.1.2.3 Site.profile set of files

- ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/modify.Site.Profile} contains the following scripts:
  
  Site.profile.wrapper
  wrapper script calling (modified) Site.profile script now named Site.profile.main, before Site.profile.pre and after Site.profile.post
  
  Site.profile.pre
  most of additional settings done here
  
  Site.profile.post
  cleaning up, if neccessary
  
  modify.Site.profile.pl
  file to modify/extend Site.profile for additional verbosity and path check
- Strategy:
  1. backup orignal Site.profile
    - if already existing
      1. replace current by original
      2. backup original with new date to follow-up last changes
  2. download files, cosmetic renaming
  3. rename Site.profile to Site.profile.main
  4. apply perl script to Site.profile.main
  5. soft link Site.profile.wrapper to Site.profile

2.3.1.2.3.1 To install Site.profile

Show ... (Expand all... Collapse all)

2.3.1.2.4 ***Mandatory soft links - (epicslogin.sh, fcn_addtopath.bash, uniqpaths)***

Finally you need to set soft links for the scripts in your <EPICS Home Directory>:


            cd  ${EPICS_HOME:?"undefined"} &&            %FOREACH{"script" in="epicslogin.sh, fcn_addtopath.bash, uniqpaths"}%      
               

               [ -f ${ALL_EPICS_TOP_DIR?:"undefined"}/bin/$script ] && ln -s -b $ALL_EPICS_TOP_DIR/bin/$script . || echo "$script" not available 1>&2             %NEXT{"script"}%

2.3.1.2.5 ***Compact - epicslogin.sh (fcn_addtopath.bash, uniqpaths, Site.profile set)***

Show ... (Expand all... Collapse all)



install_epicsloginSh() 

   {   
                                        [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p -p ${ALL_EPICS_TOP_DIR}/bin || die "something just went wrong"             && 

                               
       %FOREACH{"list" in="epics"}%
         %FOREACH{"list" in="epicslogin.sh,fcn_addtopath.bash,uniqpaths"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :            
   }   


install_unixSh()

   {   
                                        %FOREACH{"item" in="base/startup"}%            
            cd ${EPICS_HOME:?"undefined"}/base/startup && 

            [ -f unix.sh ] && { ls | grep -q unix.sh.org && echo restoring latest unix.sh.org to unix.sh && mv $(ls -tr1 unix.sh.org.* | head -n 1 | xargs) unix.sh; :; } && 

            cp unix.sh unix.sh.org$(date +%d%m%y) && 
             %FOREACH{"list" in="unix.sh.post,unix.sh.pre,unix.sh.wrapper"}%
             

             ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/wrapper.unix.sh/$list  ${EPICS_HOME:?}/base/startup && 
             %NEXT{"list"}% %NEXT{"item"}% :              

             mv unix.sh unix.sh.main && 

             ln -s -b -s -b unix.sh.wrapper unix.sh && : 
 
             %NEXT{"item"}%
               
   }   


install_SiteProfile()

   {   
                                        %FOREACH{"item" in="base/startup"}%            
            cd ${EPICS_HOME:?"undefined"}/base/startup && 

            [ -f Site.profile ] && { ls | grep -q Site.profile.org && echo restoring latest Site.profile.org to Site.profile && mv $(ls -tr1 Site.profile.org.* | head -n 1 | xargs) Site.profile; :; } && 

            cp Site.profile Site.profile.org$(date +%d%m%y) && 
             %FOREACH{"list" in="Site.profile.post,Site.profile.pre,Site.profile.wrapper,modify.Site.profile.pl"}%
             

             ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/modify.Site.profile/$list  ${EPICS_HOME:?}/base/startup && 
             %NEXT{"list"}% %NEXT{"item"}% :              

             mv Site.profile Site.profile.main && 

             perl  -pi modify.Site.profile.pl Site.profile.main && 

             ln -s -b -s -b Site.profile.wrapper Site.profile && : 
 
             %NEXT{"item"}%
               
   }   


install_MandatorySoftLinks()

   {   
                                        cd  ${EPICS_HOME:?"undefined"} &&            %FOREACH{"script" in="epicslogin.sh, fcn_addtopath.bash, uniqpaths"}%      
               

               [ -f ${ALL_EPICS_TOP_DIR?:"undefined"}/bin/$script ] && ln -s -b $ALL_EPICS_TOP_DIR/bin/$script . || echo "$script" not available 1>&2             %NEXT{"script"}%   
   }   





 install_epicsloginSh && install_SiteProfile && install_MandatorySoftLinks

2.3.1.3 myepicslogin.sh

To simplify it is recommended to create this short script in the <EPICS Home Directory> containing all settings, e.g. myepicslogin.sh and modify it for your needs:


    #!/bin/bash
    myepicslogin_scriptname=myepicslogin.sh
    #set -x -v #uncomment for debugging

    # make sure script is sourced
    if [ ${0##*/} = $myepicslogin_scriptname ]
    then 
      echo script \`${myepicslogin_scriptname}\' has to be sourced, i.e. called with a leading \`. $myepicslogin_scriptname\'
      exit -1
    fi

    unset myepicslogin_scriptname

    . ./epicslogin.sh -v -H <EPICS Home Directory> -B <EPICS Base Directory> -A <Fcn Helper Bin Directory>/fcn_addtobath.bash -P <EPICS Base Directory>/startup/<startup Script>

2.3.1.3.1 To install myepicslogin.sh

Show ... (Expand all... Collapse all)

2.3.2 by hand

At least EPICS_HOST_ARCH has to be defined, which can be done via:

Show ... (Expand all... Collapse all)


            $> echo -n "Enter <Your Host's Architecture>: " &&
                     read EPICS_HOST_ARCH &&
                     export  EPICS_HOST_ARCH

where <Your Host's Architecture> can be determined via the script Arch (sh script) or EpicsHostArch.pl (perl script) in the directory <EPICS Base Directory>/startup
so that you could also write:


            $> export  EPICS_HOST_ARCH=$(EpicsHostArch)

Note in addition the other variables mentionend in the README fimale's section Set environment variables.

2.3.3 Compact - environment

Show ... (Expand all... Collapse all)


     

install_epicsScript()

   {   
             [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p ${ALL_EPICS_TOP_DIR}/bin          && 

             [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p ${ALL_EPICS_TOP_DIR}/tools          && 

             [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && 
      git clone --recursive https://git.gsi.de/EPICS/epics-installations/all-epics-top-directories/tools.git  ${ALL_EPICS_TOP_DIR}/tools          && 

              
       %FOREACH{"list" in="epics"}%
        %FOREACH{"item" in="$list"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :            && 

                                   if [   "$(id -u)" -eq 0  ]; 
 then 
 ln -s -b $ALL_EPICS_TOP_DIR/bin/epics /usr/local/bin  

           
           else 
 [ -d ${ALL_EPICS_TOP_DIR:?'undefined'}/bin ] && export PATH=ALL_EPICS_TOP_DIR}/bin:${PATH} 

           fi
             
            
   }   


    
    

 
install_epicsloginSh() 

   {   
                                        [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p -p ${ALL_EPICS_TOP_DIR}/bin || die "something just went wrong"             && 

                               
       %FOREACH{"list" in="epics"}%
         %FOREACH{"list" in="epicslogin.sh,fcn_addtopath.bash,uniqpaths"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :            
   }   


install_unixSh()

   {   
                                        %FOREACH{"item" in="base/startup"}%            
            cd ${EPICS_HOME:?"undefined"}/base/startup && 

            [ -f unix.sh ] && { ls | grep -q unix.sh.org && echo restoring latest unix.sh.org to unix.sh && mv $(ls -tr1 unix.sh.org.* | head -n 1 | xargs) unix.sh; :; } && 

            cp unix.sh unix.sh.org$(date +%d%m%y) && 
             %FOREACH{"list" in="unix.sh.post,unix.sh.pre,unix.sh.wrapper"}%
             

             ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/wrapper.unix.sh/$list  ${EPICS_HOME:?}/base/startup && 
             %NEXT{"list"}% %NEXT{"item"}% :              

             mv unix.sh unix.sh.main && 

             ln -s -b -s -b unix.sh.wrapper unix.sh && : 
 
             %NEXT{"item"}%
               
   }   


install_SiteProfile()

   {   
                                        %FOREACH{"item" in="base/startup"}%            
            cd ${EPICS_HOME:?"undefined"}/base/startup && 

            [ -f Site.profile ] && { ls | grep -q Site.profile.org && echo restoring latest Site.profile.org to Site.profile && mv $(ls -tr1 Site.profile.org.* | head -n 1 | xargs) Site.profile; :; } && 

            cp Site.profile Site.profile.org$(date +%d%m%y) && 
             %FOREACH{"list" in="Site.profile.post,Site.profile.pre,Site.profile.wrapper,modify.Site.profile.pl"}%
             

             ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/modify.Site.profile/$list  ${EPICS_HOME:?}/base/startup && 
             %NEXT{"list"}% %NEXT{"item"}% :              

             mv Site.profile Site.profile.main && 

             perl  -pi modify.Site.profile.pl Site.profile.main && 

             ln -s -b -s -b Site.profile.wrapper Site.profile && : 
 
             %NEXT{"item"}%
               
   }   


install_MandatorySoftLinks()

   {   
                                        cd  ${EPICS_HOME:?"undefined"} &&            %FOREACH{"script" in="epicslogin.sh, fcn_addtopath.bash, uniqpaths"}%      
               

               [ -f ${ALL_EPICS_TOP_DIR?:"undefined"}/bin/$script ] && ln -s -b $ALL_EPICS_TOP_DIR/bin/$script . || echo "$script" not available 1>&2             %NEXT{"script"}%   
   }   

 
    

install_myepicslogins.sh()

   {   
                            cd  $EPICS_HOME && wget -N -nv --no-check-certificate https://wiki.gsi.de/pub/Epics/EpicsInstallationsAtGsiBase/myepicslogin.sh   && 

                                  cd  $EPICS_HOME && 

      perl  -pi -e 's/^.*epicslogin\.sh -v.*$//g' myepicslogin.sh && 

      cd  $EPICS_HOME && 

      echo -n -e "myepics_home=$EPICS_HOME \n" >> myepicslogin.sh&& 

      echo -n -e " . \$myepics_home/epicslogin.sh -v -H \$myepics_home -B \$myepics_home/base -A \$myepics_home/fcn_addtopath.bash $(basename $EPICS_HOME) \$([ -f \$myepics_home/base/startup/unix.sh ] && echo -P \$myepics_home/base/startup/unix.sh) \$* \n\n" >> myepicslogin.sh && 

      echo -n -e "unset myepics_home \n" >> myepicslogin.sh&& 

      cd  $EPICS_HOME && . ./myepicslogin.sh    
   }   



      
install_epicsScript
       &&   
    install_epicsloginSh && install_SiteProfile && install_MandatorySoftLinks &&
    install_myepicslogins.sh

2.4 Compiler settings

If you are using different compilers, CC and CCC have to be modified in the corresponding ${EPICS_BASE}/configure/os directories.

Show ... (Expand all... Collapse all)

This is triggered by setting EPICS_GCC_VERSION_GSI.

Set EPICS_VERSION (assuming 7.0.4 to be set)
export EPICS_VERSION=7.0.4
First export the environment variable(s)
- $element
containing the path to the home directory:
$> echo -n "Enter <EPICS Home Directory>: " && read EPICS_HOME && export EPICS_HOME
(e.g. ${ALL_EPICS_TOP_DIR:?undefined}/<GSI EPICS OS DIR TREE>/EPICS-<Version> (e.g. EPICS-7.0.4))
$> cd EPICS_HOME && . epics -H $(dirname $PWD) -P "" $(basename $PWD)
Set GSI-Site specific gcc settings:
$> [ ! -z ${EPICS_GCC_VERSION_GSI} ] && echo 'CC=$(GNU_BIN)/gcc-'${EPICS_GCC_VERSION_GSI} >> ${EPICS_BASE}/configure/os/CONFIG_SITE.${EPICS_HOST_ARCH}.${EPICS_HOST_ARCH} $> [ ! -z ${EPICS_GCC_VERSION_GSI} ] && echo 'CCC=$(GNU_BIN)/g++-'${EPICS_GCC_VERSION_GSI} >> ${EPICS_BASE}/configure/os/CONFIG_SITE.${EPICS_HOST_ARCH}.${EPICS_HOST_ARCH}

3Additional Configuration settings

cross compile for a different target(/host) architecture you have to
- change settings in $EPICS_BASE/configure
  - for cross compiler target architectures change CROSS_COMPILER_TARGET_ARCH in $EPICS_BASE/configure/CONFIG_SITE
- add additional setup script calls in $EPICS_HOME/myepicslogin.sh
  - for example for this script setupCrisCrossCompiler.sh
    $> cd $EPICS_HOME && wget -N -nv https://wiki.gsi.de/pub/Epics/EpicsInstallationsAtGsiBase/setupCrisCrossCompiler.sh $> echo -n -e ". ./setupCrisCrossCompiler.sh \n\n" >> myepicslogin.sh

4 Compile

Setting up the environment


            $> cd  $EPICS_HOME &&  . epics 7.0.4ENDSECTION{"epics compile - 1"}%

Following the instruction the README file, but using GSI make (which is GNU make) type: (+ multicore parallel build)


           $> cd $EPICS_BASE && make distclean && make -j

Finally to add new paths to PATH etc.


            $>   cd  $EPICS_HOME &&  . epics %EPICSBASE_VERSION

4.1 Obstacles

Show ... (Expand all... Collapse all)

4.2 Compact - Compile

Show ... (Expand all... Collapse all)

5 All Compact

Show ... (Expand all... Collapse all)


 
download_epicsBase()

   {   
                     mkdir -p $EPICS_HOME   && 

                    cd  $EPICS_HOME
                && 

                git clone --recursive -b 7-0 https://git.launchpad.net/epics-base base-7-0                

                  if[ $? -ne 0 ]; 

                  then 
                                      mkdir -p ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION}   && 

                    cd  ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION}
                && 

                wget -N -nv https://epics-controls.org/download/base/base-7.0.4.tar.gz   && 

                    cd  $EPICS_HOME
                      && tar -zxvf ${EPICS_DOWNLOAD_DIR}/Base/${EPICS_VERSION}/base-7.0.4.tar.gz   
                  
                  fi && 
 
                    cd  $EPICS_HOME
                && 

                groups | grep -q -w  epicsadm && chgrp -R  epicsadm $EPICS_HOME
                && 

                find $EPICS_HOME -user $(id -n -u) -exec chmod ug+rw {} \;   && 

                    cd  $EPICS_HOME && ln -s -b base-* base   
    }           
 


      

install_epicsScript()

   {   
             [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p ${ALL_EPICS_TOP_DIR}/bin          && 

             [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p ${ALL_EPICS_TOP_DIR}/tools          && 

             [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && 
      git clone --recursive https://git.gsi.de/EPICS/epics-installations/all-epics-top-directories/tools.git  ${ALL_EPICS_TOP_DIR}/tools          && 

              
       %FOREACH{"list" in="epics"}%
        %FOREACH{"item" in="$list"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :            && 

                                   if [   "$(id -u)" -eq 0  ]; 
 then 
 ln -s -b $ALL_EPICS_TOP_DIR/bin/epics /usr/local/bin  

           
           else 
 [ -d ${ALL_EPICS_TOP_DIR:?'undefined'}/bin ] && export PATH=ALL_EPICS_TOP_DIR}/bin:${PATH} 

           fi
             
            
   }   


    
    

 
install_epicsloginSh() 

   {   
                                        [ -d ${ALL_EPICS_TOP_DIR:?"undefined"} ] && mkdir -p -p ${ALL_EPICS_TOP_DIR}/bin || die "something just went wrong"             && 

                               
       %FOREACH{"list" in="epics"}%
         %FOREACH{"list" in="epicslogin.sh,fcn_addtopath.bash,uniqpaths"}%
        

       ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/bin/$item  ${ALL_EPICS_TOP_DIR:?"undefined"}/bin && 
        %NEXT{"item"}% %NEXT{"list"}% :            
   }   


install_unixSh()

   {   
                                        %FOREACH{"item" in="base/startup"}%            
            cd ${EPICS_HOME:?"undefined"}/base/startup && 

            [ -f unix.sh ] && { ls | grep -q unix.sh.org && echo restoring latest unix.sh.org to unix.sh && mv $(ls -tr1 unix.sh.org.* | head -n 1 | xargs) unix.sh; :; } && 

            cp unix.sh unix.sh.org$(date +%d%m%y) && 
             %FOREACH{"list" in="unix.sh.post,unix.sh.pre,unix.sh.wrapper"}%
             

             ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/wrapper.unix.sh/$list  ${EPICS_HOME:?}/base/startup && 
             %NEXT{"list"}% %NEXT{"item"}% :              

             mv unix.sh unix.sh.main && 

             ln -s -b -s -b unix.sh.wrapper unix.sh && : 
 
             %NEXT{"item"}%
               
   }   


install_SiteProfile()

   {   
                                        %FOREACH{"item" in="base/startup"}%            
            cd ${EPICS_HOME:?"undefined"}/base/startup && 

            [ -f Site.profile ] && { ls | grep -q Site.profile.org && echo restoring latest Site.profile.org to Site.profile && mv $(ls -tr1 Site.profile.org.* | head -n 1 | xargs) Site.profile; :; } && 

            cp Site.profile Site.profile.org$(date +%d%m%y) && 
             %FOREACH{"list" in="Site.profile.post,Site.profile.pre,Site.profile.wrapper,modify.Site.profile.pl"}%
             

             ln -s -b ${ALL_EPICS_TOP_DIR:?"undefined"}/tools/startup/modify.Site.profile/$list  ${EPICS_HOME:?}/base/startup && 
             %NEXT{"list"}% %NEXT{"item"}% :              

             mv Site.profile Site.profile.main && 

             perl  -pi modify.Site.profile.pl Site.profile.main && 

             ln -s -b -s -b Site.profile.wrapper Site.profile && : 
 
             %NEXT{"item"}%
               
   }   


install_MandatorySoftLinks()

   {   
                                        cd  ${EPICS_HOME:?"undefined"} &&            %FOREACH{"script" in="epicslogin.sh, fcn_addtopath.bash, uniqpaths"}%      
               

               [ -f ${ALL_EPICS_TOP_DIR?:"undefined"}/bin/$script ] && ln -s -b $ALL_EPICS_TOP_DIR/bin/$script . || echo "$script" not available 1>&2             %NEXT{"script"}%   
   }   

 
    

install_myepicslogins.sh()

   {   
                            cd  $EPICS_HOME && wget -N -nv --no-check-certificate https://wiki.gsi.de/pub/Epics/EpicsInstallationsAtGsiBase/myepicslogin.sh   && 

                                  cd  $EPICS_HOME && 

      perl  -pi -e 's/^.*epicslogin\.sh -v.*$//g' myepicslogin.sh && 

      cd  $EPICS_HOME && 

      echo -n -e "myepics_home=$EPICS_HOME \n" >> myepicslogin.sh&& 

      echo -n -e " . \$myepics_home/epicslogin.sh -v -H \$myepics_home -B \$myepics_home/base -A \$myepics_home/fcn_addtopath.bash $(basename $EPICS_HOME) \$([ -f \$myepics_home/base/startup/unix.sh ] && echo -P \$myepics_home/base/startup/unix.sh) \$* \n\n" >> myepicslogin.sh && 

      echo -n -e "unset myepics_home \n" >> myepicslogin.sh&& 

      cd  $EPICS_HOME && . ./myepicslogin.sh    
   }   


 make_epics()

   {   
                            cd  $EPICS_HOME &&  . epics %EPICSBASE_VERSION  && 

                            cd $EPICS_BASE && make distclean && make -j    && 

                            cd  $EPICS_HOME &&  . epics %EPICSBASE_VERSION  
   }   




  download_epicsBase  &&
  
      
install_epicsScript
       &&   
    install_epicsloginSh && install_SiteProfile && install_MandatorySoftLinks &&
    install_myepicslogins.sh  &&
  make_epics

-- PeterZumbruch - 2020-08-18

Attachments 15

This topic: Epics > EpicsInstallationsAtGsi > EpicsInstallationsAtGsiBase
Topic revision: 2020-08-18, PeterZumbruch

Copyright © by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding GSI Wiki? Send feedback | Legal notice | Privacy Policy (german)

I	Attachment	Action	Size	Date	Who	Comment
html	README.html	manage	23 K	2014-04-22 - 18:36	PeterZumbruch	README for EPICS build 3.14.12
post	Site.profile.post	manage	181 bytes	2012-10-12 - 17:29	PeterZumbruch	Site.profle.post file to be sourced after Site.profile, for more verbosity
pre	Site.profile.pre	manage	2 K	2012-10-15 - 17:51	PeterZumbruch	Site.profle.pre file to be sourced before Site.profile, for more verbosity
wrapper	Site.profile.wrapper	manage	527 bytes	2012-10-12 - 17:30	PeterZumbruch	Site.profle.wrapper file sourcing Site.profile.pre Site.profile.main, Site.profile.post, for more verbosity
EXT	autoepics	manage	693 bytes	2018-11-01 - 12:03	PeterZumbruch	script to automatically extract EPICS_BASE/HOME from RELEASE subdirectory configure/RELEASE and start [[https://wiki.gsi.de/foswiki/pub/Epics/EpicsInstallationsAtGsiBase/epics][epics]] based on the results
sh	die.sh	manage	285 bytes	2013-08-23 - 16:43	PeterZumbruch	die.sh script
EXT	epics	manage	9 K	2016-08-26 - 14:31	UnknownUser	epics (GSI) global login script (new default: /home/epics/EPICS/EPICS-3.15.4)
sh	epicslogin.sh	manage	7 K	2013-08-09 - 16:18	PeterZumbruch	local bash script for setting epics environments, sourcing Site.profile and fcn_addtopath.bash
bash	fcn_addtopath.bash	manage	4 K	2013-08-09 - 16:41	PeterZumbruch	helper script sourced by epicslogin.sh
7z	modify.Site.profile.7z	manage	1 K	2018-09-18 - 11:20	PeterZumbruch	modify.Site.Profile tar ball
txt	modify.Site.profile.pl.txt	manage	683 bytes	2013-08-13 - 10:45	PeterZumbruch	file to modify/extend Site.profile for additional verbosity and path check
sh	modify.Site.profile.sh	manage	1 K	2014-04-15 - 14:42	PeterZumbruch	Script to modify/wrap Site.profile in base/startup
sh	myepicslogin.sh	manage	412 bytes	2013-08-08 - 15:52	PeterZumbruch	bash script for setting epics environments, sourcing Site.profile and fcn_addtopath.bash
sh	setupCrisCrossCompiler.sh	manage	1 K	2012-10-19 - 13:51	PeterZumbruch	cris cross compiler call setup script
EXT	uniqpaths	manage	485 bytes	2008-11-06 - 19:23	PeterZumbruch	perl script needed by fcn_addtopath.bash and Site.profile

EPICS installations at GSI - Base installation

1 Preface

1.1 Scripts: #!/bin/bash

1.2 some global environment variables during installation

2 General Preparations

2.1 Checks

2.2 Create Directory and Download Sources

2.2.1 Preface - GSI: Facing different versions flavors of OS, architectures and compilers

2.2.1.1 Directory Setup

2.2.2 Download EPICS base

2.2.3 Download patches EPICS base

2.2.4 Compact - Directories/epics & Download of Base Sources

2.3 Setting environment variables

2.3.1 epics set of scripts

2.3.1.1 epics

2.3.1.1.1 Usage: epics script

2.3.1.1.2 epics invocation scheme

2.3.1.1.2.1 To install the epics script...

2.3.1.1.2.2 Compact - Epics Script Installation

2.3.1.2 epicslogin.sh (fcn_addtopath.bash, uniqpaths, Site.profile / unix.sh set)

2.3.1.2.1 Usage: epicslogin.sh

2.3.1.2.1.1 To install epicslogin.sh (fcn_addtopath.bash, uniqpaths) ...

2.3.1.2.2 unix.sh set of files

2.3.1.2.2.1 To install unix.sh

2.3.1.2.3 Site.profile set of files

2.3.1.2.3.1 To install Site.profile

2.3.1.2.4 Mandatory soft links - (epicslogin.sh, fcn_addtopath.bash, uniqpaths)

2.3.1.2.5 Compact - epicslogin.sh (fcn_addtopath.bash, uniqpaths, Site.profile set)

2.3.1.3 myepicslogin.sh

2.3.1.3.1 To install myepicslogin.sh

2.3.2 by hand

2.3.3 Compact - environment

2.4 Compiler settings

3Additional Configuration settings

4 Compile

4.1 Obstacles

4.2 Compact - Compile

5 All Compact

2.3.1.2.4 ***Mandatory soft links - (epicslogin.sh, fcn_addtopath.bash, uniqpaths)***

2.3.1.2.5 ***Compact - epicslogin.sh (fcn_addtopath.bash, uniqpaths, Site.profile set)***