Thanks for the information. I was able to build the Installation Guide with
your input!

The one issue I did have, although it's not critical, is that publican was
complaining that --config isn't a parameter.

What I ended up doing was copying, for example, publican-adminguide.cfg,
pasting it, and renaming it to publican.cfg and running without the
--config parameter.

Thanks again!


On Wed, Dec 11, 2013 at 10:07 PM, Radhika Puthiyetath <
radhika.puthiyet...@citrix.com> wrote:

> Mike,
>
> Publican-all is not a frequently used config file.
>
> Do try the following:
>
> publican build --config=publican-adminguide.cfg --formats=test
> --langs=en-US
> publican build --config=publican-installation.cfg --formats=test
> --langs=en-US
> publican build --config=publican-devguide.cfg --formats=test --langs=en-US
>
> -----Original Message-----
> From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com]
> Sent: Wednesday, December 11, 2013 11:57 PM
> To: dev@cloudstack.apache.org
> Subject: Re: Documentation Question
>
> I tried to set this up on a Windows 7 VM to see if it worked for me.
>
> I seem to be able to run the build now, but have validation errors.
>
> Any thoughts on this?
>
>         Processing file tmp/en-US/xml_tmp/xenserver-maintenance-mode.xml
>         Processing file tmp/en-US/xml_tmp/xenserver-topology-req.xml
>         Processing file tmp/en-US/xml_tmp/zone-add.xml Beginning work on
> en-US Validation failed: cloudstack.xml:6: validity error : ID
> hypervisor-support-for-primarystorage already defined
> cloudstack.xml:31: validity error : ID prereq-addnic already defined
> cloudstack.xml:6: validity error : ID api-throttling already defined
> cloudstack.xml:30: validity error : ID api-throttling-configure already
> defined
> cloudstack.xml:59: validity error : ID api-throttling-limitations already
> defined
> cloudstack.xml:6: validity error : ID globally-configured-limits already
> defined
> cloudstack.xml:29: validity error : IDREF attribute linkend references an
> unknown ID "sect-source-builddebs"
> cloudstack.xml:30: validity error : IDREF attribute linkend references an
> unknown ID "sect-source-builddebs"
> cloudstack.xml:29: validity error : IDREF attribute linkend references an
> unknown ID "sect-source-buildrpm"
> cloudstack.xml:30: validity error : IDREF attribute linkend references an
> unknown ID "sect-source-buildrpm"
>
>  at script/publican line 453
>
>
> On Tue, Dec 10, 2013 at 10:40 PM, Radhika Puthiyetath <
> radhika.puthiyet...@citrix.com> wrote:
>
> > I get a clean build. Some perl file (since it it searching for
> catalog.pmfile) is missing . Not related to Publican.
> >
> > -----Original Message-----
> > From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com]
> > Sent: Wednesday, December 11, 2013 10:36 AM
> > To: dev@cloudstack.apache.org
> > Subject: Re: Documentation Question
> >
> > This is just building the current docs without my changes (and my
> > changes are quite minor at this point).
> >
> >
> > On Tue, Dec 10, 2013 at 10:05 PM, Mike Tutkowski <
> > mike.tutkow...@solidfire.com> wrote:
> >
> > > Unfortunately got the same error message:
> > >
> > > mtutkowski-LT:cloudstack-docs mtutkowski$ publican build
> > > --config=publican-adminguide.cfg --formats=test --langs=en-US Unable
> > > to retrieve URL: [file:/etc/xml/catalog] at
> > > /opt/local/lib/perl5/site_perl/5.12.4/XML/Catalog.pm line 170.
> > >
> > >
> > > On Tue, Dec 10, 2013 at 10:00 PM, Radhika Puthiyetath <
> > > radhika.puthiyet...@citrix.com> wrote:
> > >
> > >> Try the following:
> > >>
> > >> publican build --config=publican-adminguide.cfg --formats=test
> > >> --langs=en-US
> > >>         publican build --config=publican-installation.cfg
> > >> --formats=test --langs=en-US
> > >>
> > >>
> > >> Let me pull your changes and try from my end.
> > >>
> > >>
> > >> -----Original Message-----
> > >> From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com]
> > >> Sent: Wednesday, December 11, 2013 10:24 AM
> > >> To: dev@cloudstack.apache.org
> > >> Subject: Re: Documentation Question
> > >>
> > >> Thanks
> > >>
> > >> I was wondering if you understand what might be the problem here
> > >> when I try to build the docs:
> > >>
> > >> mtutkowski-LT:cloudstack-docs mtutkowski$ publican build
> > >> --config=publican-all.cfg --formats=pdf --langs=en-US Unable to
> > >> retrieve
> > >> URL: [file:/etc/xml/catalog] at
> > >> /opt/local/lib/perl5/site_perl/5.12.4/XML/Catalog.pm line 170.
> > >>
> > >>
> > >> On Tue, Dec 10, 2013 at 8:20 PM, Radhika Puthiyetath <
> > >> radhika.puthiyet...@citrix.com> wrote:
> > >>
> > >> > Yes, I am checking into master.
> > >> >
> > >> > -----Original Message-----
> > >> > From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com]
> > >> > Sent: Wednesday, December 11, 2013 3:48 AM
> > >> > To: dev@cloudstack.apache.org
> > >> > Subject: Re: Documentation Question
> > >> >
> > >> > Hi,
> > >> >
> > >> > I know we are having a discussion about changing the way we do
> > >> > docs in 4.3, but - for the time being - I was making a few
> > >> > changes locally from this
> > >> > repo:
> > >> >
> > >> > https://git-wip-us.apache.org/repos/asf/cloudstack-docs.git
> > >> >
> > >> > I notice there are only the 4.2 and master branches.
> > >> >
> > >> > I assume master is 4.3 in this repo?
> > >> >
> > >> > Thanks!
> > >> >
> > >> >
> > >> > On Thu, Dec 5, 2013 at 10:02 PM, Mike Tutkowski <
> > >> > mike.tutkow...@solidfire.com> wrote:
> > >> >
> > >> > > Thanks!
> > >> > >
> > >> > >
> > >> > > On Thu, Dec 5, 2013 at 9:39 PM, Radhika Puthiyetath <
> > >> > > radhika.puthiyet...@citrix.com> wrote:
> > >> > >
> > >> > >> Yes. It has been moved to
> > >> > >> http://git-wip-us.apache.org/repos/asf/cloudstack-docs/repo
> > >> > >>
> > >> > >>
> > >> > >>
> > >> > >> -----Original Message-----
> > >> > >> From: Mike Tutkowski [mailto:mike.tutkow...@solidfire.com]
> > >> > >> Sent: Friday, December 06, 2013 12:20 AM
> > >> > >> To: dev@cloudstack.apache.org
> > >> > >> Subject: Documentation Question
> > >> > >>
> > >> > >> Hi,
> > >> > >>
> > >> > >> It's been a while since I've needed to update documentation
> > >> > >> for CloudStack's Admin and Installation Guides.
> > >> > >>
> > >> > >> I know at some point there was talk of breaking documentation
> > >> > >> out into another repo.
> > >> > >>
> > >> > >> Can someone refresh my memory as to whether that new repo was
> > >> > >> created or if we decided to keep documentation in the same
> > >> > >> place it was located for 4.2?
> > >> > >>
> > >> > >> Thanks!
> > >> > >>
> > >> > >> --
> > >> > >> *Mike Tutkowski*
> > >> > >> *Senior CloudStack Developer, SolidFire Inc.*
> > >> > >> e: mike.tutkow...@solidfire.com
> > >> > >> o: 303.746.7302
> > >> > >> Advancing the way the world uses the
> > >> > >> cloud<http://solidfire.com/solution/overview/?video=play>
> > >> > >> *(tm)*
> > >> > >>
> > >> > >
> > >> > >
> > >> > >
> > >> > > --
> > >> > > *Mike Tutkowski*
> > >> > > *Senior CloudStack Developer, SolidFire Inc.*
> > >> > > e: mike.tutkow...@solidfire.com
> > >> > > o: 303.746.7302
> > >> > > Advancing the way the world uses the
> > >> > > cloud<http://solidfire.com/solution/overview/?video=play>
> > >> > > *(tm)*
> > >> > >
> > >> >
> > >> >
> > >> >
> > >> > --
> > >> > *Mike Tutkowski*
> > >> > *Senior CloudStack Developer, SolidFire Inc.*
> > >> > e: mike.tutkow...@solidfire.com
> > >> > o: 303.746.7302
> > >> > Advancing the way the world uses the
> > >> > cloud<http://solidfire.com/solution/overview/?video=play>
> > >> > *(tm)*
> > >> >
> > >>
> > >>
> > >>
> > >> --
> > >> *Mike Tutkowski*
> > >> *Senior CloudStack Developer, SolidFire Inc.*
> > >> e: mike.tutkow...@solidfire.com
> > >> o: 303.746.7302
> > >> Advancing the way the world uses the
> > >> cloud<http://solidfire.com/solution/overview/?video=play>
> > >> *(tm)*
> > >>
> > >
> > >
> > >
> > > --
> > > *Mike Tutkowski*
> > > *Senior CloudStack Developer, SolidFire Inc.*
> > > e: mike.tutkow...@solidfire.com
> > > o: 303.746.7302
> > > Advancing the way the world uses the
> > > cloud<http://solidfire.com/solution/overview/?video=play>
> > > *(tm)*
> > >
> >
> >
> >
> > --
> > *Mike Tutkowski*
> > *Senior CloudStack Developer, SolidFire Inc.*
> > e: mike.tutkow...@solidfire.com
> > o: 303.746.7302
> > Advancing the way the world uses the
> > cloud<http://solidfire.com/solution/overview/?video=play>
> > *(tm)*
> >
>
>
>
> --
> *Mike Tutkowski*
> *Senior CloudStack Developer, SolidFire Inc.*
> e: mike.tutkow...@solidfire.com
> o: 303.746.7302
> Advancing the way the world uses the
> cloud<http://solidfire.com/solution/overview/?video=play>
> *(tm)*
>



-- 
*Mike Tutkowski*
*Senior CloudStack Developer, SolidFire Inc.*
e: mike.tutkow...@solidfire.com
o: 303.746.7302
Advancing the way the world uses the
cloud<http://solidfire.com/solution/overview/?video=play>
*™*

Reply via email to