Chapter 5. Running PackStack
PackStack supports a variety of different deployment modes:
- Quick Start
- When run with the
--allinoneor--install-hostsarguments, PackStack performs a single node or multiple node deployment respectively. These deployments are performed using default configuration values and are recommended for initial testing of Red Hat Enterprise Linux OpenStack Platform. Users requiring more customized deployments should consider the other deployment modes.Refer to Section 5.1, “Quick Start Deployment using PackStack” for more information on running PackStack using the--allinoneor--install-hostsoptions. - Interactively
- When run interactively, PackStack provides prompts for entry of each configuration value required to complete deployment. Alternatively you may accept the provided default value.Refer to Section 5.2, “Running PackStack Interactively” for more information on running PackStack interactively.
- Non-interactively
- When run non-interactively, PackStack expects an "answer" file to be provided as a command line option. This file contains the desired settings for all configuration values that are required to complete deployment.Refer to Section 5.3, “Running PackStack Non-interactively” for more information on generating an answer file and using it to run PackStack non-interactively.
Important
To deploy OpenStack using PackStack each machine targeted for deployment must be configured to allow access using the account of the
root user over SSH on port 22.
Important
By default PackStack will configure a volume group named
cinder-volumes on the system targeted for Volume Storage deployment if one does not already exist. This volume group will be backed by a loopback device and is not appropriate for production use.
If you intend to use physical storage for the
cinder-volumes volume group then you must create the volume group in advance on the system to be used for Volume Storage.
Important
It is strongly recommended that each Compute node has two network interfaces available. One for access to the public network and one for the internal Compute network. While it is possible to use a single interface for both purposes, this approach may result in virtual machine instances obtaining addresses from the wrong DHCP server.
5.1. Quick Start Deployment using PackStack
The quickest way to deploy an OpenStack environment using PackStack is to provide a host, or list of hosts, on the command line. The first host listed is deployed as a Controller node; subsequent hosts are deployed as Compute nodes.
When using this deployment method, PackStack uses default values for all other deployment options unless they are overridden on the command line.
For a list of available command-line options, see Section 5.3.2, “Editing a PackStack Answer File”.
Procedure 5.1. Quick Start Deployment using PackStack
Single-node Deployment
Run PackStack with the--allinoneparameter to perform an "all in one" deployment on the local host. You are prompted to enter the password of therootuser to facilitate SSH key installation.Example 5.1. Single-node Deployment using OpenStack Networking (default)
In this example, PackStack is instructed to deploy an "all in one" installation to the local system, which results in the following:- OpenStack Networking is enabled by default.
- An
adminIdentity service tenant is created along with akeystonerc_adminfile. The admin password and other information are stored in thekeystonerc_adminfile, which is located in the/rootdirectory, and also in the directory from which PackStack is run, if different from/root. The admin password is also stored asCONFIG_KEYSTONE_ADMIN_PWin PackStack's answer file. - A
demoIdentity service tenant is created, with its associatedkeystonerc_demofile, which can be sourced like thekeystonerc_adminfile. The demo password is also stored asCONFIG_KEYSTONE_DEMO_PWin PackStack's answer file. - The keys
CONFIG_PROVISION_DEMOandCONFIG_PROVISION_ALL_IN_ONE_OVS_BRIDGEare automatically enabled in PackStack's answer file. This answer file will have a file name similar to/root/packstack-answers-20130306-051043.txt. - The OpenStack Dashboard is automatcially installed. After the installation is finished, you should log into the Dashboard using the
demoaccount instead of theadminaccount due to the ownership of the private and public networks.
#packstack --allinoneExample 5.2. Single-Node Deployment without OpenStack Networking
In this example, PackStack is instructed to deploy an "all in one" installation to the local system, but using only Compute networking.#packstack --allinone --os-neutron-install=nMultiple-node Deployment
Important
Red Hat Enterprise Linux OpenStack Platform requires that each system in the OpenStack environment is running Red Hat Enterprise Linux Server, and that all systems are signed up to receive updates from Red Hat Network using Subscription Manager.See Section 2.1.2.2, “Register to Red Hat Network” for information on registering to Red Hat Network.- You can ssh into each node and register it, attach an OpenStack subscription, and enable the required OpenStack repository. This allows PackStack to install OpenStack on each node.
- Alternatively, you can get PackStack to generate an answer file, then edit the answer file to contain your Red Hat subscription username and password, using the parameters
CONFIG_RH_USERandCONFIG_RH_PW. Running PackStack with this answer file configures each node to receive updates from Red Hat Network using Subscription Manager. This allows PackStack to install OpenStack on each node.For instructions on generating and editing an answer file, see Section 5.3.1, “Generating a PackStack Answer File”.
Run PackStack with the--install-hostsparameter. The parameter expects a comma-separated list of IP addresses. You will be prompted to enter the password of therootuser of each system to facilitate SSH key installation.#packstack --install-hosts=CONTROLLER_ADDRESS,NODE_ADDRESSESReplace CONTROLLER_ADDRESS with the IP address of the system that you intend to use as a Controller node. Replace NODE_ADDRESSES with IP addresses of the systems that you intend to use as Compute nodes.Example 5.3. Multiple Node Deployment
In this example, PackStack is instructed to deploy a controller node on the system with IP address192.168.43.10.Additional Compute nodes are deployed on the systems with IP addresses192.168.43.11and192.168.43.12.#packstack --install-hosts=192.168.43.10,192.168.43.11,192.168.43.12
- PackStack will prompt you to enter the password of the
rootuser for each system in the deployment. This is required to connect to the system and install Puppet which is the tool used to facilitate the rest of the deployment.root@192.168.43.10's password:
- The Puppet manifests used to deploy each component will be run on each of the target systems. The amount of time this takes to complete varies based on the hardware and existing workload of each system. The time can be significant.PackStack provides continuous updates indicating which manifests are being deployed as it progresses through the deployment process. Once the process is completed, a confirmation message similar to the one shown below will be displayed:
**** Installation completed successfully ******
Additional information regarding the locations of the answer file and other files is given. Depending on the options you chose, the following screen's content will vary:Additional information: * A new answerfile was created in: /root/packstack-answers-20131205-155916.txt * Time synchronization installation was skipped. Please note that unsynchronized time on server instances might be problem for some OpenStack components. * File /root/keystonerc_admin has been created on OpenStack client host 192.168.43.10. To use the command line tools you need to source the file. * To use the console, browse to http://192.168.43.10/dashboard * To use Nagios, browse to http://192.168.43.10/nagios username : nagiosadmin, password : abcdefgh12345678 * The installation log file is available at: /var/tmp/packstack/20131205-155915-tZ0BTD/openstack-setup.log * The generated manifests are available at: /var/tmp/packstack/20131205-155915-tZ0BTD/manifests
Procedure 5.2. Viewing the created network
- Retrieve the URL shown in the "Additional information" output shown above, and the demo tenant password in
/root/keystonerc_demo. - Type the URL into a browser to access the Dashboard:
http://HOSTNAME/dashboard/ReplaceHOSTNAMEwith the host name or IP address of the server on which you ran PackStack. - Type
demoas the User Name and the password in/root/keystonerc_demoas the Password. - Click .
- After signing in to the Dashboard, you can see details of the "all in one" deployment. For example, to see the basic network set-up, select the Project tab and choose Network Topology.
You have successfully deployed an OpenStack environment using PackStack.
Please note that:
- An answer file containing all chosen configuration options is saved to disk on the system from which you ran PackStack. This file can be used to automate future deployments.
* A new answerfile was created in: /root/packstack-answers-20130306-051043.txt
- A file containing the authentication details of the OpenStack
adminuser is saved to disk on the system to which the OpenStack client tools were deployed. (That is, on the system CONFIG_OSCLIENT_HOST) You will need these details to manage the OpenStack environment.* To use the command-line tools you need to source the file
/root/keystonerc_admincreated on 192.168.43.10
This is just the basic setup. You will now need to configure the network and run up instances, using either the Dashboard or the command-line interface.
See Part III, “Using OpenStack” for further instructions to begin using your OpenStack environment.

