Some Secure Agent Services support rolling upgrades. In a rolling upgrade, services that run on the agents within a Secure Agent group are upgraded sequentially. Therefore, while a service is being upgraded on one agent, the service remains available on other agents in the group.
The following Secure Agent service supports rolling upgrades:
•Process Server
Other services that run on the agents within a Secure Agent group are upgraded on each agent simultaneously. Therefore, they are unavailable while the agents in the group are being upgraded. They become available again when all agents in the group have been successfully upgraded.
Example
Your organization uses the following runtime environments:
•Secure Agent group A:
- Agent A1 runs Data Integration Server and Process Server.
- Agent A2 runs Data Integration Server, Mass Ingestion, and Process Server.
•Secure Agent group B:
- Agent B1 runs Data Integration Server, Mass Ingestion, and Process Server.
- Agent B2 runs Data Integration Server, Mass Ingestion, and Process Server.
When your organization is upgraded, Secure Agent groups A and B are upgraded simultaneously. Within each Secure Agent group, Process Server is upgraded sequentially. Therefore, while Process Server is being upgraded on agents A1 and B1, it remains up and running on agents A2 and B2. When the upgrade finishes on agents A1 and B1, Process Server is upgraded on agents A2 and B2.
Data Integration Server and Mass Ingestion do not support rolling upgrades. In groups A and B, Data Integration Server is upgraded on each agent simultaneously. In group B, Mass Ingestion is upgraded on agents B1 and B2 simultaneously.
Rolling upgrade error handling
If a service that supports rolling upgrades encounters an error during an upgrade, you can specify whether to continue or stop upgrading the service. Configure the error handling behavior on the Settings page.
You can select either of the following options:
In case of error, flag error and continue with upgrade
If an error occurs while a service is being upgraded, the service stops with an error on the agent in which it encountered the error. The upgrade then continues on the other agents within the group.
Warning: If you enable this option and the error occurs on all agents in the group, the service stops running on the Secure Agent group. This can cause job interruptions.
In case of error, stop upgrade
If an error occurs while a service is being upgraded, the service stops with an error on the agent in which it encountered the error. Upgrade of the service stops for all other agents in the group that have not already been upgraded. The agents that have not been upgraded continue to run the previous version of the service.
This is the default option.
To configure the error handling behavior, click Edit in the Upgrade Settings for Secure Agent Services area, select the appropriate option, and click Save.