starlingx/docs
Code Issues Proposed changes

Merge "Migrate ks-addon.cfg example for update-iso.sh to Debian (r8, dsr8)" into r/stx.8.0

Browse Source
This commit is contained in:
Zuul
2023-06-27 13:42:25 +00:00
committed by Gerrit Code Review
parent 1065dfcce4 05b62fd3e6
commit d608bc6b19
2 changed files with 65 additions and 33 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
doc/source/dist_cloud/kubernetes/installing-a-subcloud-without-redfish-platform-management-service.rst
View File

@@ -117,28 +117,32 @@ subcloud, the subcloud installation process has two phases:
The following example ``ks-addon.cfg`` file, used with the -a option, The following example ``ks-addon.cfg`` file, used with the -a option,
sets up an initial IP interface at boot time by defining a |VLAN| on sets up an initial IP interface at boot time by defining a |VLAN| on an
an Ethernet interface and has it use |DHCP| to request an IP address: Ethernet interface and has it use |DHCP| to request an IP address:
.. code-block:: none .. code-block:: none
#### start ks-addon.cfg #### start ks-addon.cfg
OAM_DEV=enp0s3 RAW_DEV=enp24s0f0
OAM_VLAN=1234 OAM_VLAN=103
cat << EOF > /etc/sysconfig/network-scripts/ifcfg-$OAM_DEV cat << EOF > ${IMAGE_ROOTFS}/etc/network/interfaces.d/ifcfg-${RAW_DEV}
DEVICE=$OAM_DEV iface ${RAW_DEV} inet manual
BOOTPROTO=none mtu 9000
ONBOOT=yes post-up echo 0 > /proc/sys/net/ipv6/conf/${RAW_DEV}/autoconf;\
LINKDELAY=20 echo 0 > /proc/sys/net/ipv6/conf/${RAW_DEV}/accept_ra;\
echo 0 > /proc/sys/net/ipv6/conf/${RAW_DEV}/accept_redirects
EOF EOF
cat << EOF > /etc/sysconfig/network-scripts/ifcfg-$OAM_DEV.$OAM_VLAN cat << EOF > ${IMAGE_ROOTFS}/etc/network/interfaces.d/ifcfg-vlan${OAM_VLAN}
DEVICE=$OAM_DEV.$OAM_VLAN iface vlan${OAM_VLAN} inet6 dhcp
BOOTPROTO=dhcp vlan-raw-device ${RAW_DEV}
ONBOOT=yes mtu 1500
VLAN=yes post-up /usr/sbin/ip link set dev vlan${OAM_VLAN} mtu 1500;\
LINKDELAY=20 echo 0 > /proc/sys/net/ipv6/conf/vlan${OAM_VLAN}/autoconf;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${OAM_VLAN}/accept_ra;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${OAM_VLAN}/accept_redirects
pre-up /sbin/modprobe -q 8021q
EOF EOF
#### end ks-addon.cfg #### end ks-addon.cfg

64
doc/source/shared/_includes/installation-prereqs.rest
View File

@@ -56,30 +56,58 @@ Before attempting to install |prod|, ensure that you have the following:
-t <menu timeout>: -t <menu timeout>:
Specify boot menu timeout, in seconds Specify boot menu timeout, in seconds
The following example ``ks-addon.cfg`` file, used with the ``-a`` option, sets up The following example ``ks-addon.cfg`` file, used with the ``-a`` option,
an initial IP interface at boot time by defining a VLAN on an Ethernet sets up an initial IP interface at boot time by defining a |VLAN| on an Ethernet
interface and has it use DHCP to request an IP address: interface with with ``static`` assigned |VLAN| addresses:
.. code-block:: .. code-block::
#### start ks-addon.cfg #### start ks-addon.cfg
OAM_DEV=enp0s3 RAW_DEV=enp24s0f0
OAM_VLAN=1234 OAM_VLAN=103
MGMT_VLAN=163
cat << EOF > ${IMAGE_ROOTFS}/etc/network/interfaces.d/auto
auto ${RAW_DEV} lo vlan${OAM_VLAN} vlan${MGMT_VLAN}
cat << EOF > /etc/sysconfig/network-scripts/ifcfg-$OAM_DEV
DEVICE=$OAM_DEV
BOOTPROTO=none
ONBOOT=yes
LINKDELAY=20
EOF EOF
cat << EOF > /etc/sysconfig/network-scripts/ifcfg-$OAM_DEV.$OAM_VLAN cat << EOF > ${IMAGE_ROOTFS}/etc/network/interfaces.d/ifcfg-${RAW_DEV}
DEVICE=$OAM_DEV.$OAM_VLAN iface ${RAW_DEV} inet manual
BOOTPROTO=dhcp mtu 9000
ONBOOT=yes post-up echo 0 > /proc/sys/net/ipv6/conf/${RAW_DEV}/autoconf;\
VLAN=yes echo 0 > /proc/sys/net/ipv6/conf/${RAW_DEV}/accept_ra;\
LINKDELAY=20 echo 0 > /proc/sys/net/ipv6/conf/${RAW_DEV}/accept_redirects
EOF EOF
cat << EOF > ${IMAGE_ROOTFS}/etc/network/interfaces.d/ifcfg-vlan${OAM_VLAN}
iface vlan${OAM_VLAN} inet6 static
vlan-raw-device ${RAW_DEV}
address <__address__>
netmask 64
gateway <__address__>
mtu 1500
post-up /usr/sbin/ip link set dev vlan${OAM_VLAN} mtu 1500;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${OAM_VLAN}/autoconf;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${OAM_VLAN}/accept_ra;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${OAM_VLAN}/accept_redirects
pre-up /sbin/modprobe -q 8021q
EOF
cat << EOF > ${IMAGE_ROOTFS}/etc/network/interfaces.d/ifcfg-vlan${MGMT_VLAN}
iface vlan${MGMT_VLAN} inet6 static
vlan-raw-device ${RAW_DEV}
address <__address__>
netmask 64
mtu 1500
post-up /usr/local/bin/tc_setup.sh vlan${MGMT_VLAN} mgmt 10000 > /dev/null;\
/usr/sbin/ip link set dev vlan${MGMT_VLAN} mtu 1500;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${MGMT_VLAN}/autoconf;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${MGMT_VLAN}/accept_ra;\
echo 0 > /proc/sys/net/ipv6/conf/vlan${MGMT_VLAN}/accept_redirects
pre-up /sbin/modprobe -q 8021q
EOF
#### end ks-addon.cfg #### end ks-addon.cfg
After updating the ISO image, create a bootable USB with the ISO or put the After updating the ISO image, create a bootable USB with the ISO or put the
@@ -128,8 +156,8 @@ Before attempting to install |prod|, ensure that you have the following:
- A record of the IP addresses allocated for the public interfaces for your - A record of the IP addresses allocated for the public interfaces for your
deployment \(that is IP addresses for the |OAM| Network and |SRIOV| Data deployment (that is IP addresses for the |OAM| Network and |SRIOV| Data
Networks\). Networks).
.. end-install-prereqs .. end-install-prereqs