Some changes were made to the development environment in order to:
- Add git/github
- 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.
Update framework settings
yum --enablerepo=clearos-updates-testing,clearos-developer upgrade
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:
Update the Apache configlet
svn update ~/clearos/webconfig/framework
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 \
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:
\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:
If all you need to see is your own app, then your .clearos configuration should have a single entry:
\clearos\framework\Config::$apps_paths = 'my_apps';
to whatever subdirectory in your home directory contains your app source code.
If you ever need to use the development versions of the framework, you can find the document on the topic here: