IBM BPM, V8.0.1, All platforms > Manage assets in the Process Center repository > Manage the Process Center repository > Applying governance
Recovering if a process application under governance fails to install
If the installation of a process application fails while under governance, a number of remedies are available for administrators.
If an error occurs when you try to install a snapshot, the installation service returns an InstallErrorDetails object within the InstallResponse object. The InstallErrorDetails object provides an error code, a recoverable flag, an error message, a suggested action, and supporting details. You can include this object in a governance process to email an error report to an administrator. The recoverable flag is set to true only when the connection failed because the server is down or unreachable. Here are the error codes that might be returned:
- -15 Invalid input
- The input to the installation service is not valid.
For example, the migrationInstructions list in the ProcessAppInstallation object might be missing.
- -14. Installation not fully complete
- Some parts of the installation did not succeed. For more information about this problem, see Troubleshooting snapshot installations.
- -13. Multiple installation requests were found
- Multiple requests exist to install the same snapshot to the same server, which causes the installation service call to fail.
- -10. Not authorized
- The user ID that was used to call the governance service does not have the authority to install a snapshot to a server. This error might happen when governance services are run outside the system lane and a user without the necessary authority accepts the task.
- -9. Insufficient capabilities
- Possible causes include the process application has monitor models and the server does not have Business Monitor capability or a request was made to install an advanced application to a standard server.
- -8. Error updating the installation record
- Installation probably succeeded, but there was a failure when marking the installation record as complete.
- -7. Connection failed
- Verify the connection and try again.
- -6. Snapshot export failed
- Installation failed when Process Center tried to export the snapshot package to be installed on the Process Server.
- -5. Internal error
- A failure occurred that is related to the installation state machine.
- -4. Unsupported application
- A request was made to install an advanced application to a standard server. This error is similar to error -9 but happens at a different stage in the code path.
- -3. Snapshot already on the server
- The Process Server already has a snapshot with the same ID as the one in the installation request.
- -2. Dmgr unavailable
- The dmgr was not available for an ND Process Server environment.
- -1 Installation failed
- This message applies to errors that are not covered by the more specific codes.
Procedure
- If a customized governance process is faulty, change to the default governance process, fix your customized governance process, and then change back to your process from the default process.
- If the server stopped, the server administrator must fix the problem.
- If the connection to the server fails during installation of a snapshot, bring the server back online and reinstall the snapshot.
- If the installation failed because the process application snapshot is invalid, it can never be installed. Create a new snapshot.
- If the administrator can determine the cause of the failure, the administrator should fix the problem and then try again to install the process application.
- If a governance process is used to install a snapshot, process the InstallResponse returned by the Install Snapshot service to make sure installation is successful. If the installation is not successful, use the Cancel Snapshot Installation service to cancel the previous installation request. This method of cancellation is required if the installation is triggered through a governance process which is associated with Snapshot Status Change event. Changing the Snapshot Status Change governance assignment to the default does not reset the status of failed installations.
Applying governance to a process application
Related concepts:
Troubleshooting snapshot installations
Related tasks:
Applying a governance BPD to a process application or snapshot
Migrating a governance process from V8.0.0
Create a governance process for installing a process application
Create a governance process for the status of a snapshot
Create a governance BPD that installs a snapshot when the status changes
Changing a governance application
Testing a governance process
Export and importing a process application that uses customized governance
Related reference:
Governance services