Hung-Wei Chiu | 77c969e | 2020-10-23 18:13:07 +0000 | [diff] [blame] | 1 | .. |
| 2 | SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org> |
| 3 | SPDX-License-Identifier: Apache-2.0 |
| 4 | |
Hung-Wei Chiu | 77c969e | 2020-10-23 18:13:07 +0000 | [diff] [blame] | 5 | eNB Installation |
| 6 | ================ |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 7 | |
| 8 | This section describes how to install and configure the Sercomm eNB which is |
| 9 | the default eNB device in Aether. |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 10 | |
Woojoong Kim | 6bfbf8a | 2020-11-25 15:32:15 -0800 | [diff] [blame] | 11 | .. _enb-installation: |
| 12 | |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 13 | Preliminaries |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 14 | ------------- |
| 15 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 16 | Prepare the following devices: |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 17 | |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 18 | * Sercomm eNB |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 19 | * GPS Antenna |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 20 | * 10GbE SFP+ to 1/10GbE copper media converter |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 21 | * PoE+ Injector |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 22 | * Workstation to remotely access and configure the eNB |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 23 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 24 | Collect the following information: |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 25 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 26 | * eNB IP address |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 27 | * MME IP address (10.168.0.6 by default for Aether Central) |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 28 | * TAC |
| 29 | * Cell ID |
| 30 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 31 | .. warning:: |
Charles Chan | eec8a26 | 2021-10-21 15:58:27 -0700 | [diff] [blame^] | 32 | ``Cell ID`` and ``TAC`` are critical parameters that need to be globally unique. |
| 33 | Please get the assigned value from OPs team. |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 34 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 35 | Connect the eNB |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 36 | --------------- |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 37 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 38 | The Sercomm eNB has two Ethernet ports (``WAN`` and ``LAN``), one power port, |
| 39 | and one GPS port. The ``WAN`` port support Power over Ethernet (PoE+). |
| 40 | |
| 41 | Connect a GPS Antenna to the eNB and place is in a location where it has |
| 42 | visibility to the open sky, such as a window or skylight. |
| 43 | |
| 44 | Connect the eNB to the fabric switch through a media converter and PoE+ |
| 45 | Injector to the ``WAN`` port of the eNB, then it will automatically get |
| 46 | pre-configured IP address using DHCP. |
| 47 | |
| 48 | Verify that you can access the web-based configuration(``https://<eNB IP>``) |
| 49 | from your workstation. If the eNB address is not directly reachable, use the |
| 50 | management server as a jump host - this can be done using ssh:: |
| 51 | |
| 52 | ssh user@jumphost -L 8443:<eNB IP>:443 |
| 53 | |
| 54 | then visiting ``https://localhost:8443`` |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 55 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 56 | The default credentials for the Sercomm eNB are: |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 57 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 58 | * Username: ``sc_femto`` |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 59 | * Password: ``scHt3pp`` (may also be ``sc_femto``) |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 60 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 61 | .. image:: images/enb-sercomm-home.png |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 62 | |
| 63 | LTE configuration |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 64 | ----------------- |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 65 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 66 | Go to **Manage > LTE Basic Settings** tab and change the parameters as shown below. |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 67 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 68 | Click ``Save`` at the bottom after making the changes. |
| 69 | |
| 70 | .. image:: images/enb-sercomm-lte.png |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 71 | :alt: Sercomm eNB UI LTE configuration page |
| 72 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 73 | * Carrier Number: ``2`` |
| 74 | * Carrier Aggregation: ``unchecked`` |
| 75 | * BandWidth: ``20`` |
| 76 | * FrequencyBand: ``48,48`` |
| 77 | * EARFCN: ``55440,55640`` |
| 78 | * CellIdentity: ``assigned Cell ID`` |
| 79 | * PCI: ``100,101`` |
| 80 | * TxPower: ``20`` |
| 81 | * Tunnel Type: ``IPv4`` |
| 82 | * MME IP Address: ``10.168.0.6`` |
| 83 | * TAC: ``assigned TAC`` |
| 84 | * PLMNID: ``315010`` |
| 85 | * Sync Source: ``FREE_RUNNING`` |
| 86 | * Enable CWMP: ``unchecked`` |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 87 | |
Charles Chan | eec8a26 | 2021-10-21 15:58:27 -0700 | [diff] [blame^] | 88 | .. note:: |
| 89 | E-UTRAN Cell Global Identifier (ECGI) should be used for the `CellIdentity` field |
| 90 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 91 | Other Settings |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 92 | -------------- |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 93 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 94 | Go to **TR098 > SysPara** tab and set ``fsminitd`` parameter setting to ``2``. |
| 95 | Click ``Modify`` button right next to the parameter value, and ``Save`` button at the bottom. |
| 96 | |
| 97 | .. image:: images/enb-sercomm-syspara.png |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 98 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 99 | Connect the Sercomm eNB to the Google SAS |
| 100 | ----------------------------------------- |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 101 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 102 | Configure the SAS parameters by going to the **Manage > SAS Configuration** |
| 103 | tab. Configure the following parameters: |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 104 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 105 | * Enable: checked |
| 106 | * Server URL: ``https://sas.goog/v1.2/`` |
| 107 | * UserContactInformation: ``aether`` |
| 108 | * FCCID: ``P27-SCE4255W`` (It can be find on the device) |
| 109 | * Category: ``A`` |
| 110 | * Measure Configuration: ``RECEIVED_POWER_WITHOUT_GRANT`` |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 111 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 112 | .. image:: images/enb-sercomm-sascfg.png |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 113 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 114 | Make a note of the eNB's GPS coordinates, as they are used later |
| 115 | |
| 116 | .. note:: |
| 117 | The Sercomm eNB multiplies the GPS coordinates by 1000000, and the height in |
| 118 | meters by 1000 in it's UI. |
| 119 | |
| 120 | Next, go to the **FAP > FAP_Security** section. This will list security |
| 121 | certificates installed on the eNB, and will provide both the device Serial |
| 122 | Number and the certificate subject. On the first line copy the ``Subject`` |
| 123 | field, which should have content similar to ``/C=TW/O=Sercomm/OU=WInnForum CBSD |
| 124 | Certificate/CN=P27-SCE4255W:2009CW5000019``. |
| 125 | |
| 126 | .. image:: images/enb-sercomm-fapsec.png |
| 127 | |
| 128 | For the SAS to trust the CBSD, it must receive signed CPI data specific to the |
| 129 | device. To create this data, duplicate the ``example.json`` as |
| 130 | ``DEVICE_SERIAL_NUMBER.json``, and update the content to match eNB's settings. |
| 131 | |
| 132 | The signing tool `cbrstools/cpisign.py |
| 133 | <https://gerrit.opencord.org/plugins/gitiles/cbrstools/+/refs/heads/master/cpisign.py>`_ |
| 134 | script will sign CPI data. |
| 135 | |
| 136 | This script requires a CBRS CPI key (``.p12`` format) and associated password |
| 137 | to be run - an example invocation:: |
| 138 | |
| 139 | $ python cpisign.py -k YOUR_CPI_KEY.p12 DEVICE_SERIAL_NUMBER.json |
| 140 | |
| 141 | It will prompt for your CPI key password when run, and will generate a signed |
| 142 | file in ``output/`` folder, named with the serial number. |
| 143 | |
| 144 | Next, go to the **FAPService > FAPControl** tab , and in the |
| 145 | **FAPService_FAPControl_LTE** section set these fields: |
| 146 | |
| 147 | * AdminState: checked |
| 148 | |
| 149 | In the **FAPService_FAPControl_LTE_X_000E8F_SAS** section, configure the |
| 150 | following information in fields: |
| 151 | |
| 152 | * CPIEnable: checked |
| 153 | * Enable: checked |
| 154 | * ManufacturerPrefixEnable: checked |
| 155 | * Server: <should have the SAS URL filled in> |
| 156 | * CPIId: <CPI_ID_from_certificate> |
| 157 | * CPIName: <CPI_name> |
| 158 | * HeightType: ``AGL`` |
| 159 | * CPISignatureData: <generated_output_from_python_script> |
| 160 | * Location: ``indoor`` |
| 161 | * AntennaAzimuth, AntennaDowntilt, AntennaGain, AntennaBeamwidth: same as |
| 162 | SERIAL_NUMBER.json |
| 163 | |
| 164 | * CertSubject: ``/C=TW/O=Sercomm/OU=WInnForum CBSD |
| 165 | Certificate/CN=P27-SCE4255W:2009CW50000...`` (from previous step) |
| 166 | |
| 167 | Then click ``Save``, and go to the power icon at top right and tell the eNB to restart. |
| 168 | |
| 169 | Once restarted, check the **State > Misc State** tab to verify that the device |
| 170 | is registered with SAS. |
| 171 | |
| 172 | .. image:: images/enb-sercomm-sasstatus.png |
| 173 | |
| 174 | Verify that the eNB is correctly registered on the SAS website. |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 175 | |
| 176 | Troubleshooting |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 177 | --------------- |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 178 | |
| 179 | Connectivity check |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 180 | """""""""""""""""" |
| 181 | |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 182 | In order to check the connectivity, we can use the Sercomm eNB admin UI. |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 183 | |
| 184 | Go to **Manage > IP Diagnose** tab |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 185 | |
Hyunsun Moon | cd0d42f | 2021-10-18 19:08:41 -0700 | [diff] [blame] | 186 | .. image:: images/enb-sercomm-ip-diagnose.png |
| 187 | :width: 800 |
Woojoong Kim | 6348401 | 2020-11-11 17:20:55 -0800 | [diff] [blame] | 188 | :alt: Sercomm eNB UI IP Diagnose page |
| 189 | |
Wei-Yu Chen | 91d90de | 2021-10-18 22:06:12 +0800 | [diff] [blame] | 190 | In this page, check the ``ping`` menu, put an IP address to test in the text |
| 191 | box, and click ``Run`` button. |
| 192 | |
| 193 | After a few seconds the ping results will be displayed. |
| 194 | |
| 195 | eNB SAS log shows failed state |
| 196 | """""""""""""""""""""""""""""" |
| 197 | |
| 198 | Usually this is because of a configuration mismatch between the eNB config and |
| 199 | CPI signature data. Check in **Manage > Log > sas.log** and look for |
| 200 | information returned by the SAS. |
| 201 | |
| 202 | eNB SAS log disappears |
| 203 | """""""""""""""""""""" |
| 204 | |
| 205 | When the eNB runs out of space due to log messages, the sas daemon will not |
| 206 | run. Clear the log by clicking ``ClearLog`` at the bottom of the log page. |
| 207 | |
| 208 | eNB SAS log shows errors |
| 209 | """""""""""""""""""""""" |
| 210 | |
| 211 | If the sas.log shows a message like ``failed to open file |
| 212 | /var/conf/sas/cpi.key`` there is likely something wrong with the configuration. |
| 213 | Check the following: |
| 214 | |
| 215 | * ``CPISignatureData`` field - data is larger than the field size, could be |
| 216 | entered twice. |
| 217 | |
| 218 | * Check that the location and other data that is signed by the CPI key matches |
| 219 | the data in the eNB UI. |