[BUG][DOC] Setting up Linux Squeak 2.8a with PWS Swiki and Crashing HOWTO

Mark A. Schwenk mas at wellthot.com
Tue Jun 13 13:12:11 UTC 2000


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.





More information about the Squeak-dev mailing list