Red Hat Training

A Red Hat training course is available for Red Hat Satellite

Release Notes

Red Hat Satellite 5.7

Product notes, new features, and known bugs for Red Hat Satellite 5.7

Daniel Macpherson

Red Hat Engineering Content Services


This document contains a set of product notes, new features, and known bugs for Red Hat Satellite 5.7

Chapter 1. Introduction

The release notes for Red Hat Satellite 5.7 contains product notes, new features and enhancements, API information, and technical preview information. These release notes also note down major corrections and known bugs in the product.

Chapter 2. Product Notes

  • Red Hat Satellite 5.7 is only available on Red Hat Enterprise Linux 6 as the host operating system. This means support on Red Hat Enterprise Linux 5 is no longer available for Red Hat Satellite 5.7. Red Hat Satellite 5.7 can still manage clients using Red Hat Enterprise Linux 5, 6, and 7.
  • Due to an updated version of the PostgreSQL Embedded Database, the database location has changed from /var/lib/pgsql in Red Hat Satellite 5.6 to /opt/rh/postgresql92/root/var/lib/pgsql in Red Hat Satellite 5.7. Make sure to allocate enough hard disk space to this location.
  • Red Hat Satellite 5.7 now provides Power Management controls for clients through IPMI. This feature is supported on x86_64 architecture only.

Chapter 3. New Features and Enhancements

The following new features and enhancements have been added to Red Hat Satellite 5.7:
  • Authentication through Identity Management (IdM) Servers - Red Hat Satellite 5.7 now contains a tool called spacewalk-setup-ipa-authentication, which configures your Satellite server to use an IdM/IPA server for authenticating users. See the Red Hat Satellite 5.7 Installation Guide for instructions for setting IdM authentication.
  • FIPS 140-2 support - The Federal Information Processing Standard (FIPS) 140-2 is a U.S. government security standard used to accredit cryptographic modules. This FIPS standard is enabled at an operating system level. Red Hat Satellite now uses the SHA-256 hashing method instead of MD5 to support the FIPS 140-2 standard. If you aim to upgrade from a non-FIPS Satellite server to FIPS-compliant Satellite 5.7 server, some additional configuration is required prior to enabling FIPS on the Satellite server. This involves updating user passwords and client certificates. See the upgrade instructions in the Red Hat Satellite 5.7 Installation Guide for configuration prior to enabling FIPS.
  • SSL support for Managed and External Database connections - Red Hat Satellite 5.7 now supports secure database communication in federated environments, such as Managed Database and External Database Satellite environments. See the Red Hat Satellite 5.7 Installation Guide for instructions on securing the database communication.
  • Enhanced Reporting in a Hosted Virtual Machine - Red Hat Satellite 5.7 now supports running a virtual machine on the Satellite server to host the Subscription Asset Manager server. See the Red Hat Satellite 5.7 Installation Guide for basic setup instructions.
  • Power Management - Red Hat Satellite 5.7 provides new features to control a client's power functions, such as Power On, Power Off, and Reboot. Clients require an IPMI interface for these function. See the system management instructions in the Red Hat Satellite 5.7 Getting Started Guide for configuration instructions.
  • Action Chaining - Red Hat Satellite 5.7 provides the ability to schedule a sequence of operations for systems.
  • New Client Architecture Support - Red Hat Satellite 5.7 now supports clients running on Power LE architectures.
  • Proxy Precaching - Red Hat Satellite 5.7 Proxy Server provides the ability to pre-cache or mirror RPMS to disk.
  • New User Interface - Red Hat Satellite 5.7 has a new UI style. Note that the overall menu structure and core operation of Satellite has not changed.
  • New API tool - Red Hat Satellite 5.7 now provides the spacecmd command line tool that interfaces with a major subset of the Satellite 5.7 APIs.
  • Read-only API access - Red Hat Satellite 5.7 now supports API access using a read-only user.
  • Enhancements to spacewalk-clone-by-date - The spacewalk-clone-by-date tool has been enhanced and now includes:
    • Ability to pass option --errata to state specific errata or erratum to clone, versus a stated date.
    • Ability to add specific errata with dependencies to cloned channel (BZ#1015963).
    • Ability to specify channel name, summary, and description for channels being created at the time of clone.
    • Ability to make spacewalk-clone-by-date able to specify channel name, summary, and description (BZ#830609).

Chapter 4. New API Methods

Red Hat Satellite 5.7 provides the following new API methods:
  • actionchain.addConfigurationDeployment
  • actionchain.addPackageInstall
  • actionchain.addPackageRemoval
  • actionchain.addPackageUpgrade
  • actionchain.addPackageVerify
  • actionchain.addScriptRun
  • actionchain.addSystemReboot
  • actionchain.createChain
  • actionchain.deleteChain
  • actionchain.listChainActions
  • actionchain.listChains
  • actionchain.removeAction
  • actionchain.renameChain
  • actionchain.scheduleChain
  • systemgroup.listSystemsMinimal
  • system.listSystemEvents
  • system.provisioning.snapshot.rollbackToSnapshot
  • system.provisioning.snapshot.rollbackToTag
  • system.scheduleCertificateUpdate
  • system.schedulePackageInstall
  • user.external.createExternalGroupToRoleMap
  • user.external.createExternalGroupToSystemGroupMap
  • user.external.deleteExternalGroupToRoleMap
  • user.external.deleteExternalGroupToSystemGroupMap
  • user.external.getDefaultOrg
  • user.external.getExternalGroupToRoleMap
  • user.external.getExternalGroupToSystemGroupMap
  • user.external.getKeepTemporaryRoles
  • user.external.getUseOrgUnit
  • user.external.listExternalGroupToRoleMaps
  • user.external.listExternalGroupToSystemGroupMaps
  • user.external.setDefaultOrg
  • user.external.setExternalGroupRoles
  • user.external.setExternalGroupSystemGroups
  • user.external.setKeepTemporaryRoles
  • user.external.setUseOrgUnit
  • user.getCreateDefaultSystemGroup
  • user.setCreateDefaultSystemGroup
  • user.setReadOnly

Chapter 5. Technical Preview

Red Hat Satellite 5.7 provides the following features as a technical preview:
  • Monitoring with SELinux - Monitoring with SELinux in enforcing mode continues to be offered as a technical preview for installations of Red Hat Satellite and Red Hat Satellite Proxy.

Chapter 6. Documentation Changes

The following sections contain some high-level documentation changes for Red Hat Satellite 5.7.

6.1. Major Book Changes in the Installation Guide

  • Installation instructions split into three separate installation scenarios:
    • Satellite with Embedded Database
    • Satellite with Managed Database
    • Satellite with External Database (PostgreSQL or Oracle)
  • Entitlements Certificates content moved to its own chapter. This is a fairly important step and moving the content to a seperate chapter increases the visability and prominence.
  • New content for IdM authentication
  • New content for secure database communication for Satellites using Managed and External Database
  • New content for hosting a virtual machine on the Satellite server to use for a Subscription Asset Manager server when setting up Enhanced Reporting

6.2. Major Book Changes in the Getting Started Guide

  • New content for Power Management

6.3. Major Book Changes in the Reference Guide

There is no Reference Guide document being released with Satellite 5.7. The content from this book has been moved to more appropriate books in the documentation suite. These changes include:
  • Chapter 1:
    • Multiple Satellite content moved to the Installation Guide
    • CLI Management Tools content moved to the User Guide
    • Monitoring content moved to the User Guide
  • Chapter 2:
    • Solaris client content moved to the Client Configuration Guide.
  • Chapter 3:
    • Proxy Information content moved to the Proxy Installation Guide
  • Chapter 4:
    • Customer Package Management content moved to the Getting Started Guide
  • Chapter 5:
    • Troubleshooting moved to the User Guide
  • Appendix A:
    • Probes moved to the User Guide

6.4. Major Book Changes in the Proxy Installation Guide

  • New content for Proxy pre-caching
  • New content for Proxy load balancing

Chapter 7. Major Corrections

Red Hat Satellite 5.7 corrects the following bugs:
Satellite 5.7 now consistently no longer double-counts systems subscribed to more than one channel from the same channel family.
The OSAD client can now connect to Satellite through a HTTP Squid proxy.
Satellite 5.7 fixes jabberd init script to no longer throw a harmless error when starting the service.
spacewalk-api has been fixed to correctly handle booleans.
When using rhnpush with large (4G+) rpms it no longer fails with Internal Server Error when attempting to upload them into Satellite.
Forgot password option has been fixed and now correctly works as expected.

Appendix A. Revision History

Revision History
Revision 1.1-8Thu Aug 20 2015Dan Macpherson
Mass publication of all Satellite 5.7 books
Revision 1.1-7Tue Aug 11 2015Dan Macpherson
Minor revisions
Revision 1.1-6Wed May 27 2015Dan Macpherson
Minor Revisions
Revision 1.1-5Tue Feb 17 2015Dan Macpherson
Minor maintenance updates
Revision 1.1-4Tue Feb 3 2015Dan Macpherson
Pushing maintenance update for Satellite 5.7
Revision 1.1-3Thu Jan 15 2015Dan Macpherson
Updating to include note for new database location
Revision 1.1-2Wed Jan 7 2015Dan Macpherson
Packaging snapshot versions
Revision 1.1-1Tue Jan 6 2015Dan Macpherson
Major Corrections section added to release notes. Also added minor fixes to the document.
Revision 1.1-0Mon Jan 5 2015Dan Macpherson
Initial creation of Release Notes

Legal Notice

Copyright © 2015 Red Hat.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.