manage-iocs - Utility to report/manipulate EPICS soft IOCS
manage-iocs [-v] [-x] <cmd> [arguments...]
This script performs a variety of tasks related to administration of systems hosting several EPICS softIocs. It is integrated with the softioc init script also provided. manage-iocs has a number of commands which can be grouped into two catagories: reporting and admin.
- help
-
Print usage message
- report [iocname]
-
Print a table of information with one line for each configured softioc. Includes username, procServ port, user to run as, and command to execute.
- status
-
List all installed IOCs. Indicates if the associated procServ is running, and whether it is registered to automatically start on reboot.
- nextport
-
Helper when creating a new IOC instance. Tries to find a port for procServ which isn't used. Finds the highest port number in use and adds one.
- install iocname
-
Creates/updates the init script associated with an IOC in /etc/init.d/.
- enable iocname
-
Register an IOC instance so that it will be started automatically when the system reboots.
- disable iocname
-
Unregister an IOC so that it will not start with the system reboots.
- -h
-
Print usage message.
- -v
-
More verbose output
- -x
-
Turn on shell echoing. Very verbose.
- /etc/default/epics-softioc
-
Global configuration. This must include a definition of $SOFTBASE which is a ':' seperated list of IOC base directories. For example: SOFTBASE=/epics/iocs
- /epics/iocs/config/global
-
Configuration for all IOCS in that base directory.
- /epics/iocs/[IOC]/config
-
Configuration for a single IOC instance.
Michael Davidsaver <[email protected]>