Updating cartridges

Follow these steps to update a cartridge from an older version.

1. Select a cartridge from the list.
2. Click Update from the top of the window.
   The Update Cartridge window opens.
3. Optionally, you can change the display name of the cartridge.
4. Make sure the license agreement is accepted.
5. Click Choose File to select a new version of the previously uploaded cartridge from the directory of your desktop.

   The new cartridge must have the same cartridge name as the cartridge that it is being updated. The cartridge name is given in the cartridge.properties file that is contained in the cartridge. However, previously processed documents are reindexed during a rerun of the respective actions only if the cartridge's version number changed. Otherwise, any new cartridge logic is applied only to newly processed documents, which can result in inconsistencies. The cartridge version is also set in the cartridge.properties file. For more information about the properties file, see the developerWorks recipe Developing Regular Expression Cartridges for StoredIQ.

6. Click Save.

   If the cartridge that is provided in the update is invalid or if an unexpected error occurs during the update process, an error message is returned and displayed in the Last Error field of the Details pane. If an error occurs, the previously uploaded version of the cartridge remains available.

   If Step-up Analytics executions are active, the Update button is not active. The number of active Step-up Analytics executions is given in the Total active Step-up Analytics executions using this cartridge field in the Details section.