addconfig

This kandoMaintain 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>

Important: -n <name> and -v <value> are required.

Options

The following table shows the options for this command.

-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.

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’

Back to top

GitCentric Bridge configuration settings

This section describes the GitCentric Bridge configuration settings using the addconfig command.

The bridge is the webapp <tomcat_home>/webapps/kandoBridge that keeps your Git repositories and AccuRev streams in sync.

Use the following syntax: kandoMaintain addconfig <parameters>

The following table lists the configuration parameters and their values:

AC_GIT_BIN Value: Full path and name of Git executable. Typically set by the GitCentric installer and should not need to be modified. If this value is not defined, GitCentric uses the PATH to find the Git executable.
ACCUREV_COMMAND_LOGFILE Value: Full path and name of a log file. DEBUG ONLY. Use only when directed by   support. This log shows each AccuRev command that gets executed by the bridge. For Code Review and UI logging, see: <gc_home>/site/etc/gerrit.config
PRESERVE_TEMP_FILES Value: [Y|y] . DEBUG ONLY. Use only when directed by   Support. Y specifies to not delete temporary files (from xmlpromote, fast-import, misc. messages, etc.) that are generated in $CATALINA_HOME/temp.
AC_BRIDGEAPI_SECURITY_POLICY Value: AllowAnyHost. DEBUG. (Case sensitive.) By default GitCentric recognizes trigger events only from trusted servers. Use this setting to troubleshoot if a trusted server is having difficulty communicating with GitCentric.
GIT_RENAME_THRESHOLD Value: [0-100]. Value for matching the Git rename detection threshold, so that a file delete/replace can be identified as a rename operation, allowing AccuRev to track the history of a renamed file. The default value is 50 which is the same as the default Git setting. Only adjust this value if renames are not identified accurately.
kando.bridgeURL Value: URL of the GitCentric bridge. Allows you to set the URL of the GitCentric bridge. Used when the GitCentric server and AccuRev Server are on different hosts. For example: http://<host name>:8080/KandoBridge where <host name> is the name or IP address of the GitCentric server host.

Back to top

See also: