Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

5.6. Disabling Obsolete Cartridges

Cartridges are updated over time, leaving older versions of a cartridge with fewer advantages. To acknowledge this, cartridges can be marked obsolete in their cartridge manifests. Obsolete cartridges represent technologies, or versions of technologies, for which you do not want developers to be able to deploy new applications or add-on cartridges, but that are still required by the applications already using them.
By default, obsolete cartridges are still available to developers when deploying new applications or add-on cartridges. However, you can disable the use of all obsolete cartridges, preventing developers from using them in these cases. Whether the use of obsolete cartridges is enabled or disabled, applications already using obsolete cartridges continue to function normally and can add new gears using the obsolete cartridges automatically, for example during scaling operations.

Procedure 5.4. To Disable Obsolete Cartridges:

  1. Ensure the ALLOW_OBSOLETE_CARTRIDGES parameter in the /etc/openshift/broker.conf file on the broker host is set to false: 
    ALLOW_OBSOLETE_CARTRIDGES="false"
    Copy to Clipboard Toggle word wrap
  2. Add the Obsolete: true parameter to the /usr/libexec/openshift/cartridges/Cart_Name/metadata/manifest.yml file on each node host for any cartridge being marked obsolete: 
    Obsolete: true
    Copy to Clipboard Toggle word wrap
  3. Restart the MCollective service on each node host: 
    # service ruby193-mcollective restart
    Copy to Clipboard Toggle word wrap
  4. Update the cartridge lists on the broker. For releases prior to OpenShift Enterprise 2.1, run the following command on the broker host to clear the broker cache and, if installed, the Management Console cache: 
    # oo-admin-broker-cache --clear --console
    Copy to Clipboard Toggle word wrap
    For OpenShift Enterprise 2.1 and later, run the following commands on the broker host to import the latest cartridge manifests from the nodes and, if installed, clear the Management Console cache: 
    # oo-admin-ctl-cartridge -c import-profile
# oo-admin-console-cache --clear
    Copy to Clipboard Toggle word wrap
  5. Restart the broker service: 
    # service openshift-broker restart
    Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat