/
Configuration via the System Console

Configuration via the System Console

Owned by Shaun Morris
Last updated: May 24, 2013Version comment

Using the System Console is described in the Using Console Commands section.

Managing Features

DDF includes many components, packaged as features, that can be installed and/or uninstalled without restarting the system. Features are collections of OSGi bundles, configuration data, and/or other features. For more information on the features that come with DDF, including a list of the ones included, consult the DDF Included Features page in the Software Version Description Document (SVDD).

Transitive Dependencies

Features may have dependencies on other features and will auto-install them as needed.

Installing Features

  1. Determine which feature to install by looking at the available features on DDF.

    ddf@local>features:list

    The console should output a list of all features available (installed and uninstalled). A snippet of the list output is shown below (the versions may differ based on the version of DDFbeing run):

    State         Version          Name                          Repository  Description
[installed  ] [2.0.1         ] ddf-core                      ddf-2.1.0
[uninstalled] [2.0.1         ] ddf-sts                       ddf-2.1.0
[installed  ] [2.0.1         ] ddf-security-common           ddf-2.1.0
[installed  ] [2.0.1         ] ddf-resource-impl             ddf-2.1.0
[uninstalled] [2.0.1         ] ddf-source-dummy              ddf-2.1.0

  2. Install the desired feature.

    ddf@local>features:install ddf-source-dummy

  3. Check the feature list to verify the feature was installed.

    ddf@local>features:list
    State         Version          Name                          Repository  Description
[installed  ] [2.0.1         ] ddf-core                      ddf-2.1.0
[uninstalled] [2.0.1         ] ddf-sts                       ddf-2.1.0
[installed  ] [2.0.1         ] ddf-security-common           ddf-2.1.0
[installed  ] [2.0.1         ] ddf-resource-impl             ddf-2.1.0
[installed  ] [2.0.1         ] ddf-source-dummy              ddf-2.1.0

  4. Check the bundle status to verify the service is started.

    ddf@local>list

    The console output should show an entry similar to the following:

    [ 117] [Active     ] [            ] [Started] [   75] DDF :: Catalog :: Source :: Dummy (<version>)

Uninstalling Features

  1. Check the feature list to verify the feature is installed properly.

    ddf@local>features:list

    State         Version          Name                          Repository  Description
[installed  ] [2.0.1         ] ddf-core                      ddf-2.1.0
[uninstalled] [2.0.1         ] ddf-sts                       ddf-2.1.0
[installed  ] [2.0.1         ] ddf-security-common           ddf-2.1.0
[installed  ] [2.0.1         ] ddf-resource-impl             ddf-2.1.0
[installed  ] [2.0.1         ] ddf-source-dummy              ddf-2.1.0

  2. Uninstall the feature

    ddf@local>features:uninstall ddf-source-dummy

    Dependencies that were auto-installed by the feature are not automatically uninstalled.

  3. Verify that the feature has uninstalled properly.

    ddf@local>features:list

    State         Version          Name                          Repository  Description
[installed  ] [2.0.1         ] ddf-core                      ddf-2.1.0
[uninstalled] [2.0.1         ] ddf-sts                       ddf-2.1.0
[installed  ] [2.0.1         ] ddf-security-common           ddf-2.1.0
[installed  ] [2.0.1         ] ddf-resource-impl             ddf-2.1.0
[uninstalled] [2.0.1         ] ddf-source-dummy              ddf-2.1.0