From 064ac4ba6b06b6f1ca532749c785d4af5d8d2306 Mon Sep 17 00:00:00 2001 From: Liam McLoughlin Date: Mon, 15 Aug 2011 03:24:38 +0100 Subject: Add Gentoo README (not too different, for now) --- README | 19 +++++---------- README.debian | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 84 insertions(+), 13 deletions(-) create mode 100644 README.debian diff --git a/README b/README index 3a3c223..cceed2c 100644 --- a/README +++ b/README @@ -2,28 +2,21 @@ = Gentoaster README = ===================== -Foreword -======= -Right now I'm developing this on Ubuntu/Debian, so the following instructions are for those platforms. If you install the appropriate prerequisites, it will work on Gentoo too, of course. - - Prerequisites ============= php5-cli php5-dev php5-mysql -gearman-job-server +gearmand gearman-php-ext -qemu-utils -extlinux +qemu-img +syslinux sfdisk git websockify -There might be more, I'll update this list at some point. Install these as follows: sudo apt-get install php5-cli php5-dev php5-mysql gearman-job-server qemu-utils extlinux sfdisk git - -The Gearman PHP extension has to be installed manually, as follows: +PHP must be configured with mysqli support. The Gearman PHP extension has to be installed manually, as follows: wget http://pecl.php.net/get/gearman-0.7.0.tgz tar xvf gearman-0.7.0.tgz @@ -33,7 +26,7 @@ phpize make sudo make install -Add "extension=gearman.so" to your php.ini (probably /etc/php5/cli/php.ini) +Add "extension=gearman.so" to your php.ini (for both CLI and CGI if you have separate configs) Websockify can be installed as follows: @@ -48,7 +41,7 @@ cd /usr/share git clone http://git.overlays.gentoo.org/gitroot/proj/gentoaster.git Configure settings in config.php and web/config.php as appropriate Run php5 install.php as root -Configure a webserver of your choice to server the web folder on the address you specified +Configure a webserver of your choice (I'd recommend nginx with PHP-FPM) to server the web folder on the address you specified Running ======= diff --git a/README.debian b/README.debian new file mode 100644 index 0000000..3a3c223 --- /dev/null +++ b/README.debian @@ -0,0 +1,78 @@ +===================== += Gentoaster README = +===================== + +Foreword +======= +Right now I'm developing this on Ubuntu/Debian, so the following instructions are for those platforms. If you install the appropriate prerequisites, it will work on Gentoo too, of course. + + +Prerequisites +============= + +php5-cli +php5-dev +php5-mysql +gearman-job-server +gearman-php-ext +qemu-utils +extlinux +sfdisk +git +websockify + +There might be more, I'll update this list at some point. Install these as follows: sudo apt-get install php5-cli php5-dev php5-mysql gearman-job-server qemu-utils extlinux sfdisk git + +The Gearman PHP extension has to be installed manually, as follows: + +wget http://pecl.php.net/get/gearman-0.7.0.tgz +tar xvf gearman-0.7.0.tgz +cd gearman-0.7.0 +phpize +./configure +make +sudo make install + +Add "extension=gearman.so" to your php.ini (probably /etc/php5/cli/php.ini) + +Websockify can be installed as follows: + +cd /usr/share +git clone https://github.com/kanaka/websockify.git +ln -s /usr/share/websockify/websockify /usr/bin/websockify + +Installation +============ + +cd /usr/share +git clone http://git.overlays.gentoo.org/gitroot/proj/gentoaster.git +Configure settings in config.php and web/config.php as appropriate +Run php5 install.php as root +Configure a webserver of your choice to server the web folder on the address you specified + +Running +======= + +The installer will start the daemon for you automatically, but if you need to do this yourself later, run the following as root: + +/etc/init.d/gentoaster start + +The daemon MUST be ran as root for it to work, otherwise all builds will fail. + +Now that the daemon is running, you can try a build, using the sample client: + +php5 /usr/share/gentoaster/client.php /usr/share/gentoaster/configs/minimal.ini + +This will give you some output similar to the following: + +Job sent, handle was H:lucidity:3 - hash 6085655f187a8442f82c43ebf98e5fdb + +You can check on the status of that build by running the following: + +php5 /usr/share/gentoaster/status.php + +Where is the hash returned by client.php (for example 6085655f187a8442f82c43ebf98e5fdb) + +If the build is still running, you'll get a progress percentage. If it's finished, the return code and result message will be shown. + +If you've setup a webserver, you can also use the WebUI at the address you've configured -- cgit v1.2.3-65-gdbad