NOTE: This documentation is for the Rackspace Private Cloud Software v. 2.0 ISO. Other v. 2.0 documentation can be found on the Archived Versions page. Documentation for the newest version of Rackspace Private Cloud Software can be found in the Getting Started section.

This section discusses the procedure for installing Rackspace Private Cloud Software on VMWare Player 4 on Windows.

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

You can access your workstation's network settings by launching vmnetcfg.exe and looking under NAT Settings and DHCP settings. Use the Start IP Address Range as the IP address of the first VM that you boot.

VMWare Fusion assigns IP addresses ending in .1 to the host network adapters. To use them as gateways from within instances and ensure the passage of outbound traffic from your instances, you must use gateway IP addresses ending in .2.

1. In VMWare Player 4, create a new virtual machine. Select I will install the operating system later.
2. Select Linux and Ubuntu 64-bit for the guest operating system.
3. Name the controller node and select the directory in which to save it, or accept the default.
4. Set the maximum disk size to 20 or more and select the option to store the virtual disk as a single file.
5. Do not launch the instance immediately. Instead, right-click on the virtual machine in the list of VMs and select Virtual Machine Settingsand configure the following settings:
   • Memory: Increase VM memory to a minimum of 4 GB. More memory is preferred.
   • Processors: Allocate 2 or more.
   • CD/DVD (IDE): Select Use ISO image file and navigate to the location where your Rackspace Private Cloud Software ISO is saved to select it.
6. Locate the virtual machine's .vmx file, which you will find in the directory that was assigned in Step 3. Open the file in a text editor and change the value of vcpu.hotadd to "FALSE". Ensure that the variable vhv.enable is present and set to "TRUE".
   

   vcpu.hotadd = "FALSE"
   vhv.enable = "TRUE"

7. Return to VMWare Player and launch the virtual machine. The ISO will launch immediately.
8. After the ISO has launched and loaded, accept the EULA statement.
9. Select Controller.
10. 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.
11. 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.
12. Enter the address for the nova fixed network.
13. If you want to configure a DMZ network, enter the DMZ address and the DMZ gateway address.
14. Enter a password for the admin user. You will use this admin username and password to access the API and the dashboard.
15. 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 tenant) for this user.
16. 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.

17. 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 15. 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

You can access your workstation's network settings by launching vmnetcfg.exe and looking under NAT Settings and DHCP settings. Use the Start IP Address Range as the IP address of the first VM that you boot.

VMWare Fusion assigns IP addresses ending in .1 to the host network adapters. To use them as gateways from within instances and ensure the passage of outbound traffic from your instances, you must use gateway IP addresses ending in .2.

1. In VMWare Player 4, create a new virtual machine. Select I will install the operating system later.
2. Select Linux and Ubuntu 64-bit for the guest operating system.
3. Name the controller node and select the directory in which to save it, or accept the default.
4. Set the maximum disk size to 20 or more and select the option to store the virtual disk as a single file.
5. Do not launch the instance immediately. Instead, right-click on the virtual machine in the list of VMs and select Virtual Machine Settingsand configure the following settings:
   • Memory: Increase VM memory to a minimum of 2 GB. More memory is preferred.
   • Processors: Allocate 2 or more.
   • CD/DVD (IDE): Select Use ISO image file and navigate to the location where your Rackspace Private Cloud Software ISO is saved to select it.
6. Locate the virtual machine's .vmx file, which you will find in the directory that was assigned in Step 3. Open the file in a text editor and change the value of vcpu.hotadd to "FALSE". Ensure that the variable vhv.enable is present and set to "TRUE".
   

   vcpu.hotadd = "FALSE"
   vhv.enable = "TRUE"

7. Return to VMWare Player and launch the virtual machine. The ISO will launch immediately.
8. After the ISO has launched and loaded, accept the EULA statement.
9. Select Compute to install a compute node.
10. 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.
11. 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.
12. 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.

13. 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.
14. 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.