|
|
PieSoftwareInstallationSoftware Installation
- Retrieve your copy of Pie from whatever source you prefer. A good place to start looking for the latest version might be http://pie.ekkaia.org?page=DownloadPie
- Uncompress and un-tar the received TAR-archive.
- The archive contains a copy of the GNU general public license. You might be interested in giving it a careful look.
- The archive contains a directory named
pie/. This is the root directory for your actual installation of Pie, though not necessarily the so-called Document Root of your web server. You can place Pie into any directory or sub-directory of your web server's accessible web space.
- Change directories into
pie/ and locate directory var/. When unpacking the tar-archive, you probably did so using either your personal user account, root access or any other user. Usually, neither matches the UID of your web server, that is, the UID it assumes when running PHP scripts. However, Pie requires permission to create and write to files below var/. To make Pie happy, do one of the following:
- As root, (while residing in
pie/) type: chown -R <web> var where <web> stands for your web server's UID or user name.
- Being just the mortal user you unpacked your TAR-archive as, type: chmod -R go+rwx var to allow all users to write to
var. Depending on whether your GID matches that of the web server's, chmod -R g+rwx var might suffice.
- *Note that either option might cause noteworthy security leaks unless you use your web server's file system exclusively.* Luckily, Pie version 0.2 and later allows you to configure any of the directories and files below
var/ independently so you can actually put them anywhere you want or even move them outside the server's document root. Still, these directories and all files below need read/write permission to function properly.
- You may want to modify the content of file
index.html that comes with the archive to serve your personal preferences.
- Your installation is now ready for testing. Launch your favourite web browser, enter the respective domain name (if applicable) and path (if applicable) to access the file
pie.php. Called with no additional parameters, pie.php displays the system's home page, that is, a page called MainPage.
- Along with the basic software library comes this very documentation. To build these pages, which, for the sake of a small size of the distributed software archive, are included as sources only, build the output via pie.php?action=rebuild
|
