# IOC

TODO: some iocs not associated to a service, where to put? 
TODO: need to dev/prod template them too

## Host 

sls-vserv-bd-01(-dev)

## Shell

Start up an IOC shell:

```shell
iocsh AGEBD-CPCL-MASTER_main.subs
```

then you can run commands to interact with EPICS.

List available PVs:

```shell
> dbl
```

## Install

On `sls-lc*`

```shell
ioc install -V --ioc AGEBD-CPCL-TUNEFBX –clean
```

Result: on ioc host, e.g. `sls-vserv-bd-01-dev`

```shell
vim /etc/shellbox/<port-number>
```

## Check PVs of installed IOC

```shell
ioc shell AGEBD-CPCL-MASTER-DEV
```

```shell
> dbl
```

Exit:

```shell
Ctrl + d
```

Old docs: # TODO: merge with current

## IOC installation
The following instructions explain the basics of starting and managing IOCs on the IOC host. 
For the initial install the shellbox on the ioc host must be restarted. 
For existing IOCs a login to the IOC and restart via ctr+x is sufficient.

### local tests
#### using subs file
iocsh AGEBD-CPCL-PLAYGROUND_main.subs

#### using template file 
iocsh PLAYGROUND.template DEVICE=TEST

### proper install
ioc install -V --ioc AGEBD-CPCL-PLAYGROUND --clean

ioc shell AGEBD-CPCL-PLAYGROUND

ctrl+x

### login on BD IOC host for access to shellbox
ssh sls-vserv-bd-01

#### shellbox  
TODO: should be -bd-01?
cd /ioc/hosts/sls-vserv-op-01<br>
gedit shellbox.conf<br>

restart ioc via shellbox:<br>
sudo shellbox reload            # new ioc installed<br>
sudo shellbox status            # status of all iocs on server<br>
sudo shellbox stop 50045        # stop ioc<br>
sudo shellbox start 50045       # start ioc<br>
sudo shellbox log 50045 -f      # log file (tail)<br>
exit                            # exit ssh<br>