This is a gui and cli application for managing the deployment and inspection of PMPS database files on production PLCs at LCLS. It provides tools to make deployment and verification of deployment seamless and easy.
Once installed, this application can be invoked via pmpsdb. For example, here is
the current output of pmpsdb --help:
usage: pmpsdb [-h] [--version] [--verbose] [--export-dir EXPORT_DIR] {gui,list-files,upload-to,download-from,compare,reload} ...
PMPS database deployment helpers
positional arguments:
{gui,list-files,upload-to,download-from,compare,reload}
gui Open the pmpsdb gui.
list-files Show all files uploaded to a PLC.
upload-to Upload a database export file to a PLC.
download-from Download a database file previously exported to a PLC.
compare Compare files beteween the local exports and the PLC.
reload Force the PLC to re-read the database export while running.
optional arguments:
-h, --help show this help message and exit
--version Show version information and exit
--verbose, -v Show tracebacks and debug statements
--export-dir EXPORT_DIR, -e EXPORT_DIR
The directory that contains database file exports.
From a git clone, you can invoke the same script without needing to install the
package. This is done from the root directory here by calling
python -m pmpsdb --help, for example.
This application will not work unless you have access to the LCLS controls networks. It is designed to run on an endstation's operator consoles.
The most common usage will be to open the gui from an operator console as simply pmpsdb gui.
This package can be installed using recent versions of pip that support
the pyproject.toml format.
To install, you can choose one of the following:
pip install pmpsdb_clientto install from pypi- clone this repo, check out the desired tag, and run the following from the root directory:
pip install . - install directly from github via:
pip install 'pmpsdb_client @ git+https://github.com/pcdshub/[email protected]'for example, to install version v1.1.2.
The PLC must have the following configuration:
- ftp enabled, with either the default logins or anonymous uploads enabled
- firewall TCP ports 20-21 allowed
These are both editable in the CX Configuration Tool. Enabling the ftp server will require a PLC restart, updating the firewall will not.