Closed davidjwbbc closed 1 year ago
Regarding /docs/README.md
I would like that we make a bit more clear how to execute the following:
Install both the 5GMS Application Server and Application Function.
(I would add links to the installation pages... perhaps trivial).
...
Start the Application Server.
(5g-ms-application-server ... let's add an example)
Start the Application Function.
(/install/bin/open5gs-msafd -c msaf.yaml ... let's add an example)
For number 1
This is an issue if older versions of the pip
build
and/or setuptools
Python modules are already installed on the system. Although the documentation isn't clear, it appears that the --upgrade
flag does not require that the module be already installed. When present will upgrade the specified modules if they already installed. Without the flag, if a module is already installed it is left at the current version instead of being updated. Therefore changing the current instructions to include the upgrade flag should fix some issues with pip, build and setuptools version mismatches.
For number 2
root
) then it would install the application on normal paths, not requiring an update to $PATH
.venv/bin/python3 -m pip install .
), then the command is installed in the venv bin directory and will be on the $PATH
if the venv enviroment has been activated (e.g. source venv/bin/activate
), or can be run directly from the bin directory, e.g.venv/bin/5gms-application-server
.$PATH
to include this directory. Alternatively the command can be run by specifying the full path, e.g. ~/.local/bin/5gms-application-server
.Another thing... At the AS we've got the examples under tests/examples At the AF they are under just /examples
Would it make sense to push the examples to another repo so they are just in one place and updated only once? e.g. at the rt-common-shared or at the rt-mbms-examples (repurposing the name to rt-examples, it's also weird that rt-mbms-examples contains flute but that's for another moment...)
Another thing... At the AS we've got the examples under tests/examples At the AF they are under just /examples
Would it make sense to push the examples to another repo so they are just in one place and updated only once? e.g. at the rt-common-shared or at the rt-mbms-examples (repurposing the name to rt-examples, it's also weird that rt-mbms-examples contains flute but that's for another moment...)
They were moved out of rt-common-shared because, although similar, the examples for the Application Server are different from the ones for the Application Function.
For the Application Server they are only needed if you are doing stand alone testing on the Application Server without the Application Function, which is why they are in tests/examples
near the m3 test client script.
For the Application Function they are example configurations and were put in examples
. Might be better renaming that directory to example-configurations
.
I got it. Once the AS is configured through AF you no longer need configurations (just left for testing). test/examples is fine For the AF examples is fine
After testing the latest development branch, @jordijoangimenez, has suggested a couple of improvements to the documentation:
python3 -m pip install --upgrade pip build setuptools
beforepython3 -m pip install .
$PATH
after having installed 5gms-application-server (as an unprivileged user).docs/README.md
how to "Install both the 5GMS Application Server and Application Function".