Documentation
Tutorial: Deploying Pier
This tutorial describes how to deploy Pier on a Debian Linux distribution (Mac OS X users please refer to Pier headless on Mac OS X). It assumes that you have a pier.image
image that you want to install on a Debian Linux installation with Apache 2 under a domain called www.YOURDOMAIN.com
.
Start up
- Download the Pier one click image
- Copy to the
/srv/site
folder the followings:-
pier.image
, -
pier.changes
, -
files/
folder, and -
Pharo10.sources
.
-
- You can run the image headless by using the following bash script:
#!/bin/bash #settings USER="www-data" VM="/usr/bin/squeakvm" VM_PARAMS="-mmap 200m -vm-sound-null -vm-display-null" IMAGE="pier.image" #start the vm "$VM" $VM_PARAMS "$IMAGE" &
Setting up Apache2
- Make sure that
mod_proxy
andmod_rewrite
are installed and are enabled - Go to
/etc/apache2/sites-available
and create the following configuration:
<VirtualHost> # set serer name ProxyPreserveHost On ServerName www.YOURDOMAIN.com # connfigure static file serving DocumentRoot /srv/site/files <Directory /srv/site/files> Order deny,allow Allow from all </Directory> # rewrite incoming requests RewriteEngine On RewriteRule ^/pier(.*)$ http://www.YOURDOMAIN.com$1 [redirect,last] RewriteRule ^/files/(.*)$ http://localhost:8080/files/$1 [proxy,last] RewriteCond /srv/site/files/%{REQUEST_FILENAME} !-f RewriteRule ^/(.*)$ http://localhost:8080/pier/$1 [proxy,last] </VirtualHost>
- Go to
/etc/apache2/sites-enabled
and make a soft link to your configuration
Configuring Seaside
- Edit the configuration of the Pier application located in the /config:
- Set the Server Hostname to:
http://www.YOURDOMAIN.com
- Set the Server Path to:
/
- Set the Base Path to:
/
- Set the Server Hostname to:
- Set the Deployment Mode to
true
Make Pier work with Apache2
Set the baseURL to: http://www.YOURDOMAIN.com