Schema Repository Command Line Reference

Use the tibschemad command line executable to start schema repository process.

The schema repository executable installs in TIBCO_HOME/akd/repo/version/bin/tibschemad.

Client Communication

Parameter Arguments Description
-l

-listen

interface:port Optional.

The repository listens for requests at this interface and port. Nonetheless, it is good practice to direct requests through the realm server, which redirects the requests to an appropriate schema repository.

When absent, the default location is localhost:8081.

Realm Server Back-End Storage

Parameter Arguments Description
-ftl URL Optional.

A list of the realm server URLs, separated by the pipe character (|).

The schema repository uses the realm server at this location for back-end schema storage.

When absent, the default URL is http://localhost:8080

-u

-user

user Optional. (Required for communication with a secure realm server.)

The schema repository authenticates itself to the realm server with this user name.

-p

-password

password Optional. (Required for communication with a secure realm server.)
The repository authenticates itself to the realm server with this password. Supply one of the following forms:
  • stdin
  • env:environment_var_name
  • file:password_file_path
  • pass:password

For further details, see Password Security.

-trust-file file_path Optional. (Required for TLS communication with a secure realm server.)

When present, the repository process reads the realm server's trust file from this path, and uses that trust data in communications with the secure realm server.

-trust-everyone Optional.
The repository trusts any realm server without verifying trust in the realm server's certificate.
Warning: Do not use this parameter except for convenience in development and testing. It is not secure.
-mem Optional.

When present, the schema repository stores schemas only in process memory (which is not persistent) instead of using the realm server for backend storage.

Warning: Do not use this mode in production environments.

Configuration

Parameter Arguments Description
-c

-config

file_path Optional.

Path to a JSON configuration file.

Command line arguments override environment variables, which override configuration file arguments.

When absent, the schema repository first looks for ./.tibschemad, then ~/.tibschemad.

-env Optional.

The repository prints the environment variables that would produce its current configuration and exits.

-show-config Optional.

The repository prints the contents of a configuration file that would produce its current configuration and exits.

Tracing and Logging

Parameter Arguments Description
-debug Optional.

When present, print debugging information.

-q

-quiet

Optional.

When present, the repository prints minimal output.

-v

-verbose

Optional.

When present, print verbose output.

-version Optional.

When present, the repository outputs version information and exits.