Versions Compared

Key

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

...

Code Block
$ cd gears/app
$ sudo cp -r tmp /var/cache/gears
$ sudo chown -R $HTTPUSER /var/cache/gears
$ sudo chmod 700 /var/cache/gears
$ mv tmp tmp.not
$ ln -s /var/cache/gears tmp

In order to integrate COmanage Gears with your authentication system, configure your Web server to protect the directory gears/app/webroot/auth/login. For example, under Apache you may place an .htaccess the file in that directory with contents similar to this:

Code Block

AuthType shibboleth
ShibRequestSetting requireSession 1
require valid-user

Database Server Setup

If you are using MySQL, use the InnoDB storage engine, not MyISAM. To set this as the default storage engine on a Unix-like system, add the following to /etc/my.cnf and restart mysql before setting up the database tables:

...

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.

Note

schema create is intended to be run once. If you need to run it again, the easiest approach is to drop the database and start over.

Initial Configuration

Run the initial configuration script:. Be sure to enter the username that will be returned by your web server's authentication engine. For example, under Apache this corresponds to $REMOTE_USER.

Code Block
$ cd cake/console
$ ./cake setup
Enter administrator's given name  
> Pat
Enter administrator's family name  
> Lee
Enter administrator's login username  
> plee@university.edu
Note

setup is intended to be run once. After you run it, you should be able to login via the web interface and make whatever changes you need that way. If you need to run it again, the easiest approach is to drop the database and start over.