191 lines
6.5 KiB
ReStructuredText
191 lines
6.5 KiB
ReStructuredText
.. raw:: pdf
|
|
|
|
PageBreak
|
|
|
|
.. index:: Red Hat OpenStack
|
|
|
|
Red Hat OpenStack Deployment Notes
|
|
==================================
|
|
|
|
.. contents :local:
|
|
|
|
Overview
|
|
--------
|
|
|
|
Fuel can deploy OpenStack using Red Hat OpenStack packages and Red Hat
|
|
Enterprise Linux Server as a base operating system. Because Red Hat has
|
|
exclusive distribution rights for its products, Fuel cannot be bundled with
|
|
Red Hat OpenStack directly. To work around this issue, you can enter your
|
|
Red Hat account credentials in order to download Red Hat OpenStack Platform.
|
|
The necessary components will be prepared and loaded into Cobbler. There are
|
|
two methods Fuel supports for obtaining Red Hat OpenStack packages:
|
|
|
|
* :ref:`RHSM` (default)
|
|
* :ref:`RHN_Satellite`
|
|
|
|
.. index:: Red Hat OpenStack: Deployment Requirements
|
|
|
|
Deployment Requirements
|
|
-----------------------
|
|
|
|
Minimal Requirements
|
|
++++++++++++++++++++
|
|
|
|
* Red Hat account (https://access.redhat.com)
|
|
* Red Hat OpenStack entitlement (one per node)
|
|
* Internet access for Fuel Master node
|
|
|
|
Optional requirements
|
|
+++++++++++++++++++++
|
|
|
|
* Red Hat Satellite Server
|
|
* Configured Satellite activation key
|
|
|
|
.. _RHSM:
|
|
|
|
Red Hat Subscription Management (RHSM)
|
|
--------------------------------------
|
|
|
|
Benefits
|
|
++++++++
|
|
|
|
* No need to handle large ISOs or physical media.
|
|
* Register all your hosts with just a single username and password.
|
|
* Automatically register the necessary products required for installation.
|
|
* Download only the latest packages.
|
|
* Download only necessary packages.
|
|
|
|
Considerations
|
|
++++++++++++++
|
|
|
|
* Must observe Red Hat licensing requirements after deployment
|
|
* Package download time is dependent on network speed (20-60 minutes)
|
|
|
|
.. seealso::
|
|
|
|
`Overview of Subscription Management - Red Hat Customer
|
|
Portal <https://access.redhat.com/site/articles/143253>`_
|
|
|
|
.. _RHN_Satellite:
|
|
|
|
Red Hat RHN Satellite
|
|
---------------------
|
|
|
|
Benefits
|
|
++++++++
|
|
|
|
* Faster download of Red Hat OpenStack packages
|
|
* Register all your clients with an activation key
|
|
* More granular control of package set for your installation
|
|
* Registered OpenStack hosts don't need external network access
|
|
* Easier to consume for large enterprise customers
|
|
|
|
Considerations
|
|
++++++++++++++
|
|
|
|
* Red Hat RHN Satellite is a separate offering from Red Hat and requires
|
|
dedicated hardware
|
|
* Still requires Red Hat Subscription Manager and Internet access to download
|
|
registration packages (for Master node only)
|
|
|
|
What you need
|
|
+++++++++++++
|
|
|
|
* Red Hat account (https://access.redhat.com)
|
|
* Red Hat OpenStack entitlement (one per host)
|
|
* Internet access for Fuel master host
|
|
* Red Hat Satellite Server
|
|
* Configured Satellite activation key
|
|
|
|
Your RHN Satellite activation key must be configured the following channels
|
|
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
* RHEL Server High Availability
|
|
* RHEL Server Load Balancer
|
|
* RHEL Server Optional
|
|
* RHEL Server Resilient Storage
|
|
* RHN Tools for RHEL
|
|
* Red Hat OpenStack 3.0
|
|
|
|
.. seealso::
|
|
|
|
`Red Hat | Red Hat Network Satellite <http://www.redhat.com/products/enterprise-linux/rhn-satellite/>`_
|
|
|
|
.. _rhn_sat_channels:
|
|
|
|
Fuel looks for the following RHN Satellite channels.
|
|
|
|
* rhel-x86_64-server-6
|
|
* rhel-x86_64-server-6-ost-3
|
|
* rhel-x86_64-server-ha-6
|
|
* rhel-x86_64-server-lb-6
|
|
* rhel-x86_64-server-rs-6
|
|
|
|
.. note:: If you create cloned channels, leave these channel strings intact.
|
|
|
|
.. index:: Red Hat OpenStack: Troubleshooting
|
|
|
|
Troubleshooting Red Hat OpenStack Deployment
|
|
--------------------------------------------
|
|
|
|
Issues downloading from Red Hat Subscription Manager
|
|
++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
If you receive an error from Fuel UI regarding Red Hat OpenStack download
|
|
issues, ensure that you have a valid subscription to the Red Hat OpenStack
|
|
3.0 product. This product is separate from standard Red Hat Enterprise
|
|
Linux. You can check by going to https://access.redhat.com and checking
|
|
Active Subscriptions. Contact your `Red Hat sales representative
|
|
<https://access.redhat.com/site/solutions/368643>`_ to get the proper
|
|
subscriptions associated with your account.
|
|
|
|
If you are still encountering issues, `contact Mirantis
|
|
Support <http://www.mirantis.com/contact/>`_.
|
|
|
|
Issues downloading from Red Hat RHN Satellite
|
|
+++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
If you receive an error from Fuel UI regarding Red Hat OpenStack download
|
|
issues, ensure that you have all the necessary channels available on your
|
|
RHN Satellite Server. The correct list is :ref:`here <rhn_sat_channels>`.
|
|
|
|
If you are missing these channels, please contact your `Red Hat sales
|
|
representative <https://access.redhat.com/site/solutions/368643>`_ to get
|
|
the proper subscriptions associated with your account.
|
|
|
|
RHN Satellite error: "rhel-x86_64-server-rs-6 not found"
|
|
++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
This means your Red Hat Satellite Server has run out of available entitlements
|
|
or your licenses have expired. Check your RHN Satellite to ensure there is at
|
|
least one available entitlement for each of the required channels.
|
|
|
|
If any of these channels are missing or you need to make changes your
|
|
account, please contact your `Red Hat sales representative
|
|
<https://access.redhat.com/site/solutions/368643>`_ to get the proper
|
|
subscriptions associated with your account.
|
|
|
|
Yum Error: Cannot retrieve repository metadata (repomd.xml) for repository: rhel-x86_64-server-6.
|
|
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
This can be caused by many problems. This could happen if your SSL
|
|
certificate does not match the hostname of your RHN Satellite Server or if
|
|
you configured Fuel to use an IP address during deployment. This is not
|
|
recommended and you should use a fully qualified domain name for your RHN
|
|
Satellite Server.
|
|
|
|
You may find solutions to your issues with ``repomd.xml`` at the
|
|
`Red Hat Knowledgebase <https://access.redhat.com/>`_ or contact
|
|
`Red Hat Support. <https://access.redhat.com/support/>`_.
|
|
|
|
GPG Key download failed. Looking for URL your-satellite-server/pub/RHN-ORG-TRUSTED-SSL-CERT
|
|
+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
|
|
|
|
This issue has two known problems. If you are using VirtualBox, this may not
|
|
be properly configured. Ensure that your upstream DNS resolver is correct
|
|
in ``/etc/dnsmasq.upstream``. This setting is configured during the bootstrap
|
|
process, but it is not possible to validate resolution of internal DNS names
|
|
at that time. Also, this may be caused by other DNS issues, local network,
|
|
or incorrect spelling of the RHN Satellite Server. Check your local network
|
|
and settings and try again.
|