Обновление документа: 2025.04.07
Данный документ предназначен для разработчиков и тестировщиков, работающих с программным обеспечением стека протоколов уровня L1-HighPHY/L2 базовой станции 5G. В нем содержится информация о требованиях к оборудованию, установке, настройке и запуске ПО, а также контактные данные для получения дополнительной информации.
Для функционирования ПО требуется использовать Linux CentOS version
7.8.2003, версия ядра Linux 3.10.0-1127.19.1.rt56.1116.el7.x86_64
По умолчанию из дистрибутива устанавливается обычное ядро. Чтобы получить необходимую версию ядра, требуется выполнить следующие команды:
sudo yum --enablerepo=extras install epel-release
sudo yum install -y wget atool
cd /tmp
wget
https://buildlogs.centos.org/c7.1804.u.x86_64/tuned/20180820184932/2.9.0-1.el7_5.2.x86_64/tuned-2.9.0-1.el7_5.2.noarch.rpm
sudo yum remove tuned
sudo rpm -i tuned-2.9.0-1.el7_5.2.noarch.rpm
wget
http://linuxsoft.cern.ch/cern/centos/7/rt/CentOS-RT.repo
wget
http://ftp.riken.jp/Linux/cern/slc58/x86_64/RPM-GPG-KEYs/RPM-GPG-KEY-cern
sudo cp CentOS-RT.repo /etc/yum.repos.d/CentOS-RT.repo
sudo cp RPM-GPG-KEY-cern
/etc/pki/rpm-gpg/RPM-GPG-KEY-cer
Чтобы получить необходимую версию ядра 7.8.2003(3.10.0-1127.19.1.rt56.1116.el7.x86_64), требуется выполнить следующие команды:
sudo yum install -y kernel-rt-3.10.0-1127.19.1.rt56.1116.el7.x86_64
sudo yum install -y kernel-rt-devel-3.10.0-1127.19.1.rt56.1116.el7.x86_64
После чего выполнить перезагрузку машины.
Для корректной работы ПО необходимо установить и настроить библиотеки
hugepages
.
Настройка страниц hugepages
производится путем
конфигурирования загрузчика операционной системы.
Для установки и настройки нужно выполнить следующие действия:
sudo yum -y install libhugetlbfs libhugetlbfs-utils
hugeadm --page-sizes-all
В результате должны получить следующий вывод:
2097152 (2Mb)
1073741824 (1Gb)
Проверить поддержку со стороны процессора 1G Hugepages:
cat /proc/cpuinfo | grep pdpe1gb | head -n 1
Далее необходимо заполнить конфигурационный файл
/etc/default/grub
следующим содержимым, а затем выполнить
grub2-mkconfig -o /boot/efi/EFI/centos/grub.cfg
, пример
приведён ниже:
GRUB_TIMEOUT=5
GRUB_DISTRIBUTOR="$(sed 's, release .*$,,g' /etc/system-release)"
GRUB_DEFAULT=saved
GRUB_DISABLE_SUBMENU=true
GRUB_TERMINAL_OUTPUT="console"
GRUB_CMDLINE_LINUX="crashkernel=auto spectre_v2=retpoline rd.lvm.lv=centos/root rd.lvm.lv=centos/swap rhgb quiet intel_iommu=on iommu=pt usbcore.autosuspend=-1 selinux=0 enforcing=0 nmi_watchdog=0 softlockup_panic=0 audit=0 intel_pstate=disable cgroup_memory=1 cgroup_enable=memory mce=off idle=poll hugepagesz=1G hugepages=50 hugepagesz=2M hugepages=20 default_hugepagesz=1G processor.max_cstate=1 intel_idle.max_cstate=0 isolcpus=1-14, rcu_nocbs=1-14 kthread_cpus=0,15 irqaffinity=0,15 nohz_full=1-14 skew_tick=1 nohz=on nosoftlockup"
GRUB_DISABLE_RECOVERY="true"
ВНИМАНИЕ! В строке выше необходимо указать достаточное количество ядер для параметров isolcpus, nohz_full, rcu_nocbs. Выше, в качестве примера указано 1-15 для 16 ядерного процессора. При использовании альтернативной конфигурации количество ядер выбирается в зависимости от конфигурации сервера.
По завершении настройки, нужно перезапустить машину.
После перезапуска выполнить команду:
hugeadm --pool-list
Вывод должен содержать следующее:
Size Minimum Current Maximum Default
1073741824 16 16 16 *
Для корректной работы функций ПО, необходимо выполнить следующие действия.
Отключить сервис firewalld
, выполнив следующие
команды:
sudo systemctl stop firewalld
sudo systemctl disable firewalld
sudo systemctl mask --now firewalld
Отключить сервис NetworkManager
, выполнив следующие
команды:
sudo systemctl stop NetworkManager
sudo systemctl disable NetworkManager
Отключить сервис irqbalance
, выполнив следующие команды:
sudo systemctl stop irqbalance
sudo systemctl disable irqbalance
l2_l1highphy.tar.gz
tar -xzvf l2_l1highphy.tar.gz
cd l2_l1highphy && ./install.sh .
Installation script complete successfully.
cd /usr/local/bin
sudo ./hardware_info /tmp/hwinfo.txt
/tmp
будет создан
текстовый файл с именем hwinfo.txt
приблизительно следующего содержания:
BOARD_SN=L1HF879019T
MACHINE_ID=88bbd12a7f484f03b6485a1a2d5e6d30
PRODUCT_SN=PC0WBQJ7
PRODUCT_UUID=467f59cc-2df6-11b2-a85c-a4b61e3a629e
hwinfo.txt
доверенным представителям
ООО «ИРТЕЯ», в ответ будет выслан файл лицензии
license.lic
.license.lic
в директорию
с /usr/local/du/bin
.user_name
(имя пользователя),user_password
(пароль
пользователя),host IP Address
(IP-адрес
распределенного модуля)sudo su
, используя
пароль, указанный в пункте 2.root
в консоли.ifconfig
,
например:
lspci | grep acc
Например:/usr/local/du/config/sys_config.txt
, изменив
параметры:
PCI_ADDR_FEC
– на PCI-адрес аппаратного
ускорителя FEC из п.5.MAC_ADDR_FH
- на MAC-адрес сетевого интерфейса из п.4.ETH_DEV_FH
– на имя сетевого интерфейса из п.4./usr/local/flexran/bin/nr5g/gnb/l1/phycfg_xran.xml
, изменив
параметр:
dpdkBasebandDevice
–на PCI-адрес аппаратного
ускорителя FEC из п.5, например:
/usr/local/flexran/bin/nr5g/gnb/l1/xrancfg_sub6.xml
, изменив
параметры:
PciBusAddoRu0Vf0
и
PciBusAddoRu0Vf1
– на PCI-адреса двух виртуальных
сетевых функций интерфейса, уточнив их предварительно, используя
команду:
lspci | grep Virtual
Пример вывода команды:
PciBusAddoRu0Vf0
— вторая виртуальная функция их
списка,PciBusAddoRu0Vf1
— первая виртуальная функция из
списка, например:
user_name
(имя пользователя),user_password
(пароль пользователя),host IP Address
(IP-адрес распределенного модуля)sudo su
, используя
пароль, указанный в пункте 2 выше.root
в консоли.
/usr/local/сu/config/
/usr/local/cu/config/
с помощью команды:
cd /usr/local/cu/config
netconf_du.xml
(/usr/local/du/config/netconf_du.xml
), изменив значения
параметров localIpAddress
и
remoteIpAddress
для интерфейсов F1 в сторону
распределенного модуля, секции F1C_EP
и EP_F1U
для Сontrol plane и User
plane каналов передачи данных соответственно:
sudo service gnb_du_cl_dpdk restart
После установки ПО L1-HighPHY/L2 не запускается автоматически (только после перезапуска системы).
Для изменения поведения можно воспользоваться скриптами настройки:
/usr/local/du/scripts/disable_auto_restart
/usr/local/du/scripts/enable_auto_restart
sudo systemctl start gnb_du_cl_dpdk
sudo systemctl stop gnb_du_cl_dpdk
sudo systemctl status gnb_du_cl_dpdk
Для просмотра логов ПО L2 используются следующие команды:
tail -f /var/log/5G-gNB/Console.log -n100
tail -f /var/log/5G-gNB/boot_log_du_YY_MM_DD_hh_mm_ss_part_0.log -n100
tail -f /usr/local/du/bin/du_YY_MM_DD_hh_mm_ss_part_0.log -n100
Для просмотра логов confD используются следующие команды:
tail -f /var/log/5G-gNB/confd_gnb_du_sub6_dpdk.log -n100
tail -f /var/log/5G-gNB/netconf_gnb_du_cl_dpdk.log -n100
Для просмотра логов ПО L1-HighPHY используются следующие команды:
tail -f /var/log/5G-gNB/console_flexran.log -n100
tail -f /var/log/5G-gNB/flexran_output.log -n100
tail -f /var/log/5G-gNB/flexran_startup.log -n100
ОБЩЕСТВО С ОГРАНИЧЕННОЙ ОТВЕТСТВЕННОСТЬЮ "ИРТЕЯ" | LIMITED LIABILITY COMPANY "IRTEYA" |
---|---|
115432, Г.МОСКВА, ВН.ТЕР.Г. МУНИЦИПАЛЬНЫЙ ОКРУГ ДАНИЛОВСКИЙ, ПР-КТ АНДРОПОВА, Д. 18, К. 9 | 18, ANDROPOV AVE, BLDG. 9, MOSCOW, MOSCOW, DANILOVSKY MUNICIPAL DISTRICT, 115432 |
ОГРН: 1217700118866 ИНН: 9725046231 КПП: 772501001 | OGRN: 1217700118866 INN/TAX ID: 9725046231 KPP: 772501001 |
Тел.: +7 (985) 76-85-888 | Tel.: +7 (985) 76-85-888 |
Эл. почта: zapros@irteya.ru | E-mail: zapros@irteya.ru |
Документация для скачивания, а также информация по продукту размещена на сайте: https://irteya.ru | Documents and product details are available on the site: https://irteya.ru |