gpcmdr

Configures and manages instances of the Command Center Console.

gpcmdr [--ssh_full_path <path>] 
       --setup [[<section_header>] --config_file <path>]
     | --start [<instance_name>]
     | --stop [<instance_name>]
     | --restart [<instance_name>]
     | --migrate [<instance_name>]
     | --remove [<instance_name>]
     | --status [<instance_name>]

Option	Description
`--setup`	Configures console components on the installation host. With this option, `gpcmdr` prompts for values to configure the components and writes the values to `app.conf`. For more information on these configuration parameters, see Configuration File Reference.
`--config_file`	Sets the path to a configuration file to use to set up new Command Center instances. This option must be used with the `--setup` option. See Setup Configuration File for information about the format and content of this configuration file. If section_header is supplied, `gpcmdr` only sets up the instance defined in the named section in the configuration file. Otherwise, `gpcmdr` sets up all instances in the configuration file.
`--start`	Starts the specified instance (or all instances by default) and its associated web service.
`--stop`	Stops the specified instance (or all instances by default) and its associated web service.
`--migrate`	Copies Command Center instances (or all instances by default) from a previous installation.
`--remove`	Removes the specified instance and its associated database schema.
`--restart`	Restarts the specified instance (or all instances by default) and its associated web service.
`--status`	Displays the status, either `Running` or `Stopped`, of the web service.
`--version`	Displays the version of the `gpcmdr` utility.
`--ssh_full_path`	Sets the full path to the ssh command. Use this to override the ssh command found on the path.

Description

The gpcmdr utility sets up and configures Command Center Console instances, starts and stops instances, and provides status information.

You can set up a new Command Center Console instance interactively or, by providing a configuration file, non-interactively.

For actions --start, --stop, --restart, --migrate, and --status you can specify a console instance name. If you do not specify a name, the action applies to all existing console instances.

On the --start option, gpcmdr creates the gpcc_basic, gpcc_operator_basic, and gpcc_operator database roles if they do not already exist.

The --migrate option prompts you to enter the path to the Command Center installation with instances you want to migrate. The utility checks whether the instance to copy already exists in the new location before copying. If the instance exists in the new location, a prompt asks whether you want to overwrite the instance.

Examples

Interactively create a new Command Center Console instance:

$ gpcmdr --setup

Set up the Command Center Console instance defined in the [development] section of a configuration file:

$ gpmcdr --setup development gpccinstances.cfg

Check the status of all Command Center Console instances:

$ gpcmdr --status