Page History

Installation Steps

1. PHP
2. Web Server
3. Download and Install Source
4. Database
5. Email
6. Registry Setup Script
7. Cron
8. Testing

9. Setting Up Your First CO

10. QA and Production Tiers
11. High availability (HA) considerations

Troubleshooting

• The directory registry-source/ contains a .htaccess with necessary mod_rewrite directives. Not all Apache configurations by default allow configuration options within .htaccess files. Be sure that your Apache configuration has the necessary AllowOveride configuration to allow that .htaccess file to be processed (this is not the default on Debian Squeeze and other Linux distributions).
• Following an upgrade, failure to login due to Auth.User.name doesn't exist may be due to caches that need to be cleared.
• Messages like Warning (2): preg_match(): Compilation failed: unknown option bit(s) set at offset -1 [CORE/Cake/Utility/Validation.php, line 782] are indicative of a bad version of PCRE, described above.

Gears Components

While the architecture of COmanage Gears describes three separate components of COordinate (the backend system), COnsole (the web UI), and the REST COnnectors (for XML and JSON data transfers), the actual implementation is based on an MVC framework called CakePHP. As such, the technical implementation consists of one package, where the boundaries separating these three components is somewhat fuzzy. Roughly speaking, COnsole can be thought of as the HTML views and the REST COnnectors can be thought of as the XML and JSON views. While not strictly correct, this conceptualization is adequate for installation.

Prerequisites

While Comanage Gears is designed to work in a LAMP environment, the only required component is PHP. Other modern operating systems, web servers, and databases should all work. Configuration of these prerequisites is generally beyond the scope of this documentation.

PHP

PHP 5.2 or later is required. No special build options are currently required.

Web Server Setup

The web server should operate under SSL. Make sure the server is capable of rendering PHP.

Install the COmanage Gears directory wherever you like, and configure your web server to deliver it at a suitable URL (such as https://site.edu/gearsImage Removed or https://gears.site.eduImage Removed).

You should verify that the web server will not deliver unprocessed files, especially configuration files such as the database configuration file (ie: https://site.edu/gears/app/config/database.phpImage Removed). By default, these files will not be delivered.

Install Source

Install the COmanage Gears source files to your selected directory.

$ svn co http://anonsvn.internet2.edu/svn/gears/tags/0.1
$ mv 0.1 $INSTALL_DIR

Database Server Setup

Create a new database for COmanage Gears. You can name the new database whatever you like. Set the configuration information, including the password to connect to the database with, in app/config/database.php.

Set up the database schema by XXX

...