deploy built website to your ISP (Was: Help with new templates)

[David Crossley <cr...@apache.org>]

CFAS Webmaster wrote:
> Gav.... wrote:
> > Subject: Re: Help with new templates
 
When starting a new topic, please change the Subject.
 
> > | BTW there are some brave user to use them live. Diwaker is using them in
> > | on his homepage. ;-)
> > | http://floatingsun.net
> > 
> > Is this on Diwakers' own web server or public?

If you see it with your web browser, then it is public.

> >I was going to ask the question as I don't see it
> > documented anywhere, how does
> >anyone publish a forrest site to the web so it 
> >is available to all.
>
> The way *I* do it is to run forrest from the root of the seeded tree, in 
> my case in these emails it's .../cfas-new/, where you'll likely find the 
> src/ directory. 
> 
> >I have an apache web server running so it is not a
> > problem, just wondered if
> >this project was meant for intranet use only or
> > if porting to an ISP web space
> >was possible or a future goal.
>
> That's good.  What you'd want to do for a static site is give Apache 
> access to the build/site directory under the seeded tree, eg. 
> .../cfas-new/build/site/  There's probably an index.html file there that 
> Apache will be happy to serve.

That is very dangerous. If you break your forrest
build in any way, then your live web server is broken.
Much better to separate the concerns. Build your
site in one place, then deploy it to the server.

> Another method is to copy the .../build/site/* tree
> into the web root of a server.

Gav, i am confused by your question, so i will try
to answer what i think the question is.

You have an account with an ISP, which provides a
special directory to place a set of documents for
your website (called the document root).

You have Forrest installed on your office desktop.
cd to the top of your forrest site (which is
where the forrest.properties file lives).
Do 'forrest' which generates the documents into
build/site directory.

Now you need to deploy the contents of build/site
onto your ISP's webserver. That will entirely
depend on how your ISP provides you access.

One way would be to do it manually.
cd build/site
tar cf mysite.tar *
gzip *.tar
... use 'scp' or 'ftp' or whatever method that
your ISP provides to put that file onto your webserver.
Then log in to your server and uncompress the
archive into the document root of your webserver.
Your ISP might even enable you to use ftp or scp
to deploy the files straight into your document root
without the gzip and followup login step. Another
way would be to use 'rsync'.

How to do these manual methods is beyond the
scope of Forrest project.

The best way to deploy your generated website
is to use "forrestbot":
http://forrest.apache.org/tools/forrestbot.html

It has various different mechanisms for deployment.
We use the "svn" deployment technique for the
forrest.apache.org website. Our generated website
is added to a Subversion repository, then on the
server there is an outomated process which does
cd to our document root, then 'svn update'.

Forrestbot has other deployment methods such
as ftp and scp, not yet using rsync but that
would be possible to develop. 

Of course Forrest can also be used in dynamic mode.
There are various ways to do this. One way is
to cd to your forrest source top-level and do
'forrest war'. This creates a web application archive
which you add to your ISP's servlet containers' webapps
directory. (e.g. Tomcat or Jetty). How you do this
is completely beyond the scope of the Forrest project.

David

Re: deploy built website to your ISP (Was: Help with new templates)

[Ross Gardler <rg...@apache.org>]

Gav.... wrote:

> |
> | Of course Forrest can also be used in dynamic mode.
> | There are various ways to do this. One way is
> | to cd to your forrest source top-level and do
> | 'forrest war'. This creates a web application archive
> | which you add to your ISP's servlet containers' webapps
> | directory. (e.g. Tomcat or Jetty). How you do this
> | is completely beyond the scope of the Forrest project.
> 
> I imagine, unless one is on first name terms with their ISP
> that getting them to do that will be a bit blood/stone scenario,
> I will set it up on my own server though and have a play.

Many ISP's provide more than static web hosting. However, you get what 
you pay for (menaing dynamic hosting is much more expensive)

> In terms of 'dynamic' are we talking PHP style here, in replacement
> of or in conjunction with? Such as grabbing content from a mySQL
> database and using PHP to add it to web page(s).

Dynamic, in the context of Forrest, means that a live instance is 
running so any changes to your XDocs will immediately be reflected in 
your published site.

If you do "forrest run" on your project you will be running a dynamic 
instance of Forrest locally. See 
http://forrest.apache.org/docs_0_70/your-project.html#webapp

Forrest can be extended (when running in dynamic mode) to retireve 
content from other sources such as databases and process the data 
appropriately.

However, it has nothing to do with PHP. PHP is a programming language 
used for build dynamic sites, but it has no connection with Forrest 
(other than Forrest can skin the output of PHP applications if you want 
it to).

Ross

Re: deploy built website to your ISP (Was: Help with new templates)

["Gav...." <br...@brightontown.com.au>]

----- Original Message ----- 
From: "David Crossley" <cr...@apache.org>
To: <us...@forrest.apache.org>
Sent: Wednesday, August 03, 2005 9:20 AM
Subject: deploy built website to your ISP (Was: Help with new templates)

| When starting a new topic, please change the Subject.

Yep, no problem, apologies.

|
| > > | BTW there are some brave user to use them live. Diwaker is using 
them in
| > > | on his homepage. ;-)
| > > | http://floatingsun.net
| > >
| > > Is this on Diwakers' own web server or public?
|
| If you see it with your web browser, then it is public.

Ok, slip of the keyboard there, I meant is the site published on
a private (Home) server or a public (ISP) one.


|
| > >I was going to ask the question as I don't see it
| > > documented anywhere, how does
| > >anyone publish a forrest site to the web so it
| > >is available to all.
| >
| > The way *I* do it is to run forrest from the root of the seeded tree, in
| > my case in these emails it's .../cfas-new/, where you'll likely find the
| > src/ directory.
| >
| > >I have an apache web server running so it is not a
| > > problem, just wondered if
| > >this project was meant for intranet use only or
| > > if porting to an ISP web space
| > >was possible or a future goal.
| >
| > That's good.  What you'd want to do for a static site is give Apache
| > access to the build/site directory under the seeded tree, eg.
| > .../cfas-new/build/site/  There's probably an index.html file there that
| > Apache will be happy to serve.
|
| That is very dangerous. If you break your forrest
| build in any way, then your live web server is broken.
| Much better to separate the concerns. Build your
| site in one place, then deploy it to the server.
|
| > Another method is to copy the .../build/site/* tree
| > into the web root of a server.
|
| Gav, i am confused by your question, so i will try
| to answer what i think the question is.
|
| You have an account with an ISP, which provides a
| special directory to place a set of documents for
| your website (called the document root).
|
| You have Forrest installed on your office desktop.
| cd to the top of your forrest site (which is
| where the forrest.properties file lives).
| Do 'forrest' which generates the documents into
| build/site directory.
|
| Now you need to deploy the contents of build/site
| onto your ISP's webserver. That will entirely
| depend on how your ISP provides you access.
|
| One way would be to do it manually.
| cd build/site
| tar cf mysite.tar *
| gzip *.tar
| ... use 'scp' or 'ftp' or whatever method that
| your ISP provides to put that file onto your webserver.
| Then log in to your server and uncompress the
| archive into the document root of your webserver.
| Your ISP might even enable you to use ftp or scp
| to deploy the files straight into your document root
| without the gzip and followup login step. Another
| way would be to use 'rsync'.

Thanks for the above, I have uploaded using FTP
and the site works fine. FYI I am using the latest
0.8-dev version.

|
| How to do these manual methods is beyond the
| scope of Forrest project.

No problem.

|
| The best way to deploy your generated website
| is to use "forrestbot":
| http://forrest.apache.org/tools/forrestbot.html
|
| It has various different mechanisms for deployment.
| We use the "svn" deployment technique for the
| forrest.apache.org website. Our generated website
| is added to a Subversion repository, then on the
| server there is an outomated process which does
| cd to our document root, then 'svn update'.
|
| Forrestbot has other deployment methods such
| as ftp and scp, not yet using rsync but that
| would be possible to develop.

Sounds good, I will take a look at Forrestbot.

|
| Of course Forrest can also be used in dynamic mode.
| There are various ways to do this. One way is
| to cd to your forrest source top-level and do
| 'forrest war'. This creates a web application archive
| which you add to your ISP's servlet containers' webapps
| directory. (e.g. Tomcat or Jetty). How you do this
| is completely beyond the scope of the Forrest project.

I imagine, unless one is on first name terms with their ISP
that getting them to do that will be a bit blood/stone scenario,
I will set it up on my own server though and have a play.

In terms of 'dynamic' are we talking PHP style here, in replacement
of or in conjunction with? Such as grabbing content from a mySQL
database and using PHP to add it to web page(s).

Thanks for your help. Now I will get back to the validation problems.

Gav... 



-- 
No virus found in this outgoing message.
Checked by AVG Anti-Virus.
Version: 7.0.338 / Virus Database: 267.9.9/62 - Release Date: 2/08/2005