Add the intersphinx Sphinx extension to enable seamless
linking from the charm-guide.
This is already enabled for the charm-guide - for seamless
linking from this guide (deploy-guide).
Change-Id: I36442bfc8ff9267786cce87b32dfff2348c30f57
Improve and streamline upgrade overview text.
In particular, move the topology information to the
upgrade-overview page.
Related-Bug: #1929091
Change-Id: If8bb494966915c34f50a23937f3b500ed99c7049
Add dedicated OpenStack upgrade migration path pages to
make it clearer for upgraders. Doing so also removes
non-relevant text from the general upgrade-issues page.
Add a redirect to account for the deleted placement
charm special procedure page.
Closes-Bug: #1970272
Change-Id: Ibd09e9e0d66a6f9e152f37c6ac675eed35c97bde
Remove the storage pages as they are being migrated
to the charm-guide.
Add HTML redirects (and tests) as a consequence.
Depends-On: I933916e1a77e108ec255289e562149240ba09470
Change-Id: I20ffd8b97cfdac37ce83dc9fab35be236999e1e5
Remove the Compute pages as they are being migrated
to the charm-guide.
Add HTML redirects (and tests) as a consequence.
Change-Id: Idf777582fcb902dcd1f603d04c8f872c579460ff
Improve formatting for an unordered list on the
OVN page.
This PR will also be used to generate an OpenStack
Yoga version of charm-deployment-guide.
Change-Id: I8f24579ad202129e76b05e84a6a3aee780517b6d
There is a broken link on the upgrade-charms page due
to upstream Juju doc changes.
This PR will also be used to generate an OpenStack
Yoga version of charm-deployment-guide.
Change-Id: Ibe1f8041c1e5a8175fb63d638cc81b0987ed6eba
Improve wording on the special charm procedures page
(it currently is at odds with channeled charms) and
streamline the reference back to the rest of the
upgrade pages.
Change-Id: I4f39e75fdda968a280f230283cf3ea41d7397c51
Now that the golden path tutorial has received
sufficient polish, this PR makes modifications to the
Deploy Guide accordingly.
* Point to the tutorial and remove the
install-openstack-bundle page.
* Reword, refactor, and deal with a link.
Change-Id: I90fd395c1a31d3e59f480a8dd0bb8fcf58915e83
Update the install instructions to Jammy Yoga.
Remove the worker-multiplier option for containerised
services as this leads to too many processes on highly
resourced machines. There is already a default maximum
number of four.
Instructions have been tested and verified. At the time
of writing:
* placement charm needed to be installed by force
* ntp charm was not available for Jammy
Change-Id: I7282604f416ac7bf3b3ebfb6b9cd5ed257847b66
Remove page 'app-masakari' as it is being migrated
to the charm-guide.
Add an HTML redirect (and test) as a consequence.
Depends-On: I23547bee5239b0f2075042c9b799d0c060bd3de2
Change-Id: Ia7dc6e2f12035e824310cabdaa93663a69ddeb30
Remove page 'app-trilio-vault' as it is being migrated
to the charm-guide.
Add an HTML redirect (and test) as a consequence.
Drive-by: Remove the convenience link stating that cloud
operations have moved. It has been there for one release.
Depends-On: I48df4c1ce1e41fd8625d1bb0891d52b3a098f911
Change-Id: Ie41a79fa8973c40319e5ac85cb871381e7d3a62a
This cycles validation work has changed the classification of the
feature as well as hardware and software requirements.
Change-Id: Ib7f5ed930623a777beca20728fa19e04d5306f76
Improve the instructions that cover the introduction of the
placement charm by mentioning that nova-compute payload
upgrade should follow nova-cloud-controller payload upgrade.
Correct the payload upgrade order on the openstack-upgrade
page by putting nova-compute after nova-cloud-controller.
The former was recently moved up due to minimise OVN control
plane downtime but the current fix is essential.
The upgrdae-charms page was likewise updated.
Closes-Bug: #1970266
Change-Id: Ic564bfd649bd8d3ba435577b7e7d2f472992a1c6
Add a special charm procedure that outlines how to
migrate non-channel charms to channel charms.
Depends-On: Ia3ebfad4a6aa43620cad188b07ec6fc7a29b71a7
Change-Id: Ia425ff2e3eb0227d4b942c8a9e1ae2b88fe32787
A deployment can be left with misleading messaging
in `juju status` output if the `prepare` sub-command
is invoked when an LTS upgrade candidate is not
available.
Change-Id: Iaabe4ab544b84b8fca6281bbd50cb1521d1032ee
The series upgrade guiding principle needs to change
the order of leader vs non-leader unit machines. This
corresponds to what is in the upgrade-series-openstack
page.
Edit the associated examples accordingly.
Remove a warning about a trusty:xenial upgrade scenario
as this is now considered obsolete.
Minor word refactor and improvements.
Change-Id: Ic3cb50e2afdcd80b2d7c9ab03cf63096e03ca2d0
An upgraded ceph-radosgw charm will cause breakage
for an existing product-streams endpoint. Manual
intervention is required.
Change-Id: I31ebeeee36c19b984cb571cef43b4c0bb4c56b98
Starting with OpenStack Wallaby explicit load balancer
user roles are required. Amend the Octavia page as a
consequence.
Closes-Bug: #1961198
Change-Id: I7e89c176e4bbafa6d0fd772025fcea4b777d00cf
There is an admonishment on the upgrade-openstack page
affecting Ocatavia that is better organised as an upgrade
issue.
Add a table of contents to the main body of the issues
page to allow for better navigation.
Change-Id: I51ffecfd76ace9a6f7589e1d7a072a996b38bd8e
Docs currently state that charms will only upgrade the
software packages that a charm is associated with.
Fix this. A charm will change a machine's apt sources
and any packages that can be upgraded for a co-located
service will also be upgraded.
Change-Id: Iecd0273ba976b1b5823cf8e9f272267b65dd8977
Introduce changes across all upgrade pages to
accomodate for charm channels.
Removed the method for determining charm revision
update candidate as there is no reasonable way to
do this with the legacy charm stream.
Drive-by: Remove unused file (enable-merge)
Depends-On: Ia3ebfad4a6aa43620cad188b07ec6fc7a29b71a7
Change-Id: I7ea4eae65cc55c3a7081a505dd9bad34852dc8c3
Correct a faulty comparison between the neutron-gateway
and ovn-chassis charms. The latter is a subordinate
charm. Bring up ovn-dedicated-chassis from the bottom
of the list.
Place nova-compute directly after ovn-central to
reduce OVN control plane downtime. Add an explanatory
admonishment.
Reflect all the above in both the upgrade-charms and
upgrade-openstack pages.
Due to the connection between this documentation and
internal testing, a comment will be added to an existing
zaza-openstack-tests ordering bug (GH #709) explaining
what was done here.
Drive-by: Implement a more efficient build invocation
by taking advantage of multi-core systems in
addition to only building changed files.
Related-Bug: #1960275
Change-Id: I18c65bfc333912a480e7942a06641fce3971834e
This page is being moved to the CG (charm-guide) as the
long-term vision of the CDG (deploy-guide) is to focus
solely on the deployment of Charmed OpenStack.
Redirects were put in place as a consequence.
This PR also aids in other doc efforts taking place in
the CG.
Drive-by: Repair a link on the index page that points
to the Ceph documentation.
Depends-On: Iae5cdfad42b6775a053a5de8d8e73def318d277d
Change-Id: I95ce35b577343864eadaffa2398047455dc4f868
This page is being moved to the CG (charm-guide) as the
long-term vision of the CDG (deploy-guide) is to focus
solely on the deployment of Charmed OpenStack.
Redirects were put in place as a consequence.
This PR also aids in other doc efforts taking place in
the CG.
Drive-by: Fix existing redirects (s/howto/admin)
Depends-On: Ib3d02d716bdad0bce52ed72b7528ad1ccb301bb3
Change-Id: Id61ea10b30cff0f10a09b32b66b693dd9b8ab6bb
Apply the contents of the upgrade-openstack page to
provide a full detailed example of an actual OpenStack
upgrade. The new page is called upgrade-openstack-example.
Drive-by: Fix link on the index page.
Change-Id: Ib3118f57e18d4d0a04534ebc1004e2c0fdbd0747
Improve the information on order lists for both charm and
payload upgrades.
Add the following charms to the charms order:
* manila-ganesha
* octavia
Add the following charm to the payload order:
* manila-ganesha
The manila-generic alpha charm was erroneously included
in both lists. Remove it.
Add a note to both pages stating that only stable charms
are currently considered.
On the charms page it is mentioned that the given order is
based on internal testing because it is also stated that
order is irrelevant. The sentence was dropped from the
payload page because the order is not irrelevant.
Closes-Bug: #1959632
Change-Id: I3a71c3ed1a1d5c0463db8ca3ec598cd53aedf3c7