Installation

Latest Release

Community Release 19

Repository: http://repos.fedorapeople.org/repos/pulp/pulp/

Testing Builds

Community Releases are built and tested at the end of each Pulp sprint (roughly every three weeks). Testing builds are created more frequently (currently every Wednesday and Friday afternoon) and contain in progress features and bug fixes. While it is recommended that users try to stick with the Community Releases, there may be times where a feature or bug fix is desired before a CR is built.

The repo files for  Fedora and  RHEL contain definitions for both the community releases and our testing build repository, however the latter is disabled by default. To install or update to a testing build, simply edit the Pulp repo file and set the testing repo's enabled flag to 1. The next time yum downloads Pulp, it will use the testing build.

Prerequisites

• For RHEL-5
  • Pulp does not currently work with SELinux on RHEL-5, so it needs to be set to Permissive or Disabled.
• The following ports must be open into the server:
  • 443 for API and package retrieval
  • 5672 for non-ssl or 5674 for SSL message bus connections
• The following ports must be open into consumer systems:
  • 5672 for non-ssl or 5674 for SSL message bus connections
• mod_python must be uninstalled (or at least not loaded by apache). mod_wsgi, a Pulp requirement, does not function alongside mod_python.

Installation

Server

1. Download the necessary repository configuration files:

$ wget -O /etc/yum.repos.d/fedora-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/fedora-pulp.repo

$ wget -O /etc/yum.repos.d/rhel-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/rhel-pulp.repo

$ rpm -Uvh http://dl.fedoraproject.org/pub/epel/5/i386/epel-release-5-4.noarch.rpm

$ wget -O /etc/yum.repos.d/rhel-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/rhel-pulp.repo

$ rpm -Uvh http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-5.noarch.rpm

2. Install Pulp and its dependencies:

$ yum install pulp

3. Update /etc/pulp/pulp.conf to reflect the hostname of the Pulp server.
   • Change localhost in the below to the hostname of the Pulp server.

     [server]
     server_name: localhost
     ...
     ...
     [messaging]
     url:        tcp://localhost:5672
     

4. Initialize Pulp, which starts and configures database:

$ service pulp-server init

5. Start Pulp, which starts the database, message bus broker, and web server:

   $ service pulp-server start
   

6. (optional) Configure Pulp to automatically start system startup:

   $ chkconfig pulp-server on
   

Installation Notes

• The default user is admin with the password admin.

Admin Client

The Pulp Admin Client is used for administrative commands on the Pulp server, such as the manipulation of repositories and content. The Pulp Admin Client can be run on any machine that can access the Pulp server, including the server itself. It is not a requirement that the admin client be run on a machine that is configured as a Pulp consumer.

Pulp admin commands are accessed through the pulp-admin script.

1. Download the repository configuration file to /etc/yum.repos.d:

   $ wget -O /etc/yum.repos.d/fedora-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/fedora-pulp.repo
   

2. Install the Pulp admin client packages:

$ yum install pulp-admin

3. Update the admin client configuration to point to the Pulp server. Keep in mind that because of the SSL verification, this should be the fully qualified name of the server, even if it is the same machine (localhost will not work with the default apache generated SSL certificate). For more information see the FAQ page. This change must be done in the following places:
   • host

$ vi /etc/pulp/admin/admin.conf

Consumer Client

The Pulp Consumer Client is present on all systems that wish to act as a consumer of a Pulp server. The Pulp Consumer Client provides the means for a system to register and configure itself with a Pulp server. Additionally, the Pulp Consumer Client runs an agent that will receive messages and commands from the Pulp server.

Pulp consumer commands are accessed through the pulp-consumer script. This script must be run as root to permit access to add references to the Pulp server's repositories. More information can be found in the Pulp Consumer Client User Guide.

1. Download the repository configuration file to /etc/yum.repos.d:

   $ wget -O /etc/yum.repos.d/fedora-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/fedora-pulp.repo
   

2. Install the Pulp consumer client packages:

$ yum install pulp-consumer

3. Update the consumer client configuration to point to the Pulp server. Keep in mind that because of the SSL verification, this should be the fully qualified name of the server, even if it is the same machine (localhost will not work with the default apache generated SSL certificate). For more information see the FAQ page. This change must be done in four places:
   • host
   • baseurl
   • keyurl
   • ksurl

$ vi /etc/pulp/consumer/consumer.conf

4. Start the agent:

   $ service pulp-agent start
   

Content Delivery Server

1. Download the necessary repository configuration files:

$ wget -O /etc/yum.repos.d/fedora-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/fedora-pulp.repo

$ wget -O /etc/yum.repos.d/rhel-pulp.repo http://repos.fedorapeople.org/repos/pulp/pulp/rhel-pulp.repo

2. Install the CDS RPM and its dependencies:

   $ yum install pulp-cds
   

3. Configure the CDS to connect to the Pulp server's message broker by editing /etc/pulp/cds.conf and changing the host property.

4. Ensure the appropriate messaging port is open on the CDS instance (see Prerequisites above for information on the port number).

5. Start the Pulp CDS daemon:

   $ service pulp-cds start