FR2BCO05

Magnet Information Management System
Based on Web Application
for the KEK e-/e+ Injector Linac

Masanori Satoh, Yoshinori Enomoto (KEK Acc. Lab., SOKENDAI)
Takuya Kudou (Mitsubishi Electric System & Service Co., Ltd)

Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

1

Outline• Lepton Accelerator Complex in KEK Tsukuba Campus• Device information database system• New Magnet information management system based onWeb application• Summary
ICALEPCS2023, Oct. 2023

Lepton Accelerator Complex in KEK Tsukuba Campus--- e-/e+ injector, four rings and e+ DR --Simultaneous top-up injection since 2019e+e-

HER : e7 GeV

Belle II
SuperKEKBLER : e+4 GeV

Circumference : ~3 km
STF
PF-AR: 6.5 GeV

Injector LINAC(600 m)Each ring requires much different beam quality
Injector linac beam up-to 50 Hz
Bunch charge: 0.1 nC – 4 nC (10 nC for e+ production)
Beam energy: 2.5 GeV – 7 GeVEmittance: 15 – 150 mm·mrad (normalized)e+ Damping Ring
PF: 2.5 GeV

Injector Linac provides the beams to 4 (+1) different rings up to 50 Hzl Photon Factory
Light Sourcel PF-ARl SuperKEKB High Energy Ring (HER)l SuperKEKB Low Energy Ring (LER) + Damping Ring
Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

Belle II experiment3

Pulse to pulse beam switching:rf e- gun/thermionic e- gun
In injector section

Thermionic DC e- gun (GU_AT)
w/ 2 subharmonic bunchers (114 MHz, 571 MHz)and 2 bunchers.

・e+ production e-: 10 nC (for LER injection)・e- study/HER injection: 1 nC
・PF injection: 0.1 - 0.3 nC
・PF-AR injection: 0.1 - 0.3 nC

RF e- gun
（GR_A1 for HER injection）

Pulsed bend

ICALEPCS2023, Oct. 2023

Beam switching yard
from injector to each ring beam transport line

Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

5Event Based Timing System
EVG clockCentral timing station

Main Rings

EVG#1

EVG EVR

Event signal (optical fiber)
PFAR

PFARPFL

TT

TTPFL

EVR

EVG#2 EVG#3
EVR
EVR

EVR

EVR

e− GunJ-ARC

EVRs
Masanori Satoh (KEK)

EVR
EVR

EVR

EVR

EVR

e+Target
EVR

Micro-Research Finland Oy: event generator (EVG),
event receiver (EVR)• Based on VME system (VxWorks6.8 (RTOS),
MVME6100 (CPU))• PXIe EVR for pulsed magnet control• EVG x 3, EVR x 28 (VME), x17 (PXIe)• Low level rf phase, pulsed magnet, etc arecontrolled by using the EventCode distributed from
EVG. (each EventCode is tagged to each ring
injection beam.)
EVR

EVR
EVR

Damping Ring

EVR

EVR

EVR

e‒ BT (PF: 2.5 GeV, 0.1nC)e‒ BT (PF-AR: 6.5 GeV, 0.1 nC)
e+ BT (SuperKEKB: 4 GeV, 1-4 nC)e‒ BT (SuperKEKB: 7 GeV, 1-4 nC)
Oct. 2023
EVR ICALEPCS2023,
EVR

6

Beam Injection Pattern Generation••

Beam repetition rate is determined by demand from each ring.
Priority can be defined.

Beam repetition rate management foreach beam injection mode.
Masanori Satoh (KEK)

Beam mode
KBE: SuperKEKB e- (HER)
KBP: SuperKEKB e+ (LER)
QFE: PF
ARE: PF-AR
ICALEPCS2023, Oct. 2023

7

Injector Linac Control System• EPICS based control
system with HA
server computers.
• 500 IOCs are runningon virtual machine.
• Local controller
• VME
• PLC
• Embedded system• PXIeICALEPCS2023, Oct. 2023

Device information system• The text-based database files have long been used for the device
information management.
• They are master information for generating EPICS database files
and other configuration files of LINAC control software programs.
• In this management scheme, it is not easy for common users
except a control software expert to access and update anyinformation.
• Database files: /usr/users/control/*tbl.tbl
Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

9

Screen monitor (profile monitor)
related database file
file name: scrn2tbl.tbl• Using this database file,
EPICS database can begenerated with shell orPython scripts.

ICALEPCS2023, Oct. 2023

Previous database files of magnet system
Database file namecontentes

mgtbl.tbl

DC magnet controller (PLC) information

mgbasetbl.tbl

Pulsed magnet controller (PXI) information

mgpvtbl.tbl

Magnet name/EPICS PV name table

mgbtbl.tbl

DC magnet excitation curve (magnetic field)

mgktbl.tbl

DC magnet excitation curve (k value)

mgbptbl.tbl

Pulsed magnet excitation curve (magnetic field)

mgbftbl.tbl

DC magnet fudge factor

mgbfptbl.tbl

Pulsed magnet fudge factor
ICALEPCS2023, Oct. 2023

Contents of magnet relater database files
Excitation curve (coefficients of fitting polynomial)

File header(Changelog）

Pulsed magnet
information

ICALEPCS2023, Oct. 2023

New magnet information management system• To improve the usability of magnet database, a web-baseapplication was developed.
• For non-software experts, it is not easy to update the databaseand check the present status.
• Multiple database files are consolidated into PostgreSQL.
• By using web application GUI, non experts can easily operate thedatabase.

Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

13

System diagram• Angular (UI), PostgreSQL (database), HA cluster (Corosync, PaceMaker)
User Interface (Angular)
Vistual IP Address
HA Cluster
Corosync + PaceMaker

ApacheHTTP Server

Pgpool-II watchdog
Active/Standby
・connection pooling・online recovery

PostgreSQL・Streaming replication

ApacheHTTP Server

ApacheHTTP Server

Vistual IP Address
pgpool-II

PostgreSQL

pgpool-II

PostgreSQLICALEPCS2023, Oct. 2023

pgpool-II

PostgreSQL

Functionality• The access control of the database can be managed using thealready existing Lightweight Directory Access Proto-col (LDAP)
server at LINAC. (read only or read-and-edit access)• Data can be easily edited (modify, add, delete data) directly within
the web browser by the allowed user.
• The bulk import/export data with the CSV file format. (all data orthe selected data)• 600 magnet information are registered. Each magnet informationhas 100 data column components. (magnet name, power supply
specification, ….)

Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

15

Web application main page (after authentication with ID/password)PS
namemagnetnameusernamelastupdate

maneteffective
ICALEPCS2023, Oct. 2023
lengthexcitation curvecoefficients

Edit page••

Modify/Add/Delete items directly within the web browser
Bulk import/export feature via CSV file

ICALEPCS2023, Oct. 2023

Filtering setting

ICALEPCS2023, Oct. 2023

Changelog

ICALEPCS2023, Oct. 2023

Summary• The text-based database files have long been used for the device
information management. (generating EPICS database files and other files
required for control software programs)• In the new magnet information management system, the multiple databasefiles are consolidated using PostgreSQL. The complexity of managing thesedatabase files is markedly reduced.
• Non-software experts can easily modify the data-base using the operational
interface of the web application developed by Angular.
• We will expand this system to other device information management(accelerating structure, klystron, and a beam monitor).
Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

20

Thank you for your attention!

Masanori Satoh (KEK)

ICALEPCS2023, Oct. 2023

21