VisualSVN Repository Configurator is a standalone tool that allows non-administrative users to manage permissions for repositories hosted on VisualSVN Server. Repository Configurator uses Windows Management Instrumentation (WMI) to communicate with a remote VisualSVN Server instance. Configuration steps required to allow a user to manage permissions using VisualSVN Repository Configurator are described in the KB62 article.
VisualSVN Repository Configurator may be unable to connect to a repository. Usually this happens due to the misconfiguration of the environment. This article describes how to identify and solve the problem.
Below you can find the list of typical cases that will help you to identify the cause of the connection failure and fix the misconfiguration.
User account is not a member of 'Distributed COM Users' local group
Before repository supervisor is able to manage a repository, his user account must be added to Distributed COM Users local group on the machine where VisualSVN Server is installed.
If the user account is not a member of Distributed COM Users, repository supervisor will get the following error message when attempting to connect to a repository with VisualSVN Repository Configurator:
To solve the issue, add the user to Distributed COM Users local group on the VisualSVN Server machine.
User account is not a member of 'VisualSVN Repository Supervisors' local group
Before repository supervisor is able to manage a repository, his user account must be added to VisualSVN Repository Supervisors local group on the machine where VisualSVN Server is installed.
If the user account is not a member of VisualSVN Repository Supervisors, repository supervisor will get the following error message when attempting to connect to a repository with VisualSVN Repository Configurator:
To solve the issue, add the user to VisualSVN Repository Supervisors local group on the VisualSVN Server machine.
WMI through the Windows Firewall is not allowed
VisualSVN Repository Configurator uses WMI (Windows Management Instrumentation) to communicate with a remote VisualSVN Server instance. Connecting to WMI remotely requires that you first configure Windows Firewall on the server to allow this.
If Windows Firewall is configured to block WMI connections, repository supervisor will get the following error message when attempting to connect to a repository:
Please check the firewall settings on the server or contact your system administrator.
To solve the issue, check that WMI is allowed in the Windows Firewall on the server machine where VisualSVN Server is installed. Check the article KB62 for instructions.
The user is not a supervisor of the repository
Repository supervisor's user account has to be explicitly added to the list of assigned supervisors of a particular repository. When the supervisor is not authorized to manage the repository, he will get the following error message:
To solve this issue, make the user a supervisor for the repository. Check the article KB62 for instructions.
Repository Management Delegation is disabled
As the main step to allow repository management with Repository Configurator you are required to enable Repository Management Delegation for the repository.
If Repository Management Delegation is disabled, repository supervisor will get the following error message:
To solve the issue, you need to enable Repository Management Delegation feature for the particular repository. In order to do so, you should start VisualSVN Server Manager, right-click the repository and execute All Tasks | Manage Delegation context menu command. Then check the Enable repository management delegation checkbox to enable delegation for this repository.
Other issues
Please contact us using the online feedback form if you cannot identify the reason of the connection failure using to instructions provided above.