Configure general server settings

The Apache configuration files get written based on the information you provide in the web console. You don't need a direct login to the host server operating system.

1. Click Server Settings as the second step of the Getting Started wizard or from the left panel after selecting Administration in the main navigation bar.
2. The following fields are provided values. Make changes as appropriate.
   • Hostname: This is the fully qualified hostname including the domain of your Subversion Edge Apache server. For example, cu001.cubit.abc.collab.net.
   • Port: For Windows, the default is the standard port 80. On Linux, you need to perform some additional setup to use a standard port such as port 80, or port 443 if you want to turn on SSL and use HTTPS. When you select a reserved port, examples of what you need to do will be displayed. To run the server on any port less than 1024, you need root access. The system will check for this as well.
     You have two options to allow use of port 80 or 443. Choose the one that fits your need. Both the following options require root privileges.

     • Use the bind helper application.
       httpd_bind is an application that comes with CollabNet Subversion Edge to allow server access to the standard ports without the server itself running with elevated privileges. For it to work, httpd_bind must be owned by root and have its suid bit set as shown in the following commands. These commands must be executed as root or sudo.

       • chown root:csvn /opt/edge_3.1.2/lib/httpd_bind/httpd_bind
       • chmod u+s /opt/edge_3.1.2/lib/httpd_bind/httpd_bind
     • Start httpd under sudo.
       The SVN server can be started with root privileges allowing it to bind to the port, after which the server will lower its privileges. To use this method and allow starting and stopping the server from the management console, set up sudo for the httpd binary to work without a password. Use "/usr/sbin/visudo" to add the following lines at the end of the sudoers file.

       • Defaults env_keep += "PYTHONPATH"
       • Defaults:csvn !requiretty
       • csvn ALL=(ALL) NOPASSWD: /opt/collabnet/csvn/bin/httpd

       Note: For illustration purposes, 'csvn' is used in the above commands as the user that runs the console. Substitute 'csvn' with appropriate user name in your case.
   • Repository Directory: This is the path to the parent directory for your Subversion Edge repositories. The default is /data/repositories in the location where you installed Subversion Edge. If you have existing repositories you want to connect to the web console, you could enter that location instead.
   • Backup Directory: Repository dump files are stored in this location under the name of the repository. The default is /data/dumps in the location where you installed Subversion Edge.
3. Specify whether you want encryption for the Subversion server. If you enable this setting, you will be provided the Advanced Configuration link to set up custom SSL directives.
4. Provide the site administrator's name, email address, and alternative contact information such as a phone number or another email address.

   Apache error messages print the administrator's name and email address.

5. Specify whether the Subversion Edge console should require HTTPS.

   In release 1.2 and later, Subversion Edge is pre-configured to run SSL on port 4434 using a self-signed certificate, in addition to the existing HTTP on port 3343. If you set HTTPS as a requirement for the console, all requests on port 3343 will get redirected to port 4434. Users who'll be accessing Subversion Edge via SSL will need to accept the certificate warnings unless you purchase an official SSL certificate from a trusted Certificate Authority.

   If you've configured Apache for SSL, it will be set to use the same self-signed certificate as the console.

6. Click Save.