Cloudera Docs

Remove a custom descriptor from Apache Knox

How to remove a custom descriptor from Knox using Cloudera Manager.

You can remove a custom descriptor from Knox when the descriptor is no longer required.

  1. In Cloudera Manager, select the Knox service.
  2. Go to Configuration.
  3. Find the Knox Gateway Advanced Configuration Snippet (Safety Valve) for conf/cdp-resources.xml advanced configuration snippet.
  4. Click the + icon, and add the following entries
    • Set the Name to the name of the descriptor that you want to delete.
    • Set the Value to remove.
    In this example, we remove the myTestDescriptor custom descriptor.

  5. Click the Save Changes(CTRL+S) button.
  6. Refresh the Knox instances configuration by clicking the Stale Configuration: Refresh needed indicator and wait until the refresh process completes.


  7. Repeat the previous steps for any number of descriptors that you want to remove.
  8. Verify that the descriptor file has been removed by running the following command in the Command Line Interface (CLI): 
    ls -al /var/lib/knox/gateway/conf/descriptors/[***DESCRIPTOR_NAME***].json
  9. Check the output. If the file has been successfully removed, you will see the following message: 
    ls: cannot access /var/lib/knox/gateway/conf/descriptors/[***DESCRIPTOR_NAME***].json: No such file or directory