X-Git-Url: https://gerrit.o-ran-sc.org/r/gitweb?a=blobdiff_plain;f=docs%2Finstallation-guide.rst;h=6e76a5973caf43ea3b7e5765c68762003cd12d01;hb=4774a0dcbd593e34f6c9e653a460f7bf18327907;hp=30376bd7f17ed55898dc26109d8831c360c6dd49;hpb=4cf6f2dd4d105f5765756c035d72972da1cba396;p=pti%2Frtp.git diff --git a/docs/installation-guide.rst b/docs/installation-guide.rst index 30376bd..6e76a59 100644 --- a/docs/installation-guide.rst +++ b/docs/installation-guide.rst @@ -3,751 +3,76 @@ .. Copyright (C) 2019 Wind River Systems, Inc. -Installation Guide -================== +INF Installation Guide +====================== .. contents:: :depth: 3 :local: -Abstract --------- +Overview +******** -This document describes how to install O-RAN INF image, example configuration for better -real time performance, and example deployment of Kubernetes cluster and plugins. +O-RAN INF is a downstream project of `StarlingX`_, and use the same installation and deployment methods. -The audience of this document is assumed to have basic knowledge in Yocto/Open-Embedded Linux -and container technology. +Please see the detail of all the supported `Deployment Configurations`_. -Version history - -+--------------------+--------------------+--------------------+--------------------+ -| **Date** | **Ver.** | **Author** | **Comment** | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ -| 2019-11-02 | 1.0.0 | Jackie Huang | Initail version | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ -| 2020-06-03 | 2.0.0 (Bronze) | Xiaohua Zhang | Bronze version | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ -| | | | | -| | | | | -+--------------------+--------------------+--------------------+--------------------+ +Notes: For Yocto based image, only "All-in-one Simplex" and "All-in-one Duplex (up to 50 worker nodes)" are supported. +.. _`Deployment Configurations`: https://docs.starlingx.io/r/stx.7.0/deploy/index-deploy-da06a98b83b1.html Preface -------- - -Before starting the installation and deployment of O-RAN INF, you need to download the ISO image or build from source as described in developer-guide. - - -Hardware Requirements ---------------------- - -Following minimum hardware requirements must be met for installation of O-RAN INF image: - -+--------------------+----------------------------------------------------+ -| **HW Aspect** | **Requirement** | -| | | -+--------------------+----------------------------------------------------+ -| **# of servers** | 1 | -+--------------------+----------------------------------------------------+ -| **CPU** | 2 | -| | | -+--------------------+----------------------------------------------------+ -| **RAM** | 16G | -| | | -+--------------------+----------------------------------------------------+ -| **Disk** | 500G * 2 | -| | | -+--------------------+----------------------------------------------------+ -| **NICs** | 2 | -| | | -+--------------------+----------------------------------------------------+ - - - -Software Installation and Deployment ------------------------------------- - -1. Installation from the O-RAN INF ISO image -```````````````````````````````````````````` - -- Please see the README.md file for how to build the image. -- The Image is a live ISO image with CLI installer: inf-image-aio-installer-intel-corei7-64.iso - -1.1 Burn the image to the USB device -'''''''''''''''''''''''''''''''''''' - -- Assume the the usb device is /dev/sdX here - -:: - - $ sudo dd if=/path/to/inf-image-aio-installer-intel-corei7-64.iso of=/dev/sdX bs=1M - -1.2 Install the server -'''''''''''''''''''''' - -- Reboot the target from the USB device. - -- Select "Graphics console install" or "Serial console install" and press ENTER - -- Remove the USB device and press ENTER to reboot - - -2. Configuration and initialize the bootstrap -````````````````````````````````````````````` - -2.1 First Login -``````````````` -Example: - -:: - - ifconfig eno1 128.224.180.14/24 up - - ip route add default via 128.224.180.1 +******* - ping 8.8.8.8 +Before starting the installation and deployment of O-RAN INF, you need to download the released ISO image or build from source as described in developer-guide. -2.3 Login the server through SSH -```````````````````````````````` +The INF project supports Multi OS and the latest released images for each based OS can be dwonloaded in: + - CentOS 7: `inf-image-centos-all-x86-64.iso`_ + - Debian 11 (bullseye): `inf-image-debian-all-x86-64.iso`_ + - Yocto 2.7 (warrior): `inf-image-yocto-aio-x86-64.iso`_ -2.4 Prepare the localhost.yml for bootstrap -``````````````````````````````````````````` +.. _`inf-image-debian-all-x86-64.iso`: https://nexus.o-ran-sc.org/content/sites/images/org/o-ran-sc/pti/rtp/g-release/inf-image-debian-all-x86-64.iso +.. _`inf-image-centos-all-x86-64.iso`: https://nexus.o-ran-sc.org/content/sites/images/org/o-ran-sc/pti/rtp/g-release/inf-image-centos-all-x86-64.iso +.. _`inf-image-yocto-aio-x86-64.iso`: https://nexus.o-ran-sc.org/content/sites/images/org/o-ran-sc/pti/rtp/g-release/inf-image-yocto-aio-x86-64.iso -Example: - -:: - - system_mode: simplex - - external_oam_subnet: 128.224.180.0/24 - - external_oam_gateway_address: 128.224.180.1 - - external_oam_floating_address: 128.224.180.14 - - admin_username: admin - - admin_password: Wind123! - - ansible_become_pass: Wind123! - - docker_http_proxy: http://xxx.xxx.xxx.xxx:8080 - - docker_https_proxy: https://xxx.xxx.xxx.xxx:8080 - -2.5 Run the bootstrap -````````````````````` - -Use the following command: - -:: - - ansible-playbook /usr/share/ansible/stx-ansible/playbooks/bootstrap.yml -vvv - -After the bootstrap successfully finish, it will show as following: - -:: - - PLAY RECAP ****************************************************************************************************************************************** - localhost : ok=256 changed=135 unreachable=0 failed=0 skipped=220 rescued=0 ignored=0 - -2.6 Configure the OAM network -````````````````````````````` +Hardware Requirements +********************* -Example: +* For INF platform Hardware Requirements, refer to `System Hardware Requirements`_. +* For INF Openstack Hardware Requirements, refer to `Openstack Hardware Requirements`_. -:: +* And you can also refer to the `Verified Commercial Hardware`_. - controller-0:~$ source /etc/platform/openrc +.. _`System Hardware Requirements`: https://docs.starlingx.io/planning/kubernetes/starlingx-hardware-requirements.html +.. _`Verified Commercial Hardware`: https://docs.starlingx.io/planning/kubernetes/verified-commercial-hardware.html +.. _`Openstack Hardware Requirements`: https://docs.starlingx.io/planning/openstack/hardware-requirements.html - [sysadmin@controller-0 ~(keystone_admin)]$ OAM_IF=eno1 +Installation +************ - [sysadmin@controller-0 ~(keystone_admin)]$ system host-if-modify controller-0 $OAM_IF -c platform - - +-----------------+--------------------------------------+ - | Property | Value | - +-----------------+--------------------------------------+ - | ifname | eno1 | - +-----------------+--------------------------------------+ - | iftype | ethernet | - +-----------------+--------------------------------------+ - | ports | [u'eno1'] | - +-----------------+--------------------------------------+ - | imac | 3c:a8:2a:1d:31:d0 | - +-----------------+--------------------------------------+ - | imtu | 1500 | - +-----------------+--------------------------------------+ - | ifclass | platform | - +-----------------+--------------------------------------+ - | aemode | None | - +-----------------+--------------------------------------+ - | schedpolicy | None | - +-----------------+--------------------------------------+ - | txhashpolicy | None | - +-----------------+--------------------------------------+ - | uuid | 95a32d13-01fc-43d2-90ab-801970fb3859 | - +-----------------+--------------------------------------+ - | ihost_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-----------------+--------------------------------------+ - | vlan_id | None | - +-----------------+--------------------------------------+ - | uses | [] | - +-----------------+--------------------------------------+ - | used_by | [] | - +-----------------+--------------------------------------+ - | created_at | 2020-06-03T08:21:17.526303+00:00 | - +-----------------+--------------------------------------+ - | updated_at | 2020-06-03T10:02:54.682501+00:00 | - +-----------------+--------------------------------------+ - | sriov_numvfs | 0 | - +-----------------+--------------------------------------+ - | sriov_vf_driver | None | - +-----------------+--------------------------------------+ - | accelerated | [False] | - +-----------------+--------------------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system interface-network-assign controller-0 $OAM_IF oam - - +--------------+--------------------------------------+ - | Property | Value | - +--------------+--------------------------------------+ - | hostname | controller-0 | - +--------------+--------------------------------------+ - | uuid | 32592cc3-9d66-4961-a51e-23686da00290 | - +--------------+--------------------------------------+ - | ifname | eno1 | - +--------------+--------------------------------------+ - | network_name | oam | - +--------------+--------------------------------------+ - - - [sysadmin@controller-0 ~(keystone_admin)]$ - [sysadmin@controller-0 ~(keystone_admin)]$ system interface-network-list controller-0 - - +--------------+--------------------------------------+--------+--------------+ - | hostname | uuid | ifname | network_name | - +--------------+--------------------------------------+--------+--------------+ - | controller-0 | 2478f4c0-a7b4-4656-aa2a-97a0e8891955 | lo | mgmt | - +--------------+--------------------------------------+--------+--------------+ - | controller-0 | 32592cc3-9d66-4961-a51e-23686da00290 | eno1 | oam | - +--------------+--------------------------------------+--------+--------------+ - | controller-0 | 43721e4d-4f52-4b4b-bd02-0efa00ef2124 | lo | cluster-host | - +--------------+--------------------------------------+--------+--------------+ - -2.7 Configure the NTP server -```````````````````````````` - -Example: +Platform Installation +--------------------- -:: - - [sysadmin@controller-0 ~(keystone_admin)]$ - [sysadmin@controller-0 ~(keystone_admin)]$ system ntp-modify ntpservers=0.pool.ntp.org,1.pool.ntp.org - - +--------------+--------------------------------------+ - | Property | Value | - +--------------+--------------------------------------+ - | uuid | 8fbe5712-6ba0-4e61-b174-ed60f152f616 | - +--------------+--------------------------------------+ - | ntpservers | 0.pool.ntp.org,1.pool.ntp.org | - +--------------+--------------------------------------+ - | isystem_uuid | 802ee0be-3728-4df4-b9f7-1533c67fd960 | - +--------------+--------------------------------------+ - | created_at | 2020-06-03T08:19:47.812249+00:00 | - +--------------+--------------------------------------+ - | updated_at | None | - +--------------+--------------------------------------+ - -2.8 Configure the Storage by using the second hard drive as ceph backend -```````````````````````````````````````````````````````````````````````` +INF uses the same installation and deployment methods of StarlingX, please refer to `StarlingX Installation`_ for the detail installation steps. -Example: +.. _`StarlingX Installation`: https://docs.starlingx.io/r/stx.7.0/deploy_install_guides/index-install-e083ca818006.html -:: - [sysadmin@controller-0 ~(keystone_admin)]$ - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-disk-list controller-0 - - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - | uuid | device_no | device_ | device_ | size_ | available_ | rpm | serial_ | device_path | - | | de | num | type | gib | gib | | id | | - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - | 3884f906-cb9b-4052-bcb8-8be70e599b9f | /dev/sda | 2048 | HDD | 1117. | 868.759 | Undetermined | PDNLH0B | /dev/disk/by-path/pci-0000: | - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - | | | | | 782 | | | RH8W4QQ | 03:00.0-scsi-0:1:0:0 | - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - | | | | | | | | | | - | 4e6c4b16-11e6-40b7-a2ff-751b14b8f0e9 | /dev/sdb | 2064 | HDD | 1117. | 0.0 | Undetermined | PDNLH0B | /dev/disk/by-path/pci-0000: | - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - | | | | | 782 | | | RH8W4QQ | 03:00.0-scsi-0:1:0:1 | - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - | | | | | | | | | | - +--------------------------------------+-----------+---------+---------+-------+------------+--------------+---------+-----------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-disk-list controller-0 | awk '/\/dev\/sdb/{print $2}' | xargs -i system host-stor-add controller-0 {} - - +------------------+-------------------------------------------------------+ - | Property | Value | - +------------------+-------------------------------------------------------+ - | osdid | 0 | - +------------------+-------------------------------------------------------+ - | function | osd | - +------------------+-------------------------------------------------------+ - | state | configuring-on-unlock | - +------------------+-------------------------------------------------------+ - | journal_location | 71a9d508-06f6-4f5a-84f2-4723e70b1ecf | - +------------------+-------------------------------------------------------+ - | journal_size_gib | 1024 | - +------------------+-------------------------------------------------------+ - | journal_path | /dev/disk/by-path/pci-0000:03:00.0-scsi-0:1:0:1-part2 | - +------------------+-------------------------------------------------------+ - | journal_node | /dev/sdb2 | - +------------------+-------------------------------------------------------+ - | uuid | 71a9d508-06f6-4f5a-84f2-4723e70b1ecf | - +------------------+-------------------------------------------------------+ - | ihost_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +------------------+-------------------------------------------------------+ - | idisk_uuid | 4e6c4b16-11e6-40b7-a2ff-751b14b8f0e9 | - +------------------+-------------------------------------------------------+ - | tier_uuid | db6eabf9-9922-4d8e-9740-c0f9878e692d | - +------------------+-------------------------------------------------------+ - | tier_name | storage | - +------------------+-------------------------------------------------------+ - | created_at | 2020-06-03T10:03:55.645744+00:00 | - +------------------+-------------------------------------------------------+ - | updated_at | None | - +------------------+-------------------------------------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-stor-list controller-0 - - +--------------------------------------+----------+-------+-----------------------+--------------------------------------+-------------------------------------------------------+--------------+------------------+-----------+ - | uuid | function | osdid | state | idisk_uuid | journal_path | journal_node | journal_size_gib | tier_name | - +--------------------------------------+----------+-------+-----------------------+--------------------------------------+-------------------------------------------------------+--------------+------------------+-----------+ - | 71a9d508-06f6-4f5a-84f2-4723e70b1ecf | osd | 0 | configuring-on-unlock | 4e6c4b16-11e6-40b7-a2ff-751b14b8f0e9 | /dev/disk/by-path/pci-0000:03:00.0-scsi-0:1:0:1-part2 | /dev/sdb2 | 1 | storage | - +--------------------------------------+----------+-------+-----------------------+--------------------------------------+-------------------------------------------------------+--------------+------------------+-----------+ - -2.9 Configure the SR-IOV enabled network -```````````````````````````````````````` -It need : - - assign the label of SR-IOV - - change the CPU policy to static - - change the hugepage setting - - create the data network - - assign the SR-IOV interface to data network - -Example: +Applications Installation +------------------------- -:: +Here are the example applications installations: - [sysadmin@controller-0 ~(keystone_admin)]$ WORKER=controller-0 - - [sysadmin@controller-0 ~(keystone_admin)]$ - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-label-assign $WORKER sriovdp=enabled - - +-------------+--------------------------------------+ - | Property | Value | - +-------------+--------------------------------------+ - | uuid | 7101010d-1897-4cc8-8c87-7dffaebf848b | - +-------------+--------------------------------------+ - | host_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-------------+--------------------------------------+ - | label_key | sriovdp | - +-------------+--------------------------------------+ - | label_value | enabled | - +-------------+--------------------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-label-assign $WORKER kube-cpu-mgr-policy=static - - +-------------+--------------------------------------+ - | Property | Value | - +-------------+--------------------------------------+ - | uuid | 4936f32b-6939-4115-b643-846bd50e7738 | - +-------------+--------------------------------------+ - | host_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-------------+--------------------------------------+ - | label_key | kube-cpu-mgr-policy | - +-------------+--------------------------------------+ - | label_value | static | - +-------------+--------------------------------------+ - - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-memory-modify $WORKER -1G 7 0 - - +-------------------------------------+--------------------------------------+ - | Property | Value | - +-------------------------------------+--------------------------------------+ - | Memory: Usable Total (MiB) | 0 | - +-------------------------------------+--------------------------------------+ - | Platform (MiB) | 7000 | - +-------------------------------------+--------------------------------------+ - | Available (MiB) | 0 | - +-------------------------------------+--------------------------------------+ - | Huge Pages Configured | True | - +-------------------------------------+--------------------------------------+ - | vSwitch Huge Pages: Size (MiB) | 1024 | - +-------------------------------------+--------------------------------------+ - | Total | 0 | - +-------------------------------------+--------------------------------------+ - | Available | 0 | - +-------------------------------------+--------------------------------------+ - | Required | None | - +-------------------------------------+--------------------------------------+ - | Application Pages (4K): Total | None | - +-------------------------------------+--------------------------------------+ - | Application Huge Pages (2M): Total | 0 | - +-------------------------------------+--------------------------------------+ - | Available | 0 | - +-------------------------------------+--------------------------------------+ - | Application Huge Pages (1G): Total | 0 | - +-------------------------------------+--------------------------------------+ - | Total Pending | 7 | - +-------------------------------------+--------------------------------------+ - | Available | 0 | - +-------------------------------------+--------------------------------------+ - | uuid | 15702f44-2281-41f3-8c83-a1e9a300ad01 | - +-------------------------------------+--------------------------------------+ - | ihost_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-------------------------------------+--------------------------------------+ - | inode_uuid | d52648bc-dfa6-4214-afa3-5d2148ee4180 | - +-------------------------------------+--------------------------------------+ - | created_at | 2020-06-03T08:21:27.468357+00:00 | - +-------------------------------------+--------------------------------------+ - | updated_at | 2020-06-03T10:10:49.159080+00:00 | - +-------------------------------------+--------------------------------------+ - - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-memory-modify $WORKER -1G 7 1 - - +-------------------------------------+--------------------------------------+ - | Property | Value | - +-------------------------------------+--------------------------------------+ - | Memory: Usable Total (MiB) | 0 | - +-------------------------------------+--------------------------------------+ - | Platform (MiB) | 1000 | - +-------------------------------------+--------------------------------------+ - | Available (MiB) | 0 | - +-------------------------------------+--------------------------------------+ - | Huge Pages Configured | True | - +-------------------------------------+--------------------------------------+ - | vSwitch Huge Pages: Size (MiB) | 1024 | - +-------------------------------------+--------------------------------------+ - | Total | 0 | - +-------------------------------------+--------------------------------------+ - | Available | 0 | - +-------------------------------------+--------------------------------------+ - | Required | None | - +-------------------------------------+--------------------------------------+ - | Application Pages (4K): Total | None | - +-------------------------------------+--------------------------------------+ - | Application Huge Pages (2M): Total | 0 | - +-------------------------------------+--------------------------------------+ - | Available | 0 | - +-------------------------------------+--------------------------------------+ - | Application Huge Pages (1G): Total | 0 | - +-------------------------------------+--------------------------------------+ - | Total Pending | 7 | - +-------------------------------------+--------------------------------------+ - | Available | 0 | - +-------------------------------------+--------------------------------------+ - | uuid | 544580b9-0f2a-41a1-b4e3-90fdf5c8f7e0 | - +-------------------------------------+--------------------------------------+ - | ihost_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-------------------------------------+--------------------------------------+ - | inode_uuid | e02c3c41-03b7-4f49-8244-bca851fa2d2f | - +-------------------------------------+--------------------------------------+ - | created_at | 2020-06-03T08:21:27.566279+00:00 | - +-------------------------------------+--------------------------------------+ - | updated_at | 2020-06-03T10:10:49.220907+00:00 | - +-------------------------------------+--------------------------------------+ - - - [sysadmin@controller-0 ~(keystone_admin)]$ PHYSNET0='physnet0' - - [sysadmin@controller-0 ~(keystone_admin)]$ PHYSNET1='physnet1' - - [sysadmin@controller-0 ~(keystone_admin)]$ WORKER=controller-0 - - [sysadmin@controller-0 ~(keystone_admin)]$ - - [sysadmin@controller-0 ~(keystone_admin)]$ system datanetwork-add ${PHYSNET0} flat - - +--------------+--------------------------------------+ - | Property | Value | - +--------------+--------------------------------------+ - | id | 1 | - +--------------+--------------------------------------+ - | uuid | 0ffe0b0a-35ff-45b2-9a62-63a494d2d18b | - +--------------+--------------------------------------+ - | name | physnet0 | - +--------------+--------------------------------------+ - | network_type | flat | - +--------------+--------------------------------------+ - | mtu | 1500 | - +--------------+--------------------------------------+ - | description | None | - +--------------+--------------------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system datanetwork-add ${PHYSNET1} flat - - +--------------+--------------------------------------+ - | Property | Value | - +--------------+--------------------------------------+ - | id | 2 | - +--------------+--------------------------------------+ - | uuid | 899ca8ba-6800-4d62-aed4-3770878da738 | - +--------------+--------------------------------------+ - | name | physnet1 | - +--------------+--------------------------------------+ - | network_type | flat | - +--------------+--------------------------------------+ - | mtu | 1500 | - +--------------+--------------------------------------+ - | description | None | - +--------------+--------------------------------------+ - - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-port-list controller-0 - - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | uuid | name | type | pci address | device | processor | accelerated | device type | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | 7007dfb1-ea55-4355-9d27-3ed4c6696283 | eno1 | ethernet | 0000:02:00.0 | 0 | 0 | False | NetXtreme BCM5719 Gigabit Ethernet PCIe [1657] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | 51f62ecf-7897-43e3-beb8-46ae5550ef05 | eno2 | ethernet | 0000:02:00.1 | 0 | 0 | False | NetXtreme BCM5719 Gigabit Ethernet PCIe [1657] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | e987725e-ab45-4151-b53d-94ba21706eb4 | eno3 | ethernet | 0000:02:00.2 | 0 | 0 | False | NetXtreme BCM5719 Gigabit Ethernet PCIe [1657] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | f4a8115a-ca0b-4336-a634-2cad77c5a88c | eno4 | ethernet | 0000:02:00.3 | 0 | 0 | False | NetXtreme BCM5719 Gigabit Ethernet PCIe [1657] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | 88965882-c816-42e8-ba0e-d3ff6f9f553e | eno49 | ethernet | 0000:04:00.0 | 0 | 0 | False | OneConnect NIC (Skyhawk) [0720] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | 98e2cedc-9ef8-4ca0-b3e0-db3a2bd0273a | eno50 | ethernet | 0000:04:00.1 | 0 | 0 | False | OneConnect NIC (Skyhawk) [0720] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | e75d7aa6-7832-4ec4-9dd4-ea8300773fd8 | ens2f0 | ethernet | 0000:05:00.0 | 0 | 0 | True | 82599ES 10-Gigabit SFI/SFP+ Network Connection [10fb] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - | 8ac4ffca-4a61-4b47-8e17-171f2e6cea66 | ens2f1 | ethernet | 0000:05:00.1 | 0 | 0 | True | 82599ES 10-Gigabit SFI/SFP+ Network Connection [10fb] | - +--------------------------------------+--------+----------+--------------+--------+-----------+-------------+-------------------------------------------------------+ - - - [sysadmin@controller-0 ~(keystone_admin)]$ INTL_IF=ens2f0 - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-if-modify -m 1500 -n sriov0 -c pci-sriov -N 6 --vf-driver=vfio $WORKER $INTL_IF - - +-----------------+--------------------------------------+ - | Property | Value | - +-----------------+--------------------------------------+ - | ifname | sriov0 | - +-----------------+--------------------------------------+ - | iftype | ethernet | - +-----------------+--------------------------------------+ - | ports | [u'ens2f0'] | - +-----------------+--------------------------------------+ - | imac | 00:1b:21:b3:46:2c | - +-----------------+--------------------------------------+ - | imtu | 1500 | - +-----------------+--------------------------------------+ - | ifclass | pci-sriov | - +-----------------+--------------------------------------+ - | aemode | None | - +-----------------+--------------------------------------+ - | schedpolicy | None | - +-----------------+--------------------------------------+ - | txhashpolicy | None | - +-----------------+--------------------------------------+ - | uuid | 9450b1ae-d1a1-4ecb-811a-fa3cb1cdf362 | - +-----------------+--------------------------------------+ - | ihost_uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-----------------+--------------------------------------+ - | vlan_id | None | - +-----------------+--------------------------------------+ - | uses | [] | - +-----------------+--------------------------------------+ - | used_by | [] | - +-----------------+--------------------------------------+ - | created_at | 2020-06-03T12:34:11.633254+00:00 | - +-----------------+--------------------------------------+ - | updated_at | 2020-06-04T02:01:28.168127+00:00 | - +-----------------+--------------------------------------+ - | sriov_numvfs | 6 | - +-----------------+--------------------------------------+ - | sriov_vf_driver | vfio | - +-----------------+--------------------------------------+ - | accelerated | [True] | - +-----------------+--------------------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system interface-datanetwork-assign ${WORKER} sriov0 ${PHYSNET0} - - +------------------+--------------------------------------+ - | Property | Value | - +------------------+--------------------------------------+ - | hostname | controller-0 | - +------------------+--------------------------------------+ - | uuid | 1d35219d-3258-42e7-8f0e-41d865710d58 | - +------------------+--------------------------------------+ - | ifname | sriov0 | - +------------------+--------------------------------------+ - | datanetwork_name | physnet0 | - +------------------+--------------------------------------+ - - - - [sysadmin@controller-0 ~(keystone_admin)]$ INTL_IF=ens2f1 - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-if-modify -m 1500 -n sriov1 -c pci-sriov -N 6 --vf-driver=vfio $WORKER $INTL_IF - - +-----------------+--------------------------------------+ - | Property | Value | - +-----------------+--------------------------------------+ - | ifname | sriov1 | - +-----------------+--------------------------------------+ - | iftype | ethernet | - +-----------------+--------------------------------------+ - | ports | [u'ens2f1'] | - +-----------------+--------------------------------------+ - | imac | 00:1b:21:b3:46:2d | - +-----------------+--------------------------------------+ - | imtu | 1500 | - +-----------------+--------------------------------------+ - | ifclass | pci-sriov | - +-----------------+--------------------------------------+ - | aemode | None | - +-----------------+--------------------------------------+ - | schedpolicy | None | - +-----------------+--------------------------------------+ - | txhashpolicy | None | - +-----------------+--------------------------------------+ - | uuid | 13d5ee99-0399-4b6b-a359-0f96660afdc4 | - | ihost_uuid | 08c23843-afa4-4b80-a285-be126365276e | - | vlan_id | None | - | uses | [] | - | used_by | [] | - | created_at | 2020-06-03T12:34:12.072624+00:00 | - | updated_at | 2020-06-04T02:03:51.405322+00:00 | - | sriov_numvfs | 6 | - | sriov_vf_driver | vfio | - | accelerated | [True] | - +-----------------+--------------------------------------+ - - [sysadmin@controller-0 ~(keystone_admin)]$ system interface-datanetwork-assign ${WORKER} sriov1 ${PHYSNET1} - - +------------------+--------------------------------------+ - | Property | Value | - +------------------+--------------------------------------+ - | hostname | controller-0 | - +------------------+--------------------------------------+ - | uuid | a87c6a5f-0c53-4ebf-9a32-38366700426f | - +------------------+--------------------------------------+ - | ifname | sriov1 | - +------------------+--------------------------------------+ - | datanetwork_name | physnet1 | - +------------------+--------------------------------------+ - -2.10 Unlock the server -`````````````````````` +* `Install O-RAN O2`_ +* `Install FlexRAN`_ -Example: +.. _`Install O-RAN O2`: https://docs.starlingx.io/admintasks/kubernetes/oran-o2-application-b50a0c899e66.html +.. _`Install FlexRAN`: https://docs.starlingx.io/sample_apps/flexran/deploy-flexran-2203-on-starlingx-1d1b15ecb16f.html -:: - - [sysadmin@controller-0 ~(keystone_admin)]$ system host-unlock controller-0 - - +-----------------------+-------------------------------------------------+ - | Property | Value | - +-----------------------+-------------------------------------------------+ - | action | none | - +-----------------------+-------------------------------------------------+ - | administrative | locked | - +-----------------------+-------------------------------------------------+ - | availability | online | - +-----------------------+-------------------------------------------------+ - | bm_ip | None | - +-----------------------+-------------------------------------------------+ - | bm_type | none | - +-----------------------+-------------------------------------------------+ - | bm_username | None | - +-----------------------+-------------------------------------------------+ - | boot_device | /dev/disk/by-path/pci-0000:03:00.0-scsi-0:1:0:0 | - +-----------------------+-------------------------------------------------+ - | capabilities | {u'stor_function': u'monitor'} | - +-----------------------+-------------------------------------------------+ - | clock_synchronization | ntp | - +-----------------------+-------------------------------------------------+ - | config_applied | 3daf20c7-c032-4aa2-839d-93da92051bea | - +-----------------------+-------------------------------------------------+ - | config_status | Config out-of-date | - +-----------------------+-------------------------------------------------+ - | config_target | bdaf20c7-c032-4aa2-839d-93da92051bea | - +-----------------------+-------------------------------------------------+ - | console | tty0 | - +-----------------------+-------------------------------------------------+ - | created_at | 2020-06-03T08:20:59.372602+00:00 | - +-----------------------+-------------------------------------------------+ - | hostname | controller-0 | - +-----------------------+-------------------------------------------------+ - | id | 1 | - +-----------------------+-------------------------------------------------+ - | install_output | graphical | - +-----------------------+-------------------------------------------------+ - | install_state | None | - +-----------------------+-------------------------------------------------+ - | install_state_info | None | - +-----------------------+-------------------------------------------------+ - | inv_state | inventoried | - +-----------------------+-------------------------------------------------+ - | invprovision | provisioning | - +-----------------------+-------------------------------------------------+ - | location | {} | - +-----------------------+-------------------------------------------------+ - | mgmt_ip | 192.168.204.2 | - +-----------------------+-------------------------------------------------+ - | mgmt_mac | 00:00:00:00:00:00 | - +-----------------------+-------------------------------------------------+ - | operational | disabled | - +-----------------------+-------------------------------------------------+ - | personality | controller | - +-----------------------+-------------------------------------------------+ - | reserved | False | - +-----------------------+-------------------------------------------------+ - | rootfs_device | /dev/disk/by-path/pci-0000:03:00.0-scsi-0:1:0:0 | - +-----------------------+-------------------------------------------------+ - | serialid | None | - +-----------------------+-------------------------------------------------+ - | software_load | 19.12 | - +-----------------------+-------------------------------------------------+ - | subfunction_avail | online | - +-----------------------+-------------------------------------------------+ - | subfunction_oper | disabled | - +-----------------------+-------------------------------------------------+ - | subfunctions | controller,worker | - +-----------------------+-------------------------------------------------+ - | task | Unlocking | - +-----------------------+-------------------------------------------------+ - | tboot | false | - +-----------------------+-------------------------------------------------+ - | ttys_dcd | None | - +-----------------------+-------------------------------------------------+ - | updated_at | 2020-06-04T02:04:59.514854+00:00 | - +-----------------------+-------------------------------------------------+ - | uptime | 49475 | - +-----------------------+-------------------------------------------------+ - | uuid | 08c23843-afa4-4b80-a285-be126365276e | - +-----------------------+-------------------------------------------------+ - | vim_progress_status | None | - +-----------------------+-------------------------------------------------+ - - - - References ----------- +********** - `StarlingX`_ .. _`StarlingX`: https://docs.starlingx.io/ - \ No newline at end of file +