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