Definitions
- BOLD: refers to files that need to be modified or generated by IOC developer
- Italics: symbolic link
How-To setup the IOC boot directories
The instructions differ between production and development due to permission restrictions in production.
Table 1
Facility | Account | Server |
---|
LCLS | laci | lcls-daemon0, lcls-daemon1, lcls-deamon2,cryo-daemon1 |
FACET-II | flaci | facet-daemon1 |
TestFac | acctf | testfac-daemon1 |
Dev | laci | lcls-dev3 (rhel6), dev-rhel7 (rhel7) |
Production: lcls, facet, testfac
- Send email to Ken Brobeck requesting:
- create controls infrastructure:
- for a new IOC that boots from a production Linux daemon server (see Table1) or a camera server.
- Add boot directory: $EPICS_IOCS<ioc>
- Add data directories: $IOC_DATA/<ioc>/<autosave,autosave-req,restore,iocInfo,archive,yaml> directories
- Add automatic boot scripts:
- (rhel6 only)
- add boot script on server defined in table 1: /etc/inti.d/st.<ioc>
- add symbolic link on server defined in table 1: /etc/rc3.d/SS98st.<ioc> ----> /etc/init.d/st.<ioc>
- Proceed to Step #2c under Development
Development: dev
- Create the $IOC_DATA directory as follows:
- cd $IOC_DATA for your IOC
- mkdir sioc-<area>-<subsystem-prefix><2-digit#>
- cd <sioc>
- mkdir archive autosave-req autosave iocInfo restore yaml
- Create the IOC boot directory with boot links as follows:
- cd $EPICS_IOCS
- mkdir sioc-<area>-<subsystem-prefix><2-digit#>
- cd <ioc>
- cp ../template/startup.cmd.soft startup.cmd
- Edit startup.cmd
- replace <ioc> with your ioc name
- replace <t_a> with the target, such as linux-x86 or linux-x86_64 or rhel6-x86_64, rhel7-x86_64 (ref. your application bin directory).
- replace <exe> with your IOC Application executable
- if your IOC Application uses a non-standard location for the st.cmd file, change path of EPICS_IOC_APP
- create symbolic: ln -s ../../iocTop/<app>/<ver> iocSpecificRelease
- Add your IOC to$EPICS_IOCS/facility/screeniocs and commit change to CVS
How-to boot an IOC from the Linux (daemon) server specified in screeniocs:
There are multiple ways to boot a soft ioc which are listed below:
- Log onto server listed in Table 1 from the account this same table, and perform the following commands:
- cd /etc/init.d
- ./st.<ioc> <restart,start,stop>
- Use iocConsole to start an ioc, which uses the screen program
- iocConsole <ioc> --stayup
- siocRestart <ioc>
- Boot IOC from the facility home display network panel
How to connect to Linux IOC from a Linux server:
- iocConsole <ioc>
How-to use screen program:
- ctrl a d : detach from the screen session
- ctrl a [ : scroll up through the start-up messages.