Nodes

This guide covers consumer client commands for managing Pulp Nodes in the Pulp Platform. For an overview, tips, and, troubleshooting, please visit the Pulp Nodes Concepts Guide.

Layout

The root level node section contains the following features.

$ pulp-consumer node --help
Usage: pulp-consumer [SUB_SECTION, ..] COMMAND
Description: pulp nodes related commands

Available Commands:
 activate   - activate a consumer as a child node
 bind       - bind this node to a repository
 deactivate - deactivate a child node
 unbind     - remove the binding between this node and a repository

Activation

A Pulp server that is registered as a consumer to another Pulp server can be designated as a child node. Once activated on the parent server, the consumer is recognized as a child node of the parent and can be managed using node commands.

To activate a consumer as a child node, use the node activate command. More information on node-level synchronization strategies can be found here.

$ pulp-consumer node activate --help
Command: activate
Description: activate a consumer as a child node

Available Arguments:

 --strategy - synchronization strategy (mirror|additive) default is additive

A child node may be deactivated using the node deactivate command. Once deactivated, the node may no longer be managed using node commands.

$ pulp-consumer node deactivate --help
Command: deactivate
Description: deactivate a child node

Note

Consumer un-registration will automatically deactivate the node.

Binding

The node bind command is used to associate a child node with a repository on the parent. This association determines which repositories may be synchronized to child nodes. The strategy specified here overrides the default strategy specified when the repository was enabled. More information on repository-level synchronization strategies can be found here.

$ pulp-consumer node bind --help
Command: bind
Description: bind this node to a repository

Available Arguments:

 --repo-id  - (required) unique identifier; only alphanumeric, -, and _ allowed
 --strategy - synchronization strategy (mirror|additive) default is additive

The node unbind command may be used to remove the association between a child node and a repository. Once the association is removed, the specified repository can no longer be be synchronized to the child node.

$ pulp-consumer node unbind --help
Command: unbind
Description: remove the binding between this node and a repository

Available Arguments:

 --repo-id - (required) unique identifier; only alphanumeric, -, and _ allowed

Note

Only activated nodes and enabled repositories may be specified.

Note

The pulp-consumer command line client must be executed with enough permissions to write system-level configuration and credential files. If permission errors are encountered, you may need root privileges.