aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--README19
-rw-r--r--README.debian78
2 files changed, 84 insertions, 13 deletions
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 <handle hash>
+
+Where <handle hash> 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