Errors/Issues with https://docs.starlingx.io/deploy_install_guides/upcoming/aio_duplex.html

[Greg Waines]

Brief Description
-----------------
Documenting issues with current docs.starlingx.io AIO-Duplex Deployment and Installation guide:
- wrsroot is still being used instead of sysadmin
- --networks option is no longer supported for 'system host-if-modify' ... replaced with additional command, 'system interface-network-assign ...'
- when configuring switch_type to ovs-dpdk, I believe you must assign a cpu core to vswitch function
     > e.g. system host-cpu-modify -f vswitch -p0 1 controller-0
- -d option is no longer supported for 'system host-if-modify' ... replaced with additional command, 'system interface-datanetwork-assign ...'
- after bringing up containerized openstack (e.g. system application-apply stx-openstack), but before verifying cluster endpoints or doing provider/tenant networking setup .... SSH user must set his environment such that CLI commands are directed to containerized openstack ... and not the underlying starlingx/kubernetes platform
e.g.
In a new shell ... WITHOUT sourcing /etc/platform/openrc,
do the following:

mkdir -p /etc/openstack
tee /etc/openstack/clouds.yaml << EOF
clouds:
  openstack_helm:
    region_name: RegionOne
    identity_api_version: 3
    endpoint_type: internalURL
    auth:
      username: 'admin'
      password: 'Li69nux*'
      project_name: 'admin'
      project_domain_name: 'default'
      user_domain_name: 'default'
      auth_url: 'http://keystone.openstack.svc.cluster.local/v3'
EOF

export OS_CLOUD=openstack_helm

THEN ... you can check cluster endpoints and do tenant networking setup.

Severity
--------
<Critical: System/Feature is not usable due to the defect>

Steps to Reproduce
------------------
NA

Expected Behavior
------------------
NA

Actual Behavior
----------------
NA

Reproducibility
---------------
NA

System Configuration
--------------------
Two node system

Branch/Pull Time/Commit
-----------------------
NA

Last Pass
---------
NA

Timestamp/Logs
--------------
NA

Test Activity
-------------
Evaluation

[Ghada Khalil (gkhalil)]

Marking as stx.2.0 gating based on Greg's recommendation. There are multiple issues with the AIO-DX install guide that need to be addressed before the release date.

[Abraham Arce (xe1gyq)]

Working on it...

[OpenStack Infra (hudson-openstack)]

Fix proposed to branch: master
Review: https://review.opendev.org/672192

[OpenStack Infra (hudson-openstack)]

Reviewed: https://review.opendev.org/672192
Committed: https://git.openstack.org/cgit/starlingx/docs/commit/?id=796e370cc878923e51f2fd340fcdf7c7ff5e14e1
Submitter: Zuul
Branch: master

commit 796e370cc878923e51f2fd340fcdf7c7ff5e14e1
Author: Abraham Arce <email address hidden>
Date: Mon Jul 22 19:52:15 2019 -0500

    Deploy Install Guides: AIO Duplex Errors / Issues

    To align AIO Duplex deployment and installation guide content,
    we are taking 2 sources of information:

    - [0] Launchpad 1836574
    - [1] StarlingX wiki changes

    These are the high level modifications:

    - URL updated.
    - Remove references to VirtualBox as our default virtual
      configuration in this guide is Libvirt/QEMU.
    - Sync up documentation:
      - Rename titles
      - Extend Local playbook information.
      - Replace ifconfig command with ip command to setup
        external connectivity.
      - System command to configure OAM for controller-0.
      - Section "Configure the vSwitch type".
      - Section "Configure data interfaces".
      - Additional comments under section
        "Test for Ceph cluster operation".
      - Additional comment under section
        "Stage application for deployment".
      - Add information to verify the cluster endpoints.
      - Replace neutron command with openstack network
        command.
      - Rework section "Configure the host's vSwitch type".
    - Make use of RST formatting directives (e.g. information):
      - Highlight configuration of NTP server and vSwitch type
        are only for Baremetal hardware.
    - Remove documentation:
      - Partition extension for cgts-vg, since it is a
        config_controller method only.
      - Enablement of primary Ceph backend, already done.
      - Providernetworking setup (pre-Stein).

    [0] https://bugs.launchpad.net/starlingx/+bug/1836574
    [1] https://wiki.openstack.org/w/index.php?title=StarlingX%2FContainers%2FInstallationOnAIODX&type=revision&diff=171081&oldid=169806

    Closes-Bug: 1836574
    Depends-On: https://review.opendev.org/#/c/672191/

    Change-Id: I8b0259b89a37b7da64ed5b232b958f7789ed94a8
    Co-authored-by: Fei Chao <email address hidden>
    Co-authored-by: Greg Waines <email address hidden>
    Signed-off-by: Abraham Arce <email address hidden>