Skip to content

Telecominfraproject/wlan-cloud-owprov

Folders and files

NameName
Last commit message
Last commit date

Latest commit

984c8fa · May 27, 2024
Dec 1, 2022
Aug 17, 2021
Sep 12, 2023
Oct 4, 2022
Feb 22, 2023
Feb 20, 2024
May 27, 2024
Sep 12, 2023
Feb 21, 2023
Sep 29, 2021
Mar 19, 2024
Feb 21, 2024
Feb 23, 2023
Feb 22, 2023
Sep 27, 2021
Mar 19, 2024
Sep 30, 2021
Feb 6, 2022
Feb 27, 2023
Oct 3, 2021
Apr 5, 2022
Oct 3, 2021
Mar 1, 2024
May 11, 2023
Sep 28, 2022
May 11, 2023
Aug 17, 2021
Jan 28, 2022
Aug 17, 2021
Aug 18, 2022

Repository files navigation

OpenWiFi Provisioning Service (OWPROV)

What is it?

The OWPROV is a service for the TIP OpenWiFi CloudSDK (OWSDK). OWPROV manages groups of access points through the use of entities and vanues. OWPROV, like all other OWSDK microservices, is defined using an OpenAPI definition and uses the ucentral communication protocol to interact with Access Points. To use the OWPROV, you either need to build it or use the Docker version.

OpenAPI

You may get static page with OpenAPI docs generated from the definition on GitHub Page. Also, you may use Swagger UI with OpenAPI definition file raw link (i.e. latest version file) to get interactive docs page.

Building

To build the microservice from source, please follow the instructions in here

Docker

To use the CLoudSDK deployment please follow here

Root entity

It's UUID value is 0000-0000-0000. Its parent entity must be empty.

Entity

Creation rules

  • You must set the parent of an entity.
  • The only properties you may set at creation are:
    • name
    • description
    • notes
    • parent

Modification rules

You may modify the following fields in the POST

  • name
  • description
  • notes

Delete

  • Children must be empty

Inventory Tags

Creation rules

  • Entity must point to an existing non-root entity
  • If you associate a venue, it must exist.
  • You must use an existing device type. Device type cannot be empty.
  • Name, description, notes are allowed.

Modification rules

  • You can modify the device type to another valid one.

Venue

Creation rules

  • If you include an entity, the parent must bot be set
  • if you include a parent, the entity must not be set
  • You cannot have children upon creation.
  • You may include an array of devices UUIDs
  • Topology and design cannot be set

Expected directory layout

From the directory where your cloned source is, you will need to create the certs, logs, and uploads directories.

mkdir certs
mkdir certs/cas
mkdir logs
mkdir uploads

You should now have the following:

--+-- certs
  |   +--- cas
  +-- cmake
  +-- cmake-build
  +-- logs
  +-- src
  +-- test_scripts
  +-- openapi
  +-- uploads
  +-- owsec.properties

Certificate

The OWFMS uses a certificate to provide security for the REST API Certificate to secure the Northbound API.

The certs directory

For all deployments, you will need the following certs directory, populated with the proper files.

certs ---+--- restapi-ca.pem
         +--- restapi-cert.pem
         +--- restapi-key.pem

Firewall Considerations

Port Description Configurable
16004 Default port for REST API Access to the OWPROV yes

Environment variables

The following environment variables should be set from the root directory of the service. They tell the OWGW process where to find the configuration and the root directory.

export OWGW_ROOT=`pwd`
export OWGW_CONFIG=`pwd`

You can run the shell script set_env.sh from the microservice root.

OWPROV Service Configuration

The configuration is kept in a file called owprov.properties. To understand the content of this file, please look here

Kafka topics

Toe read more about Kafka, follow the document

Contributions

We need more contributors. Should you wish to contribute, please follow the contributions document.

Pull Requests

Please create a branch with the Jira addressing the issue you are fixing or the feature you are implementing. Create a pull-request from the branch into master.

Additional OWSDK Microservices

Here is a list of additional OWSDK microservices

Name Description Link OpenAPI
OWSEC Security Service here here
OWGW Controller Service here here
OWFMS Firmware Management Service here here
OWPROV Provisioning Service here here
OWANALYTICS Analytics Service here here
OWSUB Subscriber Service here here