You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by Flavio Cordova <fl...@gmail.com> on 2005/10/28 02:19:15 UTC
Trying to run forrestbot...
I have created a small project using forrest and it runs fine using both
'forrest run' and 'forrest site'.
Now I'm trying to build the site using forrestbot but it's not working...
Here the build.xml I have created:
<project name="build.prounit" default="main">
<description>ProUnit Documentation build script</description>
<!-- Import properties -->
<property file="build.properties" />
<property name="getsrc.local.root-dir" location="c:/work/prounit-docs"/>
<property name="build.work-dir" value="tmp/work"/>
<property name="build.log-dir" value="tmp/logs"/>
<property name="deploy.local.dir" value="deploy-docs"/>
<target name="getsrc" depends="getsrc.clean-workdir,getsrc.local"/>
<target name="deploy" depends="deploy.local">
<echo level="info" message="DONE ???" />
</target>
<property environment="env"/>
<import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
<property name="forrest.home" value="${env.FORREST_HOME}"/>
</project>
When it runs, it reports a broken link:
[java] X [0] linkmap.html BROKEN: C:\apache-
forrest-0.7\main\webapp\tmp\work\tmp\build-info.xml (The system cannot find
the path specified)
I have already searched all FAQs and documentation but I admit I got a
little lost.
Re: Trying to run forrestbot...
Posted by David Crossley <cr...@apache.org>.
Flavio Cordova wrote:
> I have finally found some time to take a look at that.. :-)
>
> >>> build.work-dir etc. being relative paths (should be okay).
>
> Exactly... that's the problem.. In fact it would work fine if I had defined
> the property using location attribute, and not the value attribute.
> Before:
> <property name="build.work-dir" value="./tmp/work"/>
> <property name="build.log-dir" value="./tmp/logs"/>
> Now:
> <property name="build.work-dir" location="./tmp/work"/>
> <property name="build.log-dir" location="./tmp/logs"/>
> Value attribute also works if you use a full path name.
> Thanks for all !!!
Fantastic. Thanks for the feedback. The documentation
needs to be enhanced. The only place that it mentions
the "location" attribute is here:
http://forrest.apache.org/tools/forrestbot.html#getsrc.local
-David
Re: Trying to run forrestbot...
Posted by Flavio Cordova <fl...@gmail.com>.
I have finally found some time to take a look at that.. :-)
>>> build.work-dir etc. being relative paths (should be okay).
Exactly... that's the problem.. In fact it would work fine if I had defined
the property using location attribute, and not the value attribute.
Before:
<property name="build.work-dir" value="./tmp/work"/>
<property name="build.log-dir" value="./tmp/logs"/>
Now:
<property name="build.work-dir" location="./tmp/work"/>
<property name="build.log-dir" location="./tmp/logs"/>
Value attribute also works if you use a full path name.
Thanks for all !!!
On 10/28/05, David Crossley <cr...@apache.org> wrote:
>
> Flavio Cordova wrote:
> > I have created a small project using forrest and it runs fine using both
> > 'forrest run' and 'forrest site'.
> > Now I'm trying to build the site using forrestbot but it's not
> working...
>
> Great to hear that other people are using forrestbot.
> It is such a fantastic deployment tool. We are having
> great success with it at the Forrest project, and still
> only using a fraction of its ability.
>
> Going by my experience, the main thing was to set up the
> directory structure well. Also important was to invoke
> forrestbot from the correct directory.
>
> We have a separate configuration file for each site
> that we want forrestbot to build. Ours is automated via
> cron, so each hour it calls a little shell script which
> sets the java and FORREST_HOME environment variables,
> changes to the correct workspace and then calls it
> with 'forrest -f this-site-config.xml notify' to build
> it and tell us about the results.
>
> See our configuration files for our forrestbot at
> http://svn.apache.org/repos/asf/forrest/zone/
> Do an 'svn checkout' and use it to help create your
> own setup.
> http://forrest.apache.org/zone.html
>
> See also some notes in your Forrest distribution
> at etc/publishing_our_site.txt ... this is how
> forrest committers use it to build and deploy
> our website from our local workstations.
>
> > Here the build.xml I have created:
> > <project name="build.prounit" default="main">
> > <description>ProUnit Documentation build script</description>
> > <!-- Import properties -->
> > <property file="build.properties" />
> > <property name="getsrc.local.root-dir" location="c:/work/prounit-docs"/>
> > <property name="build.work-dir" value="tmp/work"/>
> > <property name="build.log-dir" value="tmp/logs"/>
> > <property name="deploy.local.dir" value="deploy-docs"/>
> >
> > <target name="getsrc" depends="getsrc.clean-workdir,getsrc.local"/>
> >
> > <target name="deploy" depends="deploy.local">
> > <echo level="info" message="DONE ???" />
> > </target>
> >
> > <property environment="env"/>
> > <import file="${env.FORREST_HOME
> }/tools/forrestbot/core/forrestbot.xml"/>
> > <property name="forrest.home" value="${env.FORREST_HOME}"/>
> > </project>
> >
> > When it runs, it reports a broken link:
> > [java] X [0] linkmap.html BROKEN: C:\apache-
> > forrest-0.7\main\webapp\tmp\work\tmp\build-info.xml (The system cannot
> find
> > the path specified)
> > I have already searched all FAQs and documentation but I admit I got a
> > little lost.
>
> That sounds like perhaps forrestbot is being invoked from
> the wrong directory.
>
> I notice some things in your config file that might cause trouble.
> Actually i am pointing out the things that are different to ours
>
> build.work-dir etc. being relative paths (should be okay).
>
> We don't import any build.properties file.
>
> We don't set the "forrest.home" property.
>
> Anyway, check out the abovementioned links and get back to us.
>
> Also, note that some changes were made to the 0.7 release branch.
> which will be needed to get email notification happening properly,
> otherwise you should be fine with the actual 0.7 release.
>
> http://svn.apache.org/viewcvs.cgi/forrest/branches/forrest_07_branch/tools/forrestbot/core/
>
> -David
>
Re: Trying to run forrestbot...
Posted by "Gav...." <br...@brightontown.com.au>.
----- Original Message -----
From: "David Crossley" <cr...@apache.org>
To: <us...@forrest.apache.org>
Sent: Sunday, October 30, 2005 10:34 AM
Subject: Re: Trying to run forrestbot...
| Gav.... wrote:
| >
| > ----- Original Message -----
| > From: "Gav...." <br...@brightontown.com.au>
| > To: <us...@forrest.apache.org>
| > Sent: Saturday, October 29, 2005 8:35 PM
| > Subject: Re: Trying to run forrestbot...
| > |
| > | Yes, I can ftp from the command-line no problem,
| > | I can not suspect a connection problem at the
| > | moment because the forrestbot is not even trying
| > | to make a connection, the FTP part of the script
| > | simply is not being executed at all.
| > |
| > | It may be an error in my script, but from the details
| > | I have on Forrestbot I can not see what is wrong/missing
| > | at this point, I will keep looking.
| >
| > Answering myself again, I found the problem.
| >
| > I looked inside deploy.xml and changed this line :-
| >
| > <target name="deploy.ftp" unless="build.failed"
description="Forrestbot:
| > Deploy via FTP">
| >
| > to
| >
| > <target name="deploy.ftp" unless="" description="Forrestbot:
| > Deploy via FTP">
| >
| > So, all deploy methods will not occur on a build failure by default.
| > (You must have changed yours sometime David)
|
| No.
|
| > Whether this should be over-ridden in the user defined forrestbot file I
| > dont know, but it works now, and combined with the turning on
| > of CLI checksums in cli.xconf, only updates via ftp those files
| > that have been changed.
| >
| > It's all good :)
|
| The checksums bit is definitely good.
|
| Being able to deploy a broken site would cause problems.
True, in my case I know they are broken and am waiting for the fix for v2,
but as long as the broken parts don't change, they don't get updated and
dont get ftp'd, so are not a problem for me at this time.
This is a workaround for me, once I have a successful build, I will revert.
Gav...
|
| I wonder how i managed to do it. Perhaps it was because i do
| separate actions with the forrestbot: 'build', then investigate
| the brokenlinks reports and log files and sometimes view,
| then 'deploy'.
|
| -David
|
--
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.362 / Virus Database: 267.12.6/151 - Release Date: 28/10/2005
--
This message was scanned for spam and viruses by BitDefender.
For more information please visit http://linux.bitdefender.com/
Re: Trying to run forrestbot...
Posted by David Crossley <cr...@apache.org>.
Gav.... wrote:
>
> ----- Original Message -----
> From: "Gav...." <br...@brightontown.com.au>
> To: <us...@forrest.apache.org>
> Sent: Saturday, October 29, 2005 8:35 PM
> Subject: Re: Trying to run forrestbot...
> |
> | Yes, I can ftp from the command-line no problem,
> | I can not suspect a connection problem at the
> | moment because the forrestbot is not even trying
> | to make a connection, the FTP part of the script
> | simply is not being executed at all.
> |
> | It may be an error in my script, but from the details
> | I have on Forrestbot I can not see what is wrong/missing
> | at this point, I will keep looking.
>
> Answering myself again, I found the problem.
>
> I looked inside deploy.xml and changed this line :-
>
> <target name="deploy.ftp" unless="build.failed" description="Forrestbot:
> Deploy via FTP">
>
> to
>
> <target name="deploy.ftp" unless="" description="Forrestbot:
> Deploy via FTP">
>
> So, all deploy methods will not occur on a build failure by default.
> (You must have changed yours sometime David)
No.
> Whether this should be over-ridden in the user defined forrestbot file I
> dont know, but it works now, and combined with the turning on
> of CLI checksums in cli.xconf, only updates via ftp those files
> that have been changed.
>
> It's all good :)
The checksums bit is definitely good.
Being able to deploy a broken site would cause problems.
I wonder how i managed to do it. Perhaps it was because i do
separate actions with the forrestbot: 'build', then investigate
the brokenlinks reports and log files and sometimes view,
then 'deploy'.
-David
Re: Trying to run forrestbot...
Posted by "Gav...." <br...@brightontown.com.au>.
----- Original Message -----
From: "Gav...." <br...@brightontown.com.au>
To: <us...@forrest.apache.org>
Sent: Saturday, October 29, 2005 8:35 PM
Subject: Re: Trying to run forrestbot...
|
| Yes, I can ftp from the command-line no problem,
| I can not suspect a connection problem at the
| moment because the forrestbot is not even trying
| to make a connection, the FTP part of the script
| simply is not being executed at all.
|
| It may be an error in my script, but from the details
| I have on Forrestbot I can not see what is wrong/missing
| at this point, I will keep looking.
Answering myself again, I found the problem.
I looked inside deploy.xml and changed this line :-
<target name="deploy.ftp" unless="build.failed" description="Forrestbot:
Deploy via FTP">
to
<target name="deploy.ftp" unless="" description="Forrestbot:
Deploy via FTP">
So, all deploy methods will not occur on a build failure by default.
(You must have changed yours sometime David)
Whether this should be over-ridden in the user defined forrestbot file I
dont know, but it works now, and combined with the turning on
of CLI checksums in cli.xconf, only updates via ftp those files
that have been changed.
It's all good :)
|
| Gav...
|
||
|| -David
||
||
|| --
|| This message was scanned for spam and viruses by BitDefender.
|| For more information please visit http://linux.bitdefender.com/
||
||
||
|| --
|| No virus found in this incoming message.
|| Checked by AVG Free Edition.
|| Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date:
27/10/2005
||
||
|
|
|
| --
| No virus found in this outgoing message.
| Checked by AVG Free Edition.
| Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
|
|
|
| --
| This message was scanned for spam and viruses by BitDefender.
| For more information please visit http://linux.bitdefender.com/
|
|
|
|
| --
| No virus found in this incoming message.
| Checked by AVG Free Edition.
| Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
|
|
--
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
--
This message was scanned for spam and viruses by BitDefender.
For more information please visit http://linux.bitdefender.com/
Re: Trying to run forrestbot...
Posted by "Gav...." <br...@brightontown.com.au>.
----- Original Message -----
From: "David Crossley" <cr...@apache.org>
To: <us...@forrest.apache.org>
Sent: Saturday, October 29, 2005 7:37 AM
Subject: Re: Trying to run forrestbot...
| Gav.... wrote:
| > I have just configured my ForrestBot file and have had some success.
| > If it helps here is my .xml file - which works to a point and ends
| > successfully (more below)
| >
| > -------------------
| > <project name="apache_minitutorials" default="main">
| > <property name="notify.email.host" value="smtp.mymail.host"/>
| > <property name="notify.email.to" value="me@mydomain.com"/>
| > <property name="notify.email.from" value="localhost"/>
| > <property name="notify.administrator"
value="Gavin<me@mydomain.com>"/>
| > <property name="getsrc.local.root-dir" location="e:/web/forrest_gump"/>
| >
| > <!-- Deploy using FTP -->
| >
| > <property name="deploy.ftp.server" value="ftp.minitutorials.com"/>
| > <property name="deploy.ftp.user" value="username"/>
| > <property name="deploy.ftp.password" value="password"/>
| > <property name="deploy.ftp.remotedir" value="/path/to/site-root/"/>
| >
| > <target name="deploy" depends="deploy.ftp"/>
| >
| > <!-- here we specify to use two notification implementations -->
| > <target name="notify" depends="notify.local, notify.email"/>
| >
| > <!-- the default implementation for getsrc is getsrc.cvs, which is what
we
| > want (but not what I want so over ride it) -->
| > <target name="getsrc" depends="getsrc.local"/>
| >
| > <!-- assumes FORREST_HOME has been set as an environment variable -->
| > <property environment="env"/>
| > <import
file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
| > </project>
| > -------------------
| >
| > Now, the main build fails because of ls.contracts.xml and another couple
of
| > Broken files,
| > due to me using v2 I suspect.
| >
| > A local log is successfully created and an email is successfully sent,
both
| > containing
| > the build errors , the FTP part of this file however does not work, I am
| > wondering if this is because the main build fails.
|
| Well i published the project site yesterday with
| a known build error. Deploy was okay, using deploy.svn
|
| > Or do I have a configuration error somewhere in my forrestbot xml file
| > above.?
| >
| > The forrestbot itself ends with 'Build Successful'
|
| I don't use ftp so not much help.
| Can you do an independent test to use ftp from
| the local command-line and succesfully put files
| to that remote path? Some ftp servers would confine
| you to the home directory or a "pub" area.
Yes, I can ftp from the command-line no problem,
I can not suspect a connection problem at the
moment because the forrestbot is not even trying
to make a connection, the FTP part of the script
simply is not being executed at all.
It may be an error in my script, but from the details
I have on Forrestbot I can not see what is wrong/missing
at this point, I will keep looking.
Gav...
|
| -David
|
|
| --
| This message was scanned for spam and viruses by BitDefender.
| For more information please visit http://linux.bitdefender.com/
|
|
|
| --
| No virus found in this incoming message.
| Checked by AVG Free Edition.
| Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
|
|
--
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
--
This message was scanned for spam and viruses by BitDefender.
For more information please visit http://linux.bitdefender.com/
Re: Trying to run forrestbot...
Posted by David Crossley <cr...@apache.org>.
Gav.... wrote:
> I have just configured my ForrestBot file and have had some success.
> If it helps here is my .xml file - which works to a point and ends
> successfully (more below)
>
> -------------------
> <project name="apache_minitutorials" default="main">
> <property name="notify.email.host" value="smtp.mymail.host"/>
> <property name="notify.email.to" value="me@mydomain.com"/>
> <property name="notify.email.from" value="localhost"/>
> <property name="notify.administrator" value="Gavin<me@mydomain.com>"/>
> <property name="getsrc.local.root-dir" location="e:/web/forrest_gump"/>
>
> <!-- Deploy using FTP -->
>
> <property name="deploy.ftp.server" value="ftp.minitutorials.com"/>
> <property name="deploy.ftp.user" value="username"/>
> <property name="deploy.ftp.password" value="password"/>
> <property name="deploy.ftp.remotedir" value="/path/to/site-root/"/>
>
> <target name="deploy" depends="deploy.ftp"/>
>
> <!-- here we specify to use two notification implementations -->
> <target name="notify" depends="notify.local, notify.email"/>
>
> <!-- the default implementation for getsrc is getsrc.cvs, which is what we
> want (but not what I want so over ride it) -->
> <target name="getsrc" depends="getsrc.local"/>
>
> <!-- assumes FORREST_HOME has been set as an environment variable -->
> <property environment="env"/>
> <import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
> </project>
> -------------------
>
> Now, the main build fails because of ls.contracts.xml and another couple of
> Broken files,
> due to me using v2 I suspect.
>
> A local log is successfully created and an email is successfully sent, both
> containing
> the build errors , the FTP part of this file however does not work, I am
> wondering if this is because the main build fails.
Well i published the project site yesterday with
a known build error. Deploy was okay, using deploy.svn
> Or do I have a configuration error somewhere in my forrestbot xml file
> above.?
>
> The forrestbot itself ends with 'Build Successful'
I don't use ftp so not much help.
Can you do an independent test to use ftp from
the local command-line and succesfully put files
to that remote path? Some ftp servers would confine
you to the home directory or a "pub" area.
-David
Re: Trying to run forrestbot...
Posted by "Gav...." <br...@brightontown.com.au>.
I have just configured my ForrestBot file and have had some success.
If it helps here is my .xml file - which works to a point and ends
successfully (more below)
-------------------
<project name="apache_minitutorials" default="main">
<property name="notify.email.host" value="smtp.mymail.host"/>
<property name="notify.email.to" value="me@mydomain.com"/>
<property name="notify.email.from" value="localhost"/>
<property name="notify.administrator" value="Gavin<me@mydomain.com>"/>
<property name="getsrc.local.root-dir" location="e:/web/forrest_gump"/>
<!-- Deploy using FTP -->
<property name="deploy.ftp.server" value="ftp.minitutorials.com"/>
<property name="deploy.ftp.user" value="username"/>
<property name="deploy.ftp.password" value="password"/>
<property name="deploy.ftp.remotedir" value="/path/to/site-root/"/>
<target name="deploy" depends="deploy.ftp"/>
<!-- here we specify to use two notification implementations -->
<target name="notify" depends="notify.local, notify.email"/>
<!-- the default implementation for getsrc is getsrc.cvs, which is what we
want (but not what I want so over ride it) -->
<target name="getsrc" depends="getsrc.local"/>
<!-- assumes FORREST_HOME has been set as an environment variable -->
<property environment="env"/>
<import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
</project>
-------------------
Now, the main build fails because of ls.contracts.xml and another couple of
Broken files,
due to me using v2 I suspect.
A local log is successfully created and an email is successfully sent, both
containing
the build errors , the FTP part of this file however does not work, I am
wondering if this is because the main build fails.
Or do I have a configuration error somewhere in my forrestbot xml file
above.?
The forrestbot itself ends with 'Build Successful'
----- Original Message -----
From: "David Crossley" <cr...@apache.org>
To: <us...@forrest.apache.org>
Sent: Friday, October 28, 2005 12:25 PM
Subject: Re: Trying to run forrestbot...
| David Crossley wrote:
| > Flavio Cordova wrote:
| > >
| > > <property name="getsrc.local.root-dir"
location="c:/work/prounit-docs"/>
| > > <property name="build.work-dir" value="tmp/work"/>
| > > <property name="build.log-dir" value="tmp/logs"/>
| > > <property name="deploy.local.dir" value="deploy-docs"/>
|
| Is that "location" correct? Does forrestbot find the
| sources okay? We are on unix, so not much help with Windows.
|
| -David
|
|
| --
| This message was scanned for spam and viruses by BitDefender.
| For more information please visit http://linux.bitdefender.com/
|
|
|
| --
| No virus found in this incoming message.
| Checked by AVG Free Edition.
| Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
|
|
--
No virus found in this outgoing message.
Checked by AVG Free Edition.
Version: 7.1.362 / Virus Database: 267.12.5/150 - Release Date: 27/10/2005
--
This message was scanned for spam and viruses by BitDefender.
For more information please visit http://linux.bitdefender.com/
Re: Trying to run forrestbot...
Posted by David Crossley <cr...@apache.org>.
David Crossley wrote:
> Flavio Cordova wrote:
> >
> > <property name="getsrc.local.root-dir" location="c:/work/prounit-docs"/>
> > <property name="build.work-dir" value="tmp/work"/>
> > <property name="build.log-dir" value="tmp/logs"/>
> > <property name="deploy.local.dir" value="deploy-docs"/>
Is that "location" correct? Does forrestbot find the
sources okay? We are on unix, so not much help with Windows.
-David
Re: Trying to run forrestbot...
Posted by David Crossley <cr...@apache.org>.
Flavio Cordova wrote:
> I have created a small project using forrest and it runs fine using both
> 'forrest run' and 'forrest site'.
> Now I'm trying to build the site using forrestbot but it's not working...
Great to hear that other people are using forrestbot.
It is such a fantastic deployment tool. We are having
great success with it at the Forrest project, and still
only using a fraction of its ability.
Going by my experience, the main thing was to set up the
directory structure well. Also important was to invoke
forrestbot from the correct directory.
We have a separate configuration file for each site
that we want forrestbot to build. Ours is automated via
cron, so each hour it calls a little shell script which
sets the java and FORREST_HOME environment variables,
changes to the correct workspace and then calls it
with 'forrest -f this-site-config.xml notify' to build
it and tell us about the results.
See our configuration files for our forrestbot at
http://svn.apache.org/repos/asf/forrest/zone/
Do an 'svn checkout' and use it to help create your
own setup.
http://forrest.apache.org/zone.html
See also some notes in your Forrest distribution
at etc/publishing_our_site.txt ... this is how
forrest committers use it to build and deploy
our website from our local workstations.
> Here the build.xml I have created:
> <project name="build.prounit" default="main">
> <description>ProUnit Documentation build script</description>
> <!-- Import properties -->
> <property file="build.properties" />
> <property name="getsrc.local.root-dir" location="c:/work/prounit-docs"/>
> <property name="build.work-dir" value="tmp/work"/>
> <property name="build.log-dir" value="tmp/logs"/>
> <property name="deploy.local.dir" value="deploy-docs"/>
>
> <target name="getsrc" depends="getsrc.clean-workdir,getsrc.local"/>
>
> <target name="deploy" depends="deploy.local">
> <echo level="info" message="DONE ???" />
> </target>
>
> <property environment="env"/>
> <import file="${env.FORREST_HOME}/tools/forrestbot/core/forrestbot.xml"/>
> <property name="forrest.home" value="${env.FORREST_HOME}"/>
> </project>
>
> When it runs, it reports a broken link:
> [java] X [0] linkmap.html BROKEN: C:\apache-
> forrest-0.7\main\webapp\tmp\work\tmp\build-info.xml (The system cannot find
> the path specified)
> I have already searched all FAQs and documentation but I admit I got a
> little lost.
That sounds like perhaps forrestbot is being invoked from
the wrong directory.
I notice some things in your config file that might cause trouble.
Actually i am pointing out the things that are different to ours
build.work-dir etc. being relative paths (should be okay).
We don't import any build.properties file.
We don't set the "forrest.home" property.
Anyway, check out the abovementioned links and get back to us.
Also, note that some changes were made to the 0.7 release branch.
which will be needed to get email notification happening properly,
otherwise you should be fine with the actual 0.7 release.
http://svn.apache.org/viewcvs.cgi/forrest/branches/forrest_07_branch/tools/forrestbot/core/
-David