File	Date	Author	Commit
cgi	2012-07-31	LaKing	[cdcb97] 0.3.5 small fixes, review code design
class	2012-07-31	LaKing	[cdcb97] 0.3.5 small fixes, review code design
css	2012-07-31	LaKing	[325982] 0.3.5 small fixes, review code design
fn	2012-07-31	LaKing	[cdcb97] 0.3.5 small fixes, review code design
i18n	2012-05-25	LaKing	[775ea0] =First commit of code that is already written.
inc	2012-07-31	LaKing	[cdcb97] 0.3.5 small fixes, review code design
js	2012-07-31	LaKing	[325982] 0.3.5 small fixes, review code design
log	2012-07-28	LaKing	[54775a] 0.3.4 more updates on mysql and system design
lxc	2012-05-25	LaKing	[775ea0] =First commit of code that is already written.
maintab	2012-07-30	LaKing	[6b2e70] 0.3.5 small fixes, review code design
plugins	2012-05-25	LaKing	[775ea0] =First commit of code that is already written.
favicon.ico	2012-05-30	LaKing	[4eb017] fixed issues by adding a filter to shell-exec
includes.php	2012-07-27	LaKing	[eab753] 0.3.4 more updates on mysql and system design
index.php	2012-07-27	LaKing	[eab753] 0.3.4 more updates on mysql and system design
license.txt	2012-05-25	LaKing	[775ea0] =First commit of code that is already written.
login-page.php	2012-07-29	LaKing	[85a555] 0.3.5 works on user management
main.php	2012-07-27	LaKing	[eab753] 0.3.4 more updates on mysql and system design
phpinfo.php	2012-05-25	LaKing	[775ea0] =First commit of code that is already written.
readme.txt	2012-07-12	LaKing	[fa7cdc] inline commit
todo.txt	2012-07-24	LaKing	[38b483] 0.2.9 added Fedora 17, working on openvpn
turm-settings.sample.php	2012-07-28	LaKing	[cfb039] 0.3.4 mysql-user integration with system users ...
version	2012-08-01	LaKing	[ead587] 0.3.5 fixes.

Read Me

Turm - The *nix remote manager. - D250 Laboratories - Open Source Software. (License not decided yet)

2012 - István Király - LaKing@D250.hu

Developers welcome!

https://sourceforge.net/p/turm

This application was developed under linux and is intended to be used on Linux.
In this readme, I assume you use a red-hat family distro, with yum as package manager.
Windows systems might be accessed thru freesshd.com tho.

Components of this application:
- PHP code with the use of MySQL query's
- jQuery, JQGrid, javascript
- Shell in a Box
- LXC


Installation notes.

First of all, a running webserver enviroment is needed.(LAMP)
Linux, Apache, PHP, MySQL, with the default settings should be fine.
These should be provided by the operating system's package manager.

PHP needs to be ssh-enabled. (http://www.php.net/manual/en/ssh2.installation.php)
SIAB needs to run as CGI.

yum -y update
yum -y install httpd php mysql-server php-pecl-ssh2


To configure this application, use the turm-settings.php file.
You can create your own based on the sample. 
turm-settings.php by default, should be located in the folder where turm-code, turm-data, turm-logs reside. ( /srv ?)


### LXC

Recommended is to install a recent version of lxc, with libvirt.
http://lxc.sourceforge.net/

CAUTION!!! So close to the kernel, if something gets messed up, the host may reboot, get unresponsive, hang, or go down completely ...

To verify your lxc installation use the command:
$ lxc-checkconfig

I use CentOS / fedora, this thread might be useful:
http://forums.fedoraforum.org/showthread.php?t=272995

Other wise, Turm, the application itself does not require any installation, it install's everything it need's on the fly, on demand.






### Detailed Installation details for Fedora 17 64 bit (for developers)

Install the default fedora. As root execute the following commands:

yum -y update
yum -y install mysql-server phpMyAdmin libcap-devel libvirt sshd httpd mc
yum -y groupinstall "Development tools"

To set the mysql root password, run the mysql_secure_installation command.


git-clone git://lxc.git.sourceforge.net/gitroot/lxc/lxc
cd lxc
./automake.sh
./configure
make
make install

lxc-checkconfig


In the desired folder, like your home folder, or /srv: 

git clone git://git.code.sf.net/p/turm/code turm-code
git config remote.origin.url "ssh://laking@git.code.sf.net/p/turm/code"
git config --global user.name "Your Name"
git config --global user.email you@example.com

mkdir turm-data
mkdir turm-logs

gedit turm-code/turm-settings.sample.php
.. save it next to the turm-code folder.

Start the apache httpd daemon, pointing to turm-code as document root.
Adjust access rights as you wish.

Make sure the SIAB cgi script is executable, and properly installed.
Currently this packega comes with shellinaboxd compiled for x86_64 systems.

Turn on, and start the sshd, httpd, mysqld services.

Check firewall and selinux settings.

At this point you may run the application.
- make sure you can access localhost or any other server vie SIAB