Synopsis

fcli tool definitions update [-s=<source>] [[-h] [--env-prefix=<prefix>] [--log-file=<logFile>] [--log-level=<logLevel>] [--log-mask=<level>] [--debug]] [[-o=<type+args>] [--style*=<style>,…​]…​ ] [--to-file=<outputFile>_]]

Description

Tool definitions list the available versions, corresponding download location, and other details for each tool. These tool definitions are used by the various 'fcli tool' commands to identify what tool versions are currently available and where to download them from. By default, each fcli release ships with the latest tool definitions that were available at the time that release was built.

The update command allows for updating the tool definitions from a URL or local file. This allows for the current fcli installation to be aware of new tool versions that were released after the current fcli release was built, and also allows users to use a custom tool definitions bundle.

For example, if it’s not allowed to download tool installation bundles from public sites like github.com or tools.fortify.com, companies can host tool installation bundles internally and provide a tool definitions bundle that points to the internally hosted installation bundles. At the same time, companies can restrict which versions of each tool users are allowed to install.

Options

-s, --source=<source>

URL or file to get the tool definitions from. If not specified, default tool definitions provided by OpenText are downloaded from a predefined URL.

Output options (also see documentation link below)

-o, --output=<type+args>

Select output type (csv, table, expr, json, xml, yaml) and optional type arguments.

--store=<var>[:<prop>]

Store JSON results in an fcli variable for later reference.

*--style*=<style>,…​

Select output style: header, no-header, pretty, no-pretty, flat, no-flat, array, single, border, no-border, md-border.

--to-file=<outputFile>

Write output to the specified file.

Generic fcli options (also see documentation link below)

--debug

Enable collection of debug logs.

--env-prefix=<prefix>

Prefix for resolving default option values. Default value: FCLI_DEFAULT.

-h, --help

Use 'fcli [command] -h' to display help for fcli (sub-)commands.

--log-file=<logFile>

Write log output to file. Default: ./fcli.log if logging is enabled.

--log-level=<logLevel>

Set logging level: TRACE, DEBUG, INFO, WARN, ERROR, NONE.

--log-mask=<level>

Log mask level: high, medium, low, none. Default: medium. Masking is done on a best-effort basis; no guarantee that all sensitive data will be masked.