Windows Agent

To install the Pro Custodibus agent on Windows, download the agent installer from this page. After you have downloaded the installer executable, copy it to the host and run it.

Install

As the Administrator user for the Windows host, place the procustodibus.conf and procustodibus-setup.conf files in host’s C:Program Files\Pro Custodibus Agent\cnf directory:

> mkdir "C:Program Files\Pro Custodibus Agent\cnf"
> move procustodibus.conf "C:Program Files\Pro Custodibus Agent\cnf\."
> move procustodibus-setup.conf "C:Program Files\Pro Custodibus Agent\cnf\."

Then run the installer executable:

> ProCustodibusAgentInstaller-latest.exe

This will install the agent, and start it running as a service.

Run

If you ran the installer before moving the procustodibus.conf and procustodibus-setup.conf files to host’s C:Program Files\Pro Custodibus Agent\cnf directory, move them now (as the Administrator user):

> move procustodibus.conf "C:Program Files\Pro Custodibus Agent\cnf\."
> move procustodibus-setup.conf "C:Program Files\Pro Custodibus Agent\cnf\."

Then, as the Administrator user, stop the agent, and start it again:

> sc stop ProCustodibusAgentService

SERVICE_NAME: ProCustodibusAgentService
        TYPE               : 10  WIN32_OWN_PROCESS
        STATE              : 1  STOPPED
        WIN32_EXIT_CODE    : 0  (0x0)
        SERVICE_EXIT_CODE  : 0  (0x0)
        CHECKPOINT         : 0x0
        WAIT_HINT          : 0x0

> sc start ProCustodibusAgentService

  SERVICE_NAME: ProCustodibusAgentService
          TYPE               : 10  WIN32_OWN_PROCESS
          STATE              : 2  START_PENDING
                                  (NOT_STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
          WIN32_EXIT_CODE    : 0  (0x0)
          SERVICE_EXIT_CODE  : 0  (0x0)
          CHECKPOINT         : 0x0
          WAIT_HINT          : 0x7d0
          PID                : 1234
          FLAGS

Run the following command to verify that the agent started up successfully:

> sc query ProCustodibusAgentService

  SERVICE_NAME: ProCustodibusAgentService
          TYPE               : 10  WIN32_OWN_PROCESS
          STATE              : 4  RUNNING
                                  (STOPPABLE, NOT_PAUSABLE, IGNORES_SHUTDOWN)
          WIN32_EXIT_CODE    : 0  (0x0)
          SERVICE_EXIT_CODE  : 0  (0x0)
          CHECKPOINT         : 0x0
          WAIT_HINT          : 0x0

If the agent is running, this command output should contain STATE : 4 RUNNING. If, not check the agent’s main log file:

> notepad "C:\Program Files\Pro Custodibus Agent\log\stdout.log"

Next Steps

  1. Check the host’s main page in the app. The Agent panel should show the results of the agent’s latest ping.

  2. If the Agent panel simply reads Set Up Agent, or if the Interfaces panel doesn’t list the WireGuard interfaces you already have running on the host, check the Agent Troubleshooting page.

Upgrade

To upgrade the agent, download the latest version of the installer, and run it as the Administrator user on the host:

> ProCustodibusAgentInstaller-latest.exe

This will stop the existing agent service, uninstall it, install the new version, and start the new version running as a service.

Uninstall

As the Administrator user for the Windows host, run the C:Program Files\Pro Custodibus Agent\uninstall.exe executable:

> "C:Program Files\Pro Custodibus Agent\unins000.exe"

This will stop the agent service and uninstall it. It will not affect any WireGuard services currently running on the host.

Other Options

To run the installer without prompts, add the /SILENT option:

> ProCustodibusAgentInstaller-latest.exe /SILENT

To run the installer without prompts or progress messages, add the /VERYSILENT option:

> ProCustodibusAgentInstaller-latest.exe /VERYSILENT

To prevent the installer from adding Start menu items, add the /NOICONS option:

> ProCustodibusAgentInstaller-latest.exe /NOICONS