[Geoserver-devel] Problem building docs for release

ianturton · July 20, 2019, 11:04am

The release job for 2.14.5 is failing on the documentation build, it claims not to be able to find the PDF

/tmp/jenkins-6a5df164/workspace/geoserver-release/src/target/release/…/…/…/doc/en/target/user/latex/*.pdf

It earlier claims to build the user-pdf correctly.

So my questions are:

do we still build the pdf?
what is the maven magic to do this? I can’t get a PDF built locally
is pdflatex present on the build server? as this would probably generate this issue?

Cheers

Ian

···

Ian Turton

Andrea_Aime4 · July 20, 2019, 11:36am

The release job for 2.14.5 is failing on the documentation build, it claims not to be able to find the PDF

/tmp/jenkins-6a5df164/workspace/geoserver-release/src/target/release/…/…/…/doc/en/target/user/latex/*.pdf

It earlier claims to build the user-pdf correctly.

So my questions are:

do we still build the pdf?

Yes we should, think last release Jody had issues and skipped it.

what is the maven magic to do this? I can’t get a PDF built locally

Err… I guess it’s a straight call to the sphinx machinery

is pdflatex present on the build server? as this would probably generate this issue?

And that alone is not enough, one need kind of the fullest latex installation package available
(at least, that was needed last time I built it locally)

Cheers
Andrea

···

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it ------------------------------------------------------- Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.

jive · July 20, 2019, 12:48pm

The documentation guide has instructions for installing LaTex to build PDF. I can build locally one tag is made and upload to sourceforge if you like.

I do not know if the worker is configured with LaTex?

···

–
Jody Garnett

Andrea_Aime4 · July 20, 2019, 12:55pm

For reference, here is the page:

https://docs.geoserver.org/latest/en/docguide/installlatex.html

Cheers
Andrea

···

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it ------------------------------------------------------- Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.

ianturton · July 21, 2019, 10:36am

I’ve managed to fix the release configuration it was missing pdflatex - for future reference the magic command is sudo apt-get install -y texlive-base texlive-latex-recommended texlive-science texlive-latex-extra texlive-extra-utils.

Also the workflow doc needs updating as there is no make file any longer, that magic command is ant user-pdf I’ll try to get to that later today.

Ian

···

Ian Turton

Andrea_Aime4 · July 22, 2019, 10:04am

Thanks Ian!

Cheers
Andrea

Il dom 21 lug 2019, 12:37 Ian Turton <ijturton@anonymised.com> ha scritto:

I’ve managed to fix the release configuration it was missing pdflatex - for future reference the magic command is sudo apt-get install -y texlive-base texlive-latex-recommended texlive-science texlive-latex-extra texlive-extra-utils.

Also the workflow doc needs updating as there is no make file any longer, that magic command is ant user-pdf I’ll try to get to that later today.

Ian

On Sat, 20 Jul 2019 at 13:55, Andrea Aime <andrea.aime@anonymised.com> wrote:

On Sat, Jul 20, 2019 at 2:48 PM Jody Garnett <jody.garnett@anonymised.com> wrote:

The documentation guide has instructions for installing LaTex to build PDF. I can build locally one tag is made and upload to sourceforge if you like.

For reference, here is the page:

https://docs.geoserver.org/latest/en/docguide/installlatex.html

Cheers
Andrea

==

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it ------------------------------------------------------- Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.

–

Ian Turton

tbarsballe · July 22, 2019, 7:06pm

Thanks Ian

I’ll add that to the startup script for the Jenkins worker next time I update it, so that it doesn’t have to be included in the release job (reconstructing exactly what packages are needed to build everything has been a bit of an adventure).

Torben

On Mon, Jul 22, 2019 at 3:05 AM Andrea Aime <andrea.aime@anonymised.com> wrote:

Thanks Ian!

Cheers
Andrea

Il dom 21 lug 2019, 12:37 Ian Turton <ijturton@anonymised.com…> ha scritto:

I’ve managed to fix the release configuration it was missing pdflatex - for future reference the magic command is sudo apt-get install -y texlive-base texlive-latex-recommended texlive-science texlive-latex-extra texlive-extra-utils.

Also the workflow doc needs updating as there is no make file any longer, that magic command is ant user-pdf I’ll try to get to that later today.

Ian

On Sat, 20 Jul 2019 at 13:55, Andrea Aime <andrea.aime@anonymised.com> wrote:

On Sat, Jul 20, 2019 at 2:48 PM Jody Garnett <jody.garnett@anonymised.com> wrote:

The documentation guide has instructions for installing LaTex to build PDF. I can build locally one tag is made and upload to sourceforge if you like.

For reference, here is the page:

https://docs.geoserver.org/latest/en/docguide/installlatex.html

Cheers
Andrea

==

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it ------------------------------------------------------- Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.

–

Ian Turton

Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

ianturton · July 22, 2019, 7:35pm

I added it to the release script so it doesn’t need to slow all the builders down.

Ian

···

Ian Turton

tbarsballe · July 22, 2019, 8:04pm

Good point, releases are infrequent enough that this doesn’t really need to be installed all the time.

Cheers,

Torben

On Mon, Jul 22, 2019 at 12:35 PM Ian Turton <ijturton@anonymised.com> wrote:

I added it to the release script so it doesn’t need to slow all the builders down.

Ian

On Mon, 22 Jul 2019 at 20:06, Torben Barsballe <tbarsballe@anonymised.com> wrote:

Thanks Ian

I’ll add that to the startup script for the Jenkins worker next time I update it, so that it doesn’t have to be included in the release job (reconstructing exactly what packages are needed to build everything has been a bit of an adventure).

Torben

On Mon, Jul 22, 2019 at 3:05 AM Andrea Aime <andrea.aime@anonymised.com> wrote:

Thanks Ian!

Cheers
Andrea

Il dom 21 lug 2019, 12:37 Ian Turton <ijturton@anonymised.com> ha scritto:

I’ve managed to fix the release configuration it was missing pdflatex - for future reference the magic command is sudo apt-get install -y texlive-base texlive-latex-recommended texlive-science texlive-latex-extra texlive-extra-utils.

Also the workflow doc needs updating as there is no make file any longer, that magic command is ant user-pdf I’ll try to get to that later today.

Ian

On Sat, 20 Jul 2019 at 13:55, Andrea Aime <andrea.aime@anonymised.com> wrote:

On Sat, Jul 20, 2019 at 2:48 PM Jody Garnett <jody.garnett@anonymised.com> wrote:

The documentation guide has instructions for installing LaTex to build PDF. I can build locally one tag is made and upload to sourceforge if you like.

For reference, here is the page:

https://docs.geoserver.org/latest/en/docguide/installlatex.html

Cheers
Andrea

==

GeoServer Professional Services from the experts! Visit http://goo.gl/it488V for more information. == Ing. Andrea Aime @geowolf Technical Lead GeoSolutions S.A.S. Via di Montramito 3/A 55054 Massarosa (LU) phone: +39 0584 962313 fax: +39 0584 1660272 mob: +39 339 8844549 http://www.geo-solutions.it http://twitter.com/geosolutions_it ------------------------------------------------------- Con riferimento alla normativa sul trattamento dei dati personali (Reg. UE 2016/679 - Regolamento generale sulla protezione dei dati “GDPR”), si precisa che ogni circostanza inerente alla presente email (il suo contenuto, gli eventuali allegati, etc.) è un dato la cui conoscenza è riservata al/i solo/i destinatario/i indicati dallo scrivente. Se il messaggio Le è giunto per errore, è tenuta/o a cancellarlo, ogni altra operazione è illecita. Le sarei comunque grato se potesse darmene notizia. This email is intended only for the person or entity to which it is addressed and may contain information that is privileged, confidential or otherwise protected from disclosure. We remind that - as provided by European Regulation 2016/679 “GDPR” - copying, dissemination or use of this e-mail or the information herein by anyone other than the intended recipient is prohibited. If you have received this email by mistake, please notify us immediately by telephone or e-mail.

–

Ian Turton

Geoserver-devel mailing list
Geoserver-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/geoserver-devel

–

Ian Turton