[[TranslatedPages]] [[PageOutline]] = Control Panel (Red) Admin/Hacking Overview = Red is a system designed to allow non-technical users to easily make system changes to servers running Linux via a web interface. Most of red is PHP code libraries designed to be extended by a programmer, not used out of the box. If you are looking for a turnkey solution, this is probably not for you. On the other hand, if you are looking for a way to give your users web access to modify settings on your server that require root privileges and you don't want to change the way your servers are configured to work with a monolithic control panel system you may be interested in Red. There are three parts to an installation that uses Red: 1. MySQL database. There is one central database containing all the settings used by Red. For a network of servers, all servers need access to this database. 1. UI machine. This machine runs the web application that allows users to add/edit/delete configuration settings, and stores those settings in the MySQL database, and notifies node servers that they have pending changes. 1. Node machines. There can be one or more machines. These machines are configured to check the central MySQL database to see if there are any pending requests, execute the requests, and update the status of the request in the database. The following pages go into more detail about how these elements work together: * The [wiki:control-panel/hacking/network network diagram] shows the relationship between various services. * The [wiki:control-panel/hacking/database database schema] provides a simple representationship between the tables in the database. * The [wiki:control-panel/hacking/object object diagram] shows the class inheritance of the main classes used in red. * The [wiki:control-panel/hacking/directories directories overview] provides a road map to the directory structure of the code. * The [wiki:control-panel/hacking/state-transition state transition] describe the typical states for items created by the database. * The [wiki:control-panel/hacking/install installation document] provides directions for how to install red. You can download the code via git with: {{{ git clone git://git.mayfirst.org/mfpl/red }}} Or, if you have write access: {{{ git clone gitolite3@git.mayfirst.org:mfpl/red }}}