Hybrid Connector version upgrade

To upgrade the Hybrid Connector version from 1.x to 2.x, complete the steps below.

Preliminary steps

Before starting the upgrade, complete the following checks:

1. Ensure client management is turned off. Disable any management or automation activity that might interfere with the upgrade.
2. Back up the Hybrid Agent configuration file:
   • Locate the Agent configuration file. Example path: C:\Program Files (x86)\CoreView Agent\Forward365.Service.PowershellService.Agent.exe.config.
   • Copy the file to a safe backup location.

Step-by-step upgrade procedure

Step 1a: uninstall the previous version

1. Open the Windows “Control Panel”.
2. Identify the Windows service name used by the Hybrid Agent. For example: “CoreView Agent”.
3. Uninstall the service.

4. Remove the “CoreView Agent” folder. The folder should be empty.

4. The service is uninstalled automatically. For additional verification, check that it is no longer listed in the “Services” panel.

Step 1b: manual uninstall

If the service is not removed automatically, complete a manual uninstall.

Prerequisite: use an Administrator command prompt or an elevated PowerShell session.

1. Open “Services” by running services.msc.
2. Identify the Windows service name used by the Hybrid Agent. For example: “CoreView Agent”.
3. Delete the service by running the following command:

   sc delete "ServiceName"

4. Wait a few seconds, then refresh “Services” to verify that the service has been removed.
5. Remove the installation folder and files. Example path: C:\Program Files (x86)\CoreView Agent.

Step 2: install the new version

To install the new version, follow steps 1 to 4 of the Installation procedure in the product manual.

Step 3: stop the new service

1. Open the Windows “Services” panel.
2. Stop the newly installed Hybrid Agent service.

Step 4: restore the configuration keys

Restore the configuration values that must be preserved from the original Forward365.Service.PowershellService.Agent.exe.config backup into the newly installed configuration file.

Ensure that the following keys exist in the new configuration file and restore their previous values:

• CentralAuthApiUrl
• SecondsPeriodTask
• BackendApiUrl
• AppHostPort
• gMSAEnabled
• gMSAName
• gMSAImporterEnabled
• gMSAImporterName

If the installation flow requires reusing the current SecurityKey and LiteDB password, follow the Existing installation procedure.

Step 5: start the service

1. Open the Windows “Services” panel.
2. Start the Hybrid Agent service.

Step 6: configure the API key

1. Copy the generated API key from the “Configure On-Premises” section.

2. Paste the API key into the connector.

Step 7: verify the session

Run “Verify session” to confirm that the upgraded Hybrid Connector is correctly configured.