Pulp Admin

Overview

The pulp-admin script is the entry point to all administrative functions on a Pulp server. In addition to Pulp content manipulation (repository management, synchronization, etc.) the pulp-admin script can also be used to manipulate consumers of a Pulp server, such as repository binding and package installation.

All commands are issued by passing the command string to the pulp-admin script. For example, to display a list of repositories, the repo list command is run:

$ pulp-admin repo list

Arguments to a command are specified after the command and begin with --. All commands support the --help argument to display more information on the possible arguments supported:

$ pulp-admin repo create --help

Configuration

Configuration for the pulp-admin script is done through the /etc/pulp/client.conf file. The pulp-admin script takes the following configuration options:

Name Description
host Fully qualified hostname of the Pulp server. In addition to being used to find the server itself, this is also used to verify the server's SSL certificate. As such, this cannot simply be the IP of the Pulp server and must be the hostname configured in the server's SSL certificate.
port Port on which the Pulp server API is hosted. The default is 443 (HTTPS) and will likely not need to be changed.
scheme Currently, only https is supported.

Script Options

pulp-admin supports the common options, always specified right after pulp-admin:

Name Flag Description
Username -u or --username Use the given username to identify the authentication credentials to use
Password -p or --password Use the given password for authentication
Hostname --host Override the configured host
$ pulp-admin -u admin -p admin --host=localhost