Make sure Maven 3 or greater and JDK 17 are installed on your system.

Please ensure, that the prerequisites are fulfilled. To run a QoD API locally, you have to follow these steps:

• Build
• Create Database
• Start QoD API

Build the project by running mvn clean package

The creation of a Redis-Database is only needed if you use another profile than 'local'. Otherwise, QoD API will use an in-memory H2-database.

If a profile is used different to 'local', the QoD API needs a Redis database to persist the session data. Therefore, you can use a local instance of Redis DB or start Redis from Docker container:

• start Redis from Docker container by running docker run --name qos-redis -p 6379:6379 -d redis
• local instance on Windows: https://github.com/zkteco-home/redis-windows
• local instance on Linux: https://redis.io/docs/getting-started/installation/install-redis-on-linux/

For information about how to configure the QoD API, please refer to the next section "Configuration".

Start the qod-api service from terminal or from an IDE or with docker

• from terminal:java --add-opens=java.base/java.net=ALL-UNNAMED -Dfile.encoding=UTF-8 -jar core\target\senf-core-<current version>.jar --spring.profiles.active=local
• from an IDE: Application can also be started directly from an IDE like IntelliJ, Eclipse, etc. by passing VM options in the "Run Configuration":
  • --add-opens=java.base/java.net=ALL-UNNAMED
  • --spring.profiles.active=local
• with docker:
  • docker build -t qod-api .
  • docker run -dp 9091:9091 -p 9092:9092 qod-api

With the 'local'-profile the application will automatically connect to an in-memory H2-database.

The configuration can be adapted here: core/src/main/resources/application.yml

The below table lists the environment variables that are used to configure the application properly. This reference implementation for the QoD API makes use of the AsSessionWithQoS API (https://www.3gpp.org/ftp/Specs/latest/Rel-17) which is usually made available as a part of a NEF/SCEF system. All variables in the below table starting with "SCEF" can be understood as NEF/SCEF.

The QoD reference implementation has been qualified against the following network service vendors:

We actively ask other Camara members to validate this implementation against their available backend network services and share the results with the community.

Contribution and feedback is always welcome. For information how to contribute, please refer to our Contribution Guideline

Copyright (c) 2022 Contributors | Deutsche Telekom AG to CAMARA a Series of LF Projects, LLC

All contributors / copyright owners license this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.