K Documentation Updates

Renamed SUSE Cloud to SUSE OpenStack Cloud.

Reorganized the manual by introducing parts and splitting long chapters to improve readability.

All nodes including the Administration Server are now based on SUSE Linux Enterprise Server 12 SP1. The documentation has been updated accordingly.

Rewrote large parts of Chapter 5, Software Repository Setup because repository handling in SUSE OpenStack Cloud has been made easier. Furthermore, repositories are no longer provided by the Novell Customer Center, but rather by the SUSE Customer Center.

Added Chapter 8, The Crowbar Web Interface.

Added documentation for the new Web interface-based installation of the Administration Server (Section 7.6.1, “Starting the SUSE OpenStack Cloud Crowbar Installation from the Web Interface”).

A new backup procedure has been added to SUSE OpenStack Cloud (Section 11.5, “Backing Up and Restoring the Administration Server”).

Section 11.3, “Upgrading from SUSE OpenStack Cloud 5 to SUSE OpenStack Cloud 6” is now done via a Web interface.

Added Section 11.2, “Service Order on SUSE OpenStack Cloud Start-up or Shutdown”.

Added Appendix J, Recovering Clusters to a Healthy State.

SUSE OpenStack Cloud 6 supports Manila a Shared File System Service (Section 10.10, “Deploying Manila”).

Added Appendix E, Configuring Role Based Access Control (RBAC).

Updated repository links and paths in Chapter 5, Software Repository Setup (http://bugzilla.suse.com/show_bug.cgi?id=862056, http://bugzilla.suse.com/show_bug.cgi?id=956681, and https://bugzilla.suse.com/show_bug.cgi?id=956686).

Provided a full list of OpenStack roles and services in Appendix C, Roles and Services in SUSE OpenStack Cloud (http://bugzilla.suse.com/show_bug.cgi?id=875149).

SUSE OpenStack Cloud does not support High Availability for the LBaaS service plug-in (http://bugzilla.suse.com/show_bug.cgi?id=881510).

Provided instructions on how to change keymap on Compute Nodes (http://bugzilla.suse.com/show_bug.cgi?id=906846).

Added a link to the SUSE Enterprise Storage documentation to Section 2.6.4.2, “Ceph—Avoiding Points of Failure” (http://bugzilla.suse.com/show_bug.cgi?id=917344).

An HA setup for Trove is not supported (http://bugzilla.suse.com/show_bug.cgi?id=919471).

Added the new section Section 11.2, “Service Order on SUSE OpenStack Cloud Start-up or Shutdown”. (http://bugzilla.suse.com/show_bug.cgi?id=919476).

Repositories are distributed by the SUSE Customer Center (http://bugzilla.suse.com/show_bug.cgi?id=919844).

Updates on adding an external Ceph cluster at Section 9.4.4.2, “Making Ceph Available on the SUSE OpenStack Cloud Nodes” (http://bugzilla.suse.com/show_bug.cgi?id=923117 and http://bugzilla.suse.com/show_bug.cgi?id=924001).

Added documentation for VXLAN support at Section 10.11, “Deploying Neutron” (http://bugzilla.suse.com/show_bug.cgi?id=923218).

HA cluster nodes need to be put into maintenance mode prior to updating packages (http://bugzilla.suse.com/show_bug.cgi?id=923962).

Added an explanation on Distributed Virtual Routers (DVR) to Section 10.11, “Deploying Neutron” (http://bugzilla.suse.com/show_bug.cgi?id=925438).

New technology preview feature: Docker support (http://bugzilla.suse.com/show_bug.cgi?id=926224).

Added instructions on how to disable PXE and DNS services on the Administration Server to allow custom provisioning at OpenStack Node Deployment (http://bugzilla.suse.com/show_bug.cgi?id=929081 and https://bugzilla.suse.com/show_bug.cgi?id=920826).

Added instructions on how to enable jumbo frames at Section 7.5, “Custom Network Configuration” (http://bugzilla.suse.com/show_bug.cgi?id=930744).

Added the new appendix Appendix E, Configuring Role Based Access Control (RBAC) (http://bugzilla.suse.com/show_bug.cgi?id=931856).

Ceilometer is also supported on HyperV Compute Nodes (http://bugzilla.suse.com/show_bug.cgi?id=932314).

Added instructions on how to install additional packages to Admin Node Deployment (http://bugzilla.suse.com/show_bug.cgi?id=936244).

Public and floating networks can be split using different VLANs (http://bugzilla.suse.com/show_bug.cgi?id=936984).

Calamari needs to be deployed on a dedicated node (http://bugzilla.suse.com/show_bug.cgi?id=940189).

Setting REPOS_SKIP_CHECKS is no longer needed on SUSE OpenStack Cloud 6 (http://bugzilla.suse.com/show_bug.cgi?id=940941).

Provided better examples for /etc/crowbar/network.json in Appendix D, The Network Barclamp Template File (http://bugzilla.suse.com/show_bug.cgi?id=944074).

Added a solution for fixing nodes in state Problem at OpenStack Node Deployment (http://bugzilla.suse.com/show_bug.cgi?id=945436).

The openvswitch with VLAN configuration for neutron-l3 no longer requires a 4 NIC configuration (http://bugzilla.suse.com/show_bug.cgi?id=946874).

The Web interface now contains a Repositories screen showing an overview of the repositories of SUSE OpenStack Cloud (http://bugzilla.suse.com/show_bug.cgi?id=952643).

Added documentation for the Cisco USC support at Section 8.2.3, “Utilities” (http://bugzilla.suse.com/show_bug.cgi?id=953982).

Added the FAQ How to provide Kernel Parameters for the SLEShammer Discovery Image? (http://bugzilla.suse.com/show_bug.cgi?id=954413).

SUSE OpenStack Cloud 6 supports Manila a Shared File System Service (http://bugzilla.suse.com/show_bug.cgi?id=956234).

Errors in Section 10.1.1, “Delete a Proposal That Already Has Been Deployed” have been fixed (http://bugzilla.suse.com/show_bug.cgi?id=956244).

Renamed SUSE Cloud to SUSE OpenStack Cloud (http://bugzilla.suse.com/show_bug.cgi?id=956431).

Updates for the Swift barclamp (http://bugzilla.suse.com/show_bug.cgi?id=956659).

Updates for the Glance barclamp (http://bugzilla.suse.com/show_bug.cgi?id=956664).

Updates for the Cinder barclamp (http://bugzilla.suse.com/show_bug.cgi?id=956666).

Updates for the Neutron barclamp (http://bugzilla.suse.com/show_bug.cgi?id=956669).

Updates for the Nova barclamp (http://bugzilla.suse.com/show_bug.cgi?id=956900).

OpenAIS has been replaced by Corosync (http://bugzilla.suse.com/show_bug.cgi?id=956670).

Updates for the list of services at Section 2.3, “SSL Encryption” (http://bugzilla.suse.com/show_bug.cgi?id=956675).

Updates for the Ceilometer barclamp (http://bugzilla.suse.com/show_bug.cgi?id=956676).

Updates for Section 2.5, “Software Requirements” (http://bugzilla.suse.com/show_bug.cgi?id=956679).

Updated Chapter 4, Installing and Setting Up an SMT Server on the Administration Server (Optional) (http://bugzilla.suse.com/show_bug.cgi?id=956680).

Minor changes in Section 12.1, “FAQ” (http://bugzilla.suse.com/show_bug.cgi?id=956682).

Services on SUSE Linux Enterprise Server 12 SP1 are started via the systemctl command (http://bugzilla.suse.com/show_bug.cgi?id=956683).

New attributes for the Appendix D, The Network Barclamp Template File (http://bugzilla.suse.com/show_bug.cgi?id=956684).

Added documentation for the new Web interface-based installation of the Administration Server to Section 7.6.1, “Starting the SUSE OpenStack Cloud Crowbar Installation from the Web Interface”. (http://bugzilla.suse.com/show_bug.cgi?id=956869).

Document the possibility to set the node file system at Section 9.2, “Node Installation” (http://bugzilla.suse.com/show_bug.cgi?id=956874).

Horizon SSL options do not match (http://bugzilla.suse.com/show_bug.cgi?id=959335).

The new backup procedure has been documented at Section 11.5, “Backing Up and Restoring the Administration Server”. (http://bugzilla.suse.com/show_bug.cgi?id=962576).

Added documentation about deploying HA for Compute Nodes (http://bugzilla.suse.com/show_bug.cgi?id=964205).

Apache needs to be restarted before starting the installation from the Web interface (http://bugzilla.suse.com/show_bug.cgi?id=966158).

Added Appendix J, Recovering Clusters to a Healthy State (http://bugzilla.suse.com/show_bug.cgi?id=966158).

Provided additional information on bonding modes at Section 7.3, “Network Mode” (Doc Comment 29562).

An HA setup of Ceilometer needs to be installed on a cluster with an odd number of nodes (Doc Comment 26861).

Completely rewrote Section 2.5, “Software Requirements”. Added information about subscriptions, optional features, media layout and repositories.

Split the chapter into two separate parts.

Transferred the optional SMT installation to the appendix (Chapter 4, Installing and Setting Up an SMT Server on the Administration Server (Optional)) to improve the readability.

Added information about SLES 12 and SUSE Enterprise Storage repositories and adjusted the repository paths to the new structure.

Removed information about linking to local SMT repositories— this is now done automatically by the installation script.

Completely rewrote Chapter 5, Software Repository Setup to make it easier to read.

Updated screenshots where necessary.

Added Section 10.5.1.2, “Using Hybrid Authentication”.

Updated Section 10.6, “Deploying Ceph (optional)” because of new configuration options, roles and the fact that Ceph needs SLES 12 nodes.

Updated Section 10.9, “Deploying Cinder” by adding instructions on how to deploy multiple back-ends. Also added descriptions for additional back-ends Fujitsu EXTERNUS DX and VMware.

Updated Section 10.11, “Deploying Neutron” because of changes in the barclamp.

Added Section 10.16, “Deploying Trove (Optional)”.

Added Miscellaneous.

Added How to change the default keymap for instances?.

Added VMware Compute Node system requirements to Section G.1, “Requirements”.

Added Section G.4, “Making the Nova Compute VMware Node Highly Available”.

Added Appendix I, Crowbar Batch.

Added a warning about old database files on shared storage to Section 10.3.1, “HA Setup for the Database” (https://bugzilla.suse.com/show_bug.cgi?id=875696).

Added information about log files written during the upgrade procedure to Section 11.3, “Upgrading from SUSE OpenStack Cloud 5 to SUSE OpenStack Cloud 6” and Appendix A, Log Files (https://bugzilla.suse.com/show_bug.cgi?id=892497).

Added Section 10.16, “Deploying Trove (Optional)” (https://bugzilla.suse.com/show_bug.cgi?id=893876).

Fixed deployment order of barclamps (https://bugzilla.suse.com/show_bug.cgi?id=894063).

Fixed wrong group names and file names in Section 9.4.4, “Using an Externally Managed Ceph Cluster” (http://bugzilla.suse.com/show_bug.cgi?id=894231).

Added Section 10.5.1.2, “Using Hybrid Authentication” (https://bugzilla.suse.com/show_bug.cgi?id=894572).

Fixed various minor issues in chapters Chapter 2, Considerations and Requirements and Chapter 3, Installing the Administration Server (https://bugzilla.suse.com/show_bug.cgi?id=895593).

Updated Section 10.9, “Deploying Cinder” by adding instructions on how to deploy multiple back-ends. Also added descriptions for additional back-ends Fujitsu EXTERNUS DX and VMware (https://bugzilla.suse.com/show_bug.cgi?id=889729).

Added a pointer to man mount(8) to Section 10.3.1, “HA Setup for the Database” (https://bugzilla.suse.com/show_bug.cgi?id=898538/).

Documented the Region Name at Section 10.5, “Deploying Keystone” (https://bugzilla.suse.com/show_bug.cgi?id=900090).

Added VMware Compute Node system requirements to Section G.1, “Requirements” (https://bugzilla.suse.com/show_bug.cgi?id=903676).

crowbar-backup (Section 11.5, “Backing Up and Restoring the Administration Server”) is now officially supported by SUSE (http://bugzilla.suse.com/show_bug.cgi?id=904374).

The YaST Crowbar module now supports adding custom repositories, which no longer makes it necessary to manually edit /etc/crowbar/provisioner.js (https://bugzilla.suse.com/show_bug.cgi?id=906267>).

Added How to change the default keymap for instances? (https://bugzilla.suse.com/show_bug.cgi?id=906846).

Corrected the number of nodes required for deploying Ceph-mon (https://bugzilla.suse.com/show_bug.cgi?id=907329).

Added installation details for an HA database setup using a shared NFS directory to Section 10.3.1, “HA Setup for the Database” (http://bugzilla.suse.com/show_bug.cgi?id=910061).

Added a link to the CinderSupportMatrix in Section 2.2.1, “Cloud Storage Services” (http://bugzilla.suse.com/show_bug.cgi?id=910843).

Added Miscellaneous (http://bugzilla.suse.com/show_bug.cgi?id=911336).

Updated Section 10.6, “Deploying Ceph (optional)” (https://bugzilla.suse.com/show_bug.cgi?id=912609).

Updated Appendix A, Log Files (https://bugzilla.suse.com/show_bug.cgi?id=912699).

Documented changes in Section 10.9, “Deploying Cinder” regarding the NetApp back-end (https://bugzilla.suse.com/show_bug.cgi?id=914711).

Added Section G.4, “Making the Nova Compute VMware Node Highly Available” (https://bugzilla.suse.com/show_bug.cgi?id=914730).

Added Appendix I, Crowbar Batch (https://bugzilla.suse.com/show_bug.cgi?id=915697).

Updated Section 10.11, “Deploying Neutron” because of changes in the barclamp (https://bugzilla.suse.com/show_bug.cgi?id=916036).

Corrected the SBD setup description in Section 10.2, “Deploying Pacemaker (Optional, HA Setup Only)” (https://bugzilla.suse.com/show_bug.cgi?id=916351).

Added information on Ceph Calamari to Section 10.6, “Deploying Ceph (optional)” (https://bugzilla.suse.com/show_bug.cgi?id=916616).

Added information about Ceph requiring SLES 12 nodes (https://bugzilla.suse.com/show_bug.cgi?id=916585, https://bugzilla.suse.com/show_bug.cgi?id=916907 and https://bugzilla.suse.com/show_bug.cgi?id=916918).

Added a warning about not to set up shared storage in a productive SUSE OpenStack Cloud (https://bugzilla.suse.com/show_bug.cgi?id=917334).

Added the section Section 7.5.1, “Providing Access to External Networks” (http://bugzilla.suse.com/show_bug.cgi?id=882795).

Updated the barclamp descriptions where necessary.

Updated screenshots where necessary.

Added the section Section 10.1.2, “Queuing/Dequeuing Proposals” (http://bugzilla.suse.com/show_bug.cgi?id=882825).

Added an explanation for the new option Policy when cluster does not have quorum to Section 10.2, “Deploying Pacemaker (Optional, HA Setup Only)” (http://bugzilla.suse.com/show_bug.cgi?id=875776).

Added a list of Neutron plugins which can be used with VMware (http://bugzilla.suse.com/show_bug.cgi?id=880128).

Added the section Section 7.5.1, “Providing Access to External Networks” (http://bugzilla.suse.com/show_bug.cgi?id=882795).

Added an annotation to Section 5.1, “Copying the Product Media Repositories” explaining why not to use symbolic links for the SUSE Linux Enterprise Server product repository (http://bugzilla.suse.com/show_bug.cgi?id=886196).

Added an explanation explaining the need to use a sub-domain in Section 2.1.4, “DNS and Host Names” (http://bugzilla.suse.com/show_bug.cgi?id=886563).

Added the section Section 10.1.2, “Queuing/Dequeuing Proposals” (http://bugzilla.suse.com/show_bug.cgi?id=882825).

Cleaned up network ranges in Section 2.1.1, “Network Address Allocation” (http://bugzilla.suse.com/show_bug.cgi?id=885807).

Corrected annotation on VLAN settings (http://bugzilla.suse.com/show_bug.cgi?id=885814).

Fixed an error about using openvswitch with Windows server integration in Section 10.11, “Deploying Neutron” (http://bugzilla.suse.com/show_bug.cgi?id=889602).

Updated the upgrade procedure in Section 11.3, “Upgrading from SUSE OpenStack Cloud 5 to SUSE OpenStack Cloud 6” (http://bugzilla.suse.com/show_bug.cgi?id=889663).

Re-wrote Chapter 7, Crowbar Setup because YaST now supports Crowbar user management, setting up a bastion network and configuring external repository URLs.

Added the section Section 9.4.4, “Using an Externally Managed Ceph Cluster”.

Added the section Section 9.3, “Converting Existing SUSE Linux Enterprise Server 12 SP1 Machines Into SUSE OpenStack Cloud Nodes”.

Added the FAQ How to change the default disk used for operating system installation? to Section 12.1, “FAQ”.

Updated Appendix G, VMware vSphere Installation Instructions.

Lots of minor changes in Chapter 10, Deploying the OpenStack Services because of changes in the Web interface.

Added Section 10.14, “Deploying Heat (Optional)”.

Added Section 10.15, “Deploying Ceilometer (Optional)”.

Added instructions on how to use the Cisco Nexus plugin with Neutron (Appendix H, Using Cisco Nexus Switches with Neutron.

Added instructions on how to configure NetApp for Cinder to Section 10.9, “Deploying Cinder”.

Updated all screenshots because of an updated Web interface theme.

Added the section Section 11.3, “Upgrading from SUSE OpenStack Cloud 5 to SUSE OpenStack Cloud 6”.

Added Chapter 11, SUSE OpenStack Cloud Maintenance.

Added definition of user roles to About This Guide.

Added instruction on adjusting the CD-ROM drive letter for deploying Windows Compute Nodes when the Administration Server has got multiple hard disks to Section F.2, “Providing a Hyper-V Netboot Environment” (http://bugzilla.suse.com/show_bug.cgi?id=863978).

Added a notes on the VLAN configuration at various places (http://bugzilla.suse.com/show_bug.cgi?id=863829 and http://bugzilla.suse.com/show_bug.cgi?id=861523).

Adjusted the memory recommendations for the Control Node(s) at Section 2.4.2, “Control Node” (http://bugzilla.suse.com/show_bug.cgi?id=862312).

Add bind mount instructions for the Hyper-V Server deployment to Section F.2, “Providing a Hyper-V Netboot Environment” (http://bugzilla.suse.com/show_bug.cgi?id=861462).

Updated Appendix G, VMware vSphere Installation Instructions (http://bugzilla.suse.com/show_bug.cgi?id=859173).

Added Section 12.2.1, “ Applying PTFs (Program Temporary Fixes) Provided by the SUSE L3 Support ” (http://bugzilla.suse.com/show_bug.cgi?id=855387).

Corrections in Section 10.6, “Deploying Ceph (optional)” (http://bugzilla.suse.com/show_bug.cgi?id=850477).

Corrected network name in the SUSE Cloud Network Overview image in Section 2.1, “Network” (http://bugzilla.suse.com/show_bug.cgi?id=846877).

Added instructions on how to disable route verification to Section 12.1, “FAQ” (http://bugzilla.suse.com/show_bug.cgi?id=841214).

Added instructions on how to set up support for Microsoft Hyper-V (Appendix F, Setting up a Netboot Environment for Microsoft* Windows).

Screenshots for node allocation and for all barclamps have been added to Chapter 9, Installing the OpenStack Nodes and Chapter 10, Deploying the OpenStack Services.

Added the FAQ What to do when install-suse-cloud fails on deploying the IPMI/BMC network? to Section 12.1, “FAQ” (http://bugzilla.suse.com/show_bug.cgi?id=782337).

Completely restructured the FAQ section in Chapter 12, Troubleshooting and Support (http://bugzilla.suse.com/show_bug.cgi?id=794534).

Added a note about VLANs on the admin network to Section 2.1, “Network” (http://bugzilla.suse.com/show_bug.cgi?id=835065).

Re-wrote Setting Up a Bastion Network.

Completely re-wrote the repositories chapter. It now also contains information on how to use an external SMT or SUSE Manager server.

Renamed the commands smt repos and smt mirror to smt-repos and smt-mmirror because of a conflict with the smt command from the star package (Chapter 4, Installing and Setting Up an SMT Server on the Administration Server (Optional)).

Added a chapter on how to adjust the SUSE OpenStack Cloud network settings (Appendix D, The Network Barclamp Template File).

Added a snippet on the os_sdn network, that was introduced in SUSE Cloud 2.0 (Section 2.1, “Network”).

Added Section 9.4.3, “Mounting NFS Shares on a Node”.

Added Section 9.4.2, “Configuring Node Updates with the SUSE Manager Client Barclamp”.

Added Section 9.4.1, “Deploying Node Updates with the Updater Barclamp”.

Re-wrote Section 9.4.6, “Enabling SSL”.

Added information on the new Public Name and Target Platform attributes on the Node Dashboard to Section 9.2, “Node Installation”.

Added Section 10.5.1, “LDAP Authentication with Keystone”.

Added instructions on how to deploy Neutron (Section 10.11, “Deploying Neutron”).

Added instructions on how to set up support for VMware ESX (Appendix G, VMware vSphere Installation Instructions).

Added instructions on how to deploy Cinder in Section 10.9, “Deploying Cinder”.

barclamp descriptions have been updated—almost all configurable attributes are now described in Chapter 10, Deploying the OpenStack Services.

Added a note on debugging and adding additional repositories the update repositories chapter (http://bugzilla.suse.com/show_bug.cgi?id=838096).

Fixed an error in Section 2.1.2.2, “Dual Network Mode” that claimed two NICs are required on the Administration Server (http://bugzilla.suse.com/show_bug.cgi?id=838412).

Clarified in Section 10.9, “Deploying Cinder” that cinder-volume can be deployed on several block storage nodes (http://bugzilla.suse.com/show_bug.cgi?id=835921).

Added the role name for the Administration Server to Example D.3, “Network Modes for Certain Roles” (http://bugzilla.suse.com/show_bug.cgi?id=838354

Added information on how to access nodes from the outside by using the Administration Server as a jump host via the bastion network in Section 2.1.3, “Accessing the Administration Server via a Bastion Network” (http://bugzilla.suse.com/show_bug.cgi?id=838341).

Added a short description on how to change the host name during the installation in the section Chapter 6, Service Configuration: Administration Server Network Configuration (http://bugzilla.suse.com/show_bug.cgi?id=826163).

Dropped snippets about how to activate the bastion network (http://bugzilla.suse.com/show_bug.cgi?id=832952).

Fixed a syntax error in a program listing at Chapter 4, Installing and Setting Up an SMT Server on the Administration Server (Optional) (http://bugzilla.suse.com/show_bug.cgi?id=826833).

Added the FAQ I have installed a new hard disk on a node that was already deployed. Why is it ignored by Crowbar? to Section 12.1, “FAQ” (http://bugzilla.suse.com/show_bug.cgi?id=779733).

Added the FAQ What to do if a node hangs during hardware discovery after the very first boot using PXE into the SLEShammer image? to Section 12.1, “FAQ” (http://bugzilla.suse.com/show_bug.cgi?id=788156).

Corrected the IP address in Chapter 6, Service Configuration: Administration Server Network Configuration (http://bugzilla.suse.com/show_bug.cgi?id=817957).

Made various improvements throughout the document (http://bugzilla.suse.com/show_bug.cgi?id=806698)