.\" Text automatically generated by txt2man
.TH grr_config_updater 1 "19 June 2018" "GRR 3.1.0.2" ""
.SH NAME
\fBgrr_config_updater \fP- GRR configuration tool
\fB
.SH SYNOPSIS
.nf
.fam C
\fBgrr_config_updater\fP [\fB-h\fP] [\fB--verbose\fP] [\fB--debug\fP] [\fB--config\fP \fICONFIG\fP]
                   [\fB--secondary_configs\fP \fISECONDARY_CONFIGS\fP] [\fB--config_help\fP]
                   [\fB--context\fP \fICONTEXT\fP] [\fB--plugins\fP \fIPLUGINS\fP]
                   [\fB--disallow_missing_config_definitions\fP] [\fB-p\fP \fIPARAMETER\fP]
                   [\fB--list_storage\fP][\fB--share_dir\fP \fISHARE_DIR\fP]
                   <subcommand>

.fam T
.fi
.fam T
.fi
.SH DESCRIPTION
This is the main configuration tool for GRR. It has numerous subcommands to
perform various actions. When first setting up a new GRR instance, one
probably only cares about 'initialize'.
.PP
This tool needs to be executed as the '_grr' user, e.g. via 'sudo \fB-u\fP _grr'.
.SH SUBCOMMANDS
.TP
.B
generate_keys
Generate crypto keys in the configuration.
.TP
.B
repack_clients
Repack the clients binaries with the current
configuration.
.TP
.B
initialize
Run all the required steps to setup a new GRR install.
.TP
.B
set_var
Set a config variable.
.TP
.B
update_user
Update user settings.
.TP
.B
add_user
Add a new user.
.TP
.B
delete_user
Delete an user account.
.TP
.B
show_user
Display user settings or list all users.
.TP
.B
upload_raw
Upload a raw file to an aff4 path.
.TP
.B
upload_artifact
Upload a raw json artifact file.
.TP
.B
upload_python
Sign and upload a 'python hack' which can be used to
execute code on a client.
.TP
.B
upload_exe
Sign and upload an executable which can be used to
execute code on a client.
.TP
.B
sign_component
Authenticode Sign the component.
.TP
.B
upload_component
Sign and upload a client component.
.TP
.B
upload_components
Sign and upload all client components.
download_missing_rekall_profiles
Downloads all Rekall profiles from the repository that
are not currently present in the database.
.SH OPTIONS
.TP
.B
\fB--verbose\fP
Turn of verbose logging.
.TP
.B
\fB--debug\fP
When an unhandled exception occurs break in the
debugger.
.TP
.B
\fB--config\fP \fICONFIG\fP
Primary Configuration file to use. This is normally
taken from the installed package and should rarely be
specified.
.PP
\fB--secondary_configs\fP \fISECONDARY_CONFIGS\fP
Secondary configuration files to load (These override
previous configuration files.).
.TP
.B
\fB--config_help\fP
Print help about the configuration.
.TP
.B
\fB--context\fP \fICONTEXT\fP
Use these contexts for the config.
.TP
.B
\fB--plugins\fP \fIPLUGINS\fP
Load these files as additional plugins.
.PP
\fB--disallow_missing_config_definitions\fP
If true, we raise an error on undefined config
options.
.PP
\fB-p\fP \fIPARAMETER\fP, \fB--parameter\fP \fIPARAMETER\fP
Global override of config values. For example \fB-p\fP
DataStore.implementation=MySQLDataStore
.TP
.B
\fB--list_storage\fP
List all storage subsystems present.
.PP
\fB--share_dir\fP \fISHARE_DIR\fP
Path to the directory containing grr data.
.SH AUTHOR
GRR developers team <grr-dev@googlegroups.com>