Merge MMTC UI feature branch into main

README.md

@@ -33,7 +33,15 @@ Missions adapt MMTC to their mission by accomplishing the following two steps:
 
 ## Quick Start
 
-MMTC requires Red Hat Enterprise Linux (RHEL) 8 or 9 and Java 8.  After cloning the repository and running `./gradlew build`, two MMTC installation options are available:
+Build requirements:
+- Red Hat Enterprise Linux (RHEL) 8 or 9 on an x86-64 host
+- Java 17
+
+Runtime requirements:
+- Red Hat Enterprise Linux (RHEL) 8 or 9 on an x86-64 host
+- Java 8 for all components except the web application, which requires Java 17
+
+After cloning the repository and running `./gradlew build`, two MMTC installation options are available:
 
 ### Demo
 
@@ -45,7 +53,6 @@ For users who wish to experiment with MMTC’s behavior and functionality withou
 
 See the "Quick Start Guide" section of the User Guide for complete instructions.
 
-
 ### Installation
 
 To create a traditional clean installation of MMTC that is ready for configuration and adaptation:
@@ -59,6 +66,6 @@ For further information, please see the User Guide at `docs/User_Guide.adoc`, wh
 
 ## Copyright
 
-© 2024 The Johns Hopkins University Applied Physics Laboratory LLC
+© 2025 The Johns Hopkins University Applied Physics Laboratory LLC
 
 This work was performed for the Jet Propulsion Laboratory, California Institute of Technology, sponsored by the United States Government under the Prime Contract 80NM0018D00004 between the Caltech and NASA under subcontract number 1658085.

build.gradle.kts

@@ -69,13 +69,33 @@ val createDistDir = tasks.register("createDistDir") {
 
     doLast {
         exec {
-            commandLine("bash", "create-dist.sh", project.version)
+            commandLine("bash", "create-dist.sh", project.version, "cli")
         }
     }
 
     outputs.dir("build/mmtc-dist-tmp")
 }
 
+val createWebAppDistDir = tasks.register("createWebappDistDir") {
+    inputs.files("mmtc-core/bin/mmtc")
+    inputs.files("mmtc-core/build/libs/mmtc-core-" + project.version + "-app.jar")
+    inputs.files("mmtc-plugin-ampcs/build/libs/mmtc-plugin-ampcs-" + project.version + ".jar")
+    inputs.files("mmtc-webapp/build/libs/mmtc-webapp-" + project.version + ".jar")
+
+    dependsOn("mmtc-core:uberJar")
+    dependsOn("mmtc-plugin-ampcs:jar")
+    dependsOn(":userGuidePdf")
+    dependsOn("mmtc-webapp:jar")
+
+    doLast {
+        exec {
+            commandLine("bash", "create-dist.sh", project.version, "webapp")
+        }
+    }
+
+    outputs.dir("build/mmtc-webapp-dist-tmp")
+}
+
 val mmtcEl8Rpm = tasks.register<Rpm>("mmtcEl8Rpm") {
     dependsOn(tasks.build)
 
@@ -141,6 +161,73 @@ tasks.getByName("mmtcEl9Rpm") {
     dependsOn(tasks.getByName("cleanMmtcEl9Rpm"))
 }
 
+val mmtcWebAppEl8Rpm = tasks.register<Rpm>("mmtcWebAppEl8Rpm") {
+    dependsOn(tasks.build)
+
+    packageName = "mmtc-webapp"
+    distribution = "el8"
+    release = "1.$distribution"
+    archStr = "x86_64"
+    os = org.redline_rpm.header.Os.LINUX
+
+    preInstall(file(projectDir.toPath().resolve("rpm-scripts/pre-install.sh")))
+    postInstall(file(projectDir.toPath().resolve("rpm-scripts/post-install.sh")))
+
+    user(this, "mmtc")
+    permissionGroup(this, "mmtc")
+
+    //make the RPM relocatable using prefix(). however, also set the default location using into();
+    //otherwise, if you install without specifying a custom "--prefix", it gets installed in /usr
+    //(at least that's what happened in my local testing).
+    prefix("/opt/local/mmtc")
+    into("/opt/local/mmtc")
+
+    //copy the distribution folder, preserving permissions since they're already correct.
+    //NOTE: this doesn't seem to set *directory* permissions, so we use post-install.sh for that.
+    from(projectDir.toPath().resolve("build/mmtc-webapp-dist-tmp"))
+
+    //NOTE: create-dist.sh updates bin/mmtc to point to the correct (newly installed) jar file,
+    //so we no longer create a symlink at lib/mmtc.jar
+}
+
+val mmtcWebAppEl9Rpm = tasks.register<Rpm>("mmtcWebAppEl9Rpm") {
+    dependsOn(tasks.build)
+
+    packageName = "mmtc-webapp"
+    distribution = "el9"
+    release = "1.$distribution"
+    archStr = "x86_64"
+    os = org.redline_rpm.header.Os.LINUX
+
+    preInstall(file(projectDir.toPath().resolve("rpm-scripts/pre-install.sh")))
+    postInstall(file(projectDir.toPath().resolve("rpm-scripts/post-install.sh")))
+
+    user(this, "mmtc")
+    permissionGroup(this, "mmtc")
+
+    //make the RPM relocatable using prefix(). however, also set the default location using into();
+    //otherwise, if you install without specifying a custom "--prefix", it gets installed in /usr
+    //(at least that's what happened in my local testing).
+    prefix("/opt/local/mmtc")
+    into("/opt/local/mmtc")
+
+    //copy the distribution folder, preserving permissions since they're already correct.
+    //NOTE: this doesn't seem to set *directory* permissions, so we use post-install.sh for that.
+    from(projectDir.toPath().resolve("build/mmtc-webapp-dist-tmp"))
+
+    //NOTE: create-dist.sh updates bin/mmtc to point to the correct (newly installed) jar file,
+    //so we no longer create a symlink at lib/mmtc.jar
+}
+
+// fix for Rpm task setting incorrect digests in RPM metadata
+tasks.getByName("mmtcWebAppEl8Rpm") {
+    dependsOn(tasks.getByName("cleanMmtcWebAppEl8Rpm"))
+}
+
+tasks.getByName("mmtcWebAppEl9Rpm") {
+    dependsOn(tasks.getByName("cleanMmtcWebAppEl9Rpm"))
+}
+
 distributions {
     main {
         distributionBaseName.set(project.name)
@@ -150,6 +237,15 @@ distributions {
     }
 }
 
+distributions {
+    create("mmtcWebApp") {
+        distributionBaseName.set("mmtc-webapp")
+        contents {
+            from("build/mmtc-webapp-dist-tmp")
+        }
+    }
+}
+
 tasks.distZip {
     dependsOn(createDistDir)
 }
@@ -164,6 +260,20 @@ tasks.installDist {
     dependsOn(createDistDir)
 }
 
+tasks.getByName<Zip>("mmtcWebAppDistZip") {
+    dependsOn(createWebAppDistDir)
+}
+
+tasks.getByName<Tar>("mmtcWebAppDistTar") {
+    dependsOn(createWebAppDistDir)
+    compression = Compression.GZIP
+    archiveExtension.set("tar.gz")
+}
+
+tasks.getByName("installMmtcWebAppDist") {
+    dependsOn(createWebAppDistDir)
+}
+
 val demoZip = tasks.register("demoZip") {
     dependsOn(tasks.build)
     dependsOn(createDistDir)

create-dist.sh

@@ -1,10 +1,16 @@
 #!/bin/bash
 
-# only arg provided to this script must be project version string
+# two args provided to this script:
+# - project version string
+# - "cli" or "webapp"
 
 set -e
 
-DIST_DIR=build/mmtc-dist-tmp
+if [ "${2}" = "webapp" ]; then
+  DIST_DIR=build/mmtc-webapp-dist-tmp
+else
+  DIST_DIR=build/mmtc-dist-tmp
+fi
 
 if [[ -d $DIST_DIR ]]; then
   rm -r $DIST_DIR
@@ -53,3 +59,17 @@ touch $DIST_DIR/log/.keep
 
 mkdir $DIST_DIR/output/
 touch $DIST_DIR/output/.keep
+
+if [ "${2}" = "webapp" ]; then
+  cp mmtc-webapp/bin/mmtc-webapp                                                  $DIST_DIR/bin
+
+  if [[ "$OSTYPE" == "darwin"* ]]; then
+    # BSD sed
+    sed -i '' "s|@VERSION@|${1}|"                                                 $DIST_DIR/bin/mmtc-webapp
+  else
+    # assume Linux (and GNU sed)
+    sed -i "s/@VERSION@/${1}/"                                                    $DIST_DIR/bin/mmtc-webapp
+  fi
+
+  cp mmtc-webapp/build/libs/mmtc-webapp-$1.jar                                      $DIST_DIR/lib/
+fi