Tutorial - 5G MSd: Basic End-to-End Setup with 5G Network
This guide describes how to setup and configure the 5G-MAG Reference Tools to create an end to end setup consisting of the 5G Downlink Media Streaming components and a 5G Network based on Open5GS and srsRAN.
5G Network with COTS UE setup
For details please refer to the corresponding documentation
5G Media Streaming setup
Server-side Setup
Step 0: Using a local server (Skip if your content is hosted in the internet)
Step 0a: Install the express.js webserver
The express.js webserver acts as our CDN for unicast delivery. To install the webserver follow the instructions here.
Step 0b: Configure ffmpeg
First we configure the ffmpeg
output. Navigate to flute-ffmpeg/files
and open ffmpeg-hls.sh
. Change the following two lines and point them to the path of the local webserver installed previously. If there is no watchfolder/hls
folder on your webserver yet create that as well.
-hls_segment_filename /home/dsi/5gmag/simple-express-server/public/watchfolder/hls/stream_%v_data%02d.ts \
-var_stream_map "v:0,a:0" /home/dsi/5gmag/simple-express-server/public/watchfolder/hls/stream_%v.m3u8
Step 0c: Run ffmpeg and the express.js webserver
Navigate to flute-ffmpeg/files
and run sh ffmpeg-hls.sh
.
Step 0d: Start the express.js webserver
Run npm start
in simple-express-server
. Our files created by ffmpeg
are now hosted and available via unicast. Try to query the master manifest to check for the availability of the files:
curl http://192.168.11.1:3333/watchfolder/hls/manifest.m3u8
#EXTM3U
#EXT-X-VERSION:6
#EXT-X-STREAM-INF:BANDWIDTH=2305600,RESOLUTION=1280x720,CODECS="avc1.64001f,mp4a.40.2"
stream_0.m3u8
Step 1: Install the Application Function
For details please refer to the corresponding section in the basic end-to-end guide.
Step 2: Install the Application Server
For details please refer to the corresponding section in the basic end-to-end guide.
Step 3: Start the Application Server
For details please refer to the corresponding section in the basic end-to-end guide.
Step 4: Basic Configuration of the Application Function
Follow the basic configuration steps documented in the basic end-to-end guide.
Step 5: Start the Application Function
Follow the command documented in the basic end-to-end guide.
Step 6: Basic configuration of the Application Function
Follow the steps to create a content hosting configuration and a provisioning session using the msaf-configuration
tool.
Client-side Setup
As we are all set on the server-side now we can focus on the client side.
Step 1: Installation, Configuration and Running the 5GMSd Client
Please follow the instructions documented in the basic end-to-end guide setup guide.