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
-
Check the host’s main page in the app. The Agent panel should show the results of the agent’s latest ping.
-
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