Web interface to the EPICS Channel Finder database. This interface allows users to query for PVs by wildcard name searches as well as querying by PV meta-data such as IOC name, record type, etc.
PV Info also integrates with several other EPICS high level services:
- PV Web Socket is used to show live PV data including the value, alarm status/severity, alarm limits, etc.
- Phoebus OLOG allows you to display any log entries that contain the specific PV name on the PV "details" page.
- Phoebus Alarm Logger displays the alarm history for a specific PV on it's "details" page.
- Archiver Appliance Web Viewer is used to show the archived history of PVs. Since this is simply an external link in PV Info to the archiver web viewer, other archive engines and their own web viewers can easily be used.
It is important to note that only the Channel Finder integration is required to use PV Info.
This repository is under active development and is currently in production at the Advanced Light Source (ALS). Effort has been made to make PV Info non-ALS specific and configurable for any site using Channel Finder but things might have been missed. So please report any bugs you might find, any new features which could be useful, and any feedback on configuring/installing/using PV Info.
- Node.js - https://nodejs.org/
In version 2.0.0 the PV Info build tool was changed from Create React App to Vite. Create React App has been deprecated by Facebook and is no longer maintained. This can cause some issues with security vulnerabilities and isn't good for the long term so we have switched to Vite. Vite is mostly a drop-in replacement but see here for differences in PV Info 1.x.x and 2.x.x - Version 2 notes.
It is important to delete the node_modules directory and do an npm install to regenerate all the dependencies when converting an existing application to version 2.0.0.
There are many React environment variables avaiable to configure PV Info for your site. Several variables will most definately need to be updated for PV Info to work. These variables are containted in .env file:
REACT_APP_ENDPOINTREACT_APP_DOMAINREACT_APP_HTTP_PROTOCOLREACT_APP_CF_URLREACT_APP_PVWS_URLREACT_APP_AA_URLREACT_APP_OLOG_URLREACT_APP_AL_URL
The only required service is Channel Finder. To turn off PV Web Socket, Archiver Web Viewer, or OLOG:
REACT_APP_USE_PVWS=falseREACT_APP_USE_AA=falseREACT_APP_USE_OLOG=falseREACT_APP_USE_AL=false
Other interesting variables are the channel finder properties that you can configure to show as searchable on the homepage:
REACT_APP_CF_RECORD_TYPEREACT_APP_CF_RECORD_DESCREACT_APP_CF_ALIASREACT_APP_EXTRA_PROPREACT_APP_SECOND_EXTRA_PROP
- Update src/theme.js with the colors and fonts you want
- Place your own logo in src/assets
- Place your own favicons in public
Installs the needed NPM modules into node_modules directory. Run this the first time you clone the repository.
Runs the app in the development mode.
Open http://localhost:3000 or possibly http://localhost:3000/pvinfo to view it in the browser.
The page will reload if you make edits.
You will also see any lint errors in the console.
Builds the app for production to the build folder.
It correctly bundles React in production mode and optimizes the build for the best performance.
The build is minified and the filenames include the hashes.
Your app is ready to be deployed!
See the section about deployment for more information.
Since React routing is done on the client side, direct links to sub pages of PV Info might not load (i.e. https://myhost/pvinfo/pv/mypv). To solve this, something like this can be added to .htaccess for apache setups to always route through the index endpoint:
$ cat .htaccess
Options -MultiViews
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.html [QSA,L]
See more screenshots here: example.md