How do I set up the Repository Module for the first time?¶

Repository Location:¶

The SVN URL to download source is: 'http://svn.ircan.gc.ca/svn/identifier' (replace "identifier" with the project's unique system name, found within the main URL for the project, such as 'http://tbs-sct.ircan.gc.ca/projects/IDENTIFIER?lang=eng'). This URL is meant to be used in your SVN client (ie: TortoiseSVN). The repository is located within a datacentre of IT Services Branch, Public Works and Government Services Canada (PWGSC). The systems are physically in Canada's National Capital Region.

When configuring the repository settings in Chiliproject, you need to enter "Subversion" as the SCM and "file:///var/svn/identifier" as the URL (replace "identifier" with the project's unique system name).

Corporate Firewall Change Request:¶

It may be necessary for Canadian Government personnel to submit a "Network Firewall Change Request" to their corporate network services.

• To access your IRCan VM using SSH, the corporate firewall needs to permit outbound connections on TCP port 22 communications to IPs 198.103.103.0/24 This IP series is held by ITSB, PWGSC. On the 1st use only of a SSH client connecting to each one of the ITSB servers, the user will have to accept the server’s key fingerprint.

• IRCan’s instance of Chiliproject and the SVN repository are listening on port port 80 (HTTP). There are plans to also offer services on port 443 (HTTPS) for greater security. Because of this, we expect that no changes to most corporate firewalls are necessary.

Client and Network Set-Up¶

It may be necessary for Canadian Government personnel to submit a "Client Firewall Change Request" to their corporate network services.

• An SSH client must be installed on your desktop and needs to be able to open sockets out on port 22. Canadian Government personnel on Windows clients often use puTTy.exe. Those on Linux clients often connect directly from emacs

• Users who want a graphical interface to the SVN repository have a wide range of choices. Canadian Government personnel on Windows clients often use tortoiseproc.exe which has received an excellent review against GC accessibility criteria. Any client-side interface application to the repository needs to be permitted to connect out on port 80 and 443.

• Any standards-based browser may be used. (However, Internet Explorer 6 has known bugs and should not be used.) Browsers must be permitted to connect out on port 80 and 443.

Choice of Repository Solutions¶

The Chiliproject (a fork of Redmine environment) currently implemented for IRCan natively supports integration with various configuration management solutions. Custom arrangements can be made for project teams that prefer something other than our current default SVN implementation.