SPEAR EPICS

Consoles and Hosts

Quick Links

Related SPEAR Links

Related SLAC Links

Console and Host List

Host Name Operating System Model Subnet IP Address Location Description System Manager
Mission-Critical AFS Taylored Linux Servers*
connie Linux RHEL6 HP Blade SPEAR Public: 134.79.46.33
Private: 172.22.247.13
B137 Computer Room IOCs, CA Clients Stephanie
beldar Linux RHEL6 HP Blade SPEAR Public: 134.79.46.34
Private: 172.22.247.14
B137 Computer Room IOCs (using private network), Gateway Stephanie
prymatt Linux RHEL6 HP Proliant SPEAR Public: 134.79.46.35 B117 Computer Room Picoharp IOC Stephanie
remulak Linux RHEL6 HP Blade SPEAR Public: 134.79.46.36
Private: 172.22.247.12
B137 Computer Room Camera IOCs Stephanie
Mission-Critical Linux Servers
spearfs1 (alias spearnfs) Linux RHEL6 HP Blade SPEAR 134.79.46.40 B137 LOS2 Computer Room NFS,RSH,TFTP Clemens
speardns1/
ssrlntp1
Linux RHEL6 HP Blade CNTRL-SRV 134.79.44.10 B137 LOS2 Computer Room DNS,NTP Clemens
speardns2/
ssrlntp2
Linux RHEL6 HP Blade CNTRL-SRV 134.79.44.11 B137 LOS2 Computer Room DNS,NTP Clemens
ssrlps1 Linux RHEL6 HP Blade CNTRL-SRV 134.79.44.90 B137 LOS2 Computer Room CUPS, SAMBA3 Clemens
spearboot Linux RHEL6 HP Blade SPEAR 134.79.46.15 B137 LOS2 Computer Room DHCP Clemens
speards1 Linux RHEL6 HP Blade SPEAR 134.79.46.127 B137 LOS2 Computer Room Console Display Server Clemens
spearepics1 Linux RHEL6 HP Blade SPEAR 134.79.46.42 B137 LOS2 Computer Room Future IOCs and CA Clients Clemens
b140-cpubpm LinuxRT Concurrent AM310/30 SPEAR 134.79.46.172 B140-106 uTCA Transport Line BPMs Stephanie
Mission-Critical VMS Servers
inj02 VMS 8.4 HP AlphaServer DS10 SPEAR 134.79.46.48 B137 LOS2 Computer Room Non-EPICS Injector Controls Clemens
spear1 VMS 8.4 HP rx2600 Itanium SPEAR 134.79.46.49 B137 LOS2 Computer Room CA Clients, RDB Apps, Web? Clemens
spear2 VMS 8.4 HP AlphaServer DS20 SPEAR 134.79.46.50 B137 LOS2 Computer Room CA Clients, RDB Apps Clemens
spear3 VMS 8.4 HP AlphaServer DS20 SPEAR 134.79.46.51 B117 Computer Room Non-EPICS SPEAR Legacy Controls, CA Clients, IDL Apps Clemens
Mission-Critical Windows Consoles
b117-pc11 Windows 7 Dell ? SPEAR 134.79.46.118 B117-11 RGA Clemens
Mission-Critical Linux Consoles**
b005-pc1 Linux RHEL6 Dell ? SPEAR 134.79.46.111 B5 Control Room MCC Display Console? Clemens
b005-pc2 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.112 B5 Control Room MCC Right Operator Console, 4 monitors Clemens
b005-pc3 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.113 B5 Control Room MCC Left Operator Console, 3 monitors Clemens
b005-pc4 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.114 B5 Control Room MCC Display Console, 2 TVs Clemens
b052-pc1 Linux RHEL6 ? SPEAR 134.79.46.119 B52 Control Room MCC Display Console Clemens
b052-pc2 Linux RHEL6 ? SPEAR 134.79.46.120 B52 Control Room MCC Display Console Clemens
b052-pc3 Linux RHEL6 ? SPEAR 134.79.46.121 B52 Control Room MCC Display Console Clemens
b117-pc01 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.97 B117-1B Injector Console, CURMON, 5 monitors Clemens
b117-pc03 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.116 B117-4 Operations Console Clemens
b117-pc04 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.115 B117-4 Operations Console, 2 TVs Clemens
b117-pc05 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.117 B117-5 Acc Phys Console, 4 monitors Clemens
b117-pc07 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.110 B117-7 Operations Console, 1 monitor Clemens
b132-pc1 Linux RHEL6 Dell ? SPEAR 134.79.46.109 B132-101 RF Console Clemens
b140-pc1 Linux RHEL6 Dell ? SPEAR 134.79.46.108 B140 Linac Control Area Linac Operations Console, 1 monitor Clemens
b140-pc2 Linux RHEL6 Dell Precision T3500 SPEAR 134.79.46.106 B140 Booster Control Area Booster Operations Console, 1 monitor Clemens
Non-Mission-Critical Windows and Linux Consoles
ssrl-b117pc1 Windows 7 Dell Precision T3500 SSRL 134.79.32.79 B117 Left Desk General Use SLAC IT
ssrl-b117pc2 Windows 7 Dell Precision T3500 SSRL 134.79.33.20 B117 Right Desk General Use SLAC IT
ssrl-b117pc3 Windows 7 Dell Precision T3500 SSRL 134.79.34.241 B117 Conference Room General Use SLAC IT
ssrl-b140pc1 Windows 7 Dell ? SSRL 134.79.34.104 B140-106A General Use SLAC IT
* Currently AFS and taylored. In the future, they will be moved to "Mission-Critical Linux Servers" and maintained by Clemens. AFS accounts are used to login or ssh into these machines. The AFS account must first be added to u-spear-servers using instructions here.
** Runs linux EPICS displays, Matlab, VMS non-EPICS displays, VMS HistoryPlot, firefox, remote desktop, etc.

Linux RHEL Installation on Servers and Workstations

References

Preparation for Installation of a New Machine

  1. Check that system requirements are satisfied. Is your hardware compatible? Do you have enough disk space?
  2. Choose a host name. If the machine is for production, add the host name to the SPEAR IP groups spreadsheet in sharepoint. For production, the IP address must be chosen from either the 465-SRVPRI group, if it is a server and will not access the internet outside of SLAC, or the 465-CONSOLE group, if it is a workstation.
  3. If the machine has a second NIC for the SSRL-SPEAR-CTRL private network (if it will be communicating with ethernet-controlled devices like terminal servers), choose a private host name (add "-pvt" to the chosen host name from the previous step) and update the SPEAR IP groups spreadsheet. The IP address must be chosen from the 466-MISC group.
  4. Send email to m$network to get an IP address for the host name, and if applicable, an IP address for the private network, and have DNS updated. For now (until the firewall rules are refined), if the machine is production, tell m$network to add the host to the rule in the SSRL firewall that allows all access between SLAC and production linux machines for the purpose of taylor and the upkeep of the spear shared account.
  5. Add the new host name to the above host list.
  6. Once DNS is updated, if necessary, add the host to the list of nodes that can access the NFS server:
    • Login to spearfs1 and get root privilege.
    • Change /etc/exports to add the host name.
    • Copy the new version of exports to /spear/prod/epics/app/spear/iocBoot/exports so that CVS can be used for revision history.
    • Exit from spearfs1.
  7. Once DNS is updated, ask SLAC to give you sudo privilege using the form on the superuser/NFS privileges web page.
  8. Join the linux-l mailing list if not already a member by selecting "Subscribe or Unsubscribe".

Preparation for Installation of an Existing Machine

  1. Save a copy or get a printout of the machine's /proc/meminfo and /proc/cpuinfo. Save a copy or get a printout of the results of the command df, which shows current disk partitions and NFS mount points.
  2. Copy the following system configuration files to /afs/slac/g/spear/linuxSystem/<hostname> for reference:
    File Reason to Save
    /etc/ntp.conf NTP Configuration File
    /etc/resolv.conf DNS Configuration File
    /etc/taylor.opts Taylor Options
    /etc/fstab NFS Mount Points
    /etc/hosts Host Name and IP Address
    /etc/security/limits.conf Account Limits
    /etc/sysconfig/network Host Name
    /etc/sysconfig/network-scripts/ifcfg-eth0,1 Ethernet Port Configuration
  3. The rest of the instructions in this section apply to servers only.
  4. First, check that SPEAR program startup files in /etc/init.d are up-to-date in their AFS reference areas:
    Program /etc/init.d File Name AFS Reference
    Soft IOCs st.soft-ioc<name> $IOC/soft-ioc<name>/S99soft-ioc<name>
    Xvfb (X Virtual Frame Buffer) st.xvfb, Xvfb.cfg $EPICS_APP/alh/script/S98xvfb, Xvfb.cfg
    Subsystem ALH (Alarm Handler) Programs st.alh-<name> $IOC/soft-iocalh-<name>00/S99zzalh.<name>
    Annunciator and Development ALH (Alarm Handler) Programs st.alh.<name> $EPICS_APP/alh/script/S99zzalh.<name>
    ChannelWatcher Programs st.ChannelWatcher.<name> $EPICS_APP/cw/script/S98ChannelWatcher.<name>
    IOC Log Message Server st.iocLogMsgServer $EPICS_APP/iocLog/script/S97iocLogMsgServer
    PV Gateways st.gateway.<name> $EPICS_APP/gtw/script/S99st.gateway.<name>
    EDM Overhead Displays st.edm.<name> $EPICS_APP/edm/script/S99edm.<name>
    Automated Fill st.autoFill $SPEAR_MATLAB/automatedFill/S99zautoFill
    Beam Line Dynamic Steering st.blds $SPEAR_MATLAB/blds/S99zblds
    Booster RF Phase Stabilization Feedback st.feedbackBooRF $SPEAR_MATLAB/feedbackBooRF/S99zfeedbackBooRF
  5. For each program that must be moved to another machine during the installation:
    • Stop the program on this machine using instruction from the program web page in the above table.
    • Remove the associated sym link in /etc/rc3.d and /etc/rc5.d on this machine (need root privilege).
    • Correct $IOC/screeniocs for any applicable soft IOC and update /prod/epics/app/spear/iocBoot/screeniocs using the spear account.
    • If iocLogMsgServer is being moved, correct EPICS_IOC_LOG_INET in $EPICS/epicsSetup, $IOC/common/st.cmd, and $IOC/b132-iocrf/st.cmd.noepics and update /prod/epics/epicsSetup, /prod/epics/app/spear/ioc/common/st.cmd, and /prod/epics/app/spear/ioc/b132-iocrf/st.cmd.noepics using the spear account.
  6. On the other machine, for each program being moved:
    • Add the same sym link in /etc/rc3.d and /etc/rc5.d that was removed in the previous step (need root privilege).
    • Start the program using instruction from the program web page in the above table.
  7. If the machine being installed has 2 drives, leave the existing system on one drive and use the other for the new system. Before starting the installation, power down the machine and unplug the drive with the existing system (or find some way to make sure the drive is not formatted later on during the installation). It may be convenient to physically swap the 2 drives so that the new system is on the first drive and the old system is on the second drive.

Preparation for Installation of a New or Existing Machine

  1. Here is a list of information that you may want to know before starting the installation.
  2. For machines with 2 NICs, record the MAC address of both NICs. Unplug the private network ethernet cable.
  3. If a boot CD is not already available, find an available CD (there is a stack in B117 that the operators use) and create an installation CDROM using these SLAC instructions as a reference. The beldar linux workstation in the B117 computer room has a DVD-RW drive. If you use this workstation:
    sudo tcsh
    cd /nfs/slac/g/scs/redhat/RHEL6/x86-64/bootiso
    cdrecord -scanbus to get list of available media and:
    cdrecord -v -speed=2 dev=1,0,0 -eject -data rhel-workstation-6.1-x86-64-boot.iso
    exit
  4. Follow SLAC installation preparation steps. Use the following ethernet setup for SPEAR linux machines:
    Description Value
    Host Name and IP Address See Host List
    Domain slac.stanford.edu
    Subnet Mask Prod (Public): 255.255.254.0
    Prod (Private): 255.255.255.0
    Dev: 255.255.252.0
    IP Gateway Prod (Public): 134.79.46.1
    Dev: 134.79.35.1
    DNS Server 1 134.79.44.10 (Linux),
    134.79.164.11 (Windows)
    DNS Server 2 134.79.44.11 (Linux),
    134.79.164.12 (Windows)
    DNS Server 3 134.79.18.40
    NTP Server 1 ssrlntp1 (134.79.44.10)
    NTP Server 2 ssrlntp2 (134.79.44.11)
    NTP Server 3 ntp2 (134.79.18.41)
    NTP Server 4 ntp3 (134.79.18.34)
    Note that the IP gateway and the DNS and NTP servers for the private NIC are not used.

Boot the Installation Program

  1. Stick the CDROM in the drive and reboot your machine. If the machine ignores the CDROM at boot time (as it will for existing machines), change the boot order of the BIOS. Enter F12 and control-S early in the bootup and select the CDROM from the list provided.
  2. Choose "Install or Upgrade an Existing System".
  3. Choose to skip the media check.
  4. The rest of the instructions in this section are for booting from NFS instead of CD.
  5. Choose "NFS directory" for "Installation Method".
  6. For machines with 2 NICs, a menu is provided to select the Networking Device. Do the "Identify" test for both NICs. The one that will probably work is the private NIC (eth1). Unplug the private ethernet cable and move the public ethernet cable from eth0 to eth1. Choose "eth1" and continue.
  7. When configuring TCP/IP, check Enable IPv4 support and check Manual configuration. Uncheck Enable IPv6 support.
  8. Configure Manual TCP/IP Configuration using information from the table from the previous step for the public NIC. Be careful - any errors can disrupt the network.
  9. Configure NFS Setup by entering:
    Description Value
    NFS server name: 172.23.16.97
    Red Hat directory: /vol/vol1/g.scs.redhat/RedHat/RHEL6/6u1/x86_64
  10. A Red Hat welcome screen appears and further configuration is needed. Follow directions.

Host Name, Time Zone, and Root Configuration

  1. Follow directions to choose the U.S. English language.
  2. Choose Basic Storage Devices.
  3. Choose Fresh Installation.
  4. For the computer name, use the full name (with the .slac.stanford.edu).
  5. Configure the network. Select the appropriate "Wired" network card and manually edit it. Enter the IP address, subnet mask, gateway, and DNS list using information from tables in previous steps. Configure IPv4 settings and leave the IPv6 setting as ignored. Choose to connect automatically.
  6. Choose America/Los Angeles for time zone. Check System clock uses UTC,
  7. Contact Clemens or Stephanie for the root password.

Disk Drive Partitioning

  1. In partitioning disk drives, use SLAC recommendations as a guide. Select Create Custom Layout.
  2. For machines with 2 drives where one drive has an existing system, leave the existing drive as-is and only format the other drive.
  3. Delete all current partitions.
  4. For most SPEAR linux machines, the partitions can be set as follows:
    Mount Point Type Primary Size (MB)
    /boot ext4 Yes 2000
    / ext4 Yes 30000
    swap swap Yes 8000
    /var ext4 No 4000
    /usr/vice/cache ext4 No 4000
    /tmp ext4 No 4000
    /scswork ext4 No 2000
    /scratch ext4 No Remainder

Package Selection and Installation

  1. Select defaults for the boot loader.
  2. Choose Desktop for the software installation type. Choose Customize now to select the software to be loaded. Use defaults except select Emacs under Applications and for servers, select Development Tools under Development. For workstations, select KDE Desktop under Desktops.
  3. Do the installation now. Disks will be reformated and packages will be installed. This step takes up to 20 minutes.
  4. Remove the CDROM and reboot.

Post Install Configuration

  1. On reboot, the Red Hat Welcome screen appears.
  2. Accept license agreement.
  3. Do NOT register with RHN. This will be done later.
  4. Do not create usernames at this time. If forced to create usernames, use the Advanced setup. Create the group first where name = "qb" and id = "1080". Then create two users as follows. Do NOT create private groups and do NOT create home directories:
    Name Description ID Group Shell
    spear spear 7225 qb /bin/tcsh
    spearmgr spear linux mgr 7753 qb /bin/tcsh
  5. After each user is created, select the user and use "Properties" to remove the user from the "users" group and add to the "qb" group.
  6. Contact Clemens or Stephanie for the account passwords.
  7. Manually set Date and Time. Synchronization will be done later.
  8. Disable Kdump.

SPEAR Configuration

  1. Login as root using the previously chosen password. Open a terminal.
  2. Disable the firewall from the System -> Administration -> Firewall menu.
  3. Disable SELinux by changing the appropriate line in /etc/selinux/config to:
    SELinux=disabled
  4. If using taylor, create /etc/taylor.opts and set the following options:
    os_updates=immediate
    named=leavealone
    network_device=leavealone
    ntp=leavealone
  5. If using taylor, install and run Taylor:
    wget -O- http://www.slac.stanford.edu/comp/unix/linux/go-taylor | sh
    Do NOT NOT NOT control-C while this is running or do any other work on the host while this is running. Taylor will take up 20 minutes to run.
  6. Disable the NetworkManager both from the from the System -> Administration -> Services menu and using the following command:
    chkconfig NetworkManager off
  7. Change /etc/hosts:
    <ip address> <nodename>.slac.stanford.edu <nodename>
    127.0.0.1 localhost.localdomain localhost
    ::1 localhost.localdomain localhost
  8. Mount the NFS server to get access to system files. First, create directories:
    mkdir /prod
    mkdir /speardata
    mkdir /accphys
    Then mount the directories:
    mount spearnfs:/spear/prod /prod
    mount spearnfs:/spear/speardata /speardata
    mount spearnfs:/spear/accphys /accphys
  9. Add the following lines to /etc/fstab:
    spearnfs:/spear/prod /prod nfs defaults 0 0
    spearnfs:/spear/speardata /speardata nfs defaults 0 0
    spearnfs:/spear/accphys /accphys nfs defaults 0 0
  10. Copy the following files from /afs/slac/g/spear/linuxSystem to the specified destination:
    File Destination
    ntp.conf /etc
    resolv.conf /etc
    xorg.conf /etc/X11
    motd (non-afs only) /etc
    passwd (non-afs only) /etc
    group (non-afs only) /etc
    fonts/decw /usr/share/X11/fonts/decw
  11. For non-taylored linux consoles, install the mplayer sound system:
    rpm -ivh http://apt.sw.be/redhat/el6/en/x86_64/rpmforge/RPMS/rpmforge-release-0.5.2-2.el6.rf.x86_64.rpm
    yum -y install mplayer vlc xmms-mp3 xmms-flac xmms-wma xmms-skins
  12. For non-taylored linux consoles that need audible alarms, add startup of the Annunciator ALH:
    cp /prod/epics/app/alh/script/S99zzalh.annunciator /etc/init.d/st.alh.annunciator
    cp /prod/epics/app/alh/script/S98xvfb /etc/init.d/st.xvfb
    cp /prod/epics/app/alh/script/Xvfb.cfg /etc/init.d
    chmod +x /etc/init.d/st.alh.annunciator
    chmod +x /etc/init.d/st.xvfb
    cd /etc/rc5.d
    ln -s ../init.d/st.alh.annunciator S99zzalh.annunciator
    ln -s ../init.d/st.xvfb S98xvfb
    Do NOT add sym links under /etc/rc3.d.
  13. Install packages needed for the ops screen grabber on both taylored and non-taylored systems:
    cp /prod/package/ImageMagick-6.9.0-0.x86_64.rpm /etc/yum.repos.d/
    yum -y install qt PyQt4 ImageMagick
  14. Start the NTP client (ntpd) from the System -> Administration -> Services menu.
  15. For servers that run IOCs, allow the spear account to have unlimited processes by add this limit to /etc/security/limits.conf:
    spear - nproc unlimited
  16. If necessary, correct /etc/sysconfig/network-scripts/ifcfg-eth0 and, for 2 NIC machines, /etc/sysconfig/network-scripts/ifcfg-eth1. For 2 NIC machines, make changes so that ifcfg-eth0 is the public interface and ifcfg-eth1 is the private network.
  17. For non-taylored machines, register with the SLAC RedHat network satellite as follows:
    cd /prod/linuxSystem
    ./rhn-register-ssrl-spear.sh
    Do NOT NOT NOT control-C while this is running or do any other work on the host while this is running.
    Clemens has the username and password for the satellite server.
  18. Reboot the computer. As the computer starts back up, properly connect the ethernet cables for 2 NIC machines.

SSH Notes

  1. For existing machines, the SSH key for the machine will change. Anybody using ssh will need to remove the old key from their ~/.ssh/known_hosts file.
  2. The ssh keys for all taylored SLAC machines are kept in /afs/slac/common/etc/ssh_known_hosts (/etc/ssh/ssh_known_hosts is a sym link to this file). This file is regenerated every morning so users will need to wait until the next morning to use ssh without warning.

Note about Booting as Single-User

  1. If for some reason the network configuration is wrong or there is some other boot problem, you will need to boot in the single-user mode.
  2. Reboot the computer but stop the boot at the grub boot screen by selecting the kernel to boot and entering "e" to edit the entry.
  3. In the startup script that appears, select the second line (the line starting with "kernel") and enter "e" to edit the line.
  4. Append "single" (must be all lower-case) to the line and enter. Note that this change is only for this bootup and is not permanent.
  5. Enter "b" to continue the boot.
  6. The boot will stop at the shell. Use "vi" to correct the configuration file with the error.
  7. Reboot.

Taylored Servers sudo Setup

  1. For taylored AFS servers, boot as a single user and reset the root password. Reboot.
  2. Log in as root and change /etc/taylor.opts to add:
    workgroup=spear
  3. Run taylor:
    /usr/local/bin/taylor -verbose everything
  4. Reboot.

Post-Taylor/Post-Bootstrap Installation

  1. If using taylor, login using your AFS account. Open a terminal. Get sudo privilege:
    sudo tcsh
  2. If not using taylor, login as root. Open a terminal.
  3. Check that mount points on spearnfs are available by listing the contents of /prod, /speardata, and /accphys directories.
  4. Correct HOSTNAME in /etc/sysconfig/network to be the host name without the ".slac.stanford.edu".
  5. Install gui-related packages needed by some EPICS extensions:
    source /prod/linuxSystem/epicsUpdate
  6. For non-taylored systems, install the spear and spearmgr user directories:
    rm -rf /home/spear
    rm -rf /home/spearmgr
    mkdir /home/spear
    chown spear:qb /home/spear
    mkdir /home/spearmgr
    chown spearmgr:qb /home/spearmgr
    su spear
    cd /home/spear
    tar -cf /prod/linuxSystem/home/spear.tar .
    exit
    su spearmgr
    cd /home/spearmgr
    tar -cf /prod/linuxSystem/home/spearmgr.tar .
    exit
  7. For non-taylored systems, if necessary, correct passwords of the spear and spearmgr accounts using System -> Administration -> Users and Groups menu.
  8. For taylored machines, create the following sym links:
    cd /usr/lib64
    ln -s readline5/libreadline.so
    cd /usr/lib
    ln -s readline5/libreadline.so
    cd /usr/include
    ln -s readline5/readline
  9. If using taylor, run taylor again and reboot:
    taylor -verbose everything
  10. If not using taylor, do a yum update and reboot.
  11. Once the machine is back up, log back in.
  12. Check DNS using nslookup for any node name.
  13. Check the second NIC by connecting to a device on the private network and using netstat -a to verify that the connection is made through the private NIC.
  14. After some minutes have passed, check functionality of NTP using ntpstat and /usr/sbin/ntpq -p.
  15. If using taylor, get sudo privilege and run taylor as many times as necessary until no more changes are made:
    taylor -verbose everything
  16. If using taylor, correct taylor options in /etc/taylor.opts using /prod/linuxSystem/taylor.opts-server or /prod/linuxSystem/taylor.opts-opi as a reference and run taylor again. Reboot.

Installing NVIDIA Driver for non-Taylored Multiple Monitor Consoles

  1. This section is from Clemens. References are Nvidia proprietary drivers and RHEL6 and Installing NVidia Graphics card drivers.
  2. Note that the NVIDIA driver needs to be installed after a new version of the linux kernel is booted.
  3. Login as root. Open a terminal.
  4. Copy /prod/linuxSystem/NVIDIA-Linux-x86_64-290.10.run to /root/Downloads/NVIDIA-Linux-x86_64-290.10.run or download it from the web.
  5. Get rid of the existing nouveau driver (do this only the first time the driver is installed):
    sed -i '/root=/s|$| rdblacklist=nouveau vga=791|' /boot/grub/grub.conf
    echo "blacklist nouveau">> /etc/modprobe.d/blacklist.conf
    mv /boot/initramfs-$(uname -r).img /boot/initramfs-$(uname -r)-nouveau.img
    dracut /boot/initramfs-$(uname -r).img $(uname -r)
    The dracut command takes a while.
    yum remove xorg-x11-drv-nouveau
  6. Reboot. The X server no longer functions so get into line mode console using Ctrl-Alt-F2.
  7. Install the new driver:
    init 3
    Kill the Xvfb process if it is up (ps -ef | grep Xvfb)
    cd /root/Downloads
    chmod +x NVIDIA-Linux-x86--290.10.run
    sh NVIDIA-Linux-x86--290.10.run
  8. Reboot, login as root, and open a terminal.
  9. Set up monitors as desired using nvidia-settings.
  10. This program adds lines to /etc/X11/xorg.conf. The following line is added that is not compatible with EDM and must be deleted:
    FontPath "catalogue:/etc/X11/fontpath.d"

Setup of Linux Console spear Account

  1. Login as spear. Before entering the password, choose KDE for desktop.
  2. Bring up the Desktop folder and add icons to the desktop for each item in that folder. Test that each icon works.
  3. If the linux console does audible alarms, check that the Annunciator ALH process is up:
    ps -ef | grep alh
    Test that it is working by bringing up the wolf box display (SPEAR Index -> Diagnostics -> Wolf Box), turning on Channel 1, and listening for a gong sound. Adjust speaker volume.
  4. Disable screensaver and power saving options so that computer and monitors stay active.

Matlab Installation

  1. If matlab runs on this machine (AFS or non-AFS, server or console), work with Jim Sebek to install a license for this machine using instructions in /prod/matlab/license/README. If matlab is already licensed but the machine hardware (MAC address) is changed or a new version of matlab is desired, the old license must be deactivated and a new license activated. If the machine is new and there are no licenses available, deactivate matlab on a less-used machine first.
  2. For running compiled matlab programs using the AFS spear account, a sym link must be added under the AFS ~spear/.matlab directory to point to the corresponding mcr directory under $MATLABDATAFILES on the NFS server. This allows the programs to run without needing an AFS token. When a new version of mcr is installed, login using the AFS spear account:
    cd $MATLABDATAFILES
    mkdir mcr_<version>
    cd ~spear/.matlab
    ln -s $MATLABDATAFILES/mcr_<version>

Configuration of Programs on AFS Servers

  1. Login using your AFS account. Open a terminal. Get sudo privilege.
  2. To run soft IOCs using iocConsole, install the screen as follows (order is important):
    mkdir /home/screen
    mkdir /home/screen/bin
    chmod g+w -R /home/screen
    mkdir /home/screen/sock
    mkdir /home/screen/usock
    cp /afs/slac/g/spear/hostApps/@sys/bin/screen /home/screen/bin
    chgrp qb -R /home/screen
    chmod u+s -R /home/screen
  3. Copy the following files from their AFS reference area to /etc/init.d using the file name shown in the following table. Give each startup file executable privilege:
    chmod +x /etc/init.d/st.<filename>
    Program /etc/init.d File Name AFS Reference
    Soft IOCs st.soft-ioc<name> $IOC/soft-ioc<name>/S99soft-ioc<name>
    Xvfb (X Virtual Frame Buffer) st.xvfb, Xvfb.cfg $EPICS_APP/alh/script/S98xvfb, Xvfb.cfg
    Subsystem ALH (Alarm Handler) Programs st.alh-<name> $IOC/soft-iocalh-<name>00/S99zzalh.<name>
    Annunciator and Development ALH (Alarm Handler) Programs st.alh.<name> $EPICS_APP/alh/script/S99zzalh.<name>
    ChannelWatcher Programs st.ChannelWatcher.<name> $EPICS_APP/cw/script/S98ChannelWatcher.<name>
    IOC Log Message Server st.iocLogMsgServer $EPICS_APP/iocLog/script/S97iocLogMsgServer
    PV Gateways st.gateway.<name> $EPICS_APP/gtw/script/S99st.gateway.<name>
    EDM Overhead Displays st.edm.<name> $EPICS_APP/edm/script/S99edm.<name>
    Automated Fill st.autoFill $SPEAR_MATLAB/automatedFill/S99zautoFill
    Beam Line Dynamic Steering st.blds $SPEAR_MATLAB/blds/S99zblds
    Booster RF Phase Stabilization Feedback st.feedbackBooRF $SPEAR_MATLAB/feedbackBooRF/S99zfeedbackBooRF
  4. For each program that was moved to another machine during the installation:
    • Stop the program on the other machine using instruction from the program web page in the above table.
    • Remove the associated sym link in /etc/rc3.d and /etc/rc5.d on the other machine (need root privilege).
    • Correct $IOC/screeniocs for any applicable soft IOC and update /prod/epics/app/spear/iocBoot/screeniocs using the spear account.
    • If iocLogMsgServer is being moved, correct EPICS_IOC_LOG_INET in $EPICS/epicsSetup, $IOC/common/st.cmd, and $IOC/b132-iocrf/st.cmd.noepics and update /prod/epics/epicsSetup, /prod/epics/app/spear/ioc/common/st.cmd, and /prod/epics/app/spear/ioc/b132-iocrf/st.cmd.noepics using the spear account.
  5. On this machine, for each program that must run:
    • Add a sym link to /etc/rc3.d and /etc/rc5.d. The sym links must start with S97, S98, or S99 to ensure startup order. Use AFS reference names in the above table as a guide for sym link names. Do NOT add sym links under /etc/rc3.d for Xvfb, ALH, and compiled matlab programs like autoFill, BLDS, and feedbackBooRF.
    • Start the program using instruction from the program web page in the above table.
  6. Reboot to make sure all programs that are expected to run on this machine, start up automatically. Check that there are no unexpected programs running (ie, that the same soft IOC isn't running on more than one machine).
  7. Reboot again to make sure all programs gracefully exit and then are restarted with no problems.


SPEAR EPICS | SPEAR Home | SSRL Computing/Networking | SSRL Home | SLAC Computing | SLAC Networking | SLAC Home

Contact: Stephanie Allison
Last Modified: Jun 24, 2015