Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 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 5.2 or later is required. No special build options are currently required, other than support for whatever database you plan on using.

Warning
titlePCRE Bug May Cause Problems

There are known issues with earlier versions of the PCRE library that will cause COmanage Gears to be unable to set up its database tables. Version 6.6 and earlier are known to have problems, while versions 8.12 and later are known to work. You can check the version that PHP was built against by running this command:

php -r 'phpinfo();' | grep PCRE

If you are using an old version of PCRE, you'll first need to install a more recent version. Be sure to configure it with the --enable-utf8 --enable-unicode-properties flags. You'll then need to rebuild PHP against the newer version of the PCRE library.

Install Source

Download the COmanage Gears source files to your selected directory.

...

Use schema update to update an existing database.

Note

If you get the error message /path/to/app/config/schema/schema.php could not be loaded while trying to create the schema, you are running an old version of the PCRE library. See the warning earlier on this page for more information.

Configure Initial Administrator