= OSSIE Updater =

The [wiki:OSSIEUpdater OSSIE Updater] utility is useful for keeping local source versions up to date.

== Usage ==

Check out the utility via subversion from [source:scripts],
{{{
$ svn co https://ossie.wireless.vt.edu/repos/ossie/scripts
}}}

Move to the directory and run the updater once with no arguments:
{{{
$ python OSSIEUpdater.py
}}}

This creates the default configuration xml file {{{ossieupdater.cfg.xml}}} which you can edit to match your directory structure.  The configuration should be fairly straightforward.

Now you may run the updater on specific modules (framework, components, nodes, etc.).  To update the framework, for example, simply run
{{{
$ python OSSIEUpdater.py --framework
}}}

A list of all options are displayed below

||  -v, --version             || Write UpdateOSSIE version ||
||  --initialize              || Create default configuration file ||
||  -a, --a                   || All, equivalent to -cdfnopsSw ||
||  -f, --framework           || [source:ossie OSSIE core framework] ||
||  -S, --standardinterfaces  || [source:standardInterfaces Standard Interfaces] ||
||  -p, --platform            || [source:platform Platform] ||
||  -s, --sigproc             || SigProc, signal processing library ||
||  -d, --domain              || [source:platform/domain Domain] ||
||  -n, --nodes               || [source:nodes Nodes] ||
||  -c, --components          || [source:components Components] ||
||  -w, --waveforms           || [source:waveforms Waveforms] ||
||  -o, --owd                 || [wiki:OWD OSSIE Waveform Developer] ||
  
== Configuration ==

The OSSIE Updater tool is configured through the {{{ossieupdater.cfg.xml}}} file.  A default file is generated by the tool itself if the file does not exist in the {{{scripts/}}} directory.  To generate the default file, run
{{{
$ python OSSIEUpdater.py --initialize
}}} 

Edit the resulting {{{ossieupdater.cfg.xml}}} file as necessary.

== Allowing root access for {{{make install}}} with sudo ==

Because the OSSIE Updater automates installation, it is useful to allow users to execute {{{make install}}} with root privelages on certain modules.  To do so, you will need to edit the sudoers file.  Login as root and execute
{{{
# /usr/sbin/visudo
}}}

Add the following line:

{{{
ALL ALL = NOPASSWD: /usr/bin/make install
}}}

save and quit ({{{:wq}}}).  If you made an error, visudo will tell you.