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 Fusion on Mac.

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 find your workstation's network settings by running ifconfig in your terminal.

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. The Controller node should end in .3.

1. In VMWare Fusion, create a new virtual machine. Click Continue without discto move on to the Installation Media screen.
2. Select Use operating system installation disc or image and click on the drop-down menu to navigate to and select the Rackspace Private Cloud Software ISO.
3. Accept the default OS (Linux, Ubuntu 64-bit) and deselect the Easy Install option, if offered.
4. Click Customize Settingsto edit the following VM settings:
   • Processors & Memory: Allocate 2 or more processors and increase VM memory to a minimum of 4 GB. More memory is preferred.
   • Hard Disk (SCSI): Allocate a minimum of 20 GB.
5. Edit the virtual machine's .vmx file. To access it, you may need to right-click on its .vmwarevm file and select Show Package Contents. Change the value of vcpu.hotadd to "FALSE" and add the variable vhv.enable, setting it to "TRUE".
   

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

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

16. 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+Fn+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 14. 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 find your workstation's network settings by running ifconfig in your terminal.

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. The Compute node should end in .4.

1. In VMWare Fusion, create a new virtual machine. Click Continue without disc to move on to the Installation Media screen.
2. Select Use operating system installation disc or image and click on the drop-down menu to navigate to and select the Rackspace Private Cloud Software ISO.
3. Accept the default OS (Linux, Ubuntu 64-bit) and deselect the Easy Install option, if offered.
4. Click Customize Settingsto edit the following VM settings:
   • Processors & Memory: Allocate 2 or more processors and increase VM memory to a minimum of 2 GB. More memory is preferred.
   • Hard Disk (SCSI): Allocate a minimum of 20 GB.
5. Edit the virtual machine's .vmx file. To access it, you may need to right-click on its .vmwarevm file and select Show Package Contents. Change the value of vcpu.hotadd to "FALSE" and add the variable vhv.enable, setting it to "TRUE".
   

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

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

12. 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.
13. 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+Fn+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.