addconfig Command

Adds a configuration parameter to the GitCentric database configuration table. Returns an error if you specify a name that already exists with -n <name>.

Syntax

kandoMaintain addconfig -n <name> -v <value>

addconfig Example

Add a new configuration value that points to the instance of Git used by GitCentric, specifying the DB user account but having kandoMaintain prompt for the DB password:

kandoMaintain addconfig -u postgres -n AC_GIT_BIN -v '/usr/local/bin/git’

Options

-u <dbadmin>

The database administration user. This is the same user name as specified during installation (default is postgres). If this is required by the command you are using but you do not include it, kandoMaintain prompts you for it.

-P <dbpass>

The database administration password. This is the same user password as specified during installation. If this is required by the command you are using but you do not include it, kandoMaintain prompts you for it. If you write scripts that incorporate this option, be sure to secure the file against unauthorized access.

-c <dbconnectstring>

The database connection string:

jdbc:postgresql://<host>:<port>/<dbname>

If you do not specify -c for a command that requires it, kandoMaintain assumes the default value jdbc:postgresql://localhost:5075/kando. If you do specify -c, then jdbc:postgresql:// at a minimum is required. Partial connection strings will have default values automatically supplied. For example, if you specify jdbc:postgresql://, kandoMaintain assumes a <host> of localhost, a <port> value of 5075 and a <dbname> of kando.

-Fc <path>

The path to a text file (such as <gc_home>/dbsettings.conf) containing values for three of the parameters used by kandoMaintain. The contents of this file should include:

DB_USER=<dbadmin>

Eliminates the need for -u on the command line.

DB_PASS=<dbpassword>

Eliminates the need for -P on the command line.

DB_CONNECT=<dbconnectstring>

Eliminates the need for -c on the command line.

For example:

DB_USER=postgres
DB_PASS=postgres
DB_CONNECT =dbc:postgresql://localhost:5075/kando

Note: The settings and the values accepted by this configuration file can change without notice from release to release.

-n <name>

Configuration name (the param_name field in the GitCentric database configuration table).

-v <value>

Configuration value (the param_value field in the GitCentric database configuration table).

-m '<comment>'

Configuration comments (the comments field in the GitCentric database configuration table). Double or single quotes are required if the comment includes spaces.