You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+44-14Lines changed: 44 additions & 14 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
<!--
2
-
Copyright (c) 2023 The Johns Hopkins University Applied Physics
2
+
Copyright (c) 2026 The Johns Hopkins University Applied Physics
3
3
Laboratory LLC.
4
4
5
5
This file is part of the Asynchronous Network Management System (ANMS).
@@ -21,13 +21,43 @@ subcontract 1658085.
21
21
-->
22
22
# AMMOS ANMS
23
23
24
-
This is a detailed developer-focused documentation for the AMMOS Asynchronous Network Management System (ANMS).
24
+
This is the quickstart documentation for the AMMOS Asynchronous Network Management System (ANMS).
25
25
26
26
### Copyright
27
27
28
-
Copyright (C) 2022-2025 The Johns Hopkins University Applied Physics Laboratory LLC.
28
+
Copyright (C) 2022-2026 The Johns Hopkins University Applied Physics Laboratory LLC.
29
29
30
-
[[_TOC_]]
30
+
# Start Here: Which Documentation Should You Use?
31
+
32
+
ANMS supports multiple types of users. The appropriate documentation depends on how you are interacting with the system.
33
+
34
+
**1. Are you installing ANMS from this source repository?**
35
+
36
+
If yes, then use this README for:
37
+
* Quickstart instructions
38
+
* Installation steps
39
+
* Basic configuration
40
+
* High-level overview
41
+
42
+
For detailed operational guidance after installation, refer to the ANMS User Guide, found here: www.nasa-ammos.github.io/anms-docs/.
43
+
44
+
**2. Are you an AMMOS user or operating an already-installed ANMS instance (not from source)?**
45
+
46
+
If yes, do not rely on this README for operational guidance. Refer to the ANMS Product Guide and ANMS User Guide for:
47
+
* System usage
48
+
* Operational workflows
49
+
* Configuration details
50
+
51
+
**NOTE:** These guides apply to *all* users once ANMS is installed.
52
+
53
+
**3. Are you a developer contributing to ANMS or setting up a development environment?**
54
+
55
+
If yes, refer to both this Readme and the ANMS Wiki – Development Guide for:
56
+
* Local development environment configuration
57
+
* Build instructions
58
+
* Testing workflows
59
+
* Contribution guidelines
60
+
* Additional troubleshooting guidance
31
61
32
62
# Quick Start
33
63
@@ -38,18 +68,18 @@ This section details prerequisites to installing the ANMS from source on a devel
38
68
### Software and OS Versions
39
69
40
70
The setup of ANMS and demos listed in this README have been tested on macOS 11.6.4 (Big Sur), RHEL 9 and Ubuntu 20.04.
41
-
To run the ANMS tool, you must also install Docker Engine version 20.10.10 or newer or Podman 5.2.2+. You will also need either Docker Compose version 1.29.2+ or podman-compose. Docker and podman can generally be used interchangeably.
71
+
To run the ANMS tool, you must also install Docker Engine version 20.10.10 or newer or Podman 5.2.2+. You will also need either Docker Compose version 1.29.2+ or podman-compose. Docker and podman can generally be used interchangeably, although **please note that for Mac users, using Docker compose instead of Podman compose is generally advised to avoid inexplicable set-up errors.**
42
72
43
-
The ANMS UI capability has been tested on Firefox version 96.0.1.
73
+
The ANMS UI capability has been tested on Firefox version 96.0.1.
44
74
There is no capability that should preclude operation on other modern browsers.
45
75
46
76
### Network Setup
47
77
48
78
If your computer is behind a network proxy, this may cause issues related to using self-signed certificates when pulling dependencies to build Docker images.
49
-
Though ANMS can be run behind a proxy; building the ANMS Docker images from behind a network proxy may result in errors.
79
+
Though ANMS can be run behind a proxy, building the ANMS Docker images from behind a network proxy may result in errors.
50
80
51
-
The first steps in each of the container image `Dockerfile` is to attempt to download an APLNIS root CA to validate the APLNIS HTTPS proxy.
52
-
When building images outside of the APLNIS, this download will gracefully fail and the image will not be able to run within the APLNIS. The URL for this certificate can be changed for users requiring equivalent functionality on their own networks.
81
+
The first steps in each of the container image `Dockerfile` is to attempt to download the appropriate root CA to validate your HTTPS proxy.
82
+
When building images outside of the internal network, it is possible that this download will gracefully fail and the image will not be able to run within the internal network. The URL for this certificate can be changed for users requiring equivalent functionality on their own networks.
53
83
54
84
### Special Notes on Podman
55
85
@@ -62,7 +92,7 @@ Note: If running on a system where **SELinux** is enabled, the system will not s
62
92
63
93
### Upgrading ANMS
64
94
65
-
If upgrading from an earlier version, a few steps are necessary to clear out earlier state.
95
+
If upgrading from an earlier version, a few steps are necessary to clear out the earlier state.
66
96
The following command sequence uses standard Docker commands to stop all containers and remove all "dangling" images, networks, and volumes.
67
97
68
98
:warning: The last command in this sequence removes volumes, **which include DB state**.
@@ -83,12 +113,12 @@ The quickstart script will configure, pull, and start the ANMS system for the fi
83
113
84
114
NOTICE: By default, quick start will pull pre-built containers from the github registry (ghcr.io). To force a rebuild, run it as `FORCE_REBULD=y ./quickstart.sh`. See the script header for details.
85
115
86
-
To stop the system use `podman compose -f testenv-compose.yml -f docker-compose.yml down`.
116
+
To stop the system, use `podman compose -f testenv-compose.yml -f docker-compose.yml down`.
87
117
88
-
To start the system in the future use `podman compose -f testenv-compose.yml up` and `podman compose up`.
118
+
To start the system in the future, use `podman compose -f testenv-compose.yml up` and `podman compose up`.
89
119
90
120
## Manual Startup
91
-
Choose the appropriate docker, podman or podman-compose commands in the directions below as appropriate for your system.
121
+
Choose the appropriate docker, podman, or podman-compose commands in the directions below as appropriate for your system.
92
122
93
123
- Edit `.env` file as appropriately
94
124
- Select appropriate profile(s) as desired.
@@ -112,7 +142,7 @@ Choose the appropriate docker, podman or podman-compose commands in the directio
- Note: The docker format argument here enables suppoort for HEALTHCHECK. If omitted, the system will run but will be unable to report the health of the system. This flag does not appear necessary when using the no-dash version of compose.
115
-
- Build test environemnt images using one of the following:
145
+
- Build test environment images using one of the following:
0 commit comments