LibraryLink ToToggle FramesPrintFeedback

Using the obr Subshell Commands

The FUSE ESB Kernel console provides interactive access to OBR using the obr subshell commands. You can use the commands to deploy your own bundles after creating a bundle repository metadata file.

The obr subshell is not installed by default. To install it:

See the OBR Console Commands in Console Reference Guide for a complete listing of the obr subshell commands.

Use add-url to add a repository file to the set of repository files for which the Repository Admin service provides access. The repository file is represented as a URL. If the repository file URL is already in the Repository Admin's set of repository files, the request is treated like a reload operation.

add-url [<repository-file-url> ...]

Use remove-url to remove a repository file from the set of repository files for which the Repository Admin service provides access. The repository file is represented as a URL.

remove-url [<repository-file-url> ...]

Use list to list the bundles available in the bundle repository. If no arguments are specified, all available bundles are listed. Otherwise, any arguments are concatenated with spaces and used as a substring filter on the bundle names.

list [<string> ...]

Use list-url to view a list of the URLs to the repository files used by the Repository Admin service.

list-url

Use info to display the metadata for specified bundles.

info <bundle-name>[;<version>] ...

If a bundle's name contains spaces, it must be surrounded by quotes. You can specify a precise version if more than one version exists, for example:

info "Bundle Repository";1.0.0

This example retrieves the metadata for version 1.0.0 of the bundle named Bundle Repository.

Use deploy to install or update specified bundles and all of their dependencies by default. You can specify either the bundle name or the bundle identifier.

deploy <bundle-name>[;<version>] ... | <bundle-id> ...

If a bundle's name contains spaces, it must be surrounded by quotes. You can specify a precise version if more than one version exists, for example:

obr deploy "Bundle Repository";1.0.0

In this example, if version 1.0.0 of Bundle Repository is already installed locally, the command attempts to update it and all of its dependencies. Otherwise, the command installs the bundle and all of its dependencies.

Use start to install and start the specified bundles and all of their dependencies by default. Use the -nodeps switch to ignore dependencies.

start [-nodeps] <bundle-name>[;<version>] ...

If a bundle's name contains spaces, it must be surrounded by quotes. If a specified bundle is already installed, this command has no effect.

You can specify a precise version if more than one version exists, for example:

obr start "Bundle Repository";1.0.0

This example installs and starts the 1.0.0version of the bundle named Bundle Repository and its dependencies.

Use source to retrieve the source archives of the specified bundles and save them to the specified local directory.

source [-x] <local-dir> <bundle-name>[;<version>] ...

Use the -x switch to automatically extract the source archives. If a bundle name contains spaces, it must be surrounded by quotes.

You can specify a precise version if more than one version exists, for example:

obr source /home/fuse/tmp "Bundle Repository";1.0.0

This example retrieves the source archive of version 1.0.0 of the bundle named Bundle Repository and saves it to the specified local directory.