Here's a complete step-by-step guide for building a Squeak 2.8a system and crashing it
by starting PWS.
Following is a step by step guide to setting up a Squeak 2.8a system on Linux and
crashing it by starting up PWS Swiki. It is pretty much the same for any other flavor
of UNIX, but I happen to be running RedHat Linux 6.2 on an Intel Pentium II system.
When you succeed in correctly installing Squeak 2.8a and starting PWS Swiki, you will
receive the following:
Segmentation fault
1086363076 Socket>listenOn:backlogSize:
1086358980 ConnectionQueue>listenLoop
1086359500 [] in ConnectionQueue>initPortNumber:queueLength:
1086359592 [] in BlockContext>newProcess
Setting up Linux Squeak 2.8a with PWS Swiki and Crashing HOWTO
You too can be a test pilot!
1. Downloading the software
1.1 Login to your system.
1.2 Download to your home directory Ian's Piumarta's source for the Squeak 2.8a VM from
ftp://ftp.inria.fr/INRIA/Projects/SOR/users/piumarta/squeak/Squeak-2.8a-src.tar.bz2
1.3 Download to your home directory the generic SqueakV2.sources file from
ftp://ftp.inria.fr/INRIA/Projects/SOR/users/piumarta/squeak/SqueakV2.sources.gz
1.4. Download to your home directory the latest Squeak 2.8 files from
ftp://st.cs.uiuc.edu/pub/Smalltalk/Squeak/2.7/files/
The latest archive at the time of this writing was
ftp://st.cs.uiuc.edu/pub/Smalltalk/Squeak/2.7/files/Squeak2.8a-2299.zip
1.5 Download to your home directory the PWS server files from
http://guzdial.cc.gatech.edu/st/server.tar
2. Building the UNIX VM
2.1 Create and change to the build directory by executing the following commands
$ mkdir ~/squeakvm
$ cd ~/squeakvm
2.2 Unpack the source archive by executing the following commands
$ bunzip2 <../Squeak-2.8a-src.tar.bz2 | tar xf -
2.3 Build the binaries by entering the following command
$ make
3. Setting up the Squeak execution directory
3.1 Create a directory as follows
$ mkdir ~/squeak
3.2 Copy the binaries created in 2.3 by executing the following commands
$ cp ~/squeakvm/2.8a/i686-pc-linux-gnu/squeak ~/squeak
$ cp ~/squeakvm/2.8a/i686-pc-linux-gnu/*.so ~/squeak
3.3 Unpack the sources file downloaded in 1.3 as follows
$ cd ~/squeak
$ gunzip <~/SqueakV2.sources.gz >SqueakV2.sources
If this fails, your web browser may have decompressed the file for you, as Netscape
Navigator did for me. In that case just
$ cp ~/SqueakV2.sources ~/squeak
3.4 Unpack the Squeak changes and image archive downloaded in 1.4 as follows
$ unzip ~/Squeak2.8a-2299.zip
4. Setting up PWS Swiki
4.1 Unpack the server archive downloaded in 1.5 as follows
$ cd ~/squeak
$ tar xf ~/server.tar
4.2 List your files to ensure they are all present.
$ ls
total 27136
-rwxrwxr-x 1 mas mas 35202 Jun 13 06:51 Profiler.so
drwxrwxr-x 6 mas mas 4096 Sep 22 1998 Server
-rwxrwxr-x 1 mas mas 71495 Jun 13 06:51 SoundCodecPrims.so
-rw-rw-r-- 1 mas mas 12578238 Jun 7 11:10 Squeak2.8a-2299.changes
-rw-rw-r-- 1 mas mas 8210796 Jun 7 11:10 Squeak2.8a-2299.image
-rwxrwxr-x 1 mas mas 161798 Jun 13 06:51 Squeak3D.so
-rw-rw-r-- 1 mas mas 5602467 Jun 13 07:04 SqueakV2.sources
-rwxrwxr-x 1 mas mas 17565 Jun 13 06:51 System.so
-rwxrwxr-x 1 mas mas 1037844 Jun 13 06:51 squeak
4.2 Start Squeak by executing the following
$ ./squeak Squeak2.8a-2299.image
4.3 Initialize the web server by executing the following in a workspace
PWS initializeAll.
An error dialog will appear--click ok. A method browser will then appear. Change the
method text as appropriate for your system and save it. For my system it is this
serverDirectory
^'/home/mas/squeak/Server/'
Once you have save your changes, execute in a workspace the following command again
PWS initializeAll.
4.4 Create a new swiki by executing the following in a workspace
SwikiAction setUp: 'myswiki'.
4.5 Save your image.
4.6 Prepare to startup PWS Swiki
4.7 Startup PWS Swiki and crash by executing the following in a workspace
PWS serveOnPort: 8080 loggingTo: 'log.txt'.
5. Epilog
Had it not crashed, you would have been able to browse to
http://localhost:8080/myswiki.1
The process is similar for a 2.7 Squeak system, but does not crash.
