blob: 23e58af125d25515b5d0cdce3f2d4fcbbc35a244 [file] [log] [blame]
Hung-Wei Chiu77c969e2020-10-23 18:13:07 +00001..
2 SPDX-FileCopyrightText: © 2020 Open Networking Foundation <support@opennetworking.org>
3 SPDX-License-Identifier: Apache-2.0
4
Woojoong Kim6bfbf8a2020-11-25 15:32:15 -08005================
Hung-Wei Chiu77c969e2020-10-23 18:13:07 +00006eNB Installation
7================
Woojoong Kim63484012020-11-11 17:20:55 -08008This section describes how to install and configure the Sercomm eNB
9which is the default eNB device for Aether/Pronto project.
10
Woojoong Kim6bfbf8a2020-11-25 15:32:15 -080011.. _enb-installation:
12
Woojoong Kim63484012020-11-11 17:20:55 -080013Preliminaries
14=============
15In order to install and configure the Sercomm eNB, we should prepare following device:
16
17* Laptop or PC
18* USB-Ethernet adapter or Ethernet port on Laptop/PC
19* CAT5/6/7 cable
20* Sercomm eNB
21* 1G-10G converter
22
23Also, we should know the below information:
24
25* MME IP address (10.168.0.6 by default)
26* TAC
27* Cell ID
28
29How to access the Sercomm eNB admin UI?
30=======================================
31The default Sercomm eNB has default configuration values which are not working within the Aether/Pronto edge.
32In order to configure the Sercomm eNB, we need to access the Sercomm eNB admin web UI.
33We can initially access the UI through the LAN port on the Sercomm eNB device.
34
35.. image:: images/enb-ser-1.jpg
36 :width: 1008
37 :height: 756
38 :alt: Sercomm eNB Port Panel
39
40The above figure depicts the Sercomm eNB port panel which has two Ethernet ports, one power port, and one GPS port.
41We should make a physical link between the laptop/PC and LAN port on the Sercomm eNB.
42In the above figure, the yellow cable should be connected to the laptop/PC.
43Once the physical link is established,
44the Ethernet interface on the laptop/PC should have an IP address in 11.11.11.0/24 subnet.
45The Sercomm eNB will automatically assign the IP address to the Ethernet interface on the laptop/PC,
46since the eNB is working as a DHCP server.
47Of course, the interface should be set to DHCP, not static.
48
49.. note::
50
51 If the Sercomm eNB does not assign the IP address on the laptop/PC's Ethernet interface, please double-check the physical link.
52 Or, it is possible to assign the static IP address on the laptop/PC's Ethernet interface. Aforementioned before, the IP address should be in 11.11.11.0/24 subnet.
53
54After the Ethernet interface on the laptop/PC has the IP address in 11.11.11.0/24 subnet,
55we can access the Sercomm eNB.
56We can open the Web browser (e.g., Chrome, Firefox, etc.), and go to `https://11.11.11.188`. Then, we can see the below login page on the Web browser.
57
58.. image:: images/enb-ser-2.png
59 :alt: Sercomm eNB UI login pae
60
61With the below credentials, we can log in the UI:
62
Zack Williams34c30e52020-11-16 10:55:00 -070063* ID: ``sc_femto``
64* Password: ``scHt3pp`` (or ``sc_femto``)
Woojoong Kim63484012020-11-11 17:20:55 -080065
66After log-in, we can see the state page.
67
68.. image:: images/enb-ser-3.png
69 :alt: Sercomm eNB UI state page
70
71Network configuration
72=====================
73We should then configure the IP address on the WAN port which will be connected to the Tofino switch.
74The network configuration page shows up when we click `NetWork set` button on the top menu bar.
75
76.. image:: images/enb-ser-4.png
77 :alt: Sercomm eNB UI network configuration page
78
79In this page, we should change four values in the `IP Address section`.
80
81* Connected type: Static IP
82* IP Address: 192.168.251.5
83* Network mask: 255.255.255.0
84* Gateway address: 192.168.251.1
85
86The IP address in this menu is the IP address for the WAN port.
Hung-Wei Chiu6ed79102021-08-24 14:27:26 -070087The Gateway address is the SD-Fabric IP address.
Woojoong Kim63484012020-11-11 17:20:55 -080088After pushing those values on the network configuration page, click the `Save` button at the bottom.
89
90.. note::
91 No need to touch any other parameters in this configuration page.
92
93LTE configuration
94=================
95Next, we should configure the LTE parameters.
96Click the `Manage` button on the top menu bar and then go to the `LTE Basic Setting` tab.
97
98.. image:: images/enb-ser-5.png
99 :alt: Sercomm eNB UI LTE configuration page
100
101In this page, we should change below parameters:
102
Woojoong Kim53081342020-11-19 11:17:05 -0800103* Carrier Number: `2`
104* Carrier Aggregation: `unchecked`
105* BandWidth: `20`
106* FrequencyBand: `48,48`
107* EARFCN: `55440,55640`
108* CellIdentity: `assigned Cell ID`
109* PCI: `100,101`
110* TxPower: `20`
111* Tunnel Type: `IPv4`
112* MME IP Address: `10.168.0.6`
113* TAC: `assigned TAC`
114* PLMNID: `315010`
115* Sync Source: `FREE_RUNNING`
116* Enable CWMP: `unchecked`
Woojoong Kim63484012020-11-11 17:20:55 -0800117
118Among those parameters, we should carefully set values to CellIdentity and TAC.
119Those parameters are the preliminaries which ONF OPs team will assign to each site.
120Likewise, after pushing those parameters, click the `Save` button at the bottom.
121
122Then, click `SAS Configuration` tab in the same page.
123
124.. image:: images/enb-ser-6.png
125 :alt: Sercomm eNB UI SAS configuration page
126
127In this page, we should change five values in the `Location Configuration` section as follows:
128
Woojoong Kim53081342020-11-19 11:17:05 -0800129* Location: `Indoor`
130* Location Source: `Manual`
131* Latitude: `0`
132* Longitude: `0`
133* Elevation: `-18000`
Woojoong Kim63484012020-11-11 17:20:55 -0800134
135Do not forget to click the save button at the bottom after pushing values.
136
137Last, click `FAPService` menu at the top menu bar and go to `FAPControl` tab.
138
139.. image:: images/enb-ser-7.png
140 :alt: Sercomm eNB UI FAP Control page
141
142In this page, we have to check a single radio box, `AdminState` in the `FAPService_FAPControl_LTE` section.
143Then, click the `Save` button at the bottom.
144
145This is the all steps to configure the Sercomm eNB.
146
147Connect the Sercomm eNB to the fabric switch
148============================================
149After the above configuration, we should power off the Sercomm eNB and connect the eNB WAN port to the fabric switch.
150The Sercomm eNB is actually has 1G WAN port, although the fabric switch has 40G interfaces.
151Therefore, we should use the 1G-10G converter in which the 1G port is connected with the Sercomm eNB
152whereas the 10G port is connected to 10G-40G breakout cable linked to the fabric switch.
153
154.. note::
155 Alternatively, we can use an any 1G/10G switch, if we do not have a 1G-10G converter.
156
157Then, power on the Sercomm eNB device and get rid of the LAN port cable.
158
159.. note::
Zack Williams34c30e52020-11-16 10:55:00 -0700160 Without the LAN port cable, we can access the Sercomm eNB admin UI through
161 `https://192.168.251.5` URL, if the laptop/PC is connected to the same
162 network via the fabric switch.
163
164 For our convenience, we can optionally add forwarding rules into the
165 firewall configuration on the management node to access the Sercomm eNB
166 admin UI from outside the network.
Woojoong Kim63484012020-11-11 17:20:55 -0800167
168Troubleshooting
169===============
170
171Connectivity check
172^^^^^^^^^^^^^^^^^^
173In order to check the connectivity, we can use the Sercomm eNB admin UI.
174Open the web browser and go to `https://192.168.251.5` and log in.
175Then, click the `Manage` menu and go to the `IP Diagnose` tab.
176
177.. image:: images/enb-ser-8.png
178 :alt: Sercomm eNB UI IP Diagnose page
179
180In this page, check the ping menu and write down the IP address `192.168.251.1` in the white box.
181Then, click the `Run` button.
182
183After a few seconds, we can see the ping results.
184If there is no results, the connectivity between the eNB and the fabric switch has a problem.
185Otherwise, the fabric switch is not up and running correctly.