Virtualization quickstart¶

This quickstart guide has been tested on Fedora 25.

Within code blocks, a prefix of $ indicates that a command should be executed as a regular user, and # indicates that a command should be performed as root.

Option 1: Using libvirt and Virtual Machine Manager¶

Install required packages:

# dnf install libvirt qemu-kvm kvm libguestfs-tools virt-install

Then, download an image for the OS you want to run in your VM. Fedora ISOs may be downloaded from here.

Launch the "Virtual Machine Manager" application and click:

1. File → New Virtual Machine
2. Local install media → Browse to downloaded ISO
3) Accept default settings

SETTING UP THE VM:¶

1. Start the VM with the "play button"
2. Choose to install fedora:
3. set hostname: give it a name other than localhost.
4. make it meaningful
5. set root password (weak one is OK)
6. if you make a user, make sure to give them sudo access

NOTE: If you make a user and forgot to give them sudo access, start the VM, open a terminal, and:

$ su
# gpasswd --add admin wheel

Then restart.

WARNING: localhost is a bad hostname. Each of your VMs should have a unique hostname. If you clone a VM, both hosts will have the same hostname. It is imperative that you change your a host's hostname before installing any pulp components, as Pulp uses its host's hostname, and Pulp can produce undefined behavior if its host's hostname is changed after the fact.

To see your host's hostname, execute hostname. To change your host's hostname, run:

# hostnamectl set-hostname <new-hostname>

SETTING UP ANSIBLE (on the VM):¶

For details on Ansible, see the Ansible documentation.

Install Ansible:
For Fedora, you can install ansible without enabling any extra repos. For RHEL7 you will have to set up epel.

For RHEL 7 only

$ wget https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
# rpm -i epel-release-latest-7.noarch.rpm

# dnf install ansible git

Download the pulp_packaging repo:

$ git clone https://github.com/pulp/pulp_packaging.git

Now we need to make a hosts file for Ansible. Use the results of the hostname command in the place of 'localhost':

$ cd pulp_packaging/ci/ansible
$ echo "$(hostname)" > hosts

Choosing what version of pulp to install¶

To choose the version of pulp that you will install:

• edit pulp_packaging/ci/ansible/roles/pulp/defaults/main.yaml, or
• pass -e pulp_version=2.14 -e pulp_build=beta in the ansible-playbook invocation, or
• in hosts file, specify pulp_version and pulp_build on the same line as hostname, i.e. name_of_host pulp_version=2.14 pulp_build=beta

Now you are ready to run the ansible playbook:

$ ansible-playbook -i hosts -e ansible_connection=local pulp_server.yaml 

For RHEL7 you will have to provide your RHN credentials as well,

$ ansible-playbook -i hosts -e ansible_connection=local pulp_server.yaml -e rhn_password=${RHN_PASS} -e rhn_pool${RHN_POOL} -e rhn_username=${RHN_USER}

These playbooks assume your are root or have passwordless sudo access. If you do not, you can additionally pass the variables -e ask_pass=True -e ansible_user=root

Option 2: Using Vagrant with either libvirt or docker¶

See Pulp Developer Setup