Seaside Installation Instructions

Seaside Installation Instructions

 

Welcome to the Squeak page for installing the Seaside web framework. This page will show you how to install two different versions of Seaside in two different ways. The first is called 2.8.3 and is a little older and a little more stable. We will install that version using a package management tool called Monticello. The second is called 3.0 and is the latest version of Seaside. We will install that using a web page at http://builder.seaside.st.

 

Installing 2.8.3

 

1. Once you have opened Squeak, click on the background called the World. Select open and then Monticello Browser. In the top right corner of that window will be a symbol with two squares. Click that to open up the window to a more useful size.
2. Click on the +Repository button. Select HTTP. You will see a template. We need to change something there. Replace http://foo.com/bar with http://www.squeaksource.com/HttpKomServer. Press Accept. Before we install Seaside, we need to install a server that Seaside will use.
3. In the large, bottom right window ensure the repository you’ve just added is selected and then press Open.
4. In the small window that appears we will need to install three things: DynamicBindings; KomServices; and; KomHttpServer. It’s best to install these three packages in that order.
5. In the left hand pane click on DynamicBindings. Then in the right hand window click the topmost version. Then click Load. Do that also for KomServices and KomHttpServer.
6. Now lets use Monticello to install Seaside. Using the same instructions as above, create an HTTP repository aimed at http://www.squeaksource.com/Seaside. Then open it.
7. In the left hand pane of the window that appears find Seaside2.8a1 and select it. Then in the right hand window choose the topmost package. Press Load.
8. We’re almost done. Click on the World, select open, and choose Workspace. In that window write WAKom startOn: 8080. Highlight that. We need to tell Squeak to do it. On a Mac click Option+click to pull up the correct menu. On PC right click. Choose Do It.
9. WAKom is a mix of two titles. WA stands for Seaside. Kom stands for the Comamche server. Executing this command starts the server on port 8080.
10. Open a browser and go to http://localhost:8080/seaside.

 

Installing 3.0

 

1.     Go to http://builder.seaside.st

2.     Forgo all the options for now. Go to 3. and press Load Script. That will download a file called seaside-3.0.0-alpha5.cs.

3.     Open Squeak and drag that file onto the background called the World.

4.     Click “install into new change set”  and wait while it installs.

5.     Now follow steps 8-10 in the 2.8.3 instructions. Realize they don’t work. Go to the Process Browser. Kill the process. Try WAComancheAdaptor startOn: 8080. See that that fails as well. Conclude that Seaside 3.0 is either no longer compatible with Squeak 3.10.2 or there is some other way to make it work. Say screw it and go to Starbucks.

 

Thanks for the instructions - they helped!

Chris Cunnington wrote:
> Seaside Installation Instructions

>
> Installing 2.8.3
>
>  
>    2. Click on the +Repository button. Select HTTP. You will see a
>       template. We need to change something there. Replace
>       http://foo.com/bar with http://www.squeaksource.com/HttpKomServer.
>       Press Accept. Before we install Seaside, we need to install a
>       server that Seaside will use.

The address should be:

http://www.squeaksource.com/KomHttpServer

The rest works fine.

I've made an Installer script for it
(tested 4 Dec 2009 on a squeak 3.10.2-7179-basic.image from a Mac):


squeaksource := Installer repository: 'http://www.squeaksource.com'.

squeaksource project: 'KomHttpServer'.
squeaksource install: 'DynamicBindings'.
squeaksource install: 'KomServices'.
squeaksource install: 'KomHttpServer'.

squeaksource project: 'Seaside'.
squeaksource install: 'Seaside2.8a1'.

"Start server"
WAKom startOn: 8080.

"Stop Server"
WAKom stop.


Thanks again and keep up the good work.

        - Jeroen
        (the shy squeak evangelist)

I'm pleaded you found them useful. Thank you for correcting me. 

That should have said "pleased". And so it goes...

I am sorry to report that although the above script works ...
It also breaks Installer (in a way I haven't found out to resolve yet).

So use (the script) with care ...


        - Jeroen

Sorry to response to my own reply ...

But the post is incorrect. The script works. Installer works (also)
after that. Its just that you get an obscure msg on Transcript from
Installer when it doesn't find a package.

So the script works - for me.

Thanks for the instructions (again), Chris.

Where is the page (on the web) ?


        - Jeroen
        (the shy Squeak evangelist)


Jeroen van Hilst wrote:

" The script works. Installer works (also) 
after that. "

Yea, I tried it an it worked fine. Nice job.

"Where is the page (on the web) ?"

I don't think it's up yet. The link from seaside.st goest to squeak.org. 

Somebody running the Squeak site will put it up soon, I'd suppose. And then they'll tell Julian Fitzel. 

Also, you can see the movie on the Squeak Vimeo repository: 

http://vimeo.com/groups/squeak/videos/7853348