OpenStack:Essex Build Node

From DocWiki

(Difference between revisions)
Jump to: navigation, search
m (Ubuntu Installation)
m (Added Category:OpenStack)
 
(35 intermediate revisions not shown)
Line 17: Line 17:
Ensure you have met the following prerequisites:
Ensure you have met the following prerequisites:
-
*Download the Ubuntu Precise ISO to a location that can be accessed by the Build Node CIMC: http://releases.ubuntu.com/12.04/ubuntu-12.04-server-amd64.iso
+
*Make sure you have tested network connectivity.  The Build Node needs to download packages over the Internet to complete the installation.
 +
 
 +
*Download the Ubuntu Precise ISO to a location that can be accessed by the Build Node CIMC: http://releases.ubuntu.com/12.04/ubuntu-12.04.1-server-amd64.iso
*Before starting the installation process, ensure that RAID is configured if a RAID Controller is present.
*Before starting the installation process, ensure that RAID is configured if a RAID Controller is present.
Line 25: Line 27:
*Time synchronization is required for proper operation of the system.  Ensure you have at least one NTP server where nodes can pull time.  Note:  The default preseed file uses the UTC time zone, so ensure UTC is used for the Build Node or make the appropriate changes to the preseed file.
*Time synchronization is required for proper operation of the system.  Ensure you have at least one NTP server where nodes can pull time.  Note:  The default preseed file uses the UTC time zone, so ensure UTC is used for the Build Node or make the appropriate changes to the preseed file.
-
== Ubuntu Installation ==
+
== Starting the Ubuntu Installation ==
-
1. Open your web browser and log into the CIMC of the Build Node.
+
<ol style="list-style-type: decimal;">
-
2. Select BIOS under the Server tab and ensure that the boot order starts with CD/DVD and then Hard Disk.  Note:  Since the Build Node is being built manually; PXE Boot is not a necessary boot option.   
+
<li><p>Open your web browser and log into the Cisco UCS CIMC of the Build Node.</p>
-
3. Launch the Virtual KVM and accept any security warnings that may appear.
+
 
-
4. Mount the Ubuntu Precise ISO by selecting the Virtual Media tab, click Add Image… and browse to the location of the Ubuntu Precise ISO previously downloaded (from the Prerequisites Section).  Lastly, make sure the Mapped check box is checked.
+
<li><p>Select BIOS under the Server tab and ensure that the boot order starts with CD/DVD and then Hard Disk.  '''Note:''' Since the Build Node is being built manually; PXE Boot is not a necessary boot option.</p>
 +
   
 +
<li><p>Launch the Virtual KVM and accept any security warnings that may appear.</p>
-
[[File:iso.png]]
+
<li><p>Mount the Ubuntu Precise ISO by selecting the Virtual Media tab, click Add Image… and browse to the location of the Ubuntu Precise ISO previously downloaded (from the Prerequisites Section).  Lastly, make sure the Mapped check box is checked.</p>
 +
 
 +
[[File:load_iso.png]]
 +
 
 +
<li><p>Reboot the node.</p>
 +
<li><p>The server will reboot and should boot from the Ubuntu ISO.  You will be presented with a screen to install Ubuntu Server 12.04.</p>
[[File:Ubuntu_install.png]]
[[File:Ubuntu_install.png]]
 +
 +
<li><p>Select Install Ubuntu Server from the Main Menu.</p>
 +
 +
<li><p>Select your desired language.</p>
 +
 +
<li><p>Select your desired Country or Territory.</p>
 +
 +
<li><p>From the Configure the keyboard menu, select <No> to Detect keyboard layout.</p>
 +
 +
<li><p>Select your desired country from Configure the keyboard > Country of Origin.</p>
 +
 +
<li><p>Select your desired language from Configure the keyboard > Keyboard layout.</p></li></ol>
 +
 +
=== Ubuntu Installation Network Settings ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>From Configure the network menu, select eth0 as your Primary network interface:</p>
 +
 +
*Your server will dynamically receive IP addressing information if DHCP is configured for the network connecting to your primary network interface.
 +
 +
*If DHCP is not configured or working properly on the network connecting to your primary interface, the installation will notify you:
 +
 +
[[File:config_net.png]]
 +
 +
<li><p>Hit return to continue if you are not using DHCP or wish to retry network auto configuration.</p>
 +
 +
<li><p>Select configure network manually</p>
 +
 +
<p>'''Note:''' We recommend configuring the Build Node with static network settings even if DHCP is used during the installation process.</p>
 +
 +
[[File:config_net2.png]]
 +
 +
<li><p>Enter the IP address you wish to assign to the Build Node.  The installer will automatically assign .1 as the gateway.  Change if necessary.  Otherwise hit return to continue the installation.</p>
 +
 +
<li><p>Enter the IP address(es) for up to 3 name (DNS) servers.  Separate the DNS server IP addresses by spaces, not commas.  Your server will query the name servers in the order entered.  Leave this field blank if you will not use name servers, or you wish to add the name servers at a later time.</p>
 +
 +
<p>'''Note:''' Name resolution is required for the proper operation of several services within a multi-node OpenStack deployment.  Add static records for OpenStack nodes in the /etc/hosts file if a DNS Server will not be used.</p>
 +
 +
[[File:config_net3.png]]
 +
 +
<li><p>Enter the hostname (a single word) that identifies your system.  The hostname should match the associated DNS Host record entry (referenced in the Prerequisites Section).</p>
 +
 +
[[File:config_net4.png]]
 +
 +
<li><p>Enter the Domain Name that the server will belong to. Note: Make sure you use the same Domain Name for all your OpenStack Nodes.</p>
 +
 +
[[File:config_net5.png]]
 +
 +
<li><p>Select the desired location for your Ubuntu archive mirror country.  These mirrors provide repositories and archives of all software for the Ubuntu distribution.</p>
 +
 +
<li><p>Confirm the name of your Ubuntu archive mirror.</p>
 +
 +
<li><p>Enter Proxy information if you need to use a Proxy to get to the Internet or leave it blank and hit enter if none.  Proxy information should be provided in the standard form: http://[[user][:password]@]host[:port]/ </p>
 +
 +
<li><p>The installer will begin loading additional software components.</p>
 +
 +
<li><p>The installer will automatically detect your time zone.  Make sure you select UTC (last option in list) as the time zone.  This is important as the default Cobbler preseed for nodes is UTC and time much be synchronized across all nodes.  Make sure to modify the preseed template in the cobbler::preseed manifest if you use a timezone other than UTC</p></li></ol>
 +
 +
=== Ubuntu Installation: Hard Disk Settings ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>The installer will begin detecting hard disks and hardware components.  '''Note:'''  If RAID is configured properly, only a single disk that represents the RAID Group should appear in the detected hard drive list.</p>
 +
 +
<li><p>You are then presented with options for partitioning your local hard disk. Select the Guided – use entire disk option and hit return.</p>
 +
 +
<li><p>Accept the warning message about lost data on the disk.</p>
 +
 +
<li><p>Select <Yes> to write the changes to disk and hit return.</p>
 +
 +
<li><p>The installer will then create the file system and install the base system.</p></li></ol>
 +
 +
=== Ubuntu Installation: User Account Settings ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>Create a Real Name (ex> John Doe) for the user account.  This is the account used for not administrative (root) purposes.</p>
 +
 +
<li><p>Select a username for the new account.  '''Note:''' We use localadmin as the username in our documentation.</p>
 +
 +
<li><p>Provide and verify password for the new username.  '''Note:''' We use ubuntu as the password in our documentation.</p>
 +
 +
<li><p>Select no to the encrypt your home directory option.  The software installation process will begin.</p></li></ol>
 +
 +
=== Ubuntu Installation: Configuring Discover Setting ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>Select No to the automatic updates option from the Configuring discover menu</p></li></ol>
 +
 +
=== Ubuntu Installation: Software Selection Settings ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>Only select OpenSSH server from Choose software to install list.</p></li></ol>
 +
 +
=== Ubuntu Installation: GRUB Boot Loader Setting ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>Select <Yes> to install the GRUB boot loader to the master boot record.</p></li></ol>
 +
 +
=== Ubuntu Installation: Finish the Installation ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>Your installation is now complete.  Select <Continue> complete the Ubuntu 12.04 Server installation.</p></li></ol>
 +
 +
=== Ubuntu Installation: Post Installation ===
 +
 +
<ol style="list-style-type: decimal;">
 +
<li><p>Click on the UCS Virtual Media tab to remove the Ubuntu 12.04 ISO.</p>
 +
 +
<li><p>Click on the UCS KVM tab to view the booting process.</p>
 +
 +
*'''Note:''' Verify your BIOS setting (C-Series) or boot policy (UCS B-Series) if your server does not select the local hard drive as the first boot device.
 +
 +
<li><p>After the server reboots, login using the Virtual KVM Console or through SSH.</p>
 +
 +
<li><p>Apply software updates.  '''Note:''' preface commands with sudo if you do not have root privileges.</p>
 +
 +
<pre>apt-get update && apt-get dist-upgrade -y</pre>
 +
 +
<li><p>Restart the system</p>
 +
 +
<pre>reboot now</pre>
 +
 +
<li><p>Ping the ip address of the Build Node to see when it comes back from reboot</p>
 +
 +
<pre>ping <build_node_ip_addr></pre>
 +
 +
<li><p>When you begin receiving ping replies, SSH to the Build Node IP address</p>
 +
 +
<pre>ssh localadmin@<build_node_ip_addr></pre></li></ol>
 +
 +
== Cisco Repository and Packages Installation ==
 +
 +
Skip the steps in this section except the '''Additional Required Packages''' if you will be deploying an [http://docwiki.cisco.com/wiki/OpenStack:Essex_Multi_Node_HA Essex High Availability OpenStack] environment.
 +
 +
1. After the Build Node has rebooted and you have logged-in, add one of the following Cisco Mirror repositories. 
 +
<pre>apt-get install python-software-properties -y
 +
 +
# For OpenStack Folsom Release
 +
add-apt-repository ppa:cisco-openstack-mirror/cisco-folsom
 +
 +
# For OpenStack Essex Release
 +
add-apt-repository ppa:cisco-openstack-mirror/cisco
 +
 +
apt-get update</pre>
 +
 +
2. Now that the Cisco Mirror repo has been added, install the Cisco Puppet Modules (installed into /usr/share/puppet/modules). 
 +
<pre>apt-get install puppet-openstack-cisco  </pre>
 +
 +
3. Optionally, you can install the following packages.
 +
 +
*'''Documentation''' (installed into /usr/share/doc/cisco-openstack-docs):
 +
<pre>apt-get install cisco-openstack-docs</pre>
 +
 +
*'''Utilities'''' (installed into /usr/share/doc/cisco-openstack-utils):
 +
<pre>apt-get install cisco-openstack-utils</pre>
 +
 +
*'''Additional Required Packages'''
 +
<pre>apt-get install ntp puppet git ipmitool -y</pre>
 +
 +
If your cisco-openstack-utils package does not include the clean_node.sh script, then pull cisco-openstack-docs directly from the Cisco GitHub repository. 
 +
<pre>git clone https://github.com/CiscoSystems/cisco-openstack-docs ~/os-docs</pre>
 +
 +
== References ==
 +
 +
*Wikipedia- Disk Partitioning: http://en.wikipedia.org/wiki/Disk_partitioning#PC_partition_types
 +
 +
*Cisco System GitHub Home: https://github.com/CiscoSystems/
 +
 +
*Ubuntu 12.04 Server Guide Advanced Installation: https://help.ubuntu.com/12.04/serverguide/C/advanced-installation.html
 +
 +
== Next Steps ==
 +
 +
'''For OpenStack Essex Deployments:'''
 +
 +
*High Availability Deployment Guide: http://docwiki.cisco.com/wiki/OpenStack:Essex_Multi_Node_HA
 +
 +
*All-In-One Deployment Guide: http://docwiki.cisco.com/wiki/OpenStack:Essex_All_In_One
 +
 +
'''For OpenStack Folsom Deployments:'''
 +
 +
*Multi-Node Deployment Guide: http://docwiki.cisco.com/wiki/OpenStack:Folsom-Multinode
 +
 +
== Feedback ==
 +
 +
Provide documentation bugs or feedback to [mailto:openstack-support@cisco.com openstack-support@cisco.com]
 +
 +
[[Category:OpenStack]]

Latest revision as of 01:30, 4 March 2014

Contents

Introduction

The Build Node Deployment Guide provides instructions for deploying an OpenStack Build Node. The Build Node consists of several software components used to automate the deployment and management of an OpenStack environment.

Dependencies

The Build Node is based on the following software versions:

  • Ubuntu: 12.04
  • Cobbler: 2.2.2-0ubuntu33
  • Puppet: 2.7.11
  • DNSMASQ: 2.59-4
  • NTP: 1:4.2.6.p3+dfsg-1ubuntu3.1

Prerequisites

Ensure you have met the following prerequisites:

  • Make sure you have tested network connectivity. The Build Node needs to download packages over the Internet to complete the installation.
  • Before starting the installation process, ensure that RAID is configured if a RAID Controller is present.
  • Create a DNS entry for the name of the Build Node. Note: By default Puppet Agents expect to register to the Puppet Master with the name puppet. If the name of the Build Node is not puppet, ensure puppet.conf is configured with the correct name of the Build Node. This is typically accomplished using the cobbler-node.pp file.
  • Time synchronization is required for proper operation of the system. Ensure you have at least one NTP server where nodes can pull time. Note: The default preseed file uses the UTC time zone, so ensure UTC is used for the Build Node or make the appropriate changes to the preseed file.

Starting the Ubuntu Installation

  1. Open your web browser and log into the Cisco UCS CIMC of the Build Node.

  2. Select BIOS under the Server tab and ensure that the boot order starts with CD/DVD and then Hard Disk. Note: Since the Build Node is being built manually; PXE Boot is not a necessary boot option.

  3. Launch the Virtual KVM and accept any security warnings that may appear.

  4. Mount the Ubuntu Precise ISO by selecting the Virtual Media tab, click Add Image… and browse to the location of the Ubuntu Precise ISO previously downloaded (from the Prerequisites Section). Lastly, make sure the Mapped check box is checked.

    Load iso.png

  5. Reboot the node.

  6. The server will reboot and should boot from the Ubuntu ISO. You will be presented with a screen to install Ubuntu Server 12.04.

    Ubuntu install.png

  7. Select Install Ubuntu Server from the Main Menu.

  8. Select your desired language.

  9. Select your desired Country or Territory.

  10. From the Configure the keyboard menu, select <No> to Detect keyboard layout.

  11. Select your desired country from Configure the keyboard > Country of Origin.

  12. Select your desired language from Configure the keyboard > Keyboard layout.

Ubuntu Installation Network Settings

  1. From Configure the network menu, select eth0 as your Primary network interface:

    • Your server will dynamically receive IP addressing information if DHCP is configured for the network connecting to your primary network interface.
    • If DHCP is not configured or working properly on the network connecting to your primary interface, the installation will notify you:

    Config net.png

  2. Hit return to continue if you are not using DHCP or wish to retry network auto configuration.

  3. Select configure network manually

    Note: We recommend configuring the Build Node with static network settings even if DHCP is used during the installation process.

    Config net2.png

  4. Enter the IP address you wish to assign to the Build Node. The installer will automatically assign .1 as the gateway. Change if necessary. Otherwise hit return to continue the installation.

  5. Enter the IP address(es) for up to 3 name (DNS) servers. Separate the DNS server IP addresses by spaces, not commas. Your server will query the name servers in the order entered. Leave this field blank if you will not use name servers, or you wish to add the name servers at a later time.

    Note: Name resolution is required for the proper operation of several services within a multi-node OpenStack deployment. Add static records for OpenStack nodes in the /etc/hosts file if a DNS Server will not be used.

    Config net3.png

  6. Enter the hostname (a single word) that identifies your system. The hostname should match the associated DNS Host record entry (referenced in the Prerequisites Section).

    Config net4.png

  7. Enter the Domain Name that the server will belong to. Note: Make sure you use the same Domain Name for all your OpenStack Nodes.

    Config net5.png

  8. Select the desired location for your Ubuntu archive mirror country. These mirrors provide repositories and archives of all software for the Ubuntu distribution.

  9. Confirm the name of your Ubuntu archive mirror.

  10. Enter Proxy information if you need to use a Proxy to get to the Internet or leave it blank and hit enter if none. Proxy information should be provided in the standard form: http://[[user][:password]@]host[:port]/

  11. The installer will begin loading additional software components.

  12. The installer will automatically detect your time zone. Make sure you select UTC (last option in list) as the time zone. This is important as the default Cobbler preseed for nodes is UTC and time much be synchronized across all nodes. Make sure to modify the preseed template in the cobbler::preseed manifest if you use a timezone other than UTC

Ubuntu Installation: Hard Disk Settings

  1. The installer will begin detecting hard disks and hardware components. Note: If RAID is configured properly, only a single disk that represents the RAID Group should appear in the detected hard drive list.

  2. You are then presented with options for partitioning your local hard disk. Select the Guided – use entire disk option and hit return.

  3. Accept the warning message about lost data on the disk.

  4. Select <Yes> to write the changes to disk and hit return.

  5. The installer will then create the file system and install the base system.

Ubuntu Installation: User Account Settings

  1. Create a Real Name (ex> John Doe) for the user account. This is the account used for not administrative (root) purposes.

  2. Select a username for the new account. Note: We use localadmin as the username in our documentation.

  3. Provide and verify password for the new username. Note: We use ubuntu as the password in our documentation.

  4. Select no to the encrypt your home directory option. The software installation process will begin.

Ubuntu Installation: Configuring Discover Setting

  1. Select No to the automatic updates option from the Configuring discover menu

Ubuntu Installation: Software Selection Settings

  1. Only select OpenSSH server from Choose software to install list.

Ubuntu Installation: GRUB Boot Loader Setting

  1. Select <Yes> to install the GRUB boot loader to the master boot record.

Ubuntu Installation: Finish the Installation

  1. Your installation is now complete. Select <Continue> complete the Ubuntu 12.04 Server installation.

Ubuntu Installation: Post Installation

  1. Click on the UCS Virtual Media tab to remove the Ubuntu 12.04 ISO.

  2. Click on the UCS KVM tab to view the booting process.

    • Note: Verify your BIOS setting (C-Series) or boot policy (UCS B-Series) if your server does not select the local hard drive as the first boot device.
  3. After the server reboots, login using the Virtual KVM Console or through SSH.

  4. Apply software updates. Note: preface commands with sudo if you do not have root privileges.

    apt-get update && apt-get dist-upgrade -y
  5. Restart the system

    reboot now
  6. Ping the ip address of the Build Node to see when it comes back from reboot

    ping <build_node_ip_addr>
  7. When you begin receiving ping replies, SSH to the Build Node IP address

    ssh localadmin@<build_node_ip_addr>

Cisco Repository and Packages Installation

Skip the steps in this section except the Additional Required Packages if you will be deploying an Essex High Availability OpenStack environment.

1. After the Build Node has rebooted and you have logged-in, add one of the following Cisco Mirror repositories.

apt-get install python-software-properties -y

# For OpenStack Folsom Release
add-apt-repository ppa:cisco-openstack-mirror/cisco-folsom 

# For OpenStack Essex Release
add-apt-repository ppa:cisco-openstack-mirror/cisco 

apt-get update

2. Now that the Cisco Mirror repo has been added, install the Cisco Puppet Modules (installed into /usr/share/puppet/modules).

apt-get install puppet-openstack-cisco  

3. Optionally, you can install the following packages.

  • Documentation (installed into /usr/share/doc/cisco-openstack-docs):
apt-get install cisco-openstack-docs
  • Utilities' (installed into /usr/share/doc/cisco-openstack-utils):
apt-get install cisco-openstack-utils
  • Additional Required Packages
apt-get install ntp puppet git ipmitool -y

If your cisco-openstack-utils package does not include the clean_node.sh script, then pull cisco-openstack-docs directly from the Cisco GitHub repository.

git clone https://github.com/CiscoSystems/cisco-openstack-docs ~/os-docs

References

Next Steps

For OpenStack Essex Deployments:

For OpenStack Folsom Deployments:

Feedback

Provide documentation bugs or feedback to openstack-support@cisco.com

Rating: 5.0/5 (3 votes cast)

Personal tools