Difference between revisions of "Introduce a new developer to Organic Design"

From Organic Design wiki
(from ewg.od)
 
m
Line 5: Line 5:
  
 
== Organic Design Servers ==
 
== Organic Design Servers ==
All our servers are installed with the [[OD:Install a new server|install a new server procedure]] which starts with the installation of the [[OD:Organicdesign-server|organicdesign-server package]] and then takes you through configuration of Apache/PHP/MySQL and our [[OD:OD/Wikia|Wikia structure]]. After that a number of other more specific procedures can be carried out which are described below.
+
All our servers are installed with the [[OD:Install a new server|install a new server procedure]] which starts with the installation of the [[organicdesign-server package]] and then takes you through configuration of Apache/PHP/MySQL and our [[OD/Wikia|Wikia structure]]. After that a number of other more specific procedures can be carried out which are described below.
  
 
== Organic Design Procedures ==
 
== Organic Design Procedures ==
The most important set of procedures is the [[OD:Category:Sysop procedures|sysop procedures]], and out of these the most key ones are:
+
The most important set of procedures is the [[sysop procedures]], and out of these the most key ones are:
*[[OD:Configure mail server|Configure mail server]] ''- Exim4 MTA with Spamassassin, Dovecot IMAP server and Roundcube webmail''
+
*[[Configure mail server]] ''- Exim4 MTA with Spamassassin, Dovecot IMAP server and Roundcube webmail''
*[[OD:Configure LAN|Configure LAN]] ''- DHCP server and firewall for LAN based servers''
+
*[[Configure LAN]] ''- DHCP server and firewall for LAN based servers''
*[[OD:Configure DNS|Configure DNS]] ''- LAN/Server based DNS and dynamic DNS solutions''
+
*[[Configure DNS]] ''- LAN/Server based DNS and dynamic DNS solutions''
*[[OD:Configure SMB|Configure SMB]] ''- Samba file shares''
+
*[[Configure SMB]] ''- Samba file shares''
*[[OD:Configure VPN|Configure VPN]] ''- Remote access to file shares and other LAN resources''
+
*[[Configure VPN]] ''- Remote access to file shares and other LAN resources''
*[[OD:Configure IRC|Configure IRC]] ''- Run a chat channel, your bot can publish notifications to the channel''
+
*[[Configure IRC]] ''- Run a chat channel, your bot can publish notifications to the channel''
*[[OD:Configure SVN|Configure SVN]] ''- Set up Subversion repositories, web-svn and client svn access''
+
*[[Configure SVN]] ''- Set up Subversion repositories, web-svn and client svn access''
  
 
== Organic Design Code ==
 
== Organic Design Code ==
Our Subversion repos at [http://svn.organicdesign.co.nz/ svn.organicdesign.co.nz] contain all our code, only the ''extensions'' and ''tools'' repo's are active. The ''extensions'' repo contains all the [[MW:User:Nad|MediaWiki extensions we maintain]] which are not popular enough to be in the official [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ MediaWiki repo]. See the [[OD:Configure SVN|configure SVN procedure]] for details about our Subversion setup and how to access it. The ''tools'' repo contains all our server tools and robot framework mainly written in Perl. Here's a quick run down of the important scripts and files:
+
Our Subversion repos at [http://svn.organicdesign.co.nz/ svn.organicdesign.co.nz] contain all our code, only the ''extensions'' and ''tools'' repo's are active. The ''extensions'' repo contains all the [[MW:User:Nad|MediaWiki extensions we maintain]] which are not popular enough to be in the official [http://svn.wikimedia.org/viewvc/mediawiki/trunk/extensions/ MediaWiki repo]. See the [[Configure SVN|configure SVN procedure]] for details about our Subversion setup and how to access it. The ''tools'' repo contains all our server tools and robot framework mainly written in Perl. Here's a quick run down of the important scripts and files:
 
*[http://svn.organicdesign.co.nz/filedetails.php?repname=tools&path=%2Fadd-db add-db] ''- a script for adding a new MediaWiki database to MySQL from a template database dump''
 
*[http://svn.organicdesign.co.nz/filedetails.php?repname=tools&path=%2Fadd-db add-db] ''- a script for adding a new MediaWiki database to MySQL from a template database dump''
 
*[http://svn.organicdesign.co.nz/filedetails.php?repname=tools&path=%2Fdovecot-cert.sh dovecot-cert.sh] ''- create/update the self-signed cert for the local Dovecot installation''
 
*[http://svn.organicdesign.co.nz/filedetails.php?repname=tools&path=%2Fdovecot-cert.sh dovecot-cert.sh] ''- create/update the self-signed cert for the local Dovecot installation''
Line 28: Line 28:
  
 
== Useful links about Organic Design in general ==
 
== Useful links about Organic Design in general ==
*[[OD:Organic Ontology|Organic Ontology]] ''- trees, mindmaps and diagrams showing all the aspects of OD''
+
*[[Organic Ontology]] ''- trees, mindmaps and diagrams showing all the aspects of OD''
*[[OD:Manifesto]] ''- our goals and philosophy''
+
*[[Manifesto]] ''- our goals and philosophy''
 
*[https://ewg.organicdesign.co.nz/files/5/51/Ra_project.ogv Screencast example of RecordAdmin usage]
 
*[https://ewg.organicdesign.co.nz/files/5/51/Ra_project.ogv Screencast example of RecordAdmin usage]

Revision as of 02:45, 28 January 2010

Procedure.svg Introduce a new developer to Organic Design
Organic Design procedure

Organic Design Servers

All our servers are installed with the install a new server procedure which starts with the installation of the organicdesign-server package and then takes you through configuration of Apache/PHP/MySQL and our Wikia structure. After that a number of other more specific procedures can be carried out which are described below.

Organic Design Procedures

The most important set of procedures is the sysop procedures, and out of these the most key ones are:

Organic Design Code

Our Subversion repos at svn.organicdesign.co.nz contain all our code, only the extensions and tools repo's are active. The extensions repo contains all the MediaWiki extensions we maintain which are not popular enough to be in the official MediaWiki repo. See the configure SVN procedure for details about our Subversion setup and how to access it. The tools repo contains all our server tools and robot framework mainly written in Perl. Here's a quick run down of the important scripts and files:

  • add-db - a script for adding a new MediaWiki database to MySQL from a template database dump
  • dovecot-cert.sh - create/update the self-signed cert for the local Dovecot installation
  • jobs - specialised jobs can be created which run in the background
  • firewall.sh - template for a basic firewall for LAN-based servers
  • wiki.pl - our script for interacting with MediaWiki's via HTTP
  • wikid.pl - our main robot/daemon script, see wiki daemon for more detail
  • wikid.conf.sample - sample configuration file for Wikia/robot framework

Useful links about Organic Design in general