Articles in this section

Urgent: End of support for Windows Server 2012 R2 with Celigo on-prem agent

Kathyana Queeman
Updated

download.svg​​ Download: On-prem agent version 4.3.0

We’re making essential changes to maintain the security and efficiency of your Celigo integrations. The Celigo on-prem agent will no longer support Windows Server 2012 R2. This decision aligns with Microsoft’s end of support for this operating system. For more details about the end of support for Windows Server 2012 R2 and how it might affect you, see Microsoft’s official End of Support Notice. You must upgrade your Windows server environment to ensure uninterrupted service and compatibility with the latest Celigo integrations.

To continue using Windows Server 2012 R2 and the Celigo on-prem agent, download agent version 4.3.0 and follow the steps in this article to install it. This agent doesn't include automatic updates, so you can continue using the unsupported Windows Server 2012 R2 environment.

download.svg​​ Download: On-prem agent version 4.3.0

Before you begin

  1. Identify all agent-based flows in your account. Note the flows that use agent-based webhook connections (if any).

    1. For webhook connections only: Determine if your webhook event provider has a retry mechanism. If it doesn't, temporarily disable the webhooks at the provider's end.

      Warning

      • Some events may be delayed during the update window.

      • integrator.io responds with status code 403 when the flow is disabled.

      • You may need to trigger any missed events from the event provider manually.

  2. Disable all agent-based flows disable_flow_icon.png.

  3. Ensure you have admin access to update the agent.

  4. download.svg​​ Download: On-prem agent version 4.3.0

Uninstall the existing agent

To uninstall the existing Celigo agent:

  1. Log in to the server using an account with administrative privileges.

  2. Search for and open the Control Panel.

    Tip

    Use the shortcut Win + R to open the search function.

  3. Click Programs → Programs and Features.

  4. Scroll through the list to find the agent.

    Tip

    The agent is usually at the top of the list since it's called "Agent." Remember to stop the agent before you uninstall it.

    Control_panel_programs_and_features_list.png

  5. Right-click the agent and click Uninstall.

  6. Follow the on-screen instructions to complete the process.

    Agent_uninstall_wizard.png

Install the new agent

If you downloaded the agent on the target computer, open the agent’s setup file, Agent Setup 4.3.0.exe, from your browser and install it. Otherwise, copy the downloaded file to the server and double-click to launch setup.

Tip

Schedule the update during a low-traffic period to minimize potential data loss.

The setup prompts you to choose installation options:

  1. Select whether to install the agent Only for me (Administrator) or for Anyone who uses this computer (all users) in the currently logged-in profile.

    1. Only for me – accessible to only one user

    2. All users – any user can run the service, but only one user should run it at a time.

      Warning

      If you select All users, administrative privileges are not automatically assigned. Add admin privileges manually as follows:

      1. Stop the service if it's running.

      2. Right-click Celigo Agent in your Windows Services app.

      3. Click Properties → Log on.

      4. Click This account, write in Administrator as the username, and enter the administrator password.

      5. Restart the agent service.

  2. Click Install.

  3. Give Windows permission to trust the downloaded executable and proceed.

  4. In the Completing Agent Setup window, ensure that Run agent is checked. Then, click Finish.

The Agent shortcut is added to your desktop and Windows programs, and the software opens to ask you for an integrator.io token.

Enter agent token

An access token secures communication between the agent and integrator.io. Your agent token was automatically generated when you initially created the agent through integrator.io. In this case, you'll be copying the agent token you already had in use.

To find the token:

  1. Return to integrator.io and navigate to Resources → Agents.

  2. In the list of agents, click Show token.

  3. Click Copy (copy.svg​​) next to the unmasked access token to copy it to your clipboard.

    360061142811-agent-2.png

  4. In the agent software, enter the access token. The agent will automatically start communicating with integrator.io.

    360061148171-agent-4.png

The agent should now be online. You may have to refresh the page to validate that it’s online.

image idm45220717887616

If your token is compromised, you can generate a new token:

  1. In integrator.io, navigate to Resources → Agents.

  2. Click Actions → Generate token.

This will automatically revoke the old token, so you must enter the new one.

Validation and troubleshooting

After installing the agent:

  1. Enable disabled webhooks on the provider's end (if any).

  2. Enable flows.

  3. Confirm that all flows are running.

  4. Verify webhook functionality (if applicable).

  5. Monitor for any errors in the first few hours after the update.

If you encounter any errors, try re-running the affected flows. For persistent issues, contact Celigo Support immediately.

Fallback procedure

If Agent version 4.3.0 fails to run or encounters issues with flow execution, immediately revert to version 3.4.0 as a temporary solution.