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.
Download
Version | Executable | PGP Signature | SHA256 Checksum |
---|---|---|---|
latest |
|||
1.7.4 |
|||
1.7.3 |
|||
1.7.1 |
|||
1.6.1 |
|||
1.6.0 |
|||
1.5.1 |
|||
1.5.0 |
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