Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 1 | .. |
| 2 | SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org> |
| 3 | SPDX-License-Identifier: Apache-2.0 |
| 4 | |
| 5 | =========================== |
| 6 | Connectivity Control Update |
| 7 | =========================== |
Hung-Wei Chiu | 6ed7910 | 2021-08-24 14:27:26 -0700 | [diff] [blame^] | 8 | At this point, Aether runtime and SD-Fabric should be ready. |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 9 | But in order to make Aether connectivity control to serve the new ACE, |
| 10 | we need to create another patch to `aether-pod-configs` repository and update `omec-control-plane`. |
| 11 | |
| 12 | .. attention:: |
| 13 | |
| 14 | Note that this step will be done via ROC in the future. |
| 15 | |
| 16 | Before you begin |
| 17 | ================ |
| 18 | Make sure you have the edge pod checklist ready. |
| 19 | Specifically, the following information is required in this section. |
| 20 | |
| 21 | * MCC |
| 22 | * MNC |
| 23 | * TAC |
| 24 | * Subscriber IMSI list |
| 25 | |
| 26 | Download aether-pod-configs repository |
| 27 | ====================================== |
| 28 | First, download the aether-pod-configs repository to your development machine. |
| 29 | |
| 30 | .. code-block:: shell |
| 31 | |
| 32 | $ cd $WORKDIR |
| 33 | $ git clone "ssh://[username]@gerrit.opencord.org:29418/aether-pod-configs" |
| 34 | |
Hyunsun Moon | a79c742 | 2020-11-18 04:52:56 -0800 | [diff] [blame] | 35 | Update OMEC control plane configs |
| 36 | ================================= |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 37 | Once you successfully download the `aether-pod-configs` repository to your local development machine |
| 38 | then move the directory to `aether-pod-configs/production/acc-gcp/app_values` |
| 39 | and edit `omec-control-plane.yml` file to add new user profile and subscribers for the new ACE. |
| 40 | |
| 41 | Here is an example of the patch https://gerrit.opencord.org/c/aether-pod-configs/+/21396. |
| 42 | Please change MCC, MNC, TAC and IMSI in the example accordingly to match the new ACE. |
| 43 | Also, change FQDN of the `pfcp-agent` service of the target ACE cluster as `user-plane` value |
| 44 | and `UE_DNS` address as `dns_primary` value. |
| 45 | |
| 46 | .. code-block:: diff |
| 47 | |
| 48 | $ cd $WORKDIR/aether-pod-configs/production/acc-gcp/app_values |
| 49 | $ vi omec-control-plane.yml |
| 50 | # Add the new ACE user profile and subscribers |
| 51 | |
| 52 | $ git diff |
| 53 | diff --git a/production/acc-gcp/app_values/omec-control-plane.yml b/production/acc-gcp/app_values/omec-control-plane.yml |
| 54 | index 24d19d9..0350fc1 100644 |
| 55 | --- a/production/acc-gcp/app_values/omec-control-plane.yml |
| 56 | +++ b/production/acc-gcp/app_values/omec-control-plane.yml |
| 57 | @@ -76,6 +76,17 @@ config: |
| 58 | - access-all |
| 59 | selected-apn-profile: "apn-internet-menlo" |
| 60 | selected-qos-profile: "qos-profile1" |
Hyunsun Moon | dc6b77b | 2020-11-19 10:55:03 -0800 | [diff] [blame] | 61 | + - selected-user-plane-profile: "test" |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 62 | + keys: |
| 63 | + serving-plmn: |
| 64 | + mcc: 315 |
| 65 | + mnc: 10 |
| 66 | + tac: 205 |
| 67 | + priority: 5 |
| 68 | + selected-access-profile: |
| 69 | + - access-all |
Hyunsun Moon | dc6b77b | 2020-11-19 10:55:03 -0800 | [diff] [blame] | 70 | + selected-apn-profile: "apn-internet-test" |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 71 | + selected-qos-profile: "qos-profile1" |
| 72 | user-plane-profiles: |
| 73 | onf-tucson: |
| 74 | user-plane: "upf.omec.svc.prd.tucson.aetherproject.net" |
| 75 | @@ -87,6 +98,8 @@ config: |
| 76 | user-plane: "upf.omec.svc.prd.intel.aetherproject.net" |
| 77 | menlo: |
| 78 | user-plane: "pfcp-agent.omec.svc.prd.menlo.aetherproject.net" |
Hyunsun Moon | dc6b77b | 2020-11-19 10:55:03 -0800 | [diff] [blame] | 79 | + test: |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 80 | + user-plane: "pfcp-agent.omec.svc.prd.new.aetherproject.net" |
| 81 | apn-profiles: |
| 82 | apn-internet-default: |
| 83 | apn-name: "internet" |
| 84 | @@ -120,6 +133,14 @@ config: |
| 85 | dns_primary: "10.59.128.11" |
| 86 | dns_secondary: "1.1.1.1" |
| 87 | mtu: 1460 |
Hyunsun Moon | dc6b77b | 2020-11-19 10:55:03 -0800 | [diff] [blame] | 88 | + apn-internet-test: |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 89 | + apn-name: "internet" |
| 90 | + usage: 1 |
| 91 | + network: "lbo" |
| 92 | + gx_enabled: true |
| 93 | + dns_primary: "10.54.128.11" |
| 94 | + dns_secondary: "1.1.1.1" |
| 95 | + mtu: 1460 |
| 96 | mme: |
| 97 | cfgFiles: |
| 98 | config.json: |
| 99 | @@ -206,6 +227,14 @@ config: |
| 100 | key: "ACB9E480B30DC12C6BDD26BE882D2940" |
| 101 | opc: "F5929B14A34AD906BC44D205242CD182" |
| 102 | sqn: 135 |
Hyunsun Moon | dc6b77b | 2020-11-19 10:55:03 -0800 | [diff] [blame] | 103 | + # test |
Hyunsun Moon | e461233 | 2020-11-23 22:04:13 -0800 | [diff] [blame] | 104 | + - imsiStart: "315010777712301" |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 105 | + msisdnStart: "9999234455" |
| 106 | + count: 30 |
| 107 | + apn: "internet" |
Hyunsun Moon | e461233 | 2020-11-23 22:04:13 -0800 | [diff] [blame] | 108 | + key: "000102030405060708090a0b0c0d0e0f" |
| 109 | + opc: "69d5c2eb2e2e624750541d3bbc692ba5" |
Hyunsun Moon | 6338f3a | 2020-11-01 00:29:23 -0700 | [diff] [blame] | 110 | + sqn: 135 |
| 111 | mmes: |
| 112 | - id: 1 |
| 113 | mme_identity: "mme.omec.svc.prd.acc.gcp.aetherproject.net" |
| 114 | |
| 115 | $ git add . |
| 116 | $ git commit -m “Update OMEC control plane for the new ACE” |
| 117 | $ git review |
| 118 | |
Hyunsun Moon | a79c742 | 2020-11-18 04:52:56 -0800 | [diff] [blame] | 119 | |
| 120 | Add subscribers to HSSDB |
| 121 | ======================== |
| 122 | Attach to one of the **cassandra-0** pod and run `hss-add-user.sh` script to add the subscribers. |
| 123 | |
| 124 | .. code-block:: shell |
| 125 | |
| 126 | $ kubectl exec -it cassandra-0 /bin/bash -n omec |
| 127 | # hss-add-user.sh arguments |
| 128 | # count=${1} |
| 129 | # imsi=${2} |
| 130 | # msisdn=${3} |
| 131 | # apn=${4} |
| 132 | # key=${5:-'000102030405060708090a0b0c0d0e0f'} |
| 133 | # opc=${6:-'69d5c2eb2e2e624750541d3bbc692ba5'} |
| 134 | # sqn=${7:-'135'} |
| 135 | # cassandra_ip=${8:-'localhost'} |
| 136 | # mmeidentity=${9:-'mme.omec.svc.prd.acc.gcp.aetherproject.net'} |
| 137 | # mmerealm=${10:-'omec.svc.prd.acc.gcp.aetherproject.net'} |
| 138 | |
Hyunsun Moon | e461233 | 2020-11-23 22:04:13 -0800 | [diff] [blame] | 139 | $ root@cassandra-0:/# ./hss-add-user.sh 10 315010777712301 9999234455 internet |