CAUTION: Rackspace strongly recommends that you install Rackspace Private Cloud Software on physical hardware nodes (bare metal) for best results. Installation on virtual platforms should only be performed for evaluation purposes.
An all-in-one installation is available, in which the controller and compute components are installed on the same device. However, for best results, we recommend a minimum of two nodes.
Installing the Controller
Before you begin, run the following command on each physical ESXi device to enable VM nesting:
$ echo 'vhv.allow = "TRUE"' >> /etc/vmware/config
- In VMWare ESXi, right-click on your server icon and select New Virtual Machine.
- On the Configuration screen, select Typical.
- On the Storage screen, select the destination storage for the VM files.
- On the Guest Operating System screen, select Linux and Red Hat Enterprise Linux (64-bit).
- On the Network screen, configure one NIC.
- On the Create a Disk screen, specify the virtual disk size and select thick or thin provisioning. The virtual disk should have at least 20 GB, preferably more.
- Click Finish.
- Locate the newly created VM in the navigation bar and select Edit Settings.
- In the settings, increase the memory to at least 4 GB and allocate 2 CPUs.
- Select CD/DVD Drive, select Datastore ISO File, and mount the Rackspace Private Cloud Software ISO. Be sure that the Connect At Power On option is selected.
- On the Options tab, change the Guest Operating System to Other - VMWare ESXi 5.x.
- Navigate to the Configuration Parameters screen, under Advanced -> General. On the configuraiton parameters screen, add the following rows and set the values as follows:
- vcpu.hotadd = FALSE
- hypervisor.cpuid.v0 = FALSE
- Save your changes and power on the virtual machine to launch the ISO.
- After the ISO has launched and loaded, accept the EULA statement.
- Select
Controller
. - Enter the NIC address. If you have more than one, you must designate one as public and one as private. In all-in-one installations, you will need to enter a public and private NIC.
- When prompted, enter the node IP address, subnet mask, gateway, name server, and host name. If you do not enter a fully-qualified domain name for the hostname, you will be prompted to enter a domain name as well.
- Enter the address for the nova fixed network.
- If you want to configure a DMZ network, enter the DMZ address and the DMZ gateway address.
- Enter a password for the
admin
user. You will use this admin username and password to access the API and the dashboard. - For the additional non-admin user, accept the default
demo
or enter your own and provide a password at the prompt. This user will not have admin privileges, but will be able to perform basic OpenStack functions, such as creating instances from images. Creating the user will also automatically create a project (also known as a tentant) for this user. - Enter the real name, user name, and password for the operating system user account. For example, the user Jane Doe would enter the following information:
- Full name for the new user:
Jane Doe
- Username for your account:
jdoe
- Password:
mysecurepassword
At this point, it will take approximately 5-10 minutes for the Ubuntu operating system installation to complete.
- If you have a proxy, enter the proxy URL at the prompt in the format
http://proxy_ip_address
:proxy_ip_port
. If you do not have a proxy, press enter to skip this step and leave the proxy information blank.
At this point, the installation process will run for approximately 30 minutes without the need for user intervention. The device will reboot during the installation process. You will see a screen with the Rackspace Private Cloud logo, followed by a screen that displays a progress bar; you can use Ctrl+Alt+F2 to toggle between the progress bar screen and a Linux TTY screen. You can follow the log during installation by switching to the correct TTY screen and viewing the log in /var/log/post-install.log
.
After the installation is complete, you can view the install log by logging into the operating system with the username and password that you configured in Step 22. The log is stored in /var/log/post-install.log
.
CAUTION: There is no password recovery system. Please do not forget your admin password.
Installing the Compute Node
Before you begin, run the following command on each physical ESXi device to enable VM nesting:
$ echo 'vhv.allow = "TRUE"' >> /etc/vmware/config
- In VMWare ESXi, right-click on your server icon and select New Virtual Machine.
- On the Configuration screen, select Typical.
- On the Storage screen, select the destination storage for the VM files.
- On the Guest Operating System screen, select Linux and Red Hat Enterprise Linux (64-bit).
- On the Network screen, configure one NIC.
- On the Create a Disk screen, specify the virtual disk size and select thick or thin provisioning. The virtual disk should have at least 20 GB, preferably more.
- Click Finish.
- Locate the newly created VM in the navigation bar and select Edit Settings.
- In the settings, increase the memory to at least 2 GB and allocate 2 CPUs.
- Select CD/DVD Drive, select Datastore ISO File, and mount the Rackspace Private Cloud Software ISO. Be sure that the Connect At Power On option is selected.
- On the Options tab, change the Guest Operating System to Other - VMWare ESXi 5.x.
- Navigate to the Configuration Parameters screen, under Advanced -> General. On the configuraiton parameters screen, add the following rows and set the values as follows:
- vcpu.hotadd = FALSE
- hypervisor.cpuid.v0 = FALSE
- Save your changes and power on the virtual machine to launch the ISO.
- After the ISO has launched and loaded, accept the EULA statement.
- Select
Compute
to install a compute node. - Enter the NIC address. If you have more than one NIC, designate one as public and one as private. Be sure that the ordering of the NICs matches the order that you specified for the controller node.
- When prompted, enter the node IP address, subnet mask, gateway, name server, and host name. If you do not enter a fully-qualified domain name for the hostname, you will be prompted to enter a domain name as well.
- Enter the real name, user name, and password for the operating system user account. For example, the user Jane Doe would enter the following information:
- Full name for the new user:
Jane Doe
- Username for your account:
jdoe
- Password:
mysecurepassword
At this point, it will take approximately 5-10 minutes for the Ubuntu operating system installation to complete.
- If you have a proxy, enter the proxy URL at the prompt in the format
http://proxy_ip_address
:proxy_ip_port
. If you do not have a proxy, press enter to skip this step and leave the proxy information blank. - Enter the IP address for the controller node. This will add the new compute node to the cluster.
At this point, the installation process will run for approximately 20 minutes without the need for user intervention. As with the controller node installation, the device will reboot during the installation process. You will see a screen with the Rackspace Private Cloud logo, followed by a screen that displays a progress bar; you can use Ctrl+Alt+F2 to toggle between the progress bar screen and a Linux TTY screen. You can follow the log during installation by switching to the correct TTY screen and viewing the log in /var/log/post-install.log
.
After the installation is complete, you can view the install log by logging into the operating system with the username and password that you configured during the Controller installation. The log is stored in /var/log/post-install.log
.
© 2011-2013 Rackspace US, Inc.
Except where otherwise noted, content on this site is licensed under a Creative Commons Attribution-NonCommercial-NoDerivs 3.0 Unported License
See license specifics and DISCLAIMER