Web version of JMenu
- Download Java 8+
- Download Apache Tomcat 7, 8, or 9
- Download wmenu.war and drop it into the Tomcat webapps directory
- Start Tomcat and navigate your web browser to localhost:8080/wmenu
Environment variables are needed:
- WMENU_JMENU_URL - path to menus web service
- WMENU_SEARCH_URL - path to search results web service
- WMENU_ROOT_MENU - name of root menu (example 'MainMenu' for ops, 'MainMenuUITF' for itf)
This project is built with Java 17 (compiled to Java 8 bytecode), and uses the Gradle 7 build tool to automatically download dependencies and build the project from source:
git clone https://github.com/JeffersonLab/wmenu
cd wmenu
gradlew build
Note: If you do not already have Gradle installed, it will be installed automatically by the wrapper script included in the source
Note for JLab On-Site Users: Jefferson Lab has an intercepting proxy
This application requires a menu server and Elasetic Search server. On-site at JLab configure the app to use:
WMENU_JMENU_URL=https://accweb9.acc.jlab.org/apps/jmenu/api/menus
WMENU_SEARCH_URL=https://accweb7.acc.jlab.org/search/jmenu-cebaf
WMENU_ROOT_MENU=MainMenu
Note: These servers support CORS to allow cross-origin requests.
- Bump the version number and release date in build.gradle and commit and push to GitHub (using Semantic Versioning).
- Create a new release on the GitHub Releases page corresponding to same version in build.gradle (Enumerate changes and link issues). Run war Gradle build target and attach war to release.
At JLab this app is found at epicsweb.jlab.org/wmenu, plus other fiefdom specific subpaths, and internally at epicswebtest.acc.jlab.org/wmenu. However, the epicsweb server is a proxy for epicswebops.acc.jlab.org, epicswebops2.acc.jlab.org, epicswebchl.acc.jlab.org, epicswebfel.acc.jlab.org, epicswebsrf.acc.jlab.org and epicswebitf.acc.jlab.org. Additionally, the context root for each is adjusted with a prefix such that all servers can be reached from a single namespace. The context root prefixes are /, /ops2, /chl, /fel, /srf, and /itf respectively. Tomcat interprets context roots from war file name unless overridden elsewhere. Therefore each war must be prefixed with <prefix>#. Use wget or the like to grab the release war file. Don't download directly into webapps dir as file scanner may attempt to deploy before fully downloaded. Be careful of previous war file as by default wget won't overrwite. The war file should be attached to each release, so right click it and copy location (or just update version in path provided in the example below). Example for chl fiefdom:
cd /tmp
rm wmenu.war
wget https://github.com/JeffersonLab/wmenu/releases/download/v1.2.3/wmenu.war
mv wmenu.war chl#wmenu.war
mv chl#wmenu.war /usr/share/tomcat/webapps