Skip to content
Snippets Groups Projects

Split Instructions.md into multiple .md files

Merged kpetersn requested to merge separate-sections into main
8 files
+ 988
961
Compare changes
  • Side-by-side
  • Inline
Files
8
1-Setup.md 0 → 100644
+ 114
0
# [IOC Deployment and Troubleshooting](README.md)
## 1 Setup
### 1.1 Configure Environment Variables
#### 1.1.1 Set enviroment variables specific to this training
Determine which shell is used
```
$ echo ${SHELL}
```
<details>
<summary>output</summary>
```
/bin/bash
```
or
```
/bin/tcsh
```
</details>
Note: the EPICS_DIR environment variable can be changed if it is desirable to create the files for this training in a different location.
bash
```bash
$ export EPICS_DIR=${HOME}/PET-S2/epics
$ export IOC_DIR=${EPICS_DIR}/synApps_6_2_1/ioc
$ export SUPPORT_DIR=${EPICS_DIR}/synApps_6_2_1/support
```
tcsh
```csh
$ setenv EPICS_DIR ${HOME}/PET-S2/epics
$ setenv IOC_DIR ${EPICS_DIR}/synApps_6_2_1/ioc
$ setenv SUPPORT_DIR ${EPICS_DIR}/synApps_6_2_1/support
```
#### 1.1.2 Set EPICS_HOST_ARCH
Run the following command to determine the RHEL version.
```bash
$ cat /etc/redhat-release
```
<details>
<summary>output</summary>
```
Red Hat Enterprise Linux Server release 7.9 (Maipo)
```
or
```
Red Hat Enterprise Linux release 8.7 (Ootpa)
```
</details>
Set EPICS_HOST_ARCH based on the major RHEL version & shell
| | RHEL7 | RHEL8 |
| --- | --- | --- |
| bash | `$ export EPICS_HOST_ARCH=rhel7-x86_64` | `$ export EPICS_HOST_ARCH=rhel8-x86_64` |
| tcsh | `$ setenv EPICS_HOST_ARCH rhel7-x86_64` | `$ setenv EPICS_HOST_ARCH rhel8-x86_64` |
#### 1.1.3 Clear EPICS environment variables
These EPICS environment variables can cause problems with this training, so they should be cleared before continuing.
bash
```bash
$ unset EPICS_BASE
$ unset EPICS_CA_ADDR_LIST
$ unset EPICS_CA_AUTO_ADDR_LIST
```
tcsh
```tcsh
$ unsetenv EPICS_BASE
$ unsetenv EPICS_CA_ADDR_LIST
$ unsetenv EPICS_CA_AUTO_ADDR_LIST
```
### 1.2 Create directories needed for the training
```bash
$ mkdir -p ${IOC_DIR} ${SUPPORT_DIR}
```
### 1.3 Confirm the directories exist
```bash
$ tree ${EPICS_DIR}
```
<details>
<summary>output</summary>
```bash
$ tree ${EPICS_DIR}
/home/beams/USERNAME/PET-S2/epics
└── synApps_6_2_1
├── ioc
└── support
3 directories, 0 files
```
</details>
## [2 Deploy a new IOC](2-IOC-deployment.md)
Loading