New features that affect upgrades

This release includes new features and new requirements that affect the upgrade process. The following list provides an overview of the changes that are addressed during this upgrade.

  • RHEL/CentOS 7.4 is added; RHEL/CentOS 7.1 is withdrawn. The upgrade process includes a step for updating the operating system.
  • On RHEL/CentOS 7.4, there may be a file locking defect in NFS 4.1. To avoid the issue, delegate hosts are configured to use NFS 4.0.
  • The serviced-zenossdbpack maintenance script is moved from /etc/cron.weekly to /opt/serviced/bin and a new cron job, /etc/cron.d/cron_zenossdbpack, is installed to invoke the maintenance script. By default, the script runs every Sunday at midnight.
  • The upgrade (and install) process now requires downloading packages from Zenoss manually. The required software and images are no longer available from the online Zenoss repository or Docker Hub. For more information, see Downloading and staging required files.

    The packages to download include a yum repository mirror that contains the required dependencies of Docker CE and Control Center. An operating system or kernel upgrade can install newer versions of the dependencies included in the mirror, and when you attempt to upgrade Docker CE or Control Center, yum will stop when it finds the newer versions. A new appendix in this document includes workarounds for the most common dependency conflicts.

  • This release includes a new feature, serviced and application audit logging. By default, audit logging requires 10GB of storage on the master host. The upgrade process includes a procedure for adding space to the master host, if necessary. For more information about audit logging, refer to the Control Center Reference Guide.
  • A new configuration variable, SERVICED_LOG_PATH, sets the location for audit logs. The default location is /var/log/serviced.
  • This release replaces Docker 1.12.1 with Docker Community Edition (CE) 17.09.0.
  • The following new configuration variables are available in /etc/default/serviced, for tuning TCP/IP communications between ZooKeeper ensemble hosts and Control Center:
    • SERVICED_ZK_CONNECT_TIMEOUT
    • SERVICED_ZK_PER_HOST_CONNECT_DELAY
    • SERVICED_ZK_RECONNECT_START_DELAY
    • SERVICED_ZK_RECONNECT_MAX_DELAY
    For more information, see Control Center configuration file.
  • The Control Center RPM package includes a script that adds the serviced user group to a host, if necessary. Users must be members of the serviced group to use the command-line interface. For more information, see User access control.

For more information about this release, refer to the Control Center Release Notes.