← Back to team overview

yahoo-eng-team team mailing list archive

[Bug 2128698] [NEW] Documentation - Install and configure (Ubuntu) - Unclear instructions in configuring image store

 

Public bug reported:

- [X] This doc is inaccurate in this way:

The section heading only mentions configuring the [glance_store]
section, but the configuration example shows modification to three
different sections: [DEFAULT], [glance_store], and [fs]. It is also not
explicitly stated that the [fs] section must be created.

- [X] I have a fix to the document that I can paste below including example:
 
OpenStack Version: 2025.2

Affected Page: Install and configure (Ubuntu)

Section: "Install and configure components" - Step 3

File: glance/doc/source/install/edit-glance-api-conf.rst

Current text:
"In the [glance_store] section, configure the local file system store and location of image files:"

Proposed fix:
"In the [DEFAULT] and [glance_store] sections, configure the local file system store. Add the [fs] section to define the location of image files:"

Configuration example remains the same.

-----------------------------------
Release: 31.0.0.0rc2.dev2 on 2023-06-28 21:28:33
SHA: 2ebeab5fca074cdd5ab194c1a0cdd079fd83d52a
Source: https://opendev.org/openstack/glance/src/doc/source/install/install-ubuntu.rst
URL: https://docs.openstack.org/glance/2025.2/install/install-ubuntu.html

** Affects: glance
     Importance: Undecided
         Status: New


** Tags: documentation

-- 
You received this bug notification because you are a member of Yahoo!
Engineering Team, which is subscribed to Glance.
https://bugs.launchpad.net/bugs/2128698

Title:
  Documentation - Install and configure (Ubuntu) - Unclear instructions
  in configuring image store

Status in Glance:
  New

Bug description:
  - [X] This doc is inaccurate in this way:

  The section heading only mentions configuring the [glance_store]
  section, but the configuration example shows modification to three
  different sections: [DEFAULT], [glance_store], and [fs]. It is also
  not explicitly stated that the [fs] section must be created.

  - [X] I have a fix to the document that I can paste below including example:
   
  OpenStack Version: 2025.2

  Affected Page: Install and configure (Ubuntu)

  Section: "Install and configure components" - Step 3

  File: glance/doc/source/install/edit-glance-api-conf.rst

  Current text:
  "In the [glance_store] section, configure the local file system store and location of image files:"

  Proposed fix:
  "In the [DEFAULT] and [glance_store] sections, configure the local file system store. Add the [fs] section to define the location of image files:"

  Configuration example remains the same.

  -----------------------------------
  Release: 31.0.0.0rc2.dev2 on 2023-06-28 21:28:33
  SHA: 2ebeab5fca074cdd5ab194c1a0cdd079fd83d52a
  Source: https://opendev.org/openstack/glance/src/doc/source/install/install-ubuntu.rst
  URL: https://docs.openstack.org/glance/2025.2/install/install-ubuntu.html

To manage notifications about this bug go to:
https://bugs.launchpad.net/glance/+bug/2128698/+subscriptions