Page History

...

1. Send email to Ken Brobeck requesting:
   1. Which facility the CPU will boot (e.g. facet, lcls, lcls2, testfac). This indicates the path to the startup.cmd  script and the DHCP server.
   2.  MAC Address of the CPU
   3. The CPU EPICS target architecture  (e.g. linuxRT-x86,linuxRT-x86_64,etc)
1. create controls infrastructure for a new linuxRT CPU and / or IOC to a specific facility production server.
   1. includes $EPICS_IOCS/<cpu,ioc>  directories
   2. includes $IOC_DATA/<ioc>/<autosave,autosave-req,restore,iocInfo,archive>  directories
2. add CPU boot information to the DHCP configuration file, and reboot the DHCP server. Ken will need the following details:
3. Which facility the CPU will boot (e.g. facet, lcls, lcls2, testfac). This indicates the path to the startup.cmd  script and the DHCP server.
4.  MAC Address of the CPU
The CPU EPICS target architecture  (e.g. linuxRT-x86,linuxRT-x86_64,etc)
2. Proceed to Development Step #3

...

1. Create the $IOC_DATA directory for your cpu and iocs as follows:
   1. cd $IOC_DATA
2.  Create the $EPICS_IOCS cpu and ioc boot directories
   1. cd $EPICS_IOCS
   2. mkdir cpu-<area>-<subsystem-prefix><2-digit#>  
   3. mkdir  sioc-<area>-<subsystem-prefix><2-digit#>
   4. Modify your application to add the cpu boot scripts.  If your IOC runs on a Shared Platform cpu then modify the SharedPlatform IOC Application  :
      1.  add  cpuBoot/<faciilti>/<cpu node>/st.cmd
      2. add any dhcp.config or ethercat xml scripts
      3. tag and push shared the SharedPlatform  tag to production  using cram.
3. Add ipxe in $TFTPBOOT/LinuxRT/boot/ipxe/<cpu>.ipxe
   1. note the buildroot version must correspond to the Application buildroot version defined based on the EPICS base version
4. Setup cpu directory files
   Original Method: (steps 3b and 3c)
   1. cd cpu-<area>-<subsystem-prefix><2-digit#>
   2. Setup relative symbolic links to the common startup script and EPICS version:.
      1. ln -s ../common/st.cmd.linuxRT.cpu  startup.cmd
      2. ln -s ../common/bin/<epics base version>  epicsSpecificRelease
   3. Generate the file kernel-module.cmd. This file load kernels modules and drivers: kernel-modules.cmd
      for examples click  here.
      New Method: (steps 3d and 3e) - must be base release R7.0.3.1-1.0 or greater
   4. Automatic:  
      1. createLinuxRTCpu --help
   5. Manual:
      1. cd cpu-<area>-<subsystem-prefix><2-digit#> 
      2. Setup relative symbolic like to the TOP of the IOC Application  first time only, thereafter use cram to upgrade link.
         1. ln -s ../../iocTop/<app> iocSpecificRelease
      3.  cp ../template/startup.cmd.linuxRT.cpu startup.cmd
         1. replace <cpu> with your cpu name
         2. replace <full path> with the full path to the directory with the cpu boot st.cmd file
copy the ioc startup.cmd script from  $EPICS_IOCS/templat
5. Setup ioc directory files
6. cd sioc-<area>-<subsystem-prefix><2-digit# 
7. 1. for linuxRT running iocsh:    cp ../template/startup.cmd.linuxRT          startup.cmd
   2. for  linuxRT running cexp:     cp ../template/startup.cmd.linuxRT.cexp  startup.cm
1. cd sioc-<area>-<subsystem-prefix><2-digit# 
2. copy the ioc startup.cmd script from  $EPICS_IOCS/templat
3. edit startup.cmd
1. 1. replace <ioc>  with your ioc name and for cexp replace <facility>
   2. change path of the EPICS_IOC_APP if your st.cmd file is in a non-standard location.
2. cp ../template/screenrc   screenrc
3. edit screenrc and replace <ioc> with your ioc name
4. Setup a relative symbolic link to the TOP of the IOC Application release.

1. 1. ln -s ../../iocTop/<app>/<version> iocSpecificRelease
2. Modify $EPICS_IOCS/screeniocs    – Please note that this is a symbolic link to a CVS file
   1. cd
   2. cd <work>
      cvs co epics/iocCommon/All/<facility>   , where facility is Dev,Prod,facet,acctest
      1. add line for cpu
         format:  cpu-<area>-<subsystem-prefix><2-digit #>      <ts>   <ts port #t>   <screen  host>   [ # comment]
      2. add line for each ioc
         format:  sioc-<area>-<subsystem prefix><2-digit #>  cpu-<area>-<subsystem-prefix><2-digit #>    <account>   [ # comment]
      3. The "comment" field in  screeeniocs  is optional and must be precede but  "#".
   1. cd epics/iocCommon/All/<facility>/screeniocs
   2. edit screeniocs
      
1. verify that the file in use has not been modified without being committed.
   1. cd $EPICS_IOCS/All/<facility>   , where facility is Dev,Prod,facet,acctest
   2. cvs diff -r HEAD screeniocs
   3. if there are issues, then send email to whoever made the change or to controls-software that you are about to update this file and uncommitted edits will be lost, so please commit your changes to CVS.  If you don't get a response,  you can either add the changes to CVS in addition to yours or just add yours.
      
2. check out screeniocs from CVS into your work area
3. cd
cd <work>
cvs co epics/iocCommon/All/<facility>   , where facility is Dev,Prod,facet,acctest
4. 1. cd epics/iocCommon/All/<facility>/screeniocs
   2. edit screeniocs
      
   1. add line for cpu
      format:  cpu-<area>-<subsystem-prefix><2-digit #>      <ts>   <ts port #t>   <screen  host>   [ # comment]
   2. add line for each ioc
      format:  sioc-<area>-<subsystem prefix><2-digit #>  cpu-<area>-<subsystem-prefix><2-digit #>    <account>   [ # comment]
   3. The "comment" field in  screeeniocs  is optional and must be precede but  "#".
5. commit your changes of screeniocs to CVS  as follows:
   1.  cvs commit  -m "added cpu and ioc blah" screeniocs
6. update the screeniocs file in use
   1. cd $EPICS_IOCS/All/<facility>
   2.  rm -f screeniocs
   3. cvs update screeniocs
       

...

1. Create script <app>/iocBoot/<facility>/<ioc>/rtPrioritySetup.cmd to set real-time priorities for threads
2. Load rtPrioritySetup.cmd from <app>/iocBoot/<facility>/<ioc>/st.cmd 

How-to Release a LinuxRT IOC Application:

How-to boot to boot a linuxRT  IOC linuxRT IOC from a Linux Host :

1. From cpu:
Log
2.  Log onto the host machine for example softegr@lcls-srv01 type the following:
   siocRestart <ioc>
   
   

How-to boot an IOC from the linuxRT hostT

The following scripts are located under the directory $IOC/common and should be in PATH on the CPU.

1. siocStart.sh <ioc>   -
 starts
2. starts a specific ioc. However, if the ioc is up nothing will be done
siocStart   
3. , if no ioc is specified all iocs on cpu not already up will be started.
4. siocStart.sh    -  starts all iocs not already running
5. iocConsole.sh <ioc> -d   (starts the specified ioc, but does not attache to the screen session)
6. iocConsole.sh <ioc> -R  (graceful reset)
7. iocConsole.sh <ioc> -r  (fast restart)
8. iocConsole.sh --help
   

How to connect to CPU from a Linux host:

...