... | ... | @@ -3,64 +3,68 @@ This page describes the setup of a stand-alone RTS system, otherwise know as a " |
|
|
Start by [installing the base OS and enabling the CDSSoftware repositories](https://git.ligo.org/cds-packaging/docs/wikis/home).
|
|
|
|
|
|
Install the AdvLigoRTS, CyMAC support package `advligorts-cymac`:
|
|
|
|
|
|
```shell
|
|
|
$ sudo apt install advligorts-cymac
|
|
|
```
|
|
|
|
|
|
This should install all needed packages except the kernel, including the RCG, and the DAQD.
|
|
|
|
|
|
## Installing a Real-Time Kernel
|
|
|
|
|
|
CDSSoftware repositories provide a real-time kernel suitable for a CyMAC. This kernel must be installed for the the CyMAC to operate properly.
|
|
|
|
|
|
```
|
|
|
```plaintext
|
|
|
sudo apt install linux-image-4.19.0-6-rtcds-amd64-unsigned
|
|
|
```
|
|
|
|
|
|
### Configure GRUB to Boot with the Real-Time Kernel
|
|
|
|
|
|
**NOTE: this should only be necessary if for some reason the RTS kernel is not showing up in the boot menu.**
|
|
|
|
|
|
#### View /boot/grub/grub.cfg
|
|
|
|
|
|
You will need to copy some strings exactly from /boot/grub/grub.cfg.
|
|
|
|
|
|
Scroll through /boot/grub/grub.cfg until you find the menu entry for the new kernel. Note exactly the name of this menu entry. A typical name is
|
|
|
|
|
|
```Debian GNU/Linux, with Linux 4.19.0-6-rtcds-amd64```
|
|
|
`Debian GNU/Linux, with Linux 4.19.0-6-rtcds-amd64`
|
|
|
|
|
|
Then, scroll up until you find the name of the menu the menu entry is in. Most likely it is in an 'advanced' menu. If the item is in a sub menu of another menu (it shouldn't be), then you'll need to copy out the names of all parent menus in order from the top most.
|
|
|
|
|
|
There will most likely be a only a single menu named
|
|
|
|
|
|
```Advanced options for Debian GNU/Linux```
|
|
|
`Advanced options for Debian GNU/Linux`
|
|
|
|
|
|
#### Edit /etc/default/grub
|
|
|
|
|
|
Change the value of GRUB_DEFAULT to be
|
|
|
|
|
|
```"Top Menu>Sub Menu 1>Sub Menu 2>Menu Item".```
|
|
|
`"Top Menu>Sub Menu 1>Sub Menu 2>Menu Item".`
|
|
|
|
|
|
Note the angle brackets separating the menus and menu items.
|
|
|
|
|
|
A typical line for the new kernel is:
|
|
|
|
|
|
```
|
|
|
```plaintext
|
|
|
GRUB_DEFAULT="Advanced options for Debian GNU/Linux>Debian GNU/Linux, with Linux 4.19.0-6-rtcds-amd64"
|
|
|
```
|
|
|
|
|
|
Where the top menu is
|
|
|
|
|
|
```Advanced options for Debian GNU/Linux```
|
|
|
`Advanced options for Debian GNU/Linux`
|
|
|
|
|
|
And the menu item is
|
|
|
|
|
|
```Debian GNU/Linux, with Linux 4.19.0-6-rtcds-amd64```
|
|
|
`Debian GNU/Linux, with Linux 4.19.0-6-rtcds-amd64`
|
|
|
|
|
|
#### Update and Reboot
|
|
|
Run
|
|
|
```sudo update-grub ```
|
|
|
and reboot.
|
|
|
|
|
|
Run `sudo update-grub `and reboot.
|
|
|
|
|
|
check with
|
|
|
|
|
|
```
|
|
|
```plaintext
|
|
|
root@x2boot0:/root$ uname -r
|
|
|
4.19.0-6-rtcds-amd64
|
|
|
```
|
... | ... | @@ -68,6 +72,7 @@ root@x2boot0:/root$ uname -r |
|
|
# Installing Control Room Tools.
|
|
|
|
|
|
If you're looking for the control room tools (dtt, ndscope, EPICS, etc.) install the `cds-workstation` package:
|
|
|
|
|
|
```shell
|
|
|
$ sudo apt install cds-workstation
|
|
|
```
|
... | ... | @@ -75,7 +80,8 @@ $ sudo apt install cds-workstation |
|
|
# additional links
|
|
|
|
|
|
See the following pages for additional information on running and setting up a cymac system:
|
|
|
|
|
|
* [debugging](cymac/debugging)
|
|
|
* [`rtcds` RCG command line interface](/RCG-command-line-interface:-rtcds)
|
|
|
* `rtcds` RCG command line interface
|
|
|
* [systemd supervision](systemd-process-supervision)
|
|
|
* [Environment Variables](environment-variables) used to configure the CyMAC |
|
|
\ No newline at end of file |