- Apply changes from review 679509 (includes correct changes,
but applied to wrong version of the guide)
- Minor grammatical and formatting changes
- Added labels to bare metal standard guides for linking
Change-Id: Ia25eb15321e5099401db535630b8489a1303c91a
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
- Migrated reorged content from wiki
- Naming, title, and capitalization consistency, minor rewording in sections
- Set up includes to reuse common content across pages
- Introduction: remove 'openstack users' and 'kubernetes users'
- Consolidate term definition into Key concepts page
- Archive R1, move R2 to current releast, set up for R3
- Remove stub pages for duplicate content, or content deferred to R3
- Rework intro and contribute pages for better readability
- Split Key concepts into two pages: Terms and Deployment Options
- Pass for grammar, punctuation, licensing, etc.
- Pull streamlined intro content into R2 install guides (from prev version)
- Added R2 release note page
- Update links to projects/project names to remove the "stx-"
- Add instructions for creating a bootable USB
Story: 2006315
Task: 36046
Change-Id: I38656fd382d1d9cf2969812c548fb7b2dc9dd31e
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
The All-In-One Duplex Extended deployment option extends the capacity
of the All-In-One Duplex deployment by adding up to four compute nodes
to the deployment.
The extended deployment option provides a capacity growth path for
someone starting with an All-In-One Duplex deployment.
Amended to add in comments from Greg Waines.
Depends-On: https://review.opendev.org/#/c/674799/
Story: 2005009
Task: 29485
Change-Id: I131fe72f7e298d6841f66ff7a6ccd3d197d7d2b1
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
This manual is a combination of the existing common StarlingX
installation guide and the existing deployment guide for the
Dedicated Storage StarlingX configuration.
Ameded to add in Greg Waines comments.
Change-Id: If61b8c35ca8926fe9a7b7a7faee921488e69d119
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
AIO Duplex:
- Remove networks parameter from host-if-modify and add
interface-network-assign command.
Controller Storage
- Fix a typo in the commands to create the volume group for Nova for
computes.
- Remove acquiring Keystone administrative privileges after controller-0
has been unlocked.
- Change the name of the server XML definition.
Common
- In section "Configure the host's vSwitch type", the "attention"
message has been moved to the beggining of the section, to promptly
notify the user OVS-DPDK is not supported in a virtual environment.
- Let the user know via the application-upload command, the complete
name is required for the stx-openstack application tarball.
Change-Id: Id487171019482174cbd7febd37a5ee9c63e9b97a
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Add Ironic deployment for standard configuration under the
Deployment and Installation Guides.
Story: 2004795
Task: 28942
Change-Id: I211182910352c9c2a986d0b7a35f945b828062e1
Co-authored-by: Mingyuan Qi <mingyuan.qi@intel.com>
Co-authored-by: Greg Waines <greg.waines@windriver.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
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 <fchao@fiberhome.com>
Co-authored-by: Greg Waines <greg.waines@windriver.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
OpenDev is community-run tools and infrastructure services for collaboratively
developing open source software [0]. A new structure has been assigned
including the new named "tools" repository which hosts the scripts to build
an StarlingX ISO image.
[0] http://lists.starlingx.io/pipermail/starlingx-discuss/2018-November/001821.html
Change-Id: Ie326347d3f4a0016d1093fc05a2eba61f02a052e
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
To align AIO Simplex deployment and installation guide content,
we are taking 2 sources of information:
- [0] Launchpad 1836575
- [1] StarlingX wiki changes
These are the high level modifications:
- URLs 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.
- Setting Ceph pool replication before application
applied (duplicated).
- Providernetworking setup (pre-Stein).
[0] https://bugs.launchpad.net/starlingx/+bug/1836575
[1] https://wiki.openstack.org/w/index.php?title=StarlingX%2FContainers%2FInstallation&type=revision&diff=171080&oldid=169805
Closes-Bug: 1836575
Depends-On: https://review.opendev.org/#/c/672191/
Change-Id: If14dd9ba4e5d05a9e20ebecb04a3d5aec8cb7133
Co-authored-by: Fei Chao <fchao@fiberhome.com>
Co-authored-by: Greg Waines <greg.waines@windriver.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
This is the first draft concocted from the wiki and some
standard texts from the installation guides.
- Amended to handle review comments and undergo a
comprehensive writing scrub.
- Amended to settle down on the possible number of computes.
Greg says basically 10. Fixed a small typo XMS -> XML.
- Amended to fix the "XML" term.
- Also, added the "Setting up provider/tenant networking"
section. Finally, a really close scrup of all text.
- Amended to make some capitalization consistent.
- Amended to take care of some review comments from Greg Waines.
- Amended (June 27) for more review comments from Greg Waines.
- Amended July 8 to fix small typo
- Added review changes July 16.
Some of the following changes includes latest content added to the wiki [0]
Added section "NVMe drive as boot drive"
Added "attention" meesage to section "Set up the NTP server"
Changed sections:
- Bootstrap controller-0
- Configure the host's vSwitch type" based in Duplex review
https://review.opendev.org/#/c/672192/
- Adding Ceph OSDs to controllers
- Using sysinv to bring up and take down the containerized OpenStack
services
Added additional comments for sections:
- Configure the host's vSwitch type" based in Duplex review
Reference to these files based in review
https://review.opendev.org/#/c/672191/:
- uninstalling-deleting-openstack
- horizon-access
Depends-On: https://review.opendev.org/#/c/672191/
Change-Id: I6c04ecca42395d84c7f66b94f7551964840eb437
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
To align AIO Simplex and Duplex deployment and installation guide content,
we are moving common sections to separate files and including them as
external document fragments:
- Uninstalling Deleting OpenStack
- Bring down OpenStack Services
- Delete OpenStack application definition
- Horizon Access
- Platform Horizon
- Containerized OpenStack Horizon
Filename and section name were rename from
additional_setup_instructions
to
uninstalling_deleting_openstack
Change-Id: I2c73153f55ddfead75c76cac6a42bfed409b9343
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Removed old deploy_guides and installation_guide folders and leftover pages as
followup to consolidation of deployment and installation guides into
deploy_install_guides.
Change-Id: I5d1d0abb4e75ef8fadf439aa7b4572831d9e469e
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
- Updated links in index to use toctrees so that Sphinx can resolve URLs correctly.
- Moved docs linked from new Installation and Deployment Guides page into same
deploy_install_guides folder.
- Updated broken links resulting from file moves.
- Removed extra folders for consistency between versions.
- Updated a couple page titles to use new R2.0 version convention.
Change-Id: Ib57a79d27411e2818569e0ded87fa393dff10075
Signed-off-by: Kristal Dale <kristal.dale@intel.com>
* Amended to make punctuation consistent.
I have re-organized the main TOC so that the new
combined install/deploy manuals comes after the StarlingX
introduction. I have hidden (for now) the older install
and deploy manuals.
Finally, I have updated the landing pages for the install/
deploy guides and the operation guides to an agreed upon
format that separates out latest, upcoming, and archived
releases.
Change-Id: Ia18f0438152d6cb1fa7ae3e9712eb3df8f5a2862
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Use a working clone URL for the tools Git repository in the AIO
duplex install guide, matching the one used in the simplex guide.
Change-Id: Id98367dcec4e8f1a82bb76adb8f4cde6fa001764
I have modified the docs repo such that the landing pages
for original installation guides and deployment guides now
list the merged deploy_install_guides AIO-SX and AIO-DX
manuals instead of the older ones that are being replaced.
Links on the landing pages at this point for the original
controller_storage deployment guide and for the original
"blanket" installation manual still exist. The reason I
left the one for the "blanket" installation guide is because
if someone clicks on that, there exists further links to
deployment information (guides) at the bottom. Those links
have been modified to point to the AIO-SX and AIO-DX
deploy_install_guides. The link for the controller_storage
deployment manual still goes to the original.
Once we get remaining combo manuals merged, we can further
modify these landing pages to where we eventually do not
have any manuals in the installation guides and
deployment guides area.
Change-Id: I7b436226c307b9bc803cc14d48712fb92c39975a
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Add the initial content for the Deployment options doc. This content is
a mildly reformated version of the same concept from the Intro/concepts.rst
document. I have added a bit more guidance as to which option to select
and why it is important.
Change-Id: If02c70e62eaedbf8692d10cb89884d30f7e72d14
Story: 2005006
Signed-off-by: Bruce Jones <bruce.e.jones@intel.com>
Draft of the combined deployment and installation
instructions for the AIO-DX StarlingX configuration.
Applied review comments from Tee Ngo and Al Bailey.
Changed "tailf" to "tail -f" per Al Bailey review.
I placed new/updated information from the AIO-DX wiki that
was updated by Tee Ngo.
I addressed Bart Wensley and Bob Churches comments.
* Leaving section on "Set Ceph pool replication" for now.
* Removed section on "Providernetworking setup (pre-Stein).
* Removed the note in the "Providernetworking setup:
Network Segment Ranges (Stein)" section.
* Removed the "Bring Down Services" section.
Patch 13: Removed the "Set Ceph pool replication" section.
Also, removed "Stein" per Al Bailey.
Change-Id: I196b2a309257b4fa8b8cceb079bbaadcd97a9257
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
I replaced the configuration process that used config_controller
with the Ansible bootstrap playbook method.
Change-Id: I978194eb45428258c940f38281962856bda2cb64
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
Signed-off-by: Abraham Arce <abraham.arce.moreno@intel.com>
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
This change is the first round of new documents and cleanup of
the "StarlingX" Introduction section of the documentation.
* Created a new "Product Introduction" document.
* Added a new "Consuming StarlingX" document.
* Added a new "Key Concepts" document.
* And cleaned up some of the other document names to make them
fit in the TOC text box.
Story: 2005002
Change-Id: Ibe2023028c749a18fd83e610519350cf9058127d
Signed-off-by: Bruce Jones <bruce.e.jones@intel.com>
The repo has been renamed to "tools". I have removed all
occurrences of "stx-tools". This addresses one of Erich
Cordoba's review comments.
Change-Id: Ia613a72b6438d4944feab2d5f6880e9f62198b7d
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
First draft of the combined deployment and installation
instructions for the AIO-SX StarlingX configuration.
Change-Id: Ib5bb6753aa1ed384c87e44b3c4d88945f2ed187a
Signed-off-by: Scott Rifenbark <srifenbark@gmail.com>
