Integrate a source code server

A site must have one or more servers to handle source code repositories and users. The source code server can be the same server as the application server or a separate server.

When you set up a managed software configuration management (SCM) server, you enable users to create, manage and share repositories through CollabNet TeamForge.

Note: The ability to add integration servers depends on the value of the DISABLE_CREATE_INTEGRATION_SERVERS flag in the site-options.conf file. You can add new integration servers when the flag is set to its default value of "false".

You can integrate more than one source code server of a given type. For example, you can have two or more Subversion servers on your site. Consult a system administrator about the requirements for setting this up.

Tip: If you use a source code solution other than Subversion, CVS, or Perforce, you can integrate it using the CollabNet TeamForge SOAP APIs. This enables you to exchange commit data with any SCM application. Consult your CollabNet TeamForge system administrator.

Note: CVS servers that integrate with CollabNet TeamForge must use the native UNIX/Linux authentication method, and not external authentication mechanisms such as NIS, NIS+, Winbind, Active Directory, or LDAP. TeamForge creates and manipulates local system accounts using the default useradd, usermod, groupadd, groupdel, and userdel commands. It expects to find any accounts or groups it created in /etc/passwd and /etc/group.

Click Admin in the site navigation bar.
Click INTEGRATIONS.
On the SCM INTEGRATIONS page, click Create.
On the Create Integration page, write a name and description for the integration.
Choose the type of SCM server you want.
Restriction: When you give a group access to a CVS or Wandisco Subversion repository, members of the group can view the repository but cannot do repository actions, such as commit and update. You must assign those permissions to users individually.

Note: The SCM Adapter option only works if you have created your own SCM integration using the CollabNet TeamForge SOAP APIs.
Supply the host name for the Soap Service Host. This is the network address of the machine on which the integrated service, such as Subversion, is running.
Note: The default localhost will work only if the integration server is on the same server as the CollabNet TeamForge server.
Leave the default values in the SOAP Service Port field.
Specify whether users will use SSL to connect to their repositories.
Change the Repository Root value if you want to store the repository on your server in a different location. The repository root is the top-level directory under which all source code repositories reside.
Select Requires Approval if an administrator must approve all repositories created on the server. By default, unmanaged servers require approval for all repositories, because repositories must be created and integrated manually.
For a Subversion or CVS server, supply the URL by which your users will access the service. This will be of the form http://<myscmserver.com>/integration/viewvc/viewvc.cgi
Important: If your system administrator has upgraded your site from SourceForge Enterprise Edition 4.4 or earlier, remove the port number in the SCM Viewer URL.

Tip: If you are working with a CVS server that uses Pserver authentication, ask your system administrator for the right URL.
Click Save. CollabNet TeamForge attempts to validate the SCM viewer URL. If it cannot validate the URL, you can:
- Correct it if you have entered it incorrectly.
- Select Save with errors if the URL is different for an end user than it is for the CollabNet TeamForge server; for example, if you have a firewall in place.

If you are adding a managed source code server, it is now added. All projects can now establish repositories on the server.
If you are adding an unmanaged CVS server, all projects can now request repositories on the server. A CollabNet TeamForge administrator must create and integrate them manually.
Note: Only CVS servers can run unmanaged.