instack-undercloud/README-packages.md

instack-undercloud via source

1. The user performing all of the installation steps on the virt host needs to have password-less sudo enabled. This step is NOT optional, you must create an additional user. Do not run the rest of the steps as root.

    sudo useradd stack
    sudo passwd stack  # specify a password
    echo "stack ALL=(root) NOPASSWD:ALL" | sudo tee -a /etc/sudoers.d/stack
    sudo chmod 0440 /etc/sudoers.d/stack
    sudo su - stack
    echo 'export LIBVIRT_DEFAULT_URI="qemu:///system"' >> ~/.bashrc
    source ~/.bashrc
   

2. Enable the test TripleO copr repository and install instack-undercloud.

    sudo curl -o /etc/yum.repos.d/slagle-openstack-m.repo https://copr.fedoraproject.org/coprs/slagle/openstack-m/repo/fedora-20/slagle-openstack-m-fedora-20.repo
    sudo yum -y install instack-undercloud
   

3. Complete the initial setup.

    source /usr/libexec/openstack-tripleo/devtest_variables.sh
    tripleo install-dependencies
    tripleo set-usergroup-membership
   

4. Verify membership in the libvirtd group

     # verify you are in the libvirtd group
     id | grep libvirtd
     # if not, start a new shell to pick it up
     sudo su - stack
   

5. Create the virtual environment. When the script has completed successfully, it will output the instack vm's IP address. Use this IP address in the next step.

     instack-virt-setup
   

6. ssh as the stack user (password is stack) to the instack vm

7. Download all the files from http://file.rdu.redhat.com/~jslagle/tripleo-images-juno-source/ to /home/stack. If you already have them downloaded, use rsync/scp/whatever to copy them over to the instack vm. The images will be uploaded to glance at the end of the install.

8. Once you are ssh'd into the instack vm as the stack user, setup the copr repo and install instack-undercloud.

    sudo curl -o /etc/yum.repos.d/slagle-openstack-m.repo https://copr.fedoraproject.org/coprs/slagle/openstack-m/repo/fedora-20/slagle-openstack-m-fedora-20.repo
    sudo yum -y install instack-undercloud
   

9. Run the installation script. By default the install will use packages from the RDO openstack-juno repo at https://repos.fedorapeople.org/repos/openstack/openstack-juno/fedora-20/. If you wish to use the internal stage repo, you can override $RDO_RELEASE_RPM as shown.

    # Optionally switch to the internal stage repo
    # export RDO_RELEASE_RPM=http://team.virt.bos.redhat.com/openstack/openstack-juno/rdo-release-juno-1.noarch.rpm
   
    instack-install-undercloud-source
   

10. Once the install script has run to completion, copy the files /root/stackrc and /root/tripleo-undercloud-passwords into the stack user's home directory.

      sudo cp /root/tripleo-undercloud-passwords .
      sudo cp /root/stackrc .
    

That completes the Undercloud install. To proceed with deploying and using the Overcloud see Overcloud-source.