ironic/doc/source/install
Julia Kreger 1435a15ce3 Fix allocations default table type
In trying to figure out why I was unable to run
all of the test_migrations tests, I realized we need
to fix and clean up our unicode declarations.

Specifically, the way I found this was my local mysql
install was defaulted to using 4 Byte Unicode characters,
however some of our fields are 255 characters, which do not
fit inside of InnoDB tables.

They do, however fit with the "utf8" storage alias, which is
presently short for UTF8MB3, as opposed to UTF8MB4 which is
what my local database server was configured for. Because this
was in opportunistic tests, I wasn't able to really sort out
what was going on and thought we needed to shorten the fields.

In reality, it turns out we never defined the allocations
table to use UTF8 and Innodb for storage.

Storage engine wise, this is not a big deal, but may mean a
DBA will one day need to dump and reload the allocation table
of a deployment.

Character set wise... It is not great, but there is not a good
way for us to do this programatically. In my opinion, the chance
of an issue being encountered by an operator is unlikely, which
out weighs the risk and impact of dumping the entire table,
deleting the table, recreating the table with the updated schema
and then repopulating the entries. Of course, if operators are not
using allocations, then it really doesn't matter for them.

Along the way, I discovered we had used the "UTF8" type alias,
which may change one day, which would break Ironic. As such,
I've also updated the definitions used to create databases
and updated our documentation.

Recommended reading:
https://docs.sqlalchemy.org/en/14/dialects/mysql.html#unicode
https://dev.mysql.com/doc/refman/8.0/en/charset-unicode-utf8mb4.html

Story: 2010348
Task: 46492

Change-Id: I4103152489bf61e2d614eaa297da858f7b2112a3
2022-10-13 21:21:24 +00:00
..
include Fix allocations default table type 2022-10-13 21:21:24 +00:00
refarch Stop documenting netboot and the boot_option capability 2022-08-01 16:36:25 +02:00
standalone Add "none" RPC transport that disables the RPC bus 2021-12-07 09:33:04 +01:00
advanced.rst Stop documenting netboot and the boot_option capability 2022-08-01 16:36:25 +02:00
configdrive.rst Docs: replace nova cli calls with openstack 2022-06-16 11:41:44 +12:00
configure-cleaning.rst Delete unavailable py2 package 2021-05-10 09:47:52 +00:00
configure-compute.rst Delete unavailable py2 package 2021-05-10 09:47:52 +00:00
configure-glance-images.rst Docs: specify what to do with the created images 2022-06-24 18:58:49 +00:00
configure-glance-swift.rst docs: use openstackdocstheme extlink extension 2019-10-08 11:12:05 +02:00
configure-identity.rst Policy json to yaml migration 2021-01-04 13:40:54 -08:00
configure-integration.rst Doc - IPv6 Provisioning 2020-04-02 17:26:48 +02:00
configure-ipmi.rst Expand the IPMI documentation 2021-07-23 14:31:12 +02:00
configure-ipv6-networking.rst Deprecate [pxe]ip_version parameter 2021-06-28 06:59:34 -07:00
configure-networking.rst docs: use openstackdocstheme extlink extension 2019-10-08 11:12:05 +02:00
configure-nova-flavors.rst Update .rst files 2020-11-16 20:27:13 +13:00
configure-pxe.rst Deprecate syslinux 2022-07-13 06:50:55 -07:00
configure-tenant-networks.rst Delete unavailable py2 package 2021-05-10 09:47:52 +00:00
creating-images.rst Rework the user guide 2021-05-10 17:18:13 +02:00
deploy-ramdisk.rst devstack: use CentOS 9 for DIB IPA builds 2022-05-25 08:57:15 -07:00
enabling-drivers.rst Bye-bye iSCSI deploy, you served us well 2021-05-04 14:28:25 +02:00
enabling-https.rst Delete unavailable py2 package 2021-05-10 09:47:52 +00:00
enrollment.rst Merge "Changes made to enrollment documentation" 2021-06-10 14:21:06 +00:00
get_started.rst docs: use openstackdocstheme extlink extension 2019-10-08 11:12:05 +02:00
index.rst Rework the user guide 2021-05-10 17:18:13 +02:00
install-obs.rst Document single process Ironic 2021-12-13 12:52:25 +01:00
install-rdo.rst Document single process Ironic 2021-12-13 12:52:25 +01:00
install-ubuntu.rst Document single process Ironic 2021-12-13 12:52:25 +01:00
install.rst Recommend various installers in the install guide 2022-01-25 15:37:13 +01:00
next-steps.rst Move install guide into new doc/source/install location 2017-07-05 12:16:37 +01:00
setup-drivers.rst Bye-bye iSCSI deploy, you served us well 2021-05-04 14:28:25 +02:00
standalone.rst Rework the user guide 2021-05-10 17:18:13 +02:00
troubleshooting.rst Updates ironic documentation 2020-10-07 09:46:34 -07:00