diff --git a/doc/source/deploy_install_guides/r3_release/figures/starlingx-aio-controller-configuration.png b/doc/source/deploy_install_guides/r3_release/figures/starlingx-aio-controller-configuration.png new file mode 100755 index 000000000..6043edd5e Binary files /dev/null and b/doc/source/deploy_install_guides/r3_release/figures/starlingx-aio-controller-configuration.png differ diff --git a/doc/source/deploy_install_guides/r3_release/figures/starlingx-aio-serial-console.png b/doc/source/deploy_install_guides/r3_release/figures/starlingx-aio-serial-console.png new file mode 100755 index 000000000..b1db59269 Binary files /dev/null and b/doc/source/deploy_install_guides/r3_release/figures/starlingx-aio-serial-console.png differ diff --git a/doc/source/deploy_install_guides/r3_release/figures/starlingx-release3-ansible-bootstrap-simplex.png b/doc/source/deploy_install_guides/r3_release/figures/starlingx-release3-ansible-bootstrap-simplex.png new file mode 100755 index 000000000..bfbe6cf52 Binary files /dev/null and b/doc/source/deploy_install_guides/r3_release/figures/starlingx-release3-ansible-bootstrap-simplex.png differ diff --git a/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst b/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst index a0e7ca09c..184a5d25d 100644 --- a/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst +++ b/doc/source/deploy_install_guides/r3_release/virtual/aio_simplex_install_kubernetes.rst @@ -36,6 +36,17 @@ Make the following menu selections in the installer: #. First menu: Select 'All-in-one Controller Configuration' #. Second menu: Select 'Serial Console' +.. figure:: ../figures/starlingx-aio-controller-configuration.png + :alt: starlingx-controller-configuration + + *Figure 1: StarlingX Controller Configuration* + + +.. figure:: ../figures/starlingx-aio-serial-console.png + :alt: starlingx--serial-console + + *Figure 2: StarlingX Serial Console* + Wait for the non-interactive install of software to complete and for the server to reboot. This can take 5-10 minutes, depending on the performance of the host machine. @@ -68,6 +79,20 @@ On virtual controller-0: sudo ip link set up dev enp7s1 sudo ip route add default via $DEFAULT_OAM_GATEWAY dev enp7s1 + Check the configured network: + + :: + + localhost:~$ ifconfig + enp7s1: flags=4163 mtu 1500 + inet 10.10.10.3 netmask 255.255.255.0 broadcast 0.0.0.0 + inet6 fe80::5054:ff:feb6:10d6 prefixlen 64 scopeid 0x20 + ether 52:54:00:b6:10:d6 txqueuelen 1000 (Ethernet) + RX packets 10 bytes 1151 (1.1 KiB) + RX errors 0 dropped 0 overruns 0 frame 0 + TX packets 94 bytes 27958 (27.3 KiB) + TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 + #. Specify user configuration overrides for the Ansible bootstrap playbook. Ansible is used to bootstrap StarlingX on controller-0. Key files for Ansible @@ -121,7 +146,8 @@ On virtual controller-0: Refer to :doc:`/deploy_install_guides/r3_release/ansible_bootstrap_configs` for information on additional Ansible bootstrap configurations for advanced - Ansible bootstrap scenarios. + Ansible bootstrap scenarios, such as docker-proxies when deploying behind a + firewall, etc. #. Run the Ansible bootstrap playbook: @@ -132,6 +158,15 @@ On virtual controller-0: Wait for Ansible bootstrap playbook to complete. This can take 5-10 minutes, depending on the performance of the host machine. + The image below shows a typical successful run. + + .. figure:: ../figures/starlingx-release3-ansible-bootstrap-simplex.png + :alt: ansible bootstarp install screen + :width: 800 + + *Figure 3: StarlingX Ansible Bootstrap* + + ---------------------- Configure controller-0 ---------------------- @@ -144,6 +179,17 @@ On virtual controller-0: source /etc/platform/openrc +#. At this stage, you can see the controller status, it will be in the locked state. + + :: + + [sysadmin@localhost ~(keystone_admin)]$ system host-list + +----+--------------+-------------+----------------+-------------+--------------+ + | id | hostname | personality | administrative | operational | availability | + +----+--------------+-------------+----------------+-------------+--------------+ + | 1 | controller-0 | controller | locked | disabled | online | + +----+--------------+-------------+----------------+-------------+--------------+ + #. Configure the OAM interface of controller-0 and specify the attached network as "oam". Use the OAM port name, for example eth0, that is applicable to your deployment environment: @@ -279,8 +325,70 @@ Unlock virtual controller-0 to bring it into service: Controller-0 will reboot to apply configuration changes and come into service. This can take 5-10 minutes, depending on the performance of the host machine. +.. note:: + + Once the controller comes back up, check the status of controller-0. It should + now show "unlocked", "enabled", "available" and "provisioned". + +:: + + [sysadmin@controller-0 ~(keystone_admin)]$ system host-list + +----+--------------+-------------+----------------+-------------+--------------+ + | id | hostname | personality | administrative | operational | availability | + +----+--------------+-------------+----------------+-------------+--------------+ + | 1 | controller-0 | controller | unlocked | enabled | available | + +----+--------------+-------------+----------------+-------------+--------------+ + [sysadmin@controller-0 ~(keystone_admin)]$ + + =============================================== + [sysadmin@controller-0 ~(keystone_admin)]$ system host-show controller-0 + +-----------------------+------------------------------------------------------------ ----------+ + | Property | Value | + +-----------------------+------------------------------------------------------------ ----------+ + | action | none | + | administrative | unlocked | + | availability | available | + | bm_ip | None | + | bm_type | none | + | bm_username | None | + | boot_device | /dev/disk/by-path/pci-0000:00:1f.2-ata-1.0 | + | capabilities | {u'stor_function': u'monitor', u'Personality': u'Controller-Active'} | + | clock_synchronization | ntp | + | config_applied | 03e22d8b-1b1f-4c52-9500-96afad295d9a | + | config_status | None | + | config_target | 03e22d8b-1b1f-4c52-9500-96afad295d9a | + | console | ttyS0,115200 | + | created_at | 2020-03-09T12:34:34.866469+00:00 | + | hostname | controller-0 | + | id | 1 | + | install_output | text | + | install_state | None | + | install_state_info | None | + | inv_state | inventoried | + | invprovision | provisioned | + | location | {} | + | mgmt_ip | 192.168.204.2 | + | mgmt_mac | 00:00:00:00:00:00 | + | operational | enabled | + | personality | controller | + | reserved | False | + | rootfs_device | /dev/disk/by-path/pci-0000:00:1f.2-ata-1.0 | + | serialid | None | + | software_load | 19.12 | + | subfunction_avail | available | + | subfunction_oper | enabled | + | subfunctions | controller,worker | + | task | | + | tboot | false | + | ttys_dcd | None | + | updated_at | 2020-03-09T14:10:42.362846+00:00 | + | uptime | 991 | + | uuid | 66aa842e-84a2-4041-b93e-f0275cde8784 | + | vim_progress_status | services-enabled | + +-----------------------+------------------------------------------------------------ ----------+ + ---------- Next steps ---------- -.. include:: ../kubernetes_install_next.txt \ No newline at end of file +.. include:: ../kubernetes_install_next.txt