Hi everyone,

Some changes were made to the development environment in order to:

- Add git/github support
- Provide a migration path to github (which is happening post ClearOS 6.5.0)
- Provide a stable version of the framework (no more "SVN trunk")

Under the hood, the default engine is switching from using the development framework & theme in SVN (typically exported to ~/clearos/webconfig) to the live framework & theme version in /usr/clearos. It's not a big change, but it is one that requires some manual changes detailed below.

Sorry for the hassle, but these changes will prevent such annoyances in the future! If you have any problems, please contact me.

Upgrade to the latest ClearOS version

First, you need to upgrade your development system to the latest ClearOS release: 6.5.0 (beta)
If you don't want to upgrade right now, that's fine too of course.

yum --enablerepo=clearos-updates-testing,clearos-developer upgrade

Update framework settings

Most of you probably want to start using the stable version of the framework instead of SVN trunk. If you want to move to the stable version, remove the references to the CLEAROS_BOOTSTRAP environment variable in ~/.bash_profile. You will need to re-login, or unset the environment variable after making the change.

If you want to continue use the bleeding edge framework in SVN, leave the CLEAROS_BOOTSTRAP environment variable as is. However, you need to update to the latest framework version in SVN trunk:

svn update ~/clearos/webconfig/framework

Update the Apache configlet

Using your regular user account (not root), update the Apache configlet. Make a backup just in case you need to review it:

sudo cp /usr/clearos/sandbox/etc/httpd/conf.d/devel.conf \

   /usr/clearos/sandbox/etc/httpd/conf.d/devel.conf.bak

clearos -w setup

The "clearos -w setup" command resets the /usr/clearos/sandbox/etc/httpd/conf.d/devel.conf file so that the default framework and theme are used.


Create/update your ~/.clearos configuration

If you want to keep the development/SVN versions of the ClearFoundation and ClearCenter apps / themes in your environment, your .clearos file should look like:

<?php 

\clearos\framework\Config::$apps_paths[] = 'clearcenter/webconfig/apps';

\clearos\framework\Config::$apps_paths[] = 'clearos/webconfig/apps';

\clearos\framework\Config::$theme_paths = array('clearos/webconfig/themes');

After making necessary changes to .clearos, you need to reload webconfig with the new path information:

clearos reload

If all you need to see is your own app, then your .clearos configuration should have a single entry:

<?php 

\clearos\framework\Config::$apps_paths[] = 'my_apps';

Change my_apps to whatever subdirectory in your home directory contains your app source code.


Framework Development

If you ever need to use the development versions of the framework, you can find the document on the topic here:

http://www.clearfoundation.com/docs/developer/framework/tutorials/framework_development_version