3.10. Outdated Cartridge List

If a newly installed cartridge is not immediately available, it could be due to an outdated, cached cartridge list. The first time the REST API is accessed, the broker host uses MCollective to retrieve the list of available cartridges from a node host. By default, this list is cached for six hours in a production environment. If the installed cartridges are modified, the cache must be cleared either manually, or by waiting until the cache expires before developers can access the updated list.

In addition, the Management Console has its own cached list of installed cartridges that must be cleared for any changes to be observed.

Use the following command on each broker in your OpenShift Enterprise installation to clear the broker cache only:

# oo-admin-broker-cache --clear

Use the following command on each broker in your OpenShift Enterprise installation to clear the broker and Console cache (the --console option implies --clear):

# oo-admin-broker-cache --console