Release CommsNet package 1.8.21

Title

Status

Due

Scheduled

Context

Project

Category

Notes Saved

**COMPLETED 2026-06-01. CommsNet 1.8.21 (system v8.0) deployed in PRE (2026-05-26) and PROD (2026-06-01).**

HPSM change C77876 opened and closed. NCC START + COMPLETED emails sent. Requester informed for PRE and PROD.

Config changes: API monitor_collection_live added (Req 2238), MotoTRB UNDOF device categorization (Req 2239), HF UNMISS/Wau entry + wau.cred created.

---

**PRE deployment completed 2026-05-26. Change C77876 opened.**

## NCC Emails

### START (send before PROD deployment)

To: "NCC" [ncc@un.org](mailto:ncc@un.org); "UNGSC DT Orchestration" [ungsc-dtorchestration@un.org](mailto:ungsc-dtorchestration@un.org)
Cc: "UNGSC AOM DS" [ungsc-aom-ds@un.org](mailto:ungsc-aom-ds@un.org); "OICT Unite Aware Dev Team" [OICT-Unite-Aware-Dev-Team@un.org](mailto:OICT-Unite-Aware-Dev-Team@un.org)
Bcc: "Unite Service Desk" [servicedesk@un.org](mailto:servicedesk@un.org)
Subject: START: C77876 - #RLS UniteAware\_Package\_CommsNet\_1.8.21

Dear colleagues,

Please be informed that the change in subject is starting in production.
Disregard related alerts until completion.

Thank you and best regards,

***

### COMPLETED (send after PROD deployment)

To: "NCC" [ncc@un.org](mailto:ncc@un.org); "UNGSC DT Orchestration" [ungsc-dtorchestration@un.org](mailto:ungsc-dtorchestration@un.org)
Cc: "UNGSC AOM DS" [ungsc-aom-ds@un.org](mailto:ungsc-aom-ds@un.org); "OICT Unite Aware Dev Team" [OICT-Unite-Aware-Dev-Team@un.org](mailto:OICT-Unite-Aware-Dev-Team@un.org)
Bcc: "Unite Service Desk" [servicedesk@un.org](mailto:servicedesk@un.org)
Subject: COMPLETED: C77876 - #RLS UniteAware\_Package\_CommsNet\_1.8.21

Dear colleagues,

Please be informed that the change in subject has been successfully completed.
Please resume normal monitoring.

Thank you and best regards,

***

## Deployment Procedure - CommsNet 1.8.21 (System v8.0)

### Release: CommsNet package 1.8.21

| Req | Description |
| --- | ----------- |
| 2239 | UNDOF device categorization in MotoTRB |
| 2238 | Live crawler monitoring (CommsNetMonitorLive collection) |
| 2227 | GPS spoofing detection for UNDOF (MotoTRB) |
| 2255 | New API endpoint /user/[Mission] |

***

### PRE Deployment

**Verify URL:** https://pre-tracking.dfs.un.org/mcop/status

**1\. Stop all previous CommsNet containers**

```
docker rm -f $(docker ps -f name=commsnet -q)
```

**2\. Create metrics log dir**

```
mkdir -p /srv/logs
chmod 777 /srv/logs
```

**3\. Pull new images $PRE registry$**

```
docker pull crgsc.un.org/uniteaware/commsnet_pre/hf:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/fssaims:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/uhf:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/mototrb:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/notifications:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/nginx:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/api:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/apex:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/gpsg:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_pre/odbc:8.0;
```

**4\. API Crawler**

```
docker rm -f commsnet_api_8_0
```

Edit config:

```
vim /srv/commsnet-8.0/api/config.yaml
```

```
commsnet_api_config:
  isSSL : false
  monitor_collection: "CommsNetMonitor"
  monitor_collection_live: "CommsNetMonitorLive"
  deployment: "COMMSNET_PRE"
  jsonlog_dir: "/tmp/logs/apidev"
  openapi_root_path: "/mcop"
  mongodb_uri: 'mongodb://comms-d-api-01.global.un.org'
  mongodb_db : "CommsNet"
```

```
cd /srv/commsnet-8.0/
./start_container api
```

**5\. MotoTRB Crawler**

```
docker rm -f commsnet_mototrb_8_0
```

Edit config:

```
vim /srv/commsnet-8.0/mototrb/config.yaml
```

```

mission_mapping:

mission_name:

0: "UNTSO"

2: "UNIFIL"

3: "UNDOF"

4: "UNFICYP"

device_kind:

1: "BaseRadios"

2: "CarRadios"

3: "HandheldRadios"

4: "Sky"

UNDOF:

base_radios:

location:

1: "CF"

2: "CZ"

3: "ROD"

4: "HH"

5: "HB"

6: "HS"

7: "POS10"

8: "POS12"

9: "POS12A"

10: "POS16"

11: "POS17A"

12: "POS22"

13: "POS25"

14: "POS27"

15: "POS30"

16: "POS31"

17: "POS32"

18: "POS32A"

19: "POS37"

20: "POS60"

21: "POS62"

22: "POS68"

23: "POS69"

24: "POS80"

25: "POS80A"

26: "POS85"

27: "POS86"

28: "OP51"

29: "OP52"

30: "OP53"

31: "OP54"

32: "OP55"

33: "OP56"

34: "OP57"

35: "OP58"

36: "OP71"

37: "OP72"

38: "OP73"

39: "UMIC"

portable_radios:

displaygroup:

1: "Military"

2: "Military"

3:
"Civilian"

location:

11: "MSO"

12: "JOC"

13: "NEPCON"

14: "NMC"

15: "LOGBATT"

16: "UMIC"

17: "FIJIBAT"

18: "FRC"

19: "MP"

21: "Medical"

22: "Spare"

23: "Spare"

24: "Spare"

25: "Spare"

26: "Spare"

27: "Spare"

28: "Spare"

29: "Spare"

31: "A Side"

32: "B Side"

UNFICYP:

base_radios:

displaygroup:

0: "Reserve"

1: "Military"

2: "UNPOL"

3: "MFR"

4: "FMPU"

5: "UN FLT"

6: "Security"

7: "MS"

8: "Reserve"

9: "Reserve"

location:

0: "UNPA"

1: "Sector 1"

2: "Sector 2"

3: "Reserve"

4: "Sector 4"

5: "Reserve"

6: "Reserve"

7: "Reserve"

8: "Reserve"

9: "Reserve"

portable_radios:

displaygroup:

0: "Reserve"

1: "Military"

2: "UNPOL"

3: "MFR"

4: "FMPU"

5: "UN FLT"

6: "Security"

7: "MS"

8: "Agencies"

9: "Reserve"

location:

0: "UNPA"

1: "Sector 1"

2: "Sector 2"

4: "Sector 4"

mobile_radios: # based in the email
11 August 2022 from UNFICYP , no location info for mobile radios

displaygroup:

0: "HQJOC"

1: "Military Sector 1"

2: "Military Sector
2"

3: "Military Sector
4"

4: "Military Sector
4"

5: "MFR"

6: "FMPU"

7: "UNPOL"

8: "medical"
```

```
cd /srv/commsnet-8.0/
./start_container mototrb
```

**6\. HF Crawler**

Create wau.cred:

```
cp /srv/commsnet-8.0/hf/scripts/creds/bouar.cred /srv/commsnet-8.0/hf/scripts/creds/wau.cred
docker rm -f commsnet_hf_8_0
```

Edit config:

```
vim /srv/commsnet-8.0/hf/config.yaml
```

```
hf_directories:
  - sector : 'TEST_UNMISS'
    zone: 'Test'
    directory: 'unmiss'
    db_name: 'main.sqlite'
    share: '//10.155.215.11/RTS'
    id: 0
  - sector : 'UNMISS'
    zone: 'Wau'
    directory: 'wau'
    db_name: 'main.sqlite'
    share: '//10.155.23.192/db'
    id: 1
```

```
cd /srv/commsnet-8.0/
./start_container hf
```

**7\. Notifications Crawler**

```
docker rm -f commsnet_notifications_8_0
cd /srv/commsnet-8.0/
./start_container notifications
```

**8\. Verify**

```
curl https://pre-tracking.dfs.un.org/mcop/status
```

Expected: all modules return `"status": 200`. If any show error, check logs:

```
docker logs -f commsnet_api_8_0
docker logs -f commsnet_hf_8_0
docker logs -f commsnet_mototrb_8_0
```

***

### PROD Deployment

**Servers:** comms-p-api-01, comms-p-api-02 (repeat on both)
**Verify URL:** https://tracking.dfs.un.org/mcop/status
**HPSM ref:** C67981 - copy and update title to: #RLS UniteAware\_Package\_CommsNet\_1.8.21

**1\. Stop all previous CommsNet containers**

```
docker rm -f $(docker ps -f name=commsnet -q)
```

**2\. Pull new images $PROD registry$**

```
docker pull crgsc.un.org/uniteaware/commsnet_prod/fssaims:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/uhf:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/mototrb:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/notifications:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/nginx:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/api:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/apex:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/gpsg:8.0;\
docker pull crgsc.un.org/uniteaware/commsnet_prod/odbc:8.0;
```

**3\. API Crawler**

```
docker rm -f commsnet_api_8_0
```

Edit config:

```
vim /srv/commsnet-8.0/api/config.yaml
```

```
commsnet_api_config:
  isSSL : false
  monitor_collection: "CommsNetMonitor"
  monitor_collection_live: "CommsNetMonitorLive"
  deployment: "COMMSNET_PROD"
  jsonlog_dir: "/tmp/logs/apidev"
  openapi_root_path: "/mcop"
  mongodb_uri: 'mongodb://comms-d-api-01.global.un.org'
  mongodb_db : "CommsNet"
```

```
cd /srv/commsnet-8.0/
./start_container api
```

**4\. MotoTRB Crawler**

```
docker rm -f commsnet_mototrb_8_0
```

Edit config (same structure as PRE, verify UNDOF/UNFICYP sections present):

```
vim /srv/commsnet-8.0/mototrb/config.yaml
```

(Same config as PRE section above - update `mongodb_host` / `mongodb_uri` to PROD values if different)

```
cd /srv/commsnet-8.0/
./start_container mototrb
```

**5\. HF Crawler**

```
cp /srv/commsnet-8.0/hf/scripts/creds/bouar.cred /srv/commsnet-8.0/hf/scripts/creds/wau.cred
docker rm -f commsnet_hf_8_0
vim /srv/commsnet-8.0/hf/config.yaml
```

(Same hf\_directories config as PRE section above)

```
cd /srv/commsnet-8.0/
./start_container hf
```

**6\. Notifications Crawler**

```
docker rm -f commsnet_notifications_8_0
cd /srv/commsnet-8.0/
./start_container notifications
```

**7\. Verify**

```
curl https://tracking.dfs.un.org/mcop/status
```

***

### Rollback

```
docker rm -f $(docker ps -f name=commsnet -q)
docker start $(docker ps -a -f name=commsnet -qa --filter "status=exited")
```

***

### Post-deployment cleanup (only after confirming rollback not needed)

```
docker rm -f $(docker ps -a -f name=7_6_0 -q)
docker rm -f $(docker ps -a -f name=7_5_0 -q)
docker rm -f $(docker ps -a -f name=7_4_0 -q)
docker rm -f $(docker ps -a -f name=7_3_0 -q)
docker images -aq | xargs docker rmi
```

Supports Markdown: bold, italics, code, lists, links. Auto-saves.

AI Notes - managed by Claude

No AI notes yet.

📂 Activities for this Item

➕ Add Activity

Open Activities

No open activities.

Closed Activities

Service Requests / Work Orders

RFS-1-12945758736

Service Request

WO-RFS-1-12945758741

RFS-1-12945952459

Service Request

WO-RFS-1-12945952472

iNeed Text

Title

Description

CommsNet - Release CommsNet package 1.8.21
Assign to Carlos Rodrigo - AOM DS

Asset#

Defined per context on the Taxonomy page.

Normalized time tracking

Last 30 days

Logged: 0:00 · Normalized: 0:00

No normalized entries for this item yet.

Meeting Notes (Project / Context)

Select a meeting to preview details.

Templates

Change Title

Change Description

Change Steps

Template Notes

Communications

Label

Order

Subject

Email Body

Attachments

Commsnet_Deployment_v8.0(1.8.21).docx

58.9 KB · application/vnd.openxmlformats-officedocument.wordprocessingml.document · 2026-05-26 09:45

Download

CommsNet - Release Notes 1.8.21.pdf

411.4 KB · application/pdf · 2026-05-26 09:45

Preview Download