-
Notifications
You must be signed in to change notification settings - Fork 592
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: Document magma_deb VM #13840
docs: Document magma_deb VM #13840
Conversation
Thanks for opening a PR! 💯
Howto
More infoPlease take a moment to read through the Magma project's
If this is your first Magma PR, also consider reading
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Formally sound.
docs/readmes/lte/s1ap_tests.md
Outdated
method by which magma is usually deployed. For everyday development, the `make` installation is | ||
recommended, while the debian installation is useful for testing packages before release. | ||
|
||
> **Warning**: These two VMs use the same network configuration, so only one of them should be |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
should
seems a bit too nonrestrictive here? Should this not be must not
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I changed "should" to "must" and reworded it slightly. Is it better now?
docs/readmes/lte/s1ap_tests.md
Outdated
Spin up and provision the gateway VM, then make and start its services: | ||
|
||
1. From `magma/lte/gateway` on the host machine: `vagrant up magma && vagrant ssh magma` | ||
1. Now in the gateway VM: `cd $MAGMA_ROOT/lte/gateway && make run` | ||
|
||
#### Debian installation | ||
|
||
Spin up the *magma_deb* VM. The services should start automatically: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
We might want to remove the should
here? That would sound more confident.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Done 🙂
f894a46
to
5602ccd
Compare
Spin up and provision the gateway VM, then make and start its services: | ||
|
||
1. From `magma/lte/gateway` on the host machine: `vagrant up magma && vagrant ssh magma` | ||
1. Now in the gateway VM: `cd $MAGMA_ROOT/lte/gateway && make run` | ||
|
||
#### Debian installation | ||
|
||
Spin up the *magma_deb* VM. The services start automatically: |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
~"During provisioning the latest magma gateway debian build from the magma artifactory is installed. This is, the deployed gateway might not match your local repository state."
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nice suggestion, thanks! I've added this as a warning.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
lgtm. one suggestion for additional information - feel free to ignore it, might be enough that this is documented in code.
Signed-off-by: Cameron Voisey <cameron.voisey@tngtech.com>
5602ccd
to
d08439c
Compare
Summary
Document how to run the integration tests versus the magma_deb VM.
Test Plan
cd $MAGMA_ROOT/docs && make precommit
passes locally.