My first Pancake

pp3345 edited this page Apr 1, 2013 · 12 revisions

You want to install and use Pancake. That's a good decision. But how? This is a small tutorial on how to get started with Pancake.

Step 1: Meet the system requirements

Pancake needs three things to unfold its good taste: Linux, PHP and DeepTrace.

Linux

You can basically use any Linux distribution (for example Debian) for Pancake. If you don't want to use Linux at all, Pancake might also run under BSD or Darwin, but those systems are not officially supported. Under Microsoft Windows it won't work at all due to its missing POSIX-compliance.

PHP

For Pancake you need at least PHP 5.4.0, although PHP 5.4.10 or newer is recommended. The PHP-binary has to be compiled with the configure options "--enable-toenizer --enable-posix --enable-ctype". In most cases, any PHP you'll find in your operating system's repositories was compiled with these options, so you don't need to worry about recompiling PHP yourself.

Installing PHP from the OS's software repositories is easy.

Under Debian, Ubuntu, Mint (or any other apt-supporting distribution) just run

sudo apt-get install php5-cli

Some operating systems only provide quite old versions of PHP. In this cases it might be a good idea to look for other repositories. For apt-supporting distributions (like Debian) you might use Dotdeb. After having added the repository just run the command above. If you don't find any repositories with current PHP-versions you can either use the old version provided by your system's repository or you can compile PHP yourself. I won't describe here how to compile PHP as that would go too deep. You'll find tutorials on the WWW.

DeepTrace

DeepTrace is an extension for the Zend Engine, the core of the PHP interpreter. It allows Pancake things like deleting functions or setting thread titles. Things that are needed to provide a clean SAPI for PHP. DeepTrace is bundled with Pancake for x86, x86_64 and ARM processors.

Step 2: Download and install Pancake

Over at pancakehttp.net you will always find the current Pancake release version. Download this version either using your browser or wget.

After having downloaded Pancake as a tarball or zipball open a shell in the directory you've downloaded Pancake to and run the following commands:

tar -zxvf pp3345-Pancake-* for tarballs or unzip pp3345-Pancake-* for zipballs

cd pp3345-Pancake-*

sudo mkdir /usr/local/Pancake

sudo cp -r * /usr/local/Pancake

cd /usr/local/Pancake/sys

sudo chmod +x pancake.sh

It is recommended to use the official Pancake init script for Debian-based systems. See README.md for further instructions.

Step 3: Start Pancake for the first time

When using the init script, run sudo /etc/init.d/pancake start. Else run the command sudo /usr/local/Pancake/sys/pancake.sh.

Now you can open your browser and go to http://localhost/ (or your servers IP address if you've installed Pancake on a remote server) and look at the amazing "Welcome to Pancake!" screen. :-)