pdf doc build job fails

Bug #1918707 reported by Goutham Pacha Ravi
6
This bug affects 1 person
Affects Status Importance Assigned to Milestone
OpenStack Shared File Systems Service (Manila)
Fix Released
Undecided
Unassigned

Bug Description

This is a CI failure tracker that occurred at the Wallaby Cycle Feature Freeze. There's an issue with the ``make`` command that's run to generate a pdf of the docs:

   Running /home/zuul/.local/tox/bin/tox -e pdf-docs -vv > /home/zuul/zuul-output/logs/sphinx-build-pdf.log 2>&1
   Output is redirected to a file as it tends to be quite verbose.
   ERROR
   {
       "delta": "0:00:30.527371",
       "end": "2021-03-11 12:26:47.551614",
       "msg": "non-zero return code",
       "rc": 1,
       "start": "2021-03-11 12:26:17.024243"
   }

And this is the final error recorded in the sphinx-build-pdf.log

   ?
   ! Emergency stop.
   \fb@put@frame ...p \ifdim \dimen@ >\ht \@tempboxa
                                                  \fb@putboxa #1\fb@afterfra...
l.44219 \end{sphinxVerbatim}

   Output written on doc-manila.pdf (458 pages).
   Transcript written on doc-manila.log.
   Latexmk: References changed.
   Latexmk: Summary of warnings from last run of (pdf)latex:
     =====Latex reported missing or unavailable character(s).
   =====See log file for details.
   Collected error summary (may duplicate other messages):
     pdflatex: Command for 'pdflatex' gave return code 1
         Refer to 'doc-manila.log' for details
   Latexmk: Use the -f option to force complete processing,
    unless error was exceeding maximum runs, or warnings treated as errors.
   === TeX engine is 'XeTeX'
   Latexmk: Errors, so I did not complete making targets
   make: *** [Makefile:29: doc-manila.pdf] Error 12
   make: Leaving directory '/home/zuul/src/opendev.org/openstack/manila/doc/build/pdf'
   ERROR: InvocationError for command /usr/bin/make -C doc/build/pdf (exited with code 2)
   pdf-docs finish: run-test after 29.48 seconds
   pdf-docs start: run-test-post
   pdf-docs finish: run-test-post after 0.00 seconds
   ___________________________________ summary ____________________________________
   ERROR: pdf-docs: commands failed

While the job is marked a failure due to the error, the pdf file is successfully generated.
The failures began around 2021-03-10 06:44:48 UTC (the first failure reported on https://review.opendev.org/763461/3

As discussed during the weekly IRC meeting on 11th March 2021 [1], we'll be setting this job to non-voting for the time being until we investigate and fix the issues.

Job logs from a failed job are attached to this bug report.

[1] http://eavesdrop.openstack.org/meetings/manila/2021/manila.2021-03-11-15.00.log.html#l-120

Revision history for this message
Goutham Pacha Ravi (gouthamr) wrote :
Revision history for this message
Goutham Pacha Ravi (gouthamr) wrote :
Revision history for this message
Goutham Pacha Ravi (gouthamr) wrote :
Changed in manila:
milestone: wallaby-rc1 → xena-1
Changed in manila:
status: New → In Progress
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix proposed to manila (stable/wallaby)

Fix proposed to branch: stable/wallaby
Review: https://review.opendev.org/c/openstack/manila/+/796224

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to manila (master)

Reviewed: https://review.opendev.org/c/openstack/manila/+/796004
Committed: https://opendev.org/openstack/manila/commit/4bfea794d74019eb5e6fa907ee26ff1fc71ce6b2
Submitter: "Zuul (22348)"
Branch: master

commit 4bfea794d74019eb5e6fa907ee26ff1fc71ce6b2
Author: Elod Illes <email address hidden>
Date: Fri Jun 11 15:21:08 2021 +0200

    Fix PDF build

    With newer sphinx the pdf build fails and gives the following error:

    ! Dimension too large.

    This could be memory issue, that can be fixed by not generating the
    sample_policy file as that can be large.

    This patch also sets back the tox-docs job as voting.

    Closes-Bug: #1918707
    Change-Id: I4f22fe7b45394045f672d5bbd3b46c4e5e4b2fd3

Changed in manila:
status: In Progress → Fix Released
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix merged to manila (stable/wallaby)

Reviewed: https://review.opendev.org/c/openstack/manila/+/796224
Committed: https://opendev.org/openstack/manila/commit/377fbc3acd3943440235eb79a8a2f6fe438f16ee
Submitter: "Zuul (22348)"
Branch: stable/wallaby

commit 377fbc3acd3943440235eb79a8a2f6fe438f16ee
Author: Elod Illes <email address hidden>
Date: Fri Jun 11 15:21:08 2021 +0200

    Fix PDF build

    With newer sphinx the pdf build fails and gives the following error:

    ! Dimension too large.

    This could be memory issue, that can be fixed by not generating the
    sample_policy file as that can be large.

    This patch also sets back the tox-docs job as voting.

    Closes-Bug: #1918707
    Change-Id: I4f22fe7b45394045f672d5bbd3b46c4e5e4b2fd3
    (cherry picked from commit 4bfea794d74019eb5e6fa907ee26ff1fc71ce6b2)

tags: added: in-stable-wallaby
Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/manila 13.0.0.0rc1

This issue was fixed in the openstack/manila 13.0.0.0rc1 release candidate.

Revision history for this message
OpenStack Infra (hudson-openstack) wrote : Fix included in openstack/manila 12.1.0

This issue was fixed in the openstack/manila 12.1.0 release.

To post a comment you must log in.
This report contains Public information  
Everyone can see this information.

Other bug subscribers

Remote bug watches

Bug watches keep track of this bug in other bug trackers.