Developers Documentation

×

Warning

301 error for file:https://clearos.com/dokuwiki2/lib/exe/css.php?t=dokuwiki&tseed=82873f9c9a1f5784b951644363f20ef8

User Tools

Site Tools


Tutorials Framework Development

By default, the ClearOS development environment uses the latest stable release of the framework and theme. From time to time, you may find that you need to use a bleeding edge feature that requires the development version. This document describes how to configure such an environment.

Webconfig Configuration

In order to enable the development version of the framework, you need to change the some lines in the Apache configlet file /usr/clearos/sandbox/etc/httpd/conf.d/devel.conf:

  • Change the DocumentRoot to point to the SVN/git version of the framework
  • Set the CLEAROS_BOOTSTRAP environment variable

Here is an example to use as a guideline:


  # DocumentRoot /usr/clearos/framework/htdocs   <-- comment out
  SetEnv CLEAROS_CONFIG /home/devuser/.clearos
  
  # For framework development only
  DocumentRoot /home/devuser/framework/htdocs
  SetEnv CLEAROS_BOOTSTRAP /home/devuser/framework/shared
  
  ... snip ...

Please don't forget to change devuser to your own username, and to change the path to the location of the git/SVN version of the framework. Restart webconfig and you should see the framework status at the top of a webconfig page change to Development.

ClearOS Development Status

CLI Configuration

For command line scripts, the CLEAROS_BOOTSTRAP environment variable is used. In your ~/.bash_profile, add the following:

 CLEAROS_BOOTSTRAP=/home/devuser/clearos/webconfig/framework/trunk/shared
 export CLEAROS_BOOTSTRAP

Again, please don't forget to change devuser to your own username, and to change the path to the location of the git/SVN version of the framework!

content/en_us/dev_framework_tutorials_framework_development.txt · Last modified: 2015/02/28 13:35 (external edit)

https://clearos.com/dokuwiki2/lib/exe/indexer.php?id=content%3Aen_us%3Adev_framework_tutorials_framework_development&1710849020