hla_framework_bd/docs/steps.md

Manual steps to be automated

• Define Name, e.g., TUNEFBX
• Add to Master IOC
  • In git repo gitea/A_BD https://gitea.psi.ch/epics_iocboot_sls/A_BD
  • Edit AGEBD-CPCL-MASTER_main.subs
  • Login on machine network and reinstall/restart master IOC
    • Ssh sls-lca
    • ioc install -V --ioc AGEBD-CPCL-MASTER –clean
    • ioc shell AGEBD-CPCL-MASTER then ctrl + x
• Add to Master Service
  • In git repo gitea/sls_bd https://gitea.psi.ch/autodeploy_bin/sls_bd
  • Edit AGEBD-SERVICE-MASTER.py to include
  • Git push
  • Restart master service
• Prepare python file
  • In git repo gitea/sls_bd https://gitea.psi.ch/autodeploy_bin/sls_bd
  • Copy AGEBD-SERVICE-TEMPLATE.py to AGEBD-SERVICE-TUNEFBX.py
• Prepare IOC for new Service
  • In git repo gitea/A_BD https://gitea.psi.ch/epics_iocboot_sls/A_BD
  • Copy directory AGEBD-CPCL-TEMPLATE to AGEBD-CPCL-TUNEFBX
  • Update all filenames
  • Update all files
  • Add required pvs to .template file
  • Add IOC to readme.md and find port number to be configured in yaml file
  • Git push
• Initialize / Start IOC for new service
  • Login on machine network and install the new IOC
    • Ssh sls-lca
    • Cd /sls/bd/
    • ioc install -V --ioc AGEBD-CPCL-TUNEFBX –clean
  • Login on BD IOC host for access to shellbox for initial start of new IOC
    • ssh sls-vserv-bd-01
    • sudo shellbox status
    • sudo shellbox reload
    • sudo shellbox status
    • sudo shellbox start XXXXXXX
• Prepare systemd unit file
  • In git repo gitea/sls_bd https://gitea.psi.ch/autodeploy_bin/sls_bd
  • Copy systemd/AGEBD-SERVICE-TEMPLATE.service systemd/AGEBD-SERVICE-TUNEFBX.service
  • Edit systemd/AGEBD-SERVICE-TUNEFBX.service for starting AGEBD-SERVICE-TUNEFBX.py
• Initialize / Start systemd service
  • Login on BD service host
  • ssh sls-vserv-bd-hla01
  • sudo su svcusr-sls2hla
  • Check if systemctl is working : >>systemctl –user
    • If return is "Failed to connect to bus: No such file or directory"
    • export XDG_RUNTIME_DIR=/run/user/51393
  • systemctl --user daemon-reload
  • systemctl --user enable /sls/bd/bin/systemd/AGEBD-SERVICE-TUNEFBX.service
  • systemctl --user start AGEBD-SERVICE-TUNEFBX.service
• Add to Service overview GUI
  • In git repo gitea/sls_bd_qt https://gitea.psi.ch/autodeploy_config/sls_bd_qt
  • Add lines to service management gui for new service >> caqtdm_designer A_BD_ServiceManager.ui
  • Test updated GUI: >> caqtdm A_BD_ServiceManager.ui
• Make GUI dedicated to new service
  • In git repo gitea/sls_bd_qt https://gitea.psi.ch/autodeploy_config/sls_bd_qt