Page History

...

Download the COmanage Registry source files somewhere into the file system. The location you put the files does not have to be the location from which the files are served by the web server. Create a symlink to the directory called registry-source (or something similar):

$ wget https://github.com/Internet2/comanage-registry/archive/0.9.23.tar.gz
$ tar xzf 0.9.23.tar.gz
$ ln -s comanage-registry-0.9.23 registry-source

Downloading the Latest Master

The master branch has the latest features that should be stable enough for use, but may not be feature complete. If you want the latest master, you can download it easily via svn:

$ svn co https://github.com/Internet2/comanage-registry/branches/master

You can also download the develop branch, which is usually more bleeding edge.

$ svn co https://github.com/Internet2/comanage-registry/branches/develop

...

Configure your web server to deliver the registry at a suitable URL such as https://some-vo.org/registry. A simple strategy to accomplish this when running under the Apache web server is to create a symlink in the DocumentRoot named registry that points to the directory .../registry-source/app/webroot:

$ cd /var/www
$ ln -s /path/to/registry-source/app/webroot registry

...

You'll most likely want to move the registry-source/app/tmp directory, since it is bad practice to have writable directories on the file system delivering web content. A reasonable alternative would be /var/cache/registry. The easiest way to do this on a Unix-like system is to create a symlink to the new directory.

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

...

In order to integrate COmanage Registry with your authentication system, configure your Web server to protect the directory registry/app/webroot/auth/login. For example, under Apache your configuration may look something like

DocumentRoot /var/www
<Directory /var/www/registry/auth/login>
  AuthType shibboleth
  ShibRequestSetting requireSession 1
  require valid-user
</Directory>

...