The CakePHP project has finally announced tentative plans to EOL the 2.x series of the framework. This will require a fairly substantial rewrite of significant portions of the current code base. This will also provide the opportunity to address some long-standing issues. The current proposal is to perform this migration during 2018, with the resulting release being Registry v4v5.0.0 (though subject to change, and in the interim referred to as Registry PE). Registry v4.0.0 will be an interim release for any migrations that must be performed prior to the v5.0.0 migration.
- Master Ticket: CO-1073
- JIRA 45.0.0 Issues
- Framework Migration Scoping
- Registry PE Progress Tracker (currently developer access only)
Setting Up a Registry PE Development Environment
Registry PE has basically the same requirements and installation process as Match. Since Registry PE documentation has not yet been written, start with Match and muddle your way through.
- PHP: v7.0.10 or greater is required. PHP v5.x is not supported.
- Apache: Apache configuration is more or less the same as Match. For the moment, Registry PE can be delivered from the same virtual host as Registry (but at, say
/registry-peinstead), though this may change. - Database: Postgres and MySQL/MariaDB remain supported, but cross database testing at the moment is limited. You are more likely to run into problems with MySQL/MariaDB. There may be a minimum version requirement of Postgres 9.6 (depending on where the database management layer work goes).
- Source: Available from https://github.internet2.edu/COmanage/registry/tree/develop
A new database (schema/tablespace) will be required. Registry PE will not use the same database or tables as Registry.
The setup script is not yet fully implemented, and authentication is not yet implemented.
After downloading the source, create a /local directory (like Match) and set up logs and tmp (again like Match) underneath. Also create /local/Config and create a database.php underneath. Set up the default Datasource as usual, this will be the new operational Registry PE database. In addition, if you wish to load data from a Registry instance, create an additional Datasource called transmogrify with the appropriate connection information.
Run ./bin/cake setup to create the initial salt file. Then run ./bin/cake database to create the initial tables.
If you wish to load existing data, the tables in the default schema must be completely empty. If you created any test records, DELETE FROM each appropriate table. When ready, run ./bin/cake transmogrify to transfer your data.
Since the menuing is not yet implemented, you need to directly access whatever controller you wish to work with (eg: /registry-pe/cos).