Search…
2.4.0 GA
SDK Installation
Configuration Examples
Release Notes
Test Automation Framework
Deploy using Docker Compose
TIP OpenWiFi 2.0 SDK
The docker-compose directory within the deploy repository contains all the relevant files for various modes of SDK.
Modes
The following two modes are currently supported by docker-compose:
- Deployments without a Load BalancerThis model contains single instances of SDK micro-services. Non-Load Balancer is suitable for scenarios where load given number of APs is below 10,000 or design for network availability is not required. A single local docker-compose deployment performance is listed here. Additionally this deployment includes options to use either self-signed certificates or user provided certificates:
- Deployments with a Load BalancerThis model is suitable for deployments where there is a need to scale performance and/or use Letsencrypt certificates for northbound service interactions. This deployment allows the user to scale up number of instances of micro-services to handle a larger load than listed here. The repository contains the instructions here:
The docker-compose yaml files are related as follows to the modes above:
- docker-compose.yml : manages Non-LB deployment with self-signed and own certificates
- docker-compose.lb.selfsigned.yml: manages LB deployment with self-signed certificates
- docker-compose.lb.letsencrypt.yml: manages LB deployment with Letencrypt certificates
Docker Compose Environment Variables
The deployments are managed using different environment files for docker-compose:
- .env : used for non LB deployments with either self-signed or own certificate deployments executed by docker-compose. For additional information please read this.
- .env.selfsigned: used for LB with self-signed deployments executed by alias docker-compose-lb-selfsigned. For additional information please read this.
- .env.letsencrypt: used for LB with letsencrypt deployments executed by alias docker-compose-lb-letsencrypt. For additional information please read this.
Volumes
The deployment creates local volumes to persist mostly application and database data. In addition to that several bind mounts are created:
docker-compose/certs/ directory used by multiple servicesdocker-compose/{microservice}_data/ directory used by each service for configuration and data. Where {microservice} is one of: owgw, owsec, owfms and owprov. Be aware that the deployment uses bind mounts on the host to mount certificate and configuration data for the micro services and therefore these files and directories will be owned by the user in the container.
Since the files are under version control, you may have to change the ownership to your user again before pulling changes.
Configuration Variables
Localizing the installation to the production environment is done through configuration information environment files per microservice. These files are: owgw.env, owgw-ui.env, owsec.env, owfms.env, owprov.env and owprov-ui.env.
These env files are used to generate runtime configuration (properties) file when no configuration is found in their respective {microservices}-data directory.
Ports
Exposed port dependencies by application are listed below:
127.0.0.1:80/443 tcp - OpenWiFi-uCentralGW-UI
127.0.0.1:8080/8443 tcp - OpenWiFi-Provisoning-UI
127.0.0.1:5912/tcp - rttys dev
127.0.0.1:5913/tcp - rttys user
0.0.0.0:15002/tcp - OpenWiFi-uCentralGW websocket
127.0.0.1:16002/tcp - OpenWiFi-uCentralGW REST API public
0.0.0.0:16003/tcp - OpenWiFi-uCentralGW fileupload
127.0.0.1:16102/tcp - OpenWiFi-uCentralGW alivecheck
127.0.0.1:16001/tcp - OpenWiFi-uCentralSec REST API public
127.0.0.1:16101/tcp - OpenWiFi-uCentralSec alivecheckBy default only the websocket and fileupload component of the OpenWiFi uCentralGW (Gateway) micro service are exposed on all interfaces. All other exposed services listen on localhost. You can change that according to your needs in the
ports sections ofdocker-compose/docker-compose.yml.Default Certificates
When cloning the repository, by default the southbound websocket certificate signed by TIP Root CA is provided for the *.wlan.local domain. Additionally a self-signed certificate for the northbound REST API is present. These enable creating a local deployment out of the box. Production deployments will replace both the southbound websocket and northbound API certificates.
The supplied certificates are valid for the
*.wlan.local domain.How to
- 1.First you'll have to install Docker Compose according to your platform specific instructions. After that clone the repository with
git clone https://github.com/Telecominfraproject/wlan-cloud-ucentral-deploy. - 2.The Docker Compose uCentral micro service configs use
openwifi.wlan.localas a hostname, so make sure you add an entry in your hosts file (or in your local DNS solution) which points to127.0.0.1or the IP of the host running the SDK. - 3.Switch to the Compose project directory with
cd docker-compose/. - 4.Default user is: [email protected] and password is: openwifi
- 1.Service enforces a password change on first login
- 5.Initialize the deployment with
docker-compose up -d. If your deployment was successfully created, you should see the following output withdocker-compose ps:
1
Name Command State Ports
2
---------------------------------------------------------------------------------------------------------------------------------------------------------------------
3
openwifi_kafka_1 /opt/bitnami/scripts/kafka ... Up 9092/tcp
4
openwifi_owfms_1 /docker-entrypoint.sh /ope ... Up 0.0.0.0:16004->16004/tcp,:::16004->16004/tcp, 0.0.0.0:16104->16104/tcp,:::16104->16104/tcp, 17004/tcp
5
openwifi_owgw-ui_1 /docker-entrypoint.sh ngin ... Up 0.0.0.0:443->443/tcp,:::443->443/tcp, 0.0.0.0:80->80/tcp,:::80->80/tcp
6
openwifi_owgw_1 /docker-entrypoint.sh /ope ... Up 0.0.0.0:15002->15002/tcp,:::15002->15002/tcp, 0.0.0.0:16002->16002/tcp,:::16002->16002/tcp,
7
0.0.0.0:16003->16003/tcp,:::16003->16003/tcp, 0.0.0.0:16102->16102/tcp,:::16102->16102/tcp, 17002/tcp
8
openwifi_owprov-ui_1 /docker-entrypoint.sh ngin ... Up 80/tcp, 0.0.0.0:8080->8080/tcp,:::8080->8080/tcp, 0.0.0.0:8443->8443/tcp,:::8443->8443/tcp
9
openwifi_owprov_1 /docker-entrypoint.sh /ope ... Up 0.0.0.0:16005->16005/tcp,:::16005->16005/tcp, 0.0.0.0:16105->16105/tcp,:::16105->16105/tcp, 17005/tcp
10
openwifi_owsec_1 /docker-entrypoint.sh /ope ... Up 0.0.0.0:16001->16001/tcp,:::16001->16001/tcp, 0.0.0.0:16101->16101/tcp,:::16101->16101/tcp, 17001/tcp
11
openwifi_rttys_1 /rttys/rttys Up 0.0.0.0:5912->5912/tcp,:::5912->5912/tcp, 0.0.0.0:5913->5913/tcp,:::5913->5913/tcp
Copied!
- 1.When the certificate for the REST API and other components is self-signed, accepting trust for the self-signed REST API certificate on your local machine is required. Add
certs/restapi-ca.pemto your trusted browser certificates or add certificate exceptions in your browser by visiting each of the following URLs (one per port) :https://openwifi.wlan.local:16001 and ports :16002 :16003 :16004 and :16005Using the browser, accept the self-signed SSL certificate warnings (make sure to visit both and add the exceptions). - 2.Connect to your AP via SSH and add a static hosts entry in
/etc/hostsforopenwifi.wlan.localwhich points to the address of the host the SDK deployment runs on. - 3.While staying in the SSH session, copy the content of
certs/restapi-ca.pemon your local machine to your clipboard and append it to the file/etc/ssl/cert.pemon the AP. This way your AP will also trust the self-signed certificate. This step is necessary for rtty features and only required when using self-signed test deployment. - 4.Navigate in a web browser to
https://openwifi.wlan.localto access the UI and login with default username and password. You will now be prompted to change this default password to something more secured.
- 1.To use the curl test scripts which are included in the micro service repositories make sure to set the following environment variables before issuing a request:
1
export UCENTRALSEC="openwifi.wlan.local:16001"
2
export FLAGS="-s --cacert <your-wlan-cloud-ucentral-deploy-location>/docker-compose/certs/restapi-ca.pem"
Copied!
Upgrading Compose Deployments
Stop the running containers with
docker-compose downCheck out the new branch by repeating Step 1 from How to above for the given release and
docker-compose up -d.Don’t forget to re-add the self-signed certificates to the containers with the provided script.
Also be aware that you may have to change back some file permissions. To obtain the most recent changes as the files are under version control, you may have to change the ownership to your user again before pulling changes.
Last modified 3mo ago